# 如何在 DuoPlus 云手机配置住宅代理？

添加自定义代理并绑定 DuoPlus 云手机，分别使用动态账密与静态实例凭据验证出口。

DuoPlus 可以为云手机配置自定义代理。本教程先取得只只HTTP连接信息，再完成检查、设备绑定和云手机内验证。

## 步骤一：获取只只HTTP代理信息

- **动态住宅**：进入“动态住宅网络 → 账密认证”，取得 `us.zzhttp.com`、端口 `7878`、生成的完整代理用户名和对应子账号密码；协议按工具选择 HTTP 或 SOCKS5 TCP。先确认实名、权益、共享流量和子账号状态。
- **静态住宅**：进入“静态住宅网络 → IP 管理”，复制已交付、可用且未到期实例的实际 IP、端口与独立代理账密。静态购买无需实名认证，不使用动态网关、子账号或客户白名单。

详细获取步骤见[账密认证](/help/network/account-auth)和[静态住宅首次连接](/help/getting-started/static-residential-quickstart)。代理密码不是控制台登录密码。

云手机由云端设备连接代理，不能填写本机的 `127.0.0.1` 或内网地址。动态住宅的海外 IPv4 来源要求需要由实际连接代理的云端环境满足；电脑能够连接并不能证明云手机能够连接。只只HTTP的 SOCKS5 链路仅支持 TCP，不启用依赖 UDP 转发的功能。

## 步骤二：添加自定义代理

1. 登录 DuoPlus，在“代理 / Proxies”页面点击“添加 / Add”；也可从目标云手机的“未配置代理 / 配置代理”进入。
2. 选择“自定义代理”，按当前页面选择 HTTP 或 SOCKS5。本教程以 HTTP 账密为例；不因为目标是 HTTPS 网页就把协议改成 HTTPS 代理。
3. 分别填写 IP 或域名、端口、用户名和密码。

| 工具字段 | 动态住宅填写 | 静态住宅填写 |
| --- | --- | --- |
| 主机 / IP / Server | `us.zzhttp.com` | 实例实际 IP |
| 端口 / Port | `7878` | 实例实际端口 |
| 用户名 / Username | 控制台生成的完整用户名 | 实例独立用户名 |
| 密码 / Password | 对应子账号密码 | 实例独立密码 |

主机字段不带协议前缀，四个字段分开填写。HTTP 代理可通过 CONNECT 访问 HTTPS 网站。

![DuoPlus 自定义代理所需四个连接字段及来源示意图](/images/help/proxy-fields.webp)

这是通用字段示意图，不是 DuoPlus 截图。自动粘贴或批量导入时先检查解析结果，密码含特殊字符时优先分字段填写。“刷新 URL”保持为空，不填写控制台链接。

## 步骤三：检查并保存代理

点击“检查代理”，核对成功提示及出口地区，然后保存。DuoPlus 的检测来自其云端网络；检测失败时核对云端可达性和动态来源限制，不修改本机白名单来猜测修复。

## 步骤四：绑定并启动云手机

在目标设备的代理配置中选择刚保存的代理，点击“完成配置”。回到设备列表开机或连接，进入云手机后再验证。需要分别维护设备出口时，为每台设备明确绑定对应配置；同一配置不会自动生成多个独立静态出口。

## 验证代理是否生效

在真正执行任务的环境中打开或请求 `https://ipinfo.io/json`，核对 `ip`、`country`、`region`，并与该环境未启用代理时的出口比较。动态网关主机与出口 IP 不相同，不要求检测结果等于网关解析地址。静态按实例标称出口核对；地区数据库可能存在偏差。再访问允许测试的 HTTPS 页面确认链路。

## 常见问题

- **连接失败或超时**：核对端点、端口、协议和执行环境网络，见[连接失败排查](/help/troubleshooting/connection-failed)。
- **认证失败**：动态核对完整用户名、子账号、权益与实际连接来源；静态核对实例当前凭据与有效期，不能靠补动态白名单解决。见[407 排查](/help/troubleshooting/proxy-auth-407)。
- **仍显示原出口**：确认代理已绑定到实际设备或任务，排除绕过列表、其他代理覆盖和旧配置。
- **检测成功但目标失败**：目标站点的 `403`、`429`、页面变化和代理连接错误分别排查，先降低并发并查看实际错误。

需要长期保持同一出口时使用静态实例；动态[粘性会话](/help/network/sticky-session)只在配置的会话周期内保持，不等于永久固定 IP。多个设备使用同一实例仍可能共用出口。截图、日志和任务导出中不要暴露完整凭据。

入口参考[DuoPlus 标准代理配置](https://help.duoplus.net/docs/Standard-Proxy-Configuration)，协议能力参考[官方代理介绍与常见问题](https://help.duoplus.net/docs/Proxy-Introduction-and-Common-Issues-with-Proxy-Configuration)。