# 纵游IP使用教程：Socks5/HTTP配置与API对接

> 来源网页：https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jiaocheng/jiaocheng-api/
> 发布日期：2026-10-13
> 更新时间：2026-10-13

纵游IP 上手只要三步：后台提取节点 → 填入客户端（Socks5 与 HTTP 共用同一组字段）→ 需要批量取用时改用 API（52 个接口、X-Api-Key 鉴权）。

[👤平台官方注册/购买/登录入口](https://zunoip.com/login/register?p=adminA1)[💰价格表（2 元起）](https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jiage/jiage-2026/)[🌐平台介绍](https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jieshao/)[🎟️邀请码怎么用](https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-zhuce/zhuce-yaoqingma/)[🔧代理工具中心](https://socks5ip.com.cn/dailigongjuzhongxin/)

**①**后台提取节点*静态住宅列表 → 选国家 → 复制连接信息*

**②**填入客户端*只改「代理类型」，地址 / 端口 / 账密共用*

**③**自测后接入*线路 → 归属地 → 延迟 → 业务模拟*

📌 一句话结论

纵游IP 的使用链路是「**后台提节点 → 填客户端 → 需要批量时换 API**」三段；Socks5 与 HTTP 共用同一组字段，游戏协议（Shadowsocks 类）走另一套参数。配完之后，用综合检测中心自测一遍再接入业务，能把大部分「装好了但不通」的问题挡在前面。

| 协议支持
| Socks5 / HTTP（mixed 混合）｜游戏协议（Shadowsocks 类）

| 全档统一指标
| 带宽 5Mbps · 并发 100 连接 · 骨干网延迟 <50ms

| API 对接
| https://zunoip.com/api · 52 个接口 · X-Api-Key 鉴权

| 上手前建议
| 先用约 2 小时 / 1GB 的测试卡跑通链路

数据来源：纵游IP 官方套餐与协议说明（我方邀请码 adminA1 口径）｜ 最后更新：2026-10-13

🔗 快速入口：[一站式注册入口](https://linkdd.cn/socks5ip) ｜ [价格中心](https://socks5ip.com.cn/jiagezhongxin/) ｜ [代理工具中心](https://socks5ip.com.cn/dailigongjuzhongxin/)

### 先把节点提出来：后台三步拿到连接信息

纵游IP 的静态长效住宅是「先有节点、再填客户端」的模式，所以第一步一定是登录后台把节点信息取出来。这一步看着简单，但地区选错的话后面全白做，所以配之前先把目标业务要用的国家确认好。

| 步骤
| 在后台做什么
| 拿到什么

| 第一步
| 登录账号，进入静态住宅 / 代理列表
| 已购买的套餐与可用地区清单

| 第二步
| 按业务目标选定国家 / 城市节点
| 一条静态长效住宅的出口记录

| 第三步
| 点提取 / 查看详情，复制连接信息
| 服务器地址、端口、用户名、密码（或授权串）

这里有个容易被忽略的点：静态长效住宅的出口**不会自动跳变**，它是「一条线路用一段时间」的形态。所以第三步复制下来的那组信息，就是接下来这段时间你要一直用的那一组，别指望它自己换。

### Socks5 和 HTTP 填的是同一组字段

很多新手以为 Socks5 和 HTTP 是两套完全不同的配置，其实在客户端这一层，它们填的字段几乎一模一样，只有「代理类型」那一栏要改。纵游IP 同时提供 Socks5 与 HTTP（mixed 混合）两种入口，选哪个取决于你的工具支持哪种。

| 客户端字段
| Socks5 填法
| HTTP 填法

| 代理类型
| SOCKS5
| HTTP / HTTPS

| 服务器 / 地址
| 后台提取的节点地址
| 同一组地址

| 端口
| 后台给出的端口
| 同一组端口

| 用户名 / 密码
| 按后台信息填写
| 同一组账号

| 浏览器扩展
| 不适用
| 可直接填 HTTP 代理

浏览器端的 HTTP 代理最省事：填地址、端口、账号密码即可，不需要装任何客户端。但如果你的工具是走系统代理的软件（多数桌面开发工具、部分指纹浏览器），则要看它支持哪种协议——支持 Socks5 的优先用 Socks5，它对 UDP 场景更友好。

### 游戏协议走的是另一套参数

纵游IP 的第三个协议入口是**游戏协议（Shadowsocks 类型）**，它不是「把 Socks5 换个名字」，而是一套独立的加密隧道参数。典型的落地方式是：拿到服务器地址、端口、加密方式和密码，或者直接拿到一条以 ss:// 开头的分享链接，把它导入支持该协议的客户端。

| 协议
| 典型参数
| 适合的工具类型

| Socks5
| 地址 + 端口 + 用户名 + 密码
| 桌面代理工具、指纹浏览器、开发脚本

| HTTP / mixed
| 地址 + 端口 + 账号密码
| 浏览器、系统代理、需要 HTTP 口的上游

| 游戏协议（Shadowsocks 类）
| 地址 + 端口 + 加密方式 + 密码（或 ss:// 链接）
| 支持该协议的客户端 / 软路由插件 / 移动端

三类协议不要混填：把 ss:// 参数填进「Socks5 代理」那一栏，客户端会一直连不上，而报错信息通常只说「认证失败」，看起来像账号问题。判断依据很简单——字段里有没有「加密方式」这一栏，有就是游戏协议那条路。

### 批量取用要做 API 对接：52 个接口，X-Api-Key 鉴权

当节点不是「手动提一条」而是「按业务量程序化取用」时，就要走 API 通道。纵游IP 的 API 地址是 https://zunoip.com/api，一共 52 个接口，鉴权靠请求头里的 **X-Api-Key**。

| 对接要点
| 说明

| 接口基址
| https://zunoip.com/api

| 接口数量
| 52 个，覆盖账号、节点与业务常用动作

| 鉴权方式
| 请求头携带 X-Api-Key

| key 从哪来
| 登录后台在账号 / 接口设置处生成，妥善保管

对接时有两条经验值得先说：一是 **key 不要写进前端代码或公开仓库**，一旦外泄等于把套餐额度交出去；二是接口有调用频率限制，脚本里务必加退避重试，而不是拿到报错就死循环重发——后端会把高频请求当成异常流量。具体每个接口的路径与参数，以官方接口文档为准，本站不做转述以免版本对不上。

### 软路由、指纹浏览器与云机，各自要改哪一处

同一个节点，落在不同设备上要改的位置完全不同。这三类是最常见也最容易配错的场景。

| 场景
| 改哪一处
| 要注意什么

| 软路由 / 整机代理
| 上游节点配置里加一条 Socks5 或游戏协议节点
| 整机与下级设备会共用同一条出口

| 指纹浏览器
| 每个环境单独填一条代理（Socks5）
| 一条出口只对应一个环境，别复用

| 安卓云机 / 模拟器
| 系统或 App 内填代理，或走游戏协议导入
| 云机数量多时优先考虑 API 批量下发

这三类场景的共同点是：一旦出口被多个业务共用，后续排查就分不清是哪一边的问题。所以「一个业务一条出口」这条组织原则，比选什么协议更影响最终体验。

### 配置完先自己验一遍，再接入业务

配好之后别急着上业务，先花两分钟自测。自测的顺序有讲究，从「线路连不连得上」到「业务跑不跑得动」，逐层往上验，出问题时才能定位到具体哪一层。

| 自测项
| 怎么验
| 判据

| 连通性
| 在 [线路可用性检测](https://socks5ip.com.cn/proxy-check/) 里填节点跑一遍
| 返回 200 且出口 IP 与目标国家一致

| 地址与归属
| 在 [IP综合检测中心](https://socks5ip.com.cn/ip-check-center/) 查出口信息
| 归属地、ASN 与预期一致，非机房标记

| 延迟与丢包
| 在 [网络测速](https://socks5ip.com.cn/speedtest/) 里跑延迟 / 抖动 / 丢包
| 延迟 30ms 内优秀、丢包 0% 理想

| 业务模拟
| 用业务里真实要做的那一步操作试一次
| 能正常完成，不触发验证或风控提示

四步里前三步用的是免费的公开工具，一分钟内就能跑完。很多人跳过自测直接上业务，结果一出问题就在「客户端配置」和「业务风控」之间来回怀疑，反而更费时间。

### 官方入口与相关页面

| 需要的页面
| 入口

| 📖 纵游IP 使用教程（本页）
| [https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jiaocheng/jiaocheng-api/](https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jiaocheng/jiaocheng-api/)

| 📊 纵游IP 价格表
| [https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jiage/jiage-2026/](https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jiage/jiage-2026/)

| 📝 官方注册入口（邀请码 adminA1）
| [https://zunoip.com/login/register?p=adminA1](https://zunoip.com/login/register?p=adminA1)

| 🔧 代理工具中心
| [https://socks5ip.com.cn/dailigongjuzhongxin/](https://socks5ip.com.cn/dailigongjuzhongxin/)

| 🛠️ IP综合检测中心
| [https://socks5ip.com.cn/ip-check-center/](https://socks5ip.com.cn/ip-check-center/)

### 常见问题（FAQ）

**Q：纵游IP 支持哪几种协议？**
A：Socks5、HTTP（Socks/HTTP mixed 混合），以及游戏协议（Shadowsocks 类型）三类。前两类可以用同一个客户端配置，只改「代理类型」那一栏；游戏协议需要单独填加密方式和密码。

**Q：新手最容易在哪一步卡住？**
A：多半卡在「填了参数但还是连不上」。常见原因有两个：把游戏协议的参数填进了 Socks5 那一栏，或者客户端走的是系统代理、但系统代理没有真正生效。先用线路检测工具跑一遍，能直接定位到是哪一层。

**Q：API 对接需要什么前置条件？**
A：需要先在后台生成 API Key，然后所有请求在请求头里带上 X-Api-Key。接口基址是 https://zunoip.com/api，共 52 个接口，具体路径与参数以官方接口文档为准。

**Q：一条节点能同时给几台设备用？**
A：技术上可以，套餐并发上限是 100 连接。但业务上不建议——静态长效住宅的价值就在于「一条出口对应一个业务环境」，多业务共用同一条出口会让后续排查分不清责任方。

**Q：配置完需要重启客户端吗？**
A：多数客户端在保存配置后会立即生效，但浏览器类工具常需要重启浏览器才能读到新的代理设置。如果改完没反应，先重启一次浏览器再判断。

**Q：怎么确认买到的是住宅出口而不是机房？**
A：用 IP综合检测中心看出口的 ASN 与归属类型。住宅出口的 ASN 通常归运营商而非云厂商，这一项比看「IP 显示在哪个国家」更能说明问题。

### 📚 相关阅读

📄 [老鱼安卓版常见问题汇总：连不上、闪退、掉线怎么解](https://socks5ip.com.cn/dailigongju/androiddaili/laoyu-android/laoyu-android-faq/)

📄 [纵游IP邀请码adminA1怎么确认生效：注册前后各核一次](https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-zhuce/zhuce-yaoqingma/)

📄 [纵游IP（ZunoIP）介绍：静态长效住宅代理平台](https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jieshao/)

### 更多帮助

**如需获取更多帮助，请访问官网：[socks5ip.com.cn](https://socks5ip.com.cn/)**

📊 **[纵游IP 价格表](https://socks5ip.com.cn/guowaiip/zongyouip/zongyouip-jiage/jiage-2026/)**

📖 **[纵游IP 平台介绍](https://socks5ip.com.cn/zongyouip/)**

🛠️ **[IP综合检测中心：IP质量/线路/测速/业务模拟免费测](https://socks5ip.com.cn/ip-check-center/)**

📝 **纵游IP 官方注册入口（邀请码 adminA1）：[https://zunoip.com/login/register?p=adminA1](https://zunoip.com/login/register?p=adminA1)**

💬 微信：**17720135827** — 7×24h在线

**全网低价IP｜聚合24家代理IP平台，全部免费测试，先测后买零风险**