> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telomatrix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TMA常见故障诊断

## 安装故障

### 现象：安装TMA时防病毒软件提示风险

**- 故障原因：**

安装TMA时，TMA会对系统配置和注册表进行修改，防病毒软件提示风险属于正常现象。

**- 解决办法：**

在防病毒软件提示风险时请选择"允许操作"。

### 现象：客户端安装失败

**- 故障原因：**

在不支持的操作系统版本上安装TMA。

**- 解决办法：**

使用TMA支持的操作系统重新安装。

TMA支持64位操作系统，相关版本型号如下：

Windows：Windows7、Windows10以及Windows11。

MAC端：macOS 10.10 (Yosemite) 及以上版本。

iOS：iOS15.0及以上

Android：Android6.0及以上。

> 注意如果是Windows7 SP1版本，需要安装补丁：KB4474419。
>
> TMA标准版本不支持32位操作系统，以及Linux系统，如有需求请联系我们提供定制化版本。

### 现象：安装时导入证书失败

**- 故障原因：**

TMA导入证书时需要与 TM 企业注册平台通信，导入失败可能是因为互联网访问异常。

**- 解决办法：**

检查本地网络，确认互联网连接正常后再次安装。

## 认证故障

### 现象：使用企微等第三方扫码登录，但二维码加载慢或者加载失败

**- 故障原因：**

TMC通过调用企微等第三方接口获取认证二维码，调用二维码慢或者失败很有可能是本地网络质量不佳导致。

**- 解决办法：**

检测本地网络是否畅通，更换网络质量更好的本地网络。

## 网络故障

### 现象：终端环境检测异常

**- 故障原因：**

不符合终端入网规则配置（如：系统版本/软件/进程/补丁/defender/域控等限制)。

**- 解决办法：**

按照提示的不合规内容进行终端环境优化。

### 现象：同步安全云网失败

**- 故障原因：**

原因1：本地网络问题，导致获取云网配置失败。

原因2：无可用的 TM 网关。

原因3：云网虚拟IP与本机IP冲突。

原因4：创建虚拟网卡失败。

**- 解决办法：**

办法1：检查本地网络质量，选择质量更好的本地网络。

办法2：在终端上执行网络监测，查看终端与TMG的连通性，如超时请联系管理员解决。

办法3：重启客户端后重新登录入网，TMA将重新分配云网虚拟IP地址。

办法4：查看本机是否安装了流量抓包工具，如：wireshark，将这个工具升级至最新版，然后重新登录TMA。

### 现象：加入安全云网失败

**- 故障原因：**

原因1：因为本地网络问题，导致TMA侧与TMG侧连接探测多次失败。

原因2：本地启用了其他网络代理程序，通过默认路由将网络流量都转发到了其他地方，如：VPN软件等。

**- 解决办法：**

办法1：选择质量更好的本地网络，使用网络检查功能，检查本地网络质量，如始终与TMG延时较大或超时，请联系管理员解决。

办法2：检查本地是否启用了其他网络代理软件，关闭这些代理软件，然后重启客户端，重新登录入网。

## 业务访问故障

### 现象：获取不到资源列表

**- 故障原因：**

本地网络质量不佳。

**- 解决办法：**

点击资源组旁边的刷新按钮，重新刷新业务资源。

点击在线时长旁边的重置网络按钮，重置网络配置。

选择质量更好的本地网络，退出TMA并重新登录。

### 现象：资源访问缓慢或失败

**- 故障原因：**

本地网络质量不佳，或者终端到TMG的网络质量不佳。

**- 解决办法：**

检查或切换本地网络，或退出TMA并重新登录。

### 现象：Web业务资源可以ping通，但使用浏览器无法打开

**- 故障原因：**

浏览器使用了代理插件。

**- 解决办法：**

检查浏览器是否启用了Web代理插件，关闭插件后重新访问。

### 现象：资源页面打开时提示“您的连接不是私密链接”

**- 故障原因：**

业务网站的证书出现错误或未使用正确的证书时会出现此故障。

**- 解决办法：**

在使用HTTPS代理业务资源时使用正确的SSL证书。

如果无法提供证书，但仍需访问时，可尝试以下方法：

* 如果是Chrome浏览器，您可以在页面键入“thisisunsafe”即可打开业务页面；

* 如果Safari浏览器，您可以点击“显示详细信息”，然后点击“访问此网站”即可打开业务页面；

* 如果是IE或Edge浏览器，您可以点击“详细信息”，然后点击“转到此网页（不推荐）”即可打开业务页面；

* 如果是Firefox浏览器，您可以点击“高级”，然后点击“接受风险并继续”即可打开业务页面。
