mcpField
P
proxies

proxies

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

关于 proxies

proxies 是 Oxylabs 代理的配置指南，面向需要住宅、移动、数据中心、ISP 或专用代理的用户。它还说明连接协议、地理定位、认证和会话控制方式。

主要功能

  1. 01配置多种共享及专用代理
  2. 02支持 HTTP、HTTPS、SOCKS5 和 HTTP/3
  3. 03按国家、城市、州或邮编定位
  4. 04通过会话参数保持或绑定 IP
  5. 05按端口选择轮换或静态 IP

适用场景

  1. 01为请求类型选择代理及连接协议
  2. 02将代理流量定位到指定地区
  3. 03在请求间保持会话或使用固定 IP

安装

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

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

安装后在 Claude Code 中输入/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。

协议（住宅代理）

协议传输方式入口点适用场景
HTTPTCPpr.oxylabs.io:7777默认协议。常见库和第三方软件均支持
HTTPSTCPhttps://pr.oxylabs.io:7777与代理之间的连接完全加密
SOCKS5TCP 和 UDPsocks5h://pr.oxylabs.io:7777客户端需要 SOCKS5 时
HTTP/3(MASQUE) UDP (QUIC)masque.oxylabs.io:50000原生 HTTP/3、UDP、UDP 上的 DNS、WebRTC/SIP/游戏流量

如果任务只需要标准 HTTP 或 HTTPS（TCP）请求，请使用主端点 pr.oxylabs.io:7777。MASQUE 会增加 QUIC 连接建立开销，仅在需要 UDP 或原生 HTTP/3 传输时才值得使用。

通过 UDP 连接访问 Google 属于受限目标（适用于 MASQUE 和 SOCKS5 UDP）。

地理位置定位参数

对于住宅代理/移动代理，请在用户名后附加参数，并使用连字符分隔，除非另有说明：

参数格式示例
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 代理需要按国家/地区轮换时，请在轮换端口上使用 user- 凭据，并添加 -country-US。

会话控制

参数描述备注
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 的住宅代理/移动代理，或在合适时按国家/分配的端口选择数据中心代理/ISP 代理

默认行为

  • 不带参数：每个请求使用随机 IP
  • 住宅代理/移动代理共用同一端点，但使用不同的 IP 池
  • 会话会自动过期，并分配新的 IP

其他资源

评论

支持 Markdown