跳转到主要内容

代理网络身份验证

通过代理用户名和密码进行本地访问

创建 Bright Data 代理区域(包括产品及其配置设置)后,您将收到一个代理用户名和密码。 代理用户名包含您的账户 ID、区域名称和可选参数。 代理用户名结构为: brd-customer-[customerID]-zone-[zone name]-[optional parameters]
请注意,区域创建后,您无法更改其 区域名称 本身。如果您需要更改区域名称,请创建一个新区域(您可以将相同类型的代理从一个区域转移到另一个区域)。
本页解释了如何通过添加可选参数和 修改用户名,从您的代码中以高度精细的方式控制 Bright Data 系统。下表汇总了开发人员可在代理用户名中使用的选项。详细列表可在我们的 API 参考文档中查看:代理 API 文档

与第三方和工具集成

您可以使用仪表板上的 代理集成示例 页面来创建不同的请求。

代理目标定位选项

这些设置让您轻松配置代理以针对特定国家/地区、州/省、城市、邮政编码和 ASN。
数据中心和 ISP 代理仅支持国家/地区目标定位
参数描述示例用户名
-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-sanfranciscobrd-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定位来自 该列表 的 ASNbrd-customer-<customer_id>-zone-<zone_name>-asn-56386
-os-xxxxx仅适用于住宅代理。允许定位 WindowsMacOSandroidbrd-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