跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt

Use this file to discover all available pages before exploring further.

本文档说明如何使用代理用户名参数配置 Bright Data 代理行为。通过修改代理用户名，您可以直接从代码中控制代理定位、IP 轮换、DNS 解析、会话处理和路由行为。 这种方法允许进行高度精细的代理控制，而无需更改仪表板设置或基础设施。

​
代理网络身份验证

Bright Data 代理访问使用代理用户名和密码进行身份验证。这些凭据是在 Bright Data 控制面板中创建代理区域时生成的。 每个代理区域代表一个特定的代理产品（数据中心、ISP 或住宅）及其基本配置。

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

创建 Bright Data 代理区域后，您将获得：
  • 代理用户名
  • 代理密码
代理用户名不仅仅是一个标识符，它还定义了代理的行为方式。 代理用户名由以下部分组成：
  • 您的账户 ID
  • 您的区域名称
  • 可选配置参数

​
代理用户名结构

brd-customer-[customerID]-zone-[zone name]-[optional parameters]
创建代理区域后，您无法更改区域名称。如果需要更改区域名称，必须创建新区域。代理只能在两个区域类型相同的情况下从一个区域转移到另一个区域。
通过添加可选参数和修改用户名，您可以直接从应用程序代码以非常精细的方式控制 Bright Data 的代理系统。 下面的部分描述了可用的配置选项。完整的列表可在 代理 API 参考文档 中获得。

​
与第三方工具集成

Bright Data 代理可与各种第三方工具、自动化框架、浏览器和 HTTP 客户端集成。为了简化集成，Bright Data 在控制面板中提供现成的请求示例。 您可以在此处访问这些示例：https://www.bright.cn/cp/zones/proxy_examples 这些示例帮助您：
  • 构造正确的代理请求
  • 验证凭据
  • 测试定位和轮换行为
  • 将代理集成到现有工具和工作流中

​
代理定位选项

这些设置让您轻松配置特定国家、州、城市、邮编和 ASN 的代理。
数据中心和 ISP 代理仅支持国家定位
参数描述示例用户名
-country-xx使用两字母代码选择国家，或使用 eu 表示欧盟中的随机国家。国家代码列表在 这里brd-customer-<customer_id>-zone-<zone_name>-country-us
-state-xxxxx使用两字母代码定位美国的一个州。必须包括美国作为国家。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从 列表 定位一个 ASNbrd-customer-<customer_id>-zone-<zone_name>-asn-56386
-os-xxxxx仅适用于住宅代理。允许定位 Windows、MacOS 或 androidbrd-customer-<customer_id>-zone-<zone_name>-os-windows

​
控制代理的 DNS

DNS 解析���定了在发送请求之前域名的解析位置。 Bright Data 允许您控制 DNS 解析是否发生：
  • 在代理对等端
  • 在 Bright Data 的超级代理服务器上
功能参数描述示例用户名
选择 DNS 解析位置-dns-local 或 -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为会话使用相同的对等端。如果对等端不可用，将返回 502 错误，显示”no peer available”brd-customer-<customer_id>-zone-<zone_name>-const

​
控制”超级代理”

超级代理是 Bright Data 的路由服务器，负责选择和管理实际的代理对等端（数据中心、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
要查找导航和其他文档页面，请获取位置如下的 llms.txt 文件：https://docs.brightdata.com/llms.txt