隧道代理接入手册

通过固定网关连接爬虫混合池或纯住宅池。默认全球随机,可按流量或并发线程使用,并在纯住宅池中配置 SESSION。

代理池混合池 / 纯住宅池 地区默认全球随机 认证账密 / 套餐白名单 协议HTTP(S) / SOCKS5
打开提取代理 查看套餐
01
MINIMUM REQUEST

最小可运行请求

示例已固定使用 proxy.123proxy.cn:36923。只需替换代理用户名和密码;出口 IP 由所选代理池自动分配。

curl --fail-with-body --silent --show-error \
  --proxy "http://proxy.123proxy.cn:36923" \
  --proxy-user "YOUR_PROXY_USER:YOUR_PROXY_PASSWORD" \
  --connect-timeout 15 \
  --max-time 30 \
  "https://api.ipify.org?format=json"
无需维护本地代理池

程序连接固定网关即可。代理健康检查、出口选择和轮转由 123Proxy 网络完成。

02
PROXY POOLS

先选择代理池

纯住宅池住宅身份
100% 住宅 IP

只包含住宅出口,适合需要住宅网络属性或多步骤会话的任务。

  • 支持按请求轮转
  • 账密认证支持 SESSION
  • 通常比混合池稍慢
03
CAPACITY MODEL

流量与并发线程

计费方式限制维度适合任务
按流量累计传输 GB流量可预测、短期或弹性任务
按并发线程同时在途请求数持续运行的代码 worker,套餐内不限流量
浏览器会快速消耗并发

一个页面会同时加载 HTML、图片、CSS、JavaScript、字体和接口请求,通常可能占用 10-20 个并发线程。浏览器自动化应按真实页面测量。

04
ROUTING

地区在提取代理时选择

隧道代理默认从全球代理池随机选择出口。它不提供国家级任意定位,只支持以下粗粒度地区预设。

全球随机默认 欧美EU + US 北美North America 欧洲Europe 亚洲Asia 美国United States 日韩Japan / Korea
需要指定国家时

请选择隧道住宅代理。它支持在提取时指定国家或地区,并将国家码编码到认证用户名末尾。

05
AUTHENTICATION

账密与套餐 IP 白名单

账密认证

选择一个代理用户。程序发送代理用户名和密码,适合开发机、动态服务器和多 worker。

HOST:PORT:USER:PASSWORD
套餐 IP 白名单

每行填写一个采集服务器公网 IPv4,保存到当前套餐。程序只需使用 HOST:PORT。

HOST:PORT

白名单以套餐为作用域,不是独立账户页面;纯住宅池的 SESSION 只支持账密认证,白名单模式不支持 SESSION。

06
STICKY ROUTING

纯住宅池的 SESSION

纯住宅池默认可按请求轮转。需要分页、短流程或多步骤请求尽量保持同一住宅出口时,在账密认证用户名中加入 SESSION。

认证用户名结构 proxy-user-sess_a8F3kP9xQ2mL_15
proxy-user代理用户 -sess_SESSION 标识 a8F3kP9xQ2mL12 位 ID 15保持分钟数
SESSION ID

必须是 12 位英文字母或数字。复用相同 ID 才会命中同一粘性路由。

保持时长

支持 1-120 分钟。到期或出口不可用时会重新分配。

改变出口

使用新的 SESSION ID,或者回到每次请求轮转模式。

07
OUTPUT FORMAT

代理输出格式

选择与你的采集工具一致的格式。控制台 API 链接使用 txt_type 决定文本输出顺序。

txt_type=1HOST:PORT:USER:PASSWORD
txt_type=2HOST:PORT@USER:PASSWORD
txt_type=3USER:PASSWORD:HOST:PORT
txt_type=4USER:PASSWORD@HOST:PORT
优先从控制台生成

提取链接包含套餐标识和路由参数。不要将完整链接或代理密码提交到公开代码仓库。

08
PRODUCTION

生产使用建议

按目标站点限制并发套餐并发不是单站点应承受的请求频率。
设置连接与读取超时区分连接代理失败和目标响应过慢。
记录请求结果至少记录状态码、耗时、重试和 SESSION。
验证有效数据不要只用 HTTP 200 判断页面或对象有效。
保护代理凭证使用环境变量或密钥管理服务,避免日志泄露。
09
TROUBLESHOOTING

常见问题

为什么纯住宅池没有保持同一出口?

确认使用账密认证、SESSION ID 为 12 位字母或数字、分钟数在 1-120 之间,并且连续请求使用完全相同的认证用户名。

为什么选择地区后仍出现其他国家?

隧道代理只提供粗粒度地区,不是国家精确定位。需要指定国家时使用隧道住宅代理,并预留路由配置同步时间。

并发线程套餐是否限制传输流量?

不按累计 GB 计费,但限制同时在途请求数。目标响应、连接复用和浏览器子资源都会影响实际并发占用。

HOSTNAME 和 IP 接入怎么选?

优先使用 HOSTNAME,便于网关维护和故障切换。只有运行环境存在 DNS 限制或控制台明确建议时再使用固定 IP。