> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/zh/proxies/dai-li-gu-zhang-pai-cha.md).

# 代理故障排查

本文档为 Thordata 代理服务的官方错误码说明，用于帮助快速定位并解决代理使用过程中遇到的问题。

### Thordata响应说明

我们的报错信息回通过：`X-thor-error-code`    `X-thor-error-msg`   `X-thor-error` 响应头展示出来，该响应头提供有关错误的详细信息。

| 请求头               | 说明           | 示例                    |
| ----------------- | ------------ | --------------------- |
| X-thor-error-code | 自定义的代理服务错误编号 | client\_101           |
| X-thor-error-msg  | 代理服务自定义错误描述  | 检查地区参数，确保与平台支持的地域列表一致 |
| X-thor-error      | 自定义代理服务错误类型  | 地区参数错误                |

提示：如果目标网站返回了下述错误信息，请根据提示进行调整。

如果您碰到了这里没有列出的响应码，随时联系我们，从而获取帮助。

**命令行说明**

要查看全部的响应报文您可以`curl`从 shell 提示符运行命令并添加选项标志`-v`将以详细模式运行 curl，并打印出标头字段，包括自定义错误代码和消息。

```
curl -v -x [rest of curl command options]
```

### 错误目录

| 编号            | 响应码 | 错误类型                                           | 提示句                                                                                                                                              |
| ------------- | --- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| client\_101   | 400 | <p>地区参数错误</p><p>Region Parameter Error</p>     | Check the region parameter to ensure it matches the list of regions supported by the platform.                                                   |
| client\_102   | 400 | <p>协议参数错误</p><p>Protocol Parameter Error</p>   | Confirm that the proxy protocol (HTTP/HTTPS, SOCKS5) matches the protocols supported by the current node.                                        |
| client\_103   | 400 | <p>端口参数错误</p><p>Port Parameter Error</p>       | Check if the port number is correct. For details, refer to <https://doc.thordata.com/doc>.                                                       |
| client\_104   | 400 | <p>主机参数错误</p><p>Host Parameter Error</p>       | Confirm that the proxy host is entered correctly.                                                                                                |
| Resource\_201 | 502 | <p>IP分配失败</p><p>IP Allocation Failed</p>       | Resource IP connection failed. Please try again. <https://www.thordata.com/>                                                                     |
| Resource\_202 | 400 | <p>地域匹配失败</p><p>Region Mismatch Failed</p>     | The requested region is not supported by Thordata. Please retry with a supported region. For more information: <https://doc.thordata.com/>       |
| Resource\_203 | 502 | <p>其他资源问题</p><p>Resource Issue</p>             | The target URL accessed by the resource IP is incorrect. Please try again.                                                                       |
| Resource\_204 | 502 | <p>其他资源问题</p><p>Resource Issue</p>             | Resource IP connection failed. Please try again.                                                                                                 |
| Auth\_301     | 407 | <p>权限不足</p><p>Insufficient Permissions</p>     | IP whitelist authentication failed. Please check if your IP is in the whitelist.                                                                 |
| Auth\_302     | 407 | <p>认证失败</p><p>Authentication Failed</p>        | Authentication succeeded, but information retrieval failed. Please contact customer service.                                                     |
| Auth\_303     | 407 | <p>账密参数错误</p><p>Credential Parameter Error</p> | Credential verification failed. Please check your account and password information and try again.                                                |
| Network\_401  | 504 | <p>网络链路中断</p><p>Network Link Interrupted</p>   | Request failed. Please try again.                                                                                                                |
| Account\_501  | 407 | <p>套餐问题</p><p>Subscription Plan Issue</p>      | Your proxy package has expired, and you currently have no service permissions. Please complete the renewal and try again.                        |
| Account\_502  | 407 | <p>流量问题</p><p>Traffic Issue</p>                | Your account traffic has been exhausted, and no new requests can be initiated. Please top up.                                                    |
| Account\_503  | 407 | <p>流量限制</p><p>Traffic Limit Exceeded</p>       | The current traffic usage has reached the limit. Please try again later.                                                                         |
| Access\_601   | 403 | <p>访问限制</p><p>Access Restricted</p>            | The requested site can only be accessed after submitting an access application and getting it approved.                                          |
| Access\_602   | 403 | <p>访问限制</p><p>Access Restricted</p>            | Sorry, you cannot access this domain. It has been detected that the domain may violate Thordata's Acceptable Use Policy, so it has been blocked. |
| Access\_603   | 403 | <p>访问限制</p><p>Access Restricted</p>            | The requested site requires you to complete KYC verification first to obtain full access rights.                                                 |
| Access\_604   | 403 | <p>访问限制</p><p>Access Restricted</p>            | Block access to LAN IP                                                                                                                           |
| Access\_605   | 403 | <p>访问限制</p><p>Access Restricted</p>            | This Port is forbidden                                                                                                                           |
| Access\_606   | 403 | <p>访问限制</p><p>Access Restricted</p>            | The requested IP triggered the IP segment restriction in the account configuration, and the requested IP is \*\*\*\*                             |
| Access\_607   | 403 | <p>访问限制</p><p>Access Restricted</p>            | Invalid request address                                                                                                                          |
| Access\_608   | 403 | <p>访问限制</p><p>Access Restricted</p>            | Does not support mainland China servers                                                                                                          |