配置 Bright Data 代理

MaskPilot 通过 Bright Data 提供的标准连接参数使用代理，不需要安装 Proxy Manager，也不读取 Bright Data 账号。请先在 Bright Data 控制台准备可用区域，再复制该区域的主机、端口、用户名和密码。

准备 Bright Data 连接信息

在控制台选择代理网络或区域，确认认证方式、目标地区和会话策略，然后取得以下信息：

常用入口地址与端口

连接方式	服务器地址	端口	适用范围
HTTP / HTTPS 主入口	brd.superproxy.io	33335	数据中心、ISP、住宅和移动代理区域的常用主入口
SOCKS5 主入口	brd.superproxy.io	22228	Bright Data 启用 SOCKS5 的代理区域
专用 IP、Proxy Manager 或控制台生成端点	控制台显示的地址	控制台显示的端口	不要用主入口值覆盖专用端点

33335 与 22228 是代理服务入口端口，不是目标网站端口。使用 SOCKS5 时必须改用 22228；把 33335 与 SOCKS5 组合会导致连接失败。若控制台为当前区域给出了其他主机或端口，应以该区域显示值为准。

• HTTP、HTTPS 或 SOCKS5 连接协议。
• 代理主机和与该协议对应的端口。
• 区域用户名与区域密码。
• 需要固定出口时使用的会话参数。

不要把账号登录密码当作区域密码，也不要从网上复制示例凭据。Bright Data 的 SOCKS5 可能使用与 HTTP/HTTPS 不同的端口，并要求代理端完成域名解析，具体以 Bright Data 官方 SOCKS5 说明和控制台显示为准。

添加一个 Bright Data 代理

1. 打开 MaskPilot 的「代理」页面，点击「添加代理」。
2. 选择「普通代理」。
3. 按 Bright Data 区域提供的连接方式选择 HTTP、HTTPS 或 SOCKS5。
4. 分别填写代理主机、端口、区域用户名和区域密码。
5. 在「服务商」中填写 Bright Data，并记录区域用途或会话策略。
6. 保存后点击「检测连接」，核对出口地区。

MaskPilot 的「地区」字段只是管理标签，不会替 Bright Data 修改出口。国家、州、城市和粘性会话等参数应先在 Bright Data 生成，或按其说明保留在用户名中。

导入多个连接

从控制台下载或复制多个端点后，可以使用「批量导入」，每行一个：

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

未写协议的行会按 HTTP 导入。导入 HTTPS 或 SOCKS5 时应保留对应协议前缀；如果用户名或密码含有 @、:、/ 等保留字符，使用控制台提供的完整 URL，或先进行 URL 编码。导入后核对协议和端口；不要把 HTTP 区域的端口直接改成 SOCKS5 而不确认服务商规则。

绑定并保持会话出口

1. 创建或编辑浏览器账号。
2. 在「网络连接」中选择「使用代理」。
3. 从已添加代理中选择目标 Bright Data 节点。
4. 保存并启动账号，再核对实际出口。

动态住宅代理可能默认轮换 IP。需要在同一浏览器会话中保持出口时，应在 Bright Data 连接信息中加入服务商规定的会话参数，再添加到 MaskPilot；仅填写备注不会改变轮换行为。

常见失败原因

• 使用了 Bright Data 登录密码，而不是区域认证信息。
• HTTP、HTTPS 与 SOCKS5 的端口或协议不匹配。
• 用户名中的区域名、国家或会话参数拼写错误。
• 区域余额、流量、白名单或合规设置不允许本次连接。
• 本机网络不能访问服务商入口或所需 DNS 路径。

修改参数后重新执行连接检测。仍失败时参见为什么代理测试失败？；需要批量导入和账号绑定的完整说明见添加、导入与绑定代理。