首页 / 使用文档
快速开始
从注册到第一次连接,先确定你需要固定出口,还是按流量使用不同地区的出口。
- 注册账号。填写用户名和密码即可,无需邮箱。
- 在用户中心选择产品,查看当前可购节点或流量阶梯,核对报价和可用余额。
- 余额不足时,在用户中心进入「在线充值」,按页面显示的渠道和订单要求付款。到账后回到产品页下单。
选购静态 IP
在静态独享或静态共享中按国家、城市查找可售节点。点开节点查看规格,按页面要求选择业务项目、数量及购买周期。数量从 1 个开始。
动态代理与会话
- 进入购买流量,选择商品并填写整数 GB 数,核对该商品的余额、单价和应付金额。到账后可从概览查看各商品剩余额度,流量用量显示整个账号的消耗。
- 在提取代理中选择协议和地区。「每次连接轮转」返回一条可重复使用的凭据,每次新建连接时出口可能变化。批量提取请选择「按时长轮转」,一次最多 200 条,每条凭据使用独立的会话。
- 按时长轮转使用最多 6 位英文字母或数字组成的会话 ID,时长可设为 1 至 60 分钟。同一地区和会话会尽量复用出口,实际地址仍可能变化。更换地区时使用新的会话 ID。
- 点击「提取」,复制结果或导出 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 限制,请核对服务器出口。