代理配置选项 - Bright Data Docs

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

代理网络身份验证

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

创建 Bright Data 代理区域后，您将获得：

代理用户名不仅仅是一个标识符，它还定义了代理的行为方式。 代理用户名由以下部分组成：

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	从列表定位一个 ASN	`brd-customer-<customer_id>-zone-<zone_name>-asn-56386`
-os-xxxxx	仅适用于住宅代理。允许定位 `Windows`、`MacOS` 或 `android`	`brd-customer-<customer_id>-zone-<zone_name>-os-windows`

DNS 解析��定了在发送请求之前域名的解析位置。 Bright Data 允许您控制 DNS 解析是否发生：

功能	参数	描述	示例用户名
选择 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