> For the complete documentation index, see [llms.txt](https://iptuns.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://iptuns.gitbook.io/docs/gu-zhang-pai-chu/lian-jie-wen-ti.md).

# 连接问题

{% hint style="warning" %}
平台的所有代理产品均需要在海外网络环境下使用，海外网络环境需要客户自行配置。
{% endhint %}

如果你在使用 Iptuns 住宅代理时遇到无法连接的情况，通常可以通过以下步骤快速定位原因。请按照顺序检查，以提高排查效率。

### 1.检查本地网络状态 <a href="#id-1-jian-cha-ben-di-wang-luo-zhuang-tai" id="id-1-jian-cha-ben-di-wang-luo-zhuang-tai"></a>

* 确认设备已连接互联网（浏览器可正常打开网页）
* 如果使用的是服务器或远程环境，请确认网络出口未受限

### 2.检查代理地址与端口

* 确保使用的 `代理 IP` 和 `端口` 与套餐信息一致
* 代理地址格式错误、端口未开放或填写多余字符，会直接导致连接失败

### 3.检查账号密码（如当前代理需要认证）

* 静态住宅 IP 和不限量住宅 IP 采用**账号密码子账号**进行代理连接认证
* 认证账号请在平台中查看或重新生成
* 复制账号密码时建议直接粘贴使用，避免手动输入时出现遗漏或多余空格

### 4.检查代理协议匹配

目前 Iptuns 住宅代理支持：

* `HTTP`
* `SOCKS5`

使用 curl 或代理管理器时，请确保协议模式与产品支持一致，错误的协议模式会导致无法握手连接。

### 5.检查防火墙或端口限制（服务器/云主机环境）

* 服务器默认可能屏蔽代理端口访问，需要手动放行或检查端口状态
* 建议使用 `telnet` 或 `nc` 进行端口连通测试：

```shellscript
telnet PROXY_IP PROXY_PORT
# 或
nc -zv PROXY_IP PROXY_PORT
```

### 6.切换网络环境测试

如果以上检查无误，建议尝试：

* 切换到 4G/5G 网络
* 更换另一个 Wi-Fi 网络
* 重新启动代理客户端或终端

### 7.使用不同工具验证连接

可尝试使用以下方式验证代理是否能连接：

* 代理管理器（Shadowrocket / v2rayNG / Clash / v2rayN 等）
* CURL 代理请求
* 浏览器插件或本地客户端配置

### 8.联系客服获取协助

如果仍无法连接，请通过客服提供以下信息，我们将协助排查：

* 连接失败提示截图（如有）
* 代理套餐类型（静态/动态/不限量）
* 代理 IP 与端口
* 连接使用的子账号（如适用）
* 设备或服务器系统类型（Mac/Windows/CentOS/Ubuntu/Android/iOS）

### 9.可能的常见原因总结

| 可能原因           | 结果        |
| -------------- | --------- |
| 网络未连接或出口受限     | 无法访问代理服务器 |
| 代理地址/端口错误      | 直接连接失败    |
| 账号密码子账号错误或复制异常 | 认证失败      |
| 协议模式不匹配        | 无法握手连接    |
| 服务器端口未放行       | 被拦截或无响应   |

### 10.免责声明

Iptuns 仅提供住宅代理出口与认证连接服务，不参与用户访问内容的执行逻辑。请确保代理用途合法合规，并遵守第三方平台规则。