配置 Oxylabs 代理

MaskPilot 不提供 Oxylabs 专属集成入口。无论使用住宅、ISP 还是数据中心代理，只要 Oxylabs 提供标准 HTTP、HTTPS 或 SOCKS5 连接，都可以按主机、端口、用户名和密码添加为普通代理。

获取 Oxylabs 端点

登录 Oxylabs 控制台并打开对应产品。动态住宅代理可以使用端点生成器选择地区、认证方式和会话类型，再导出连接列表；静态产品则从已分配的 IP 或端点列表中取得连接信息。

常用入口地址与端口

产品或入口	服务器地址	端口	协议与用途
住宅代理通用入口	pr.oxylabs.io	7777	HTTP / HTTPS / SOCKS5；地区与会话通常写入用户名
美国随机入口示例	us-pr.oxylabs.io	10000	HTTP / HTTPS；每次请求可获得美国随机出口
美国粘性入口示例	us-pr.oxylabs.io	10001	HTTP / HTTPS；用于美国粘性会话
其他国家入口	对应国家的 *-pr.oxylabs.io	各国家对应端口	从官方入口列表或控制台复制，不要套用美国端口
专用数据中心或 ISP 代理	分配的 IP 或主机名	分配的端口	每个产品和节点可能不同

pr.oxylabs.io:7777 是住宅代理最通用的入口。Oxylabs 当前不支持通过国家专用入口使用 SOCKS5；需要 SOCKS5 地区定位时，应使用通用入口并保留用户名中的国家或城市参数。不同产品不要混用入口地址。

准备以下字段：

• Oxylabs 为当前产品提供的协议。
• 入口主机或静态 IP，以及对应端口。
• 代理用户的完整用户名和密码。
• 地区、城市和粘性会话等已生成参数。

位置和会话参数可能体现在用户名或入口地址中，复制时不要删减。操作入口和可导出格式参见 Oxylabs 官方端点生成器说明。

添加一个 Oxylabs 代理

1. 打开 MaskPilot 的「代理」页面，点击「添加代理」。
2. 选择「普通代理」。
3. 按 Oxylabs 当前端点选择 HTTP、HTTPS 或 SOCKS5。
4. 分别填写入口主机、端口、代理用户名和密码。
5. 在「服务商」中填写 Oxylabs，按需添加地区、到期日期和备注。
6. 保存后点击「检测连接」，核对出口信息。

不要把控制台登录邮箱或主账号密码当作代理用户凭据。使用 IP 白名单认证时，用户名和密码可以留空，但必须先确认当前设备的公网来源 IP 已在 Oxylabs 允许列表中。

导入端点列表

从端点生成器导出 TXT，或将 CSV 中的连接字段整理为每行一条，再使用 MaskPilot 的「批量导入」：

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

未写协议的 host:port:username:password 会按 HTTP 导入；HTTPS 或 SOCKS5 节点应保留对应协议前缀。不要把整份 CSV、JSON 或带表头的内容直接当作普通代理列表。导入前移除表头与无关列，确认页面识别数量；导入后检查每条协议和端口。

绑定并选择会话方式

1. 创建或编辑浏览器账号。
2. 在「网络连接」中选择「使用代理」。
3. 选择已保存并检测通过的 Oxylabs 节点。
4. 保存后启动账号，确认实际出口地区。

动态住宅代理可能为每个请求分配新 IP。需要一个账号在单次使用期间保持同一出口时，应在 Oxylabs 端点生成器中选择粘性会话，或使用服务商规定的会话参数。MaskPilot 的代理备注和地区标签不会控制轮换。

常见失败原因

• 代理用户名缺少产品要求的前缀、地区或会话参数。
• 使用了不属于当前产品的主机或端口。
• SOCKS5 的启用条件、DNS 或端口要求与 HTTP 连接不同。
• 来源 IP 白名单、流量额度或产品状态发生变化。
• 复制时把用户名中的连字符、下划线或大小写改错。

请一次只修正一项并重新检测。协议的当前限制以 Oxylabs 官方协议说明为准；通用排查参见为什么代理测试失败？。