mcpField
O
oxylabs-proxies

oxylabs-proxies

github.com/oxylabs云与 DevOps87780 次安装2 周前更新
代码仓库

关于 oxylabs-proxies

oxylabs-proxies 是用于配置和使用 Oxylabs 代理的技能，面向需要代理连接、地理定位或 IP 会话控制的用户。内容涵盖多类代理的端点、认证方式和常见参数。

主要功能

  1. 01住宅、移动、数据中心及 ISP 代理配置
  2. 02按国家、城市和邮编定位
  3. 03通过会话参数保持或绑定 IP
  4. 04使用端口选择轮换或静态 IP

适用场景

  1. 01为请求选择合适的代理类型
  2. 02将住宅代理定位到指定国家或城市
  3. 03在多次请求间复用同一 IP

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/oxylabs/agent-skills --skill oxylabs-proxies

安装后在 Claude Code 中输入/oxylabs-proxies确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

dedicated-datacenter.md
dedicated-isp.md
examples.md
proxy-types.md

详细介绍

Oxylabs 代理

代理类型概览

类型主机端口最适用场景
住宅代理pr.oxylabs.io7777高匿名性、地理定位
移动代理pr.oxylabs.io7777移动专属内容、最高信任度
数据中心代理（共享）dc.oxylabs.io8000 轮换 / 8001+ 指定/静态高速、大流量
ISP 代理（共享）isp.oxylabs.io8000 轮换 / 8001+ 指定/静态兼顾速度与匿名性
专用数据中心代理ddc.oxylabs.io8000 轮换 / 8001+ 指定/静态自有 IP、基于端口访问
专用 ISP 代理disp.oxylabs.io8000 轮换 / 8001+ 指定/静态自有 ISP IP、锁定 ASN

住宅代理/移动代理使用 pr.oxylabs.io:7777，并通过用户名参数设置会话。数据中心/ISP 代理以及专用自助服务产品使用代理列表端口：指定/静态 IP 从 8001 开始，自动轮换使用 8000。

环境变量

请使用对应代理产品系列的凭据：

产品系列变量用户名前缀
住宅代理、移动代理OXY_RES_USERNAME、OXY_RES_PASSWORDcustomer-
数据中心代理、ISP 代理、专用数据中心代理、专用 ISP 代理OXY_DC_USERNAME、OXY_DC_PASSWORD自助服务/共享产品使用 user-

身份验证格式

customer-USERNAME:PASSWORD    # Residential, Mobile
user-USERNAME:PASSWORD          # Shared Datacenter, Shared ISP

专用代理身份验证（自助服务与企业版）详见 dedicated-datacenter.md 和 dedicated-isp.md。

住宅代理/移动代理（OXY_RES_USERNAME、OXY_RES_PASSWORD）和数据中心/ISP 代理（OXY_DC_USERNAME、OXY_DC_PASSWORD）请使用不同的凭据。

带参数时：

customer-USERNAME-cc-US-city-new_york-sessid-abc123:PASSWORD

快速开始

住宅代理/移动代理：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME:$OXY_RES_PASSWORD" \
  "https://ip.oxylabs.io/location"

数据中心代理：

curl -x "dc.oxylabs.io:8000" \
  -U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
  "https://ip.oxylabs.io/location"

ISP 代理：

curl -x "isp.oxylabs.io:8001" \
  -U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
  "https://ip.oxylabs.io/location"

对于数据中心代理、ISP 代理、专用数据中心代理和专用 ISP 代理，请使用控制面板代理列表中的端口：指定/静态 IP 从 8001 开始；列表中的第一个 IP 使用 8001。只有在任务需要自动轮换时，才切换到端口 8000。

地理定位参数

对于住宅代理/移动代理，请在用户名后追加参数，参数之间用连字符分隔（另有说明的除外）：

参数格式示例
ccISO 3166-1 alpha-2-cc-US、-cc-DE、-cc-GB
city英文，空格用下划线代替-city-new_york、-city-los_angeles
st美国州名，使用 us_ 前缀-st-us_california、-st-us_texas
postalcode5 位美国邮政编码，需与 cc-US 搭配-cc-US-postalcode-90210
ASN住宅代理/移动代理运营商 ASN-ASN-21928
X-Oxylabs-Geolocation代理标头 lat:lon;radius_miles49.9235:-97.0811;10

邮政编码定位仅适用于美国。坐标半径不得小于 10 英里。如果同时使用国家和 ASN 参数，则以国家参数为准。

地理定位示例：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-cc-US-city-new_york:$OXY_RES_PASSWORD" \
  "https://ip.oxylabs.io/location"

共享数据中心/ISP 代理按国家轮换时，请使用 -country-US，并通过轮换端口搭配 user- 凭据。

会话控制

参数说明备注
sessid在多个请求间保持同一 IP标准会话为 10 分钟，或在最长 60 秒无活动后结束
sessid_oneip将会话绑定到一个确切的出口节点如果该 IP 不可用，则返回 502
sesstime配合 sessid 或 sessid_oneip 设置会话时长（分钟）住宅回连支持最长 1440 分钟；某些接入模式的上限较低

粘性会话示例：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-cc-US-sessid-mysession123:$OXY_RES_PASSWORD" \
  "https://example.com"

定时会话（5 分钟）：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-sessid-abc123-sesstime-5:$OXY_RES_PASSWORD" \
  "https://example.com"

选择合适的代理类型

需求推荐类型
最高匿名性住宅代理
移动应用内容移动代理
速度与流量数据中心代理
兼顾速度与匿名性ISP 代理
自有专用 IP专用数据中心代理或专用 ISP 代理
地理限制内容使用 cc/city/postalcode 的住宅代理/移动代理，或在适用时使用按国家定位或指定端口的 DC/ISP 代理

默认行为

  • 不带参数：每个请求使用随机 IP
  • Residential 和 Mobile 共用同一端点，但使用不同的 IP 池
  • 会话会自动过期并获取新 IP

更多资源

评论

支持 Markdown