本文档说明如何使用代理用户名参数配置 Bright Data 代理行为。通过修改代理用户名，您可以直接从代码中控制代理定位、IP 轮换、DNS 解析、会话处理和路由行为。
这种方法允许进行高度精细的代理控制，而无需更改仪表板设置或基础设施。
代理网络身份验证
Bright Data 代理访问使用代理用户名和密码进行身份验证。这些凭据是在 Bright Data 控制面板中创建代理区域时生成的。
每个代理区域代表一个特定的代理产品（数据中心、ISP、住宅或移动）及其基本配置。
通过代理用户名和密码进行本机访问
创建 Bright Data 代理区域后，您将获得：
代理用户名不仅仅是一个标识符，它还定义了代理的行为方式。
代理用户名由以下部分组成：
代理用户名结构
brd-customer-[customerID]-zone-[zone name]-[optional parameters]
创建代理区域后，您无法更改区域名称。如果需要更改区域名称，必须创建新区域。代理只能在两个区域类型相同的情况下从一个区域转移到另一个区域。
与第三方工具集成
Bright Data 代理可与各种第三方工具、自动化框架、浏览器和 HTTP 客户端集成。为了简化集成，Bright Data 在控制面板中提供现成的请求示例。
您可以在此处访问这些示例：https://brightdata.com/cp/zones/proxy_examples
这些示例帮助您：
- 构造正确的代理请求
- 验证凭据
- 测试定位和轮换行为
- 将代理集成到现有工具和工作流中
代理定位选项
这些设置让您轻松配置特定国家、州、城市、邮编和 ASN 的代理。
| 参数 | 描述 | 示例用户名 |
|---|
| -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 |
| -carrier-os-xxxxx | 对于移动代理，您可以选择使用来自 此列表 的特定运营商 | brd-customer-<customer_id>-zone-<zone_name>-carrier-dt |
控制代理的 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 |
