IPCOOL文档中心
    • IPcool 代理IP 使用文档

    IPcool 代理IP 使用文档

    官网：https://ipcool.net/

    一、政策说明（重要）#

    根据相关政策要求，国内IP地址无法使用本平台服务。请在符合当地法律法规的前提下使用本平台代理IP服务，确保使用场景合规。如有疑问，请先联系客服确认。

    二、购买与流量获取#

    本平台采用流量余额计费模式，使用代理前需要先获取流量余额。有两种途径：
    途径一：官网购买
    登录官网 https://ipcool.net/ ，进入产品中心，选择所需流量套餐完成购买。
    途径二：联系客服获取
    如官网购买遇到问题，或需要咨询套餐详情，请直接联系在线客服获取流量余额。

    三、接入前准备（二选一）#

    账密认证适合需要灵活切换IP、或所在网络IP地址经常变化的场景，无需添加白名单；API提取适合程序化调用、自动化爬虫或需要批量获取代理IP的开发者场景，需要添加白名单并绑定扣费子账号。请根据使用场景选择一种方式完成准备。如果你已经完成准备，可直接跳到第四章验证连通性。

    3.1 账密认证准备#

    1.
    登录官网，点击「获取代理」或「进入控制台」；
    2.
    进入「认证账户管理」，点击「新增子账号」，填写账户名、账号密码，选择认证类型（默认动态住宅；如使用不限量套餐，请选择不限量），分配流量上限，将账号状态设为启用并保存；
    3.
    在子账号列表中点击「账密提取」，或进入「控制台-账密认证」；
    4.
    选择协议类型（HTTP/HTTPS、SOCKS5）、目标国家/地区、会话类型（粘性IP或轮转IP）、数量、格式，生成后获得代理主机地址、端口、用户名、密码四项连接信息。
    账密认证无需添加IP白名单，每次请求携带用户名密码进行身份验证。子账号字段规则、密码规则和配置格式见第五章。

    3.2 API提取准备#

    1.
    按 3.1 相同步骤创建子账号并分配流量；
    2.
    进入「IP白名单管理」，将调用API的服务器或本机公网IP地址加入白名单，并绑定扣费子账号；
    3.
    进入「API认证」页面，选择国家/地区、提取数量、协议类型、数据格式（TXT / JSON）、有效时长，点击「生成API链接」。
    API提取必须添加白名单，否则调用时可能返回「407 客户端 IP 不在白名单、IP 被临时封禁」。如不确定公网IP，可访问 https://ipinfo.io/ip 获取。返回结构与程序集成见第六章。

    四、快速验证连通性#

    完成第三章准备后，用一条命令确认代理是否可用。

    4.1 账密认证：HTTP/HTTPS 代理#

    将下面命令中的“你的代理主机”“你的代理端口”“你的子账号用户名”“你的代理密码”替换为 3.1 中获取的信息：

    4.2 账密认证：SOCKS5 代理#

    如果控制台为 SOCKS5 分配了独立端口，或你明确选择 SOCKS5 协议，可使用：
    socks5h:// 表示由代理端解析 DNS。若你的环境不支持，可改用 socks5://。

    4.3 API提取：先确认提取返回有效#

    先调用你在控制台生成的 API 链接：
    TXT 格式通常返回类似：
    1.1.2.2:14566
    JSON 格式返回结构参考第六章，核心字段为 body.count、body.list[].ip、body.list[].port、body.list[].expireTime。确认能返回有效 ip 和 port 后，使用返回的 ip:port 作为代理地址发起请求；如程序环境需要显式协议，可使用 http://ip:port。

    4.4 判断是否成功#

    账密认证成功标志：curl 返回内容中的出口 IP 与你本地公网 IP 不同。你可以先在本地直接执行 curl https://ipinfo.io 作为对照。
    API提取成功标志：API 返回格式正确，count 与提取数量一致，list 中包含有效 ip、port；使用返回的 ip:port 发起请求后，出口 IP 与提取结果一致。

    4.5 失败时先查这几项#

    现象优先检查对应错误码/说明
    账密连接失败主机、端口、用户名、密码是否复制完整；子账号是否启用；密码是否符合8-15位且包含大小写字母601 用户名或密码错误
    API 返回为空或报错子账号是否有可用流量；白名单是否已添加当前公网 IP；是否绑定扣费子账号407 白名单/封禁；402 流量不足
    提示中国大陆IP禁止使用当前网络环境是否符合平台要求465 中国大陆IP，禁止使用
    没有可用代理资源地区、数量、协议等参数是否合理；资源是否过期603 没有可用代理资源；454 资源过期/停用
    目标域名无法访问目标域名是否命中黑名单463 目标域名命中黑名单
    请求格式错误检查请求地址、参数是否完整400 请求格式错误、缺少目标地址
    更多错误码请查看第八章。

    五、账密认证详解（动态账密）#

    本章详细说明账密认证的子账号字段、连接信息获取和配置格式。

    5.1 添加子账号#

    登录官网后，点击「获取代理」或「进入控制台」，选择认证账户管理，点击「新增子账号」。
    填写以下信息：
    账户名：子账号的账户名
    账号密码：代理密码，长度8-15位，须包含至少一个大写字母和一个小写字母，且不能与账户名相同
    认证类型：默认动态住宅；如使用不限量套餐，请选择不限量
    流量上限：分配给该子账号的可用流量（GB），大于0且不得高于主账号当前剩余流量
    将账号状态设为启用，点击确认保存。保存后子账号即可立即使用。
    注意：子账号消耗的流量将从主账号余额中扣除。子账号流量达到上限后将停止工作，可随时在子账号列表中调整流量上限。

    5.2 获取代理连接信息#

    子账号创建完成后，在子账号列表中找到对应账号，点击「账密提取」，或进入「控制台-账密认证」。
    在提取页面选择：
    协议类型：HTTP/HTTPS、SOCKS5
    目标国家/地区
    会话类型：粘性IP（指定时间内IP不变）或轮转IP（每次请求更换IP）
    数量
    格式
    生成后，页面会显示代理主机地址、端口、用户名、密码四项连接信息。

    5.3 配置使用#

    将获取到的代理信息填入浏览器、指纹浏览器或程序中即可。账密认证方式无需添加IP白名单，每次请求携带用户名密码进行身份验证。
    常见配置格式：
    主机:端口:用户名:密码
用户名:密码@主机:端口
主机|端口|用户名|密码

    六、API提取详解#

    API提取适合程序化调用、自动化爬虫或需要批量获取代理IP的开发者场景。使用前需要完成三项准备：添加子账号、分配流量、添加白名单并绑定扣费子账号。

    6.1 添加子账号并分配流量#

    与动态账密的步骤相同——先创建子账号，填写用户名、密码，并分配流量额度。

    6.2 添加白名单并绑定扣费子账号#

    在控制台找到「IP白名单管理」页面，将您调用API的服务器或本机的公网IP地址添加到白名单中，同时绑定扣费子账号。这样API提取产生的流量消耗会从该子账号的流量额度中扣除。如子账号流量不足，需返回子账号管理页面为其追加分配流量。
    重要提示：API提取必须添加白名单，否则调用时会返回错误提示：「407 客户端 IP 不在白名单、IP 被临时封禁」。如果您不确定自己的公网IP，可访问 https://ipinfo.io/ip 获取。

    6.3 生成API链接并调用#

    完成以上准备后，进入「API认证」页面：
    1.
    选择国家/地区
    2.
    设置提取数量
    3.
    选择协议类型和数据格式（TXT / JSON）
    4.
    设置有效时长（默认5分钟，建议5-30分钟，最长支持30分钟）
    5.
    点击「生成API链接」
    生成的链接可直接用于程序调用。API返回格式示例如下：
    TXT格式：
    1.1.2.2:14566
    JSON格式：
    {
  "code": "0",
  "message": "OK",
  "body": {
    "count": 1,
    "list": [
      {
        "ip": "1.1.2.2",
        "port": 10002,
        "expireTime": 1790133952224
      }
    ]
  }
}

    6.4 程序集成#

    在代码中调用API链接获取代理IP列表，示例如下：
    建议加入异常处理与重试机制，并在高并发场景下配合线程池或队列管理。

    七、常见问题#

    Q：为什么国内IP无法使用？
    A：受政策限制，国内IP地址无法访问本平台服务，请确保您的网络环境符合要求。
    Q：是否可以访问国内网址？
    A：部分资源不支持，如需使用可咨询客服。
    Q：子账号流量可以回收吗？
    A：可以，但需要删除子账号，流量会自动回到主账号。
    Q：API提取返回为空怎么办？
    A：请依次检查：①子账号是否有可用流量；②白名单是否已添加当前IP；③API参数（地区、数量等）是否正确。
    Q：最多可以创建多少个子账号？
    A：最多支持创建50个子账号。
    Q：账密认证和API提取两种方式怎么选？
    A：账密认证适合浏览器、指纹浏览器手动配置或IP地址经常变化的场景，无需白名单；API提取适合程序自动化、爬虫批量获取代理的场景，需要白名单并绑定扣费子账号。

    八、使用时的错误码#

    错误代码说明
    400请求格式错误、缺少目标地址
    402账号剩余流量不足
    403未知认证错误码，或内部错误码未被正确映射
    407客户端 IP 不在白名单、IP 被临时封禁
    454账号或代理资源过期/停用
    455资源未提取或未绑定到当前网关
    463目标域名命中黑名单
    464可疑流量拦截
    465中国大陆IP，禁止使用
    502认证器本身返回异常
    601用户名或密码错误
    603没有可用代理资源
    604上游连接、目标连接或资源构造失败
    605请求写入上游连接失败
    如有其他问题，请联系官网客服咨询。
    修改于 2026-10-21 08:31:11
    Built with