5 分钟完成第一个代理请求

从控制台生成一组代理接入信息,先用 cURL 验证,再复制到 Python、Scrapy 或其他采集程序。

抓取程序需要部署在海外网络环境

123Proxy 提供代理 IP 服务,不提供 VPN 或翻墙功能。开始前请准备可访问目标站点的海外服务器或计算环境。

01

选择代理产品和套餐

第一次测试可优先选择隧道代理或隧道住宅代理。需要先明确任务按流量、并发线程、端口还是固定 IP 计费。

比较全部标准套餐
02

在控制台生成代理

购买或领取测试套餐后,进入对应代理产品,点击“提取代理”,再按产品选择认证、协议、地区与轮转方式。

  1. 1
    选择可用套餐

    所有配置都会绑定当前套餐;白名单不是全账户共享。

  2. 2
    选择认证方式

    本地调试推荐账密认证;固定出口服务器可以使用套餐 IP 白名单。

  3. 3
    选择协议和路由

    根据程序选择 HTTP(S) 或 SOCKS5,再设置地区、SESSION 或端口轮转。

  4. 4
    生成并复制代理账密

    代码示例已写入对应产品的固定网关,只需复制代理用户名和密码,不要使用网站登录密码。

打开隧道代理提取
03

理解代理认证

代理认证凭证与 123Proxy 网站登录账号完全不同。账密认证由代理用户提供;IP 白名单则验证发起请求的服务器公网 IPv4。

认证方式适合场景程序配置
代理用户名 / 密码开发机、多 worker、动态服务器在代理 URL 或客户端认证参数中发送
套餐 IP 白名单公网 IP 固定的采集服务器程序只配置 HOST:PORT
产品边界

静态类代理不支持白名单;隧道代理的纯住宅 SESSION 只支持账密认证。具体选项以对应产品提取页为准。

04

先用 cURL 验证代理

代码已使用隧道代理固定网关 proxy.123proxy.cn:36923。只需将控制台生成的代理用户名和密码写入环境变量,成功后应返回代理出口 IP,而不是采集服务器自身 IP。

export PROXY_USER="YOUR_PROXY_USER"
export PROXY_PASS="YOUR_PROXY_PASSWORD"

curl --fail-with-body --silent --show-error \
  --proxy "http://proxy.123proxy.cn:36923" \
  --proxy-user "${PROXY_USER}:${PROXY_PASS}" \
  --connect-timeout 15 \
  --max-time 30 \
  "https://api.ipify.org?format=json"
预期结果 {"ip": "代理出口 IP"}

测试地址由第三方提供,只用于验证出口。生产代码应替换为依法可访问的真实目标 URL。

05

复制到采集代码

示例使用环境变量保存凭证,并分别设置连接与读取超时。生产任务还应加入退避重试、目标站点并发限制和响应校验。

export PROXY_USER="YOUR_PROXY_USER"
export PROXY_PASS="YOUR_PROXY_PASSWORD"

curl --fail-with-body --silent --show-error \
  --proxy "http://proxy.123proxy.cn:36923" \
  --proxy-user "${PROXY_USER}:${PROXY_PASS}" \
  --connect-timeout 15 \
  --max-time 30 \
  "https://api.ipify.org?format=json"
不要提交真实凭证

代理用户名和密码应保存在环境变量或密钥管理服务中,不要写入公开代码仓库、镜像或日志。

06

HTTP(S) 与 SOCKS5 怎么选

HTTP(S)

最常见的网页与 API 请求方式。HTTPS 目标通常通过 HTTP CONNECT 建立隧道。

SOCKS5

适合支持 SOCKS 的客户端。建议使用远端 DNS 解析,例如 Python 中的 socks5h://

先保持简单

没有明确需求时先使用 HTTP(S),确认代理链路后再调整协议和连接池。

07

常见错误快速排查

407 Proxy Authentication Required

确认使用代理用户而不是网站登录账号;检查用户名中的 SESSION 与国家后缀顺序;白名单模式确认服务器公网 IPv4 已保存到当前套餐。

连接超时或无法连接代理主机

检查 HOST、PORT、协议和海外服务器网络;先用命令行测试,再检查防火墙、DNS 和客户端连接池。

代理可用,但目标站点返回 403 / 429

这通常是目标站点响应。降低单站点并发,读取 Retry-After,检查请求头、账号状态、访问授权和目标服务条款。

设置地区或 SESSION 后没有立即变化

部分住宅路由配置通常需要约 3-15 分钟同步。等待后重新建立连接,并通过出口查询或真实目标验证。