想使用 OxyLabs 的数据中心代理?那就不能错过这篇文章。它是最全面的 OxyLabs 数据中心代理用户指南。
快速入门
在我们开始之前,请确保您已从销售代表、专用客户经理或支持团队处收到用户名、密码和链接到您 IP 列表的所有 URL。
有两种方法可以访问 IP 列表。您可以通过浏览器直接访问 IP 列表,打开您收到的 URL(例如: https://proxy.oxylabs.io/all
).然后会要求您输入登录凭证(HTTP Basic Auth)。
或者,您也可以通过对收到的 URL 发出 GET 请求(例如 https://proxy.oxylabs.io/all
).不要忘记更换 用户名
和 密码
使用代理用户凭据。
卷曲 -u "用户名:密码" https://proxy.oxylabs.io/all
要使用代理进行请求,你需要从获取的列表中选择一个 IP 地址,并在请求参数中指定它。下面是一个 cURL 示例。您还可以找到更多其他语言的代码示例 这里 或 我们的 GitHub.
卷曲 -x 1.2.3.4:60000 -U "用户名:密码" http://ip.oxylabs.io
如果有任何本文档未涉及的问题,请联系您的专职客户经理或我们的支持人员,电话号码是 [email protected].
代理列表
基础
您的专用账户经理或我们的支持人员会向您提供代理列表的 URL,该 URL 应如下所示:
https://proxy.oxylabs.io/key/a27c5343ce4c4637a85a9297ddf1cace
只需在浏览器(或任何其他首选软件)中打开此 URL 即可。然后会要求您输入登录凭证(HTTP Basic Auth):
完成此操作后,代理列表将以纯文本形式显示。
如果您有多个列表,并希望获得分配给您账户的所有 IP,可以使用此 URL:
https://proxy.oxylabs.io/all
还可以包括 显示国家
或 显示城市
来获取 IP 及其对应位置。
RESTful
显示所有可用的代理列表
通过该端点,您可以检索属于您用户的代理列表:
GET https://api.oxylabs.io/v1/proxies/lists
curl -U username:password "https://api.oxylabs.io/v1/proxies/lists"
输出示例
[ { "uuid":"123e4567-e89b-12d3-a456-426655440000", "key":"12345678", "updated_timestamp":"2016-09-28T13:03:50+0300", "ips_count":2000, "href":"http://api.oxylabs.io/v1/proxies/lists/123e4567-e89b-12d3-a456-426655440000" } ]
检索特定代理列表
通过该端点,您可以检索特定的代理列表:
GET https://api.oxylabs.io/v1/proxies/lists/{uuid}
请求参数:
参数 | 说明 |
---|---|
uuid |
要检索的代理列表的 uuid |
curl -u username:password "https://api.oxylabs.io/v1/proxies/lists/{uuid}"
输出示例
[ { "ip":"127.0.0.1", 端口"60000", "country":"美国" }, { "IP":"127.0.0.2", "端口":"60000", "country":"GB } ]
提出要求
默认情况下,Oxylabs 代理服务器和 Proxy Rotator 使用基本的 HTTP 验证 需要您提供用户名和密码。您可以通过以下方式联系您的专用账户经理或我们的支持团队获取您的证书 [email protected].
我们还支持基于白名单 IP 地址的身份验证。请参见 白名单 IP.
根据您的身份验证方法,您可能需要更改代理端口:
目的
港口 | 使用方法 |
---|---|
60000 |
当使用登录凭证(用户名和密码)时,需要与代理一起使用。该端口用于代理 代理旋转器 在使用登录凭证和白名单 IP 时也是如此。 |
65432 |
通过白名单 IP 进行授权时,需要使用代理服务器 |
如果您想通过用户/通行证验证方法使用数据中心代理:
curl -x 1.2.3.4:60000 -U user1:pass1 http://ip.oxylabs.io
如果要通过白名单 IP 验证方法使用数据中心代理:
curl -x 1.2.3.4:65432 http://ip.oxylabs.io
白名单 IP
仪表板
我们还支持基于 IP 地址的验证。如果您直接使用代理服务器(不使用代理服务器 代理旋转器),你可以自己将 IP 列入白名单。只需登录 https://stats.oxylabs.io 并在底部侧边栏看到一个名为 "添加白名单 "的部分。点击链接后,您将进入自我白名单页面,如下所示:
在这里,您可以管理白名单 IP,并使用这些 IP 访问代理服务器。您可以将单个 IP 和最多 24 个子网列入白名单。如果您想将更大的子网列入白名单,请通过以下方式联系您的专用账户经理或支持团队 [email protected].
如果使用代理 代理旋转器 或 SOCKS 代理服务器您不能自行将 IP 地址列入白名单。相反,您必须向我们提供您希望用于连接代理服务器的 IP 地址列表。我们将把它们列入白名单(添加到防火墙例外规则中)。这样,您就可以在没有登录凭证的情况下访问代理服务器了。
请注意,如果您使用白名单 IP 访问代理,则需要使用端口 65432
.代理 代理旋转器端口保持 60000
.
RESTful
您也可以直接向我们的端点发送查询,将 IP 列入白名单。请注意,确认白名单 IP 列表的任何更改都需要 5 分钟的冷却时间。
获取白名单 IP 列表
GET https://api.oxylabs.io/v1/whitelisted_ips
回应 | 说明 |
---|---|
200 |
成功。响应体包含所有当前列入白名单的 IP 及其 ID。 |
curl -U username:password "https://api.oxylabs.io/v1/whitelisted_ips"
输出示例
{ "数据":[ { "id":9765, "address":"127.0.0.1" }, { "id":9766, "address":"127.0.0.2" } ] }
添加白名单 IP
邮寄 https://api.oxylabs.io/v1/whitelisted_ips
回应 | 说明 |
---|---|
201 |
成功。IP 地址已添加到列表中。响应体包含新添加的 地址 和 本我 . |
422 |
错误。请求正文包含无效 IP 地址。响应体包含错误信息。 |
curl -X POST -u username:password "https://api.oxylabs.io/v1/whitelisted_ips" --header "Content-Type: application/json" --data '{"address":"127.0.0.1"}'
{ "错误":{ "message":"This is not a valid IP address."、 "code":422 } }
输出示例
{ "id":9767, "address":"127.0.0.1" }
删除白名单 IP
DELETE https://api.oxylabs.io/v1/whitelisted_ips/{id}
参数 | 说明 |
---|---|
本我 |
"(《世界人权宣言》) 本我 您要删除的 IP 地址(可从 GET 白名单 IP 端点获取) |
回应 | 说明 |
---|---|
204 |
成功。IP 地址已从列表中删除。响应体为空。 |
403 |
错误。请求包含无效的 本我 .响应体包含错误信息 "拒绝访问"。 |
curl -X DELETE -u username:password "https://api.oxylabs.io/v1/whitelisted_ips/{id}"
保存变化(5 分钟冷却时间)
邮寄 https://api.oxylabs.io/v1/whitelisted_ips/upload_to_servers
回应 | 说明 |
---|---|
202 |
成功。已确认对白名单 IP 列表的更改。响应正文为空。 |
429 |
错误。更改尚未确认,端点处于 5 分钟冷却状态。响应体包含错误信息 "您已超过端点的速率限制。请稍后再试"。 |
curl -X POST -u username:password "https://api.oxylabs.io/v1/whitelisted_ips/upload_to_servers"
数据中心代理 API
替换子网 IP
POST https://api.oxylabs.io/v1/proxy-list/rest/proxy-lists/{PROXY_LIST_UUID}/by-uuid/network-modification-requests/replace
要想在使用代理管理 API 时替换现有代理列表中特定子网的 IP,您需要向上述端点发出 POST 请求,并说明您要替换的特定子网。为使其正常工作,您必须插入一个可从 API 查询到的代理列表 UUID(如所述 这里).
回应 | 说明 |
---|---|
本我 |
启动更换程序 ID |
地位 |
状态描述已启动的替换程序的状态 |
信息 |
启动的流程类型 |
创建时间 |
启动进程的时间戳 |
link_too_list_plain |
纯文本代理列表链接 |
link_too_list_json |
指向 JSON 格式代理列表的链接 |
curl -X POST -H "Content-Type: application/json" -d '{"subnets":["x.x.x.0/24", "y.y.y.0/24"]}' https://api.oxylabs.io/v1/proxy-list/rest/proxy-lists/{PROXY_LIST_UUID}/by-uuid/subnet-replacement-requests -u user:pass
输出示例
{ "id":"1", "状态":"处理中"、 "消息":无、 "类型":"替换"、 "创建时间": "2021-01-01T00:00:00+00:00":"2021-01-01T00:00:00+00:00", "link_to_list_plain":"https://proxy.oxylabs.io/key/4f34fe5862603138c1bc5ce28b181aef", "link_too_list_json":"https://api.oxylabs.io/v1/proxies/lists/8f11274c-a900-11eb-b910-901b0ec4424b" }
检查更换状态
获取 https://api.oxylabs.io/v1/proxy-list/rest/subnet-replacement-requests/{initiated_replacement_process_id}
要确认子网替换成功,必须向上述端点发出 GET 请求,同时插入 启动更换程序 ID 从之前启动的替换程序中删除。
回应 | 说明 |
---|---|
本我 |
启动更换程序 ID |
地位 |
状态描述已启动的替换程序的状态 |
信息 |
启动的流程类型 |
创建时间 |
启动进程的时间戳 |
link_too_list_plain |
纯文本代理列表链接 |
link_too_list_json |
指向 JSON 格式代理列表的链接 |
curl -u user:pass https://api.oxylabs.io/v1/proxy-list/rest/subnet-replacement-requests/{INITIATED_REPLACEMENT_PROCESS_ID}"
输出示例
{ "created_at":"2021-01-01T00:00:00+00:00", "id":"1", "link_too_list_json":"https://api.oxylabs.io/v1/proxies/lists/8f11274c-a900-11eb-b910-901b0ec4424b", "link_too_list_plain":"https://proxy.oxylabs.io/key/4f34fe5862603138c1bc5ce28b181aef", "消息":无、 "状态":"已完成"、 "类型":"替换" }
列出被替换和新的 IP
GET https://api.oxylabs.io/v1/proxy-list/rest/network-modification-requests/{INITIATED_REPLACEMENT_PROCESS_ID}/ips
当替换请求处理完毕后,可通过向上述端点发出 GET 请求,同时从之前启动的替换进程中插入已启动的替换进程 ID,来查找已删除的 IP。
初始请求将只显示 100 个被替换的 IP,分页元数据将出现在响应中。要获取剩余的被替换 IP 列表,必须使用分页。如需分页,请格式化以下端点:
GET https://api.oxylabs.io/v1/proxy-list/rest/network-modification-requests/{INITIATED_REPLACEMENT_PROCESS_ID}/ips?fields=metadata.total&after={metadata_after}
回应 | 说明 |
---|---|
项目 |
包含被替换 IP ID、IP 地址和子网地址的列表 |
本我 |
替换过程中的代理 ID |
ip |
代理 IP 地址 |
子网 |
分配 IP 的子网 |
类型 |
冗员 - 已更换的 IP、 新 - 已分配的新 IP,而不是 冗员 一种 |
元数据 |
光标分页数据显示从被替换 IP 列表数据中的哪个 IP 地址获取的界限 |
curl -u user:pass "https://api.oxylabs.io/v1/proxy-list/rest/network-modification-requests/{INITIATED_REPLACEMENT_PROCESS_ID}/ips"
输出示例
{ "项目":[ { "id":"1", "ip":"127.1.0.1", "子网":"127.1.0.0/24", "类型": "冗余":冗余 }, { "id":"2", "IP":"127.1.1.2", "子网":"127.1.1.0/24", "类型":"新" } ], "元数据":{ "后":"'100'", "之前":"'无'"、 "总数": 100 } }
代理旋转器 - 可选
该服务为可选服务,不包含在订购中。我们为您提供的不是连接到单个 IP 的端点,而是连接到您指定的代理列表的端点。每次请求,端点都会获取一个不同的 IP。要了解如何将端点用作代理,请参阅右侧示例。
备注:代理旋转器只能与端口 60000
.
curl --proxy vm.oxylabs.io:60000 http://ip.oxylabs.io
使用代理旋转器进行会话控制
使用代理旋转器可以保持相同的 IP 地址。首先,你需要知道 Proxy Rotator 有多少个代理。然后只需添加 --proxy-header "代理服务器:sXXX"
标头,其中 sXXX
是代理的编号,例如 s5
或 s2541
.
user1@machine:~$ curl -x vm.oxylabs.io:60000 -U user:pass http://ip.oxylabs.io --proxy-header "Proxy-Server: s10" 1.2.30.40 user1@machine:~$ curl -x vm.oxylabs.io:60000 -U user:pass http://ip.oxylabs.io --proxy-header "Proxy-Server: s10" 1.2.30.40 user1@machine:~$ curl -x vm.oxylabs.io:60000 -U user:pass http://ip.oxylabs.io --proxy-header "Proxy-Server: s10" 1.2.30.40
响应代码
回应 | 错误信息 | 说明 |
---|---|---|
407 |
需要代理验证 | 您正通过 60000 端口访问代理,但您未提供授权标头,或者您的凭据不正确。 |
504 |
网关超时 | 代理服务器超时。等待目标服务器的响应。通常约 60 秒。 |
503 |
服务不可用 | 连接目标服务器失败。DNS 无法解析目标服务器地址。 |
401 |
未经授权 | 证书不正确。 |
404 |
未找到 | 找不到指定的资源。 |
500 |
内部服务器错误 | 我们的服务器出了问题。稍后再试。 |
这些是使用我们的数据中心代理时最常见的响应代码。如果您收到任何其他响应代码,请联系您的专用账户经理了解更多信息。
第三方集成
Oxylabs 代理管理器
Oxylabs 代理管理器 是 Chrome 浏览器的代理管理扩展。它不仅是免费的,而且可以与您选择的任何代理提供商配合使用。启用代理无需通过设置和菜单选项。从 Chrome 网上商城下载该扩展 这里
- 单击扩展图标打开应用程序
- 如果您还没有添加任何代理,您会看到 添加新代理 按钮。点击后继续。
- 添加代理配置文件。在 输入名称.输入您从我们这里购买的代理作为 代理服务器 IP 和
60000
作为 港口 如果使用的是用户名:密码身份验证方法,以及65432
如果您使用的是白名单 IP。
填写您的 用户名 和 密码.最后,点击 保存更改.如果您已将自己的 IP 列为白名单,则根本不需要执行此步骤。
- 打开扩展,点击 连接.就这样,您就可以使用数据中心代理了。
SwitchyOmega
SwitchyOmega 是一款功能强大、性能可靠的代理管理器,可与多种流行浏览器配合使用。根据我们的经验,它是最好的代理插件之一。我们强烈推荐您使用 SwitchyOmega 代理。为此,您需要获取该插件。对于 Chrome 浏览器,请单击 这里点击 这里.安装完成后,您应该
- 打开 Switchy Omega 选项。
- 点击 新资料...
- 为新配置文件命名,选择 代理简介 类型,然后点击 创建
- 改变 规程 至 超文本传输协定.根据 服务器 输入您从我们这里购买的代理之一。在 港口 增加
60000
如果使用的是用户名:密码身份验证方法,以及65432
如果您使用的是白名单 IP。
- 接下来,点击右侧的锁定按钮。填写您的 用户名 和 密码.点击 保存更改.
如果您已将自己的 IP 列为白名单,则根本不需要执行此步骤。
- 点击 应用更改
- 最后一步,点击 SwitchyOmega 图标,选择新配置的代理。现在就可以开始了!
FoxyProxy
FoxyProxy 是一款简单的代理管理器,可与许多常用浏览器配合使用。首先,您需要获取 FoxyProxy。对于 Chrome 浏览器,请单击 这里点击 这里.安装完成后,您应该
- 打开 FoxyProxy 选项。
- 点击 添加.
- 在 IP 地址、DNS 名称、服务器名称 字段输入其中一个代理。
- 在 港口 字段输入端口。如果使用用户/通行证身份验证,端口为
60000
.如果您的 IP 已列入白名单,则端口为65432
. - 在 用户名(可选) 字段中输入您的用户名。如果您已将自己的 IP 列为白名单,请将该字段留空,因为插件会通过它进行授权,并忽略您在该字段中写入的所有内容。
- 在 密码(可选) 字段中输入您的密码。如果您已将自己的 IP 列入白名单,并希望通过它进行授权,请将此字段留空。
- 填写完所有字段后,按 节省.
- 为了让所有请求都能通过此设置运行,您必须按下 FoxyProxy 插件图标 (1),然后点击 使用代理 对所有 URL 使用代理(忽略模式) (2).
(1)
(2)
- 就这样,你完成了!
Proxifier
要在 Proxfier 中使用数据中心代理,只需按照以下步骤操作即可:
- 打开 Proxifier 应用程序。
- 添加代理。点击 代理 (1).点击 添加(2).
- 在以下窗口中输入所需信息。 IP 地址(1), 端口(2) 其中的用户名/密码验证是
60000
以及用于白名单 IP 验证的65432
选择 HTTPS(3) 协议。在验证框中单击 启用(4) 并输入所提供的 用户名(5) 和 密码(6).
不要忘记添加 顾客
在用户名开头。如果您已将设备列入白名单,请不要点击 启用,您的身份验证无需用户名/密码。如果您愿意,可以启用 显示为网络浏览器 选项。点击 好的.
- 您将被要求 您是否希望 Proxifier 默认使用该代理??这意味着您的所有浏览器都将使用此设置。您可以自行决定是否要这样做。如果选择 是即可完成设置。如果只想在特定浏览器上使用代理,请按照以下步骤操作。
- 点击 规则(1) 然后点击 添加...(2).
- 点击 +(1) 按钮添加要使用代理设置的应用程序。选择要使用代理设置的浏览器并点击。最后,您必须更改 行动(2).单击它并选择您创建的代理。
- 就是这样。现在,您的所有请求(使用浏览器时)都将通过代理进行。
参考资料
https://docs.oxylabs.io/dc/index.html
免责声明:这部分内容主要来自商家。如果商家不希望在我的网站上显示,请 联系我们 删除您的内容。
最后更新于 5 月 16, 2022