数据中心代理常见问题解答

我们在数据中心代理网络中提供四种类型的 IP：

共享（按使用量付费）
共享（按 IP 付费）
专用

共享 IP 由多个用户共享。我们在互联网服务提供商（ISP）代理网络中的共享 IP 有 2 个等级：

您只需按使用量付费。

将您连接到由 4 万个 IP 组成的资源池，该资源池由来自各个可用国家/地区固定分配的 IP 范围组成。这些 IP 可以根据需要在 4 万个资源池中持续轮换（特定国家/地区可以在 chrome、代理管理器或 API 中选择）

功能

地理位置定位 - 使用“共享” IP（按使用量付费），您可以在发送请求时使用 -country 标志来控制您的地理位置定位。针对美国的定位请求，简单示例如下所示
示例
```
curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password> "http://lumtest.com/myip.json"
```

访问我们的代理集成示例页面了解有关定位不同国家/地区定位选项的更多信息

我们在 ISP 代理网络中提供三种类型的 IP：

共享（按使用量付费）
共享（按 IP 付费）
专用

共享 IP 由多个用户共享。我们在互联网服务提供商（ISP）代理网络中的共享 IP 有 2 个等级：

您只需按使用量付费。

将您连接到由 1 万个 IP 组成的资源池，该资源池由来自各个可用国家/地区固定分配的 IP 范围组成。这些 IP 可以根据需要在 1 万个资源池中持续轮换（特定国家/地区可以在 chrome、代理管理器或 API 中选择）

功能

地理位置定位 - 使用“共享” IP（按使用量付费），您可以在发送请求时使用 -country 标志来控制您的地理位置定位。针对美国的定位请求，简单示例如下所示
示例
```
curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password> "http://lumtest.com/myip.json"
```

访问我们的代理集成示例页面了解有关定位不同国家/地区定位选项的更多信息

发送请求时，在请求中您所在区域的名称后添加 -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>

要定位特定城市，您需要使用共享（按 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>

选择包含两个单词的城市名称时，将合并写成一个单词。

例如，当以布宜诺斯艾利斯（Buenos Aires）为定位时，请求的语法将是：

-country ar-city-buenosaires

要查看更多地理定位示例，您可能需要查看我们的代理集成示例页面。

这可以通过在代理用户名中添加会话标志来完成：

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

在线程启动时生成随机数，如果要更改为线程连接分配的代理对等点（Proxy Peer），则对其进行更改。

会话 ID 可以是任何随机字符串/计数器：具有相同会话字符串的请求将使用相同的（尽可能长的）代理对等点；具有不同会话字符串的请求将被分配不同的代理对等点。
要强制更改 IP，只需修改会话 ID 即可
如果分配的代理对等点（退出节点 IP）不可用，则超级代理将在第一个请求中返回错误 “502 - 无对等点可用”，然后在第二个请求中，即使您没有更改会话 ID，超级代理也会分配一个新的对等点。
会话 IP 最多可保持 1 分钟的闲置时间。一分钟后，如果没有请求，IP 将释放回资源池。
要延长此会话/IP 的使用时间，请每 30 秒发送一个小的 keep-alive 请求，以防止该会话闲置一分钟以上。这个请求可以是任何小的请求，比如 /favicon.ico，甚至是返回 404 的请求（只要 Web 服务器不会因为这一请求而断开插座连接）。
如果您有多个客户端，并且想忽略您的客户端源 IP（与您的会话 ID 一起使用来创建会话），那么您想使用全局会话，然后添加 glob_ 作为会话前缀：

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

完整请求示例：

brd-customer-cxxxxx-zone-zone_x-session-glob_rand39484

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

默认情况下，所有区域都提供端口 80 和 443，支持 HTTP 和 HTTPS 协议。

在数据中心或互联网服务提供商（ISP）类型的代理区域中，默认情况下支持所有高于 1024 的端口。

在住宅或移动类型的代理区域中，默认情况下以下端口可用：8080、8443、5678、1962、2000、4443、4433、4430、44444 和 1969。

Bright Data 可以根据要求支持其他端口。每一项支持新端口的请求将遵循专门的额外合规流程，由 Bright Data 的合规团队执行。

激活前需要 Bright Data 合规性审查的端口示例：

端口	协议
8443	HTTP
8243	HTTPS

要请求向您的区域添加端口权限，请执行以下操作：

进入您区域的设置（默认情况下它将在“配置”选项卡上打开，如果没有，请点击）
向下滚动到“高级选项”，然后点击
启用“端口”
输入您想获得批准的端口号
填写表格，等待我们的合规团队与您联系并批准申请

使用 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 的哈希值列表。

这些值可用于定位特定的 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>"

使用代理管理器时：
- 只需点击端口即可选择相关的端口设置
- 选择定位并将中国设置为定位国家
- “选择 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

例如

住宅 Proxy - No, 但是， SERP API 是定位搜索引擎结果页面的理想产品，因为它通过主动解锁、自动选择最佳代理、自定义标题、指纹识别、解析验证码等功能保证成功率（仅按成功付费）。Targeting Google SERPs from the 住宅 network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.

**数据中心和 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. 您可以联系您的账户经理或开立支持工单以寻求帮助

您必须使用我们的中文超级代理：

使用代理管理器时：位于“端口设置” > “IP 控制”：将超级代理的位置设置为“中国”。
使用 API 命令时，使用 servercountry-cn.brd.superproxy.io

示例：

Shell
curl "https://target-chinese-网站.com" --proxy servercountry-cn.brd.superproxy.io:33335 --proxy-user brd-customer-<custormer_name>-zone-<zone_name>-country-cn:<zone_password>

HTTP 错误代码 502 表示“网关错误”。当您向 URL 发送请求，但该 URL 的服务器收到来自另一台服务器的无效响应且依赖该服务器来完成请求时，就会出现此错误。

可能原因

我们目前没有匹配您的区域配置的对等点，因为它们可能已经在其他客户端上使用，或者由于其他原因不可用。
由于没有活动，连接已超时。
主机（目标 URL）端已关闭连接

示例错误 502 响应

Request URL: SAMPLE_URL Request method: GET ***Status code: 502***  
Super proxy IP: IP  
Username: brd-customer-customer_id-zone-zone_name-country  
Password: zone_password  
Sent from: 127.0.0.1  
Response headers  
connection: keep-alive  
date: Tue, 14 Feb 2023 08:49:16 GMT  
keep-alive: timeout=5  
transfer-encoding: chunked  
x-lpm-port: 24000  
x-luminati-error: waiting for selector ".price-container" failed: timeout 90000ms exceeded  
***x-luminati-error-code: expect_element***  
x-request-id2: REQUEST_ID  
Request headers  
user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36(KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36  
host: SAMPLE_HOST  
accept-encoding: gzip, deflate  
Connection: keep-alive

HTTP 403 响应代码表示禁止您访问有效的网址。

服务器可以理解请求，但由于客户端的问题，无法完成请求。

可能原因

您的机器 IP 未列入白名单。要了解如何将 IP 列入白名单，请查阅以下文章。 https://docs.brightdata.com/cn/api-reference/proxy-manager/whitelist_ips
您尝试访问的域名被 Bright Data 屏蔽。
您的用例中未指定您尝试访问的域名。
验证码响应失败（与 Web 解锁器和 SERP API 相关）。
您尝试访问的域名已被您区域的目标主机设置禁止（请检查代理区域的访问参数）

示例错误 403 响应

< HTTP/1.1 403 response status was rejected  
< x-debug-req-id: SAMPLE_ID  
< X-Luminati-Error: response status was rejected: 403 Forbidden  
< X-Luminati-Error-Code: http_status  
< Date: Wed, 22 Feb 2023 11:11:23 GMT  
< Connection: keep-alive  
< Keep-Alive: timeout=5  
< Transfer-Encoding: chunked

403 X-luminati-error（禁止）表明您的目标域名是 Bright Data 不允许的域名

这个问题可以通过联系 Bright 数据合规团队获得批准来解决。当 Bright 数据合规团队审查您的用例并确认时，您将被告知访问权限已添加。为了更好地处理，建议将您的账户经理添加到工单中，并明确告知他您的要求

出现错误消息时：

您试图定位<host>，但被屏蔽了

如果出现这种情况，请联系 Bright 数据合规团队 (compliance@brightdata.com) 或通过工单系统联系

我们的合规团队将审查您获得特定域名访问权限的请求

数据中心代理常见问题解答

功能

功能

对于单步抓取：

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