住宅产品常见问题解答

发送请求时，请在请求中的区域名称后添加-country标志，然后添加该国家/地区的 2 个字母 ISO 代码。

在以下示例中：我们在请求中添加了 -country-us，因此我们将发送来自美国（“us”）的请求。

curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>

欧盟内部的国家分配是随机的。

与 DC、ISP 和 Web Unlocker/SERP API 相关

您可以按照与上述“国家/地区”相同的方式定位到整个欧盟地区，在请求中的 “country” 之后添加 “eu”：-country-eu

使用 -country-eu 发送的请求将使用来自以下一个国家/地区的 IP，这些国家/地区自动包含在 “eu” 中：

AL, AZ, KG, BA, UZ, BI, XK, SM, DE, AT, CH, UK, GB, IE, IM, FR, ES, NL, IT, PT, BE, AD, MT, MC, MA, LU, TN, DZ, GI, LI, SE, DK, FI, NO, AX, IS, GG, JE, EU, GL, VA, FX, FO

要定位到特定城市，您需要使用共享（按 IP 付费）或专用代理网络。

在配置代理区域时，选择首选国家/地区后，您可以添加一个城市，以进一步指定您的地理定位。

点击“添加城市” 后，您将看到所选国家/地区的可用定位城市。要查看特定地理位置的可用 IP 数量。

配置完成后，就可以使用以下语法从所选城市发送请求了

curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-<country>-city-<city>: <zone_password>

选择两个字的城市时，它将被写成一个词。

例如，要定位到布宜诺斯艾利斯，请求语法将是：

-country-ar-city-buenosaires

要查看更多地理定位示例，请访问我们的代理集成示例页面。
https://brightdata.com/cp/zones/proxy_examples

可以通过在代理用户名中添加会话标志来实现：

brd.superproxy.io:33335 br-customer-<customer_id>-zone-<zone_name>-session-rand39484

在线程启动时生成随机数，并在要更改为线程连接分配的代理对等节点时进行更改。

会话 ID 可以是任何随机字符串/计数器：具有相同会话字符串的请求将使用相同的代理对等节点（尽可能长）；具有不同会话字符串的请求将分配给不同的代理对等节点。
要强制更改 IP，只需修改会话 ID 即可。
如果分配的代理对等节点（出口节点 IP）不可用，超级代理将在第一次请求时返回错误信息 “502 - 没有可用的对等节点”，然后在第二次请求时，即使不更改会话 ID，超级代理也会分配一个新的对等节点。
会话 IP 最长可在 1 分钟的空闲时间内保持不变。一分钟后，如果没有请求，IP 就会被释放回池中。
要延长会话/IP 的持续时间，可每隔 30 秒发送一个微小的保活请求，以防止会话空闲超过一分钟。
该请求可以是任何小请求，如 /favicon.ico，甚至是返回 404 的请求（只要网络服务器不会因为该请求而断开套接字）。
如果您有多个客户端，并希望忽略客户端的源 IP（它与您的会话 ID 一起用于创建会话），那么您需要使用全局会话，然后在会话中添加 glob_ 作为前缀：

brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484

完整请求示例：

brd-customer-CXXXXX-zone-ZONE_X-session-glob_rand39484

在线程启动时生成随机数，并在要更改为线程连接分配的代理对等节点时进行更改。

使用 Bright Data 的住宅代理网络时，您可能需要使用分配给您所在区域的特定 IP。

发送测试请求，并添加 “-verbose” 或 “-v” 选项（这将打开详细日志记录）

curl "https://lumtest.com/myip.json" --verbose --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

找到 x-brd-ip 响应标头并复制其值
在请求中的区域名称后添加 -ip- 标志，并使用上一步中复制的散列 IP 值
发送测试请求，然后查看响应

curl "https://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>

我们建议使用 https://lumtest.com/myip.json 作为目标域进行测试，并审查您的 IP 凭据。

将 ASN 参数添加到地理位置定位下的区域配置中，即可启用此功能。

保存配置后，可将 ASN 标志添加到区域的凭据中，并在使用住宅代理时进行整合。

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"

注意：ASN 编号的值可在此处找到: https://bgp.potaroo.net/cidr/autnums.html

可以以 gIP 的形式选择专用住宅 IP。可通过在区域配置页面下选择“专用” IP 类型和选择 gip 数量来分配这些 IP。此外，还需要针对特定域名。

保存配置后，选择“显示已分配的专用住宅 IP” 将提供代表组 IP 的哈希值列表。

这些值可用于定位特定的 gip。例如：

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"

在中国境外时

定位到中国住宅 IP 对等节点就足够了：

curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"

在中国境内时除了定位到中国住宅 IP 对等节点外，还需要定位到我们的中国超级代理。

使用 API 命令时，代理 DNS 服务器是 servercountry-cn.brd.superproxy.io

curl --proxy servercountry-cn.brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"

使用 Proxy Manager 时：
- 点击端口，选择相关端口设置
- 选择“目标定位”并将中国设为定位国家
- 选择 IP 控制：将超级代理服务器位置设置为“中国”。

您可以选择使用以下列表中的特定运营商：

a1, aircel, airtel, att, celcom, chinamobile, claro, comcast, cox, digi, 
dt, docomo, dtac, etisalat, idea, kyivstar, meo, megafon, mtn, mtnza, mts,
optus, orange, qwest, reliance_jio, robi, sprint, telefonica, telstra, 
tmobile, tigo, tim, verizon, vimpelcom, vodacomza, vodafone, vivo, zain,
vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, 
cellc, ooredoo, drei, umobile, cableone, proximus,tele2, mobitel, o2, 
bouygues, free, sfr, digicel

例如

住宅代理——可以。 SERP API 是针对 SERP 的理想产品，因为它具有主动解锁、自动选择最佳代理、自定义标头、指纹识别、获取验证码等功能，可保证成功率（成功才需付费）。

数据中心和 ISP 代理——不行。当尝试通过上述任一代理网络专门定位到 Google 时，您的请求将被拒绝，您将在响应标头中收到以下错误信息：

HTTP/1.1 403 搜索 engine host is not allowed
X-Luminati-Error: Forbidden: This target URL isn't supported on proxy networks, use the SERP API product for targeting this URL. You may contact your account manager or open a support ticket for assistance

通过住宅网络或移动网络定位搜索引擎时，请求不会通过住宅或移动对等节点发送，而是直接通过我们的超级代理发送。这样做的原因是为了支持住宅网络和移动网络与浏览器的集成，因为浏览器可能需要从目标网站加载搜索引擎资源端点。

如果您使用住宅网络或移动网络定位搜索引擎域，请求将直接通过超级代理，以下响应标头将作为指示：

x-luminati-ip: superproxy bypass

住宅产品常见问题解答

对于单步抓取：

对于多步抓取（playwright/puppeteer/selenium）：