代理网络身份验证
通过代理用户名和密码进行本地访问
创建 Bright Data 代理区域(包括产品及其配置设置)后,您将收到一个代理用户名和密码。
代理用户名包含您的账户 ID、区域名称和可选参数。
代理用户名结构为:
brd-customer-[customerID]-zone-[zone name]-[optional parameters]
请注意,区域创建后,您无法更改其 区域名称 本身。如果您需要更改区域名称,请创建一个新区域(您可以将相同类型的代理从一个区域转移到另一个区域)。
本页解释了如何通过添加可选参数和 修改用户名,从您的代码中以高度精细的方式控制 Bright Data 系统。下表汇总了开发人员可在代理用户名中使用的选项。详细列表可在我们的 API 参考文档中查看:代理 API 文档。
与第三方和工具集成
您可以使用仪表板上的 代理集成示例 页面来创建不同的请求。
代理目标定位选项
这些设置让您轻松配置代理以针对特定国家/地区、州/省、城市、邮政编码和 ASN。
| 参数 | 描述 | 示例用户名 |
|---|
| -country-xx | 使用两位代码选择一个国家/地区,或使用 eu 选择欧盟中的随机国家/地区。国家/地区代码列表在此处 | brd-customer-<customer_id>-zone-<zone_name>-country-us |
| -state-xxxxx | 使用两位代码定位美国的州/省。您必须包含 US 作为国家/地区。 | brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny |
| -city-xxxxx | 定位一个城市。您必须包含国家/地区(例如 username-country-fr-city-paris)。请勿使用空格(例如 -city-sanfrancisco) | brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco |
| -zip-xxxxx | 定位一个美国邮政编码。使用 5 位数字的邮政编码 | brd-customer-<customer_id>-zone-<zone_name>-city-memphis-zip-37501 |
| -asn-xxxxx | 定位来自 该列表 的 ASN | brd-customer-<customer_id>-zone-<zone_name>-asn-56386 |
| -os-xxxxx | 仅适用于住宅代理。允许定位 Windows、MacOS 或 android | brd-customer-<customer_id>-zone-<zone_name>-os-windows |
| -carrier-os-xxxxx | 仅适用于移动代理,您可以选择使用 该列表 中的特定运营商 | brd-customer-<customer_id>-zone-<zone_name>-carrier-dt |
控制您的代理的 DNS
以下选项允许您设置 DNS 解析的执行方式。
| 功能 | 参数 | 描述 | 示例用户名 |
|---|
| 选择 DNS 解析的执行位置 | -dns-local or -dns-remote | 让您选择 DNS 是在连接到网站的代理上 remote(远程)解析,还是在 Bright Data 的服务器(“超级代理”)上 local(本地)解析。更多信息请见此处 | brd-customer-<customer_id>-zone-<zone_name>-dns-local |
控制您的代理轮换
以下选项允许您设置我们如何在区域内的代理中进行轮换,或附加到特定代理,以及如果对等点因某种原因不可用,我们应该怎么做。有关 IP 轮换如何与我们的代理产品配合使用的更多信息,以及以下选项的进一步解释,请参阅本文
| 功能 | 参数 | 描述 | 示例用户名 |
|---|
| 针对多个请求保持相同的 IP 或轮换 IP | -session-xxxxxx | 每个唯一的会话 ID 将获得一个唯一的 IP,可用于重复定位相同的 IP 或强制轮换。推荐用于实施程序化 IP 轮换。 | brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345 |
| 选择特定的 IP | -ip-x.x.x.x | 仅适用于分配了专用 IP 的区域 | brd-customer-<customer_id>-zone-<zone_name>-ip-1.2.3.4 |
| 选择特定的 IP 组 (gIP) | -gip-xxxxxx | 仅适用于专用住宅或移动代理。 | brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0 |
| 跟踪单个响应 | -c_tag-xxxxxx | 在其请求中包含唯一的 c_tag 标志。在响应中,企业在标头中回传相同的标签。这种无缝交换确保每个响应都与其相应的请求绑定,消除了混淆并简化了数据管理。 | brd-customer-<customer_id>-zone-<zone_name>-c_tag-<C_TAG_VALUE> |
| 在会话中绑定到对等点 | -const | 为会话使用相同的对等点。如果对等点不可用,将返回带有“no peer available”的 502 错误 | brd-customer-<customer_id>-zone-<zone_name>-const |
控制“超级代理”
超级代理是决定您的请求路由到实际代理(可以是数据中心、ISP 或住宅代理)的主服务器。注意:很少需要修改这些参数!
| 功能 | 参数 | 描述 | 示例用户名 |
|---|
| 直接从超级代理发送请求 | -direct | 强制请求从 Bright Data 的超级代理服务器发送(而不是从实际的代理对等点发送) | brd-customer-<customer_id>-zone-<zone_name>-direct |
| 在特定国家/地区选择超级代理 | session-xxxxxx | 仅适用于选择超级代理,这很少需要。更多详细信息在此处 | 示例 |
| 选择特定的 IP 组 (gIP) | gip-xxxxxx | 仅适用于专用住宅或移动代理。 | brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0 |
| 阻止超级代理绕过 | -route_err-block | 禁止 Bright Data 从我们的超级代理服务器发出请求。这意味着如果由于合规性问题我们无法通过对等点处理请求,它将失败并返回错误 | brd-customer-<customer_id>-zone-<zone_name>-route_err_block |