配置 IPFoxy 代理

MaskPilot 不需要登录 IPFoxy 账号或同步代理密钥。先在 IPFoxy 后台取得可直接连接的协议、服务器地址、端口、用户名和密码，再把这些字段添加为普通代理即可。

从 IPFoxy 获取连接信息

静态代理通常可以在已购买的代理列表中直接复制。动态代理需要先在 IPFoxy 后台选择出口地区、线路和会话方式，再生成连接信息。

常用入口地址与端口

产品或线路	服务器地址	端口	协议	使用说明
动态住宅代理 · 亚太线路	gate-sg.ipfoxy.io	58688	HTTP / SOCKS5	入口在新加坡，出口地区由用户名参数决定
动态住宅代理 · 美洲线路	gate-us.ipfoxy.io	58688	HTTP / SOCKS5	入口在美国，出口地区由用户名参数决定
静态 IPv4、IPv6、ISP 代理	控制台分配的 IP 或主机名	控制台分配的端口	HTTP 或 SOCKS5	每个节点可能不同，必须从静态代理列表复制

58688 是 IPFoxy 当前动态住宅代理的统一端口。官方仍保留旧版 SOCKS5 58622 和 HTTP 58611 端口供存量连接使用，新配置优先采用控制台当前显示的 58688。入口线路只影响连接路线，不代表最终出口地区。

复制前确认以下字段：

• **协议：**选择 IPFoxy 当前为该节点提供的 HTTP 或 SOCKS5，不要根据端口自行猜测。
• **服务器和端口：**使用后台当次显示的入口地址与端口。
• **用户名和密码：**动态代理的地区、城市或会话参数可能已经包含在用户名中，应完整保留。
• **有效期：**静态节点有到期时间时，可以同时记录到 MaskPilot 的到期日期中。

IPFoxy 的动态代理通用参数和示例可能随产品调整，请以 IPFoxy 官方参数说明和控制台当次生成的结果为准。

添加一个 IPFoxy 代理

1. 打开 MaskPilot 的「代理」页面，点击「添加代理」。
2. 选择「普通代理」。
3. 按 IPFoxy 提供的信息选择 HTTP、HTTPS 或 SOCKS5。
4. 分别填写服务器地址、端口、用户名和密码。
5. 在「服务商」中填写 IPFoxy，按需记录地区、到期日期和备注。
6. 保存后，在代理所在行点击「检测连接」。

服务器字段只填写主机名或 IP，不要同时放入协议、端口或刷新链接。动态代理的刷新 URL 不是代理服务器地址，不能粘贴到服务器字段。

批量导入

IPFoxy 后台导出多条连接信息时，可以打开「批量导入」，每行粘贴一个节点。推荐整理成以下任一格式：

host:port:username:password
http://username:password@host:port
socks5://username:password@host:port

未写协议的 host:port:username:password 会按 HTTP 导入。如果复制结果是 socks5://host:port:username:password，不要直接按网址格式导入，也不要简单去掉协议。请将其整理为标准认证 URL socks5://username:password@host:port；凭据含保留字符时先进行 URL 编码。无法安全转换时，改用「添加代理」逐项填写。开始导入前确认识别数量，完成后逐个检查协议、端口和连接状态。

绑定到浏览器账号

1. 创建或编辑浏览器账号。
2. 在「网络连接」中选择「使用代理」。
3. 点击「选择代理」，找到服务商为 IPFoxy 的已检测节点。
4. 选中节点并保存，再启动账号。

动态代理可能按请求或会话轮换出口。需要在一个浏览器会话中保持出口稳定时，应先在 IPFoxy 生成粘性会话信息，不要在 MaskPilot 中自行删改用户名里的会话参数。

检测失败怎么办

• 重新复制完整用户名，确认地区和会话参数没有被截断。
• 核对连接协议是否与当前入口端口匹配。
• 确认节点、套餐和认证信息仍有效，并检查服务商的来源网络限制。
• IPFoxy 当前要求从中国大陆以外的网络环境连接；复测时不要关闭服务商所需的可达网络路线。
• 如果只有批量导入的节点失败，改为手动添加一条进行对照。
• 如果连接成功但账号无法启动，继续核对启动时的出口信息与时区检测。

详细排查方法参见为什么代理测试失败？和为什么绑定代理后账号无法启动？。