IPProxy使用文档进入用户中心 ↗

首页 / 使用文档

快速开始

从注册到第一次连接,先确定你需要固定出口,还是按流量使用不同地区的出口。

  1. 注册账号。填写用户名和密码即可,无需邮箱。
  2. 在用户中心选择产品,查看当前可购节点或流量阶梯,核对报价和可用余额。
  3. 余额不足时,在用户中心进入「在线充值」,按页面显示的渠道和订单要求付款。到账后回到产品页下单。

选购静态 IP

在静态独享或静态共享中按国家、城市查找可售节点。点开节点查看规格,按页面要求选择业务项目、数量及购买周期。数量从 1 个开始。

核对本单金额、币种和时长后提交。在订单记录查看进度。开通后进入静态 IP查看连接信息、到期日及续费入口。

动态代理与会话

  1. 进入购买流量,选择商品并填写整数 GB 数,核对该商品的余额、单价和应付金额。到账后可从概览查看各商品剩余额度,流量用量显示整个账号的消耗。
  2. 在提取代理中选择协议和地区。「每次连接轮转」返回一条可重复使用的凭据,每次新建连接时出口可能变化。批量提取请选择「按时长轮转」,一次最多 200 条,每条凭据使用独立的会话。
  3. 按时长轮转使用最多 6 位英文字母或数字组成的会话 ID,时长可设为 1 至 60 分钟。同一地区和会话会尽量复用出口,实际地址仍可能变化。更换地区时使用新的会话 ID。
  4. 点击「提取」,复制结果或导出 TXT。每行依次是代理地址、端口、代理账号、代理密码,由冒号分隔。

提取结果含可用凭据。请在自己的客户端使用,发给客服的截图或日志请先遮盖账号和密码。

地区与编码表

全球随机适合没有地区要求的连接。指定地区时,先选国家,再按需缩小到州/省、城市。下一级选项来自当前所选地区。

范围池 2 地区标记示例
全球region-any
美国region-us
加利福尼亚州region-us_california
洛杉矶region-us_california_losangeles

页面按所选地区提取并返回完整账号,直接使用返回值即可。下载地区编码表可以查询英文名称,实际可提取的地区以提取页当次返回为准。

下载池 2 国家地区编码表 XLSX · 2.7 MiB

验证连接

以下命令中的四个中文字段分别替换为本次提取的值。SOCKS5 可让代理端解析目标域名。

curl --socks5-hostname "代理地址:端口" -U "代理账号:代理密码" https://ipinfo.io/ip

HTTP 代理同样可以访问 HTTPS 网站,客户端通过 CONNECT 建立隧道。池 2 的代理入口支持 HTTP 和 SOCKS5,连接这个入口时请选择其支持的协议。

curl --proxy "http://代理地址:端口" -U "代理账号:代理密码" https://ipinfo.io/ip

订单与钱包

订单记录按静态 IP、动态流量分类。点开记录可查订单号、数量或 GB 数及下单时的金额。静态实例的到期日和续费见「静态 IP」。

余额与流水显示本站统一计费币种。运营方调整币种时,钱包按该次锁定汇率转换。历史订单和流水继续显示交易当时的币种。

客户 API

在用户中心「API 接入」创建密钥,按需要授予读取、购买或续费权限。把密钥保存在服务端。正式站的接口前缀为 https://api.yyproxy.com/api/v1。

先给环境变量 IPX_API_KEY 赋值,再查询余额,验证密钥和读取权限。

curl -H "Authorization: Bearer ${IPX_API_KEY}" https://api.yyproxy.com/api/v1/balance
用途相对接口前缀的路径权限
余额 / 静态目录GET /balance、/catalog读取
静态报价POST /quote读取
创建静态订单POST /orders购买
订单、实例GET /orders、/orders/{bizNo}、/instances读取
续费POST /orders/{bizNo}/renew续费
动态产品及用量GET /dynamic/products、/dynamic/usage读取
流量报价POST /dynamic/quote读取
购买流量POST /dynamic/orders购买
提取动态凭据POST /dynamic/extract购买

静态报价使用目录返回的 sku、数量 ipCount 与周期数 cycles。流量报价使用产品编号 productNo 和购买量 gb。创建和续费订单还要发送 Idempotency-Key。一次业务操作使用一个键,网络中断后重试同一笔操作时复用原键和参数。

创建静态订单或购买流量时,可把报价返回的 priceCurrency 原样填入请求的 currency。如果站点在报价后切换了计费币种,服务端会返回 HTTP 409。请重新报价,让用户确认新金额和币种后再下单。该字段仅校验币种,成交金额以订单为准。

通过 API 提取一条动态代理

先为当前账号购买流量,再使用具备购买权限的密钥发送请求。这个例子使用 HTTP 和全球随机地区。响应中的 data.lines 是可以直接交给客户端的凭据列表。

curl -X POST https://api.yyproxy.com/api/v1/dynamic/extract \
  -H "Authorization: Bearer ${IPX_API_KEY}" \
  -H "Content-Type: application/json" \
  --data '{"protocol":"http","quantity":1}'

常见问题

找不到想要的城市怎么办?

先核对所属国家与州/省。地区表提供英文名,当次供应范围以页面选项为准。若页面提示地区加载失败,可重试后再选择。

付款后没看到静态 IP 怎么办?

先查订单状态和钱包流水。订单处理中可稍后查看,保留本站订单号用于核对,避免重复购买。

为什么还有钱包余额却不能提取?

提取消耗动态账户中的流量。请检查流量是否已到账、是否有剩余,以及账户是否暂停。

客户 API 返回 401 或 403 怎么办?

检查请求是否发到了 API 域名、Bearer 密钥是否有效,以及密钥是否具备接口所需权限。如配置了 IP 限制,请核对服务器出口。