JoyProxy 帮助中心

简体中文

English

简体中文

English

常见报错与连接排查 ​

当你在提取代理、调用接口或抓取网页遇到网络阻断时，请参考本章的诊断指南逐步排查定位。

典型 HTTP 报错代码排查 ​

407 代理鉴权失败

这是最常见的配置错误，表明代理网关拒绝了你的连接请求。请按以下顺序检查：

  1. 密码是否填写正确：确认你填写的密码是控制台「账密与白名单」中为该网络创建的代理密码，而不是登录 JoyProxy 网站的主账号密码。
  2. 用户名是否被截断：如果是动态代理，确认是否完整复制了 Web 提取或 API 提取返回的整长串用户名字符串。任何少拷一个字母或自行删减国家/会话标记的操作都会导致 407。
  3. 白名单模式检查：如果你计划免密使用，检查当前的出口公网 IP 是否已经成功录入对应网络的「IP 白名单」中；请注意动态代理目前必须使用用户名密码鉴权。
  4. 账户额度检查：检查你的动态流量包是否已耗尽，或者静态独享线路是否已经过期未续费。
401 未经授权

通常出现在调用 RESTful API（如 /v2/extract 或 /v1/fetch）时：

  1. Token 混淆：确认请求头中携带的 Token 类型是否正确。提取代理 IP 需要使用「代理提取 API Token」，抓取接口需要使用「Scraping API Token」，不能使用「主用户 Token」调用公网采集。
  2. 请求头格式规范：标准的 HTTP 头必须形如 Authorization: Bearer <Your_Token>（注意 Bearer 与 Token 之间有一个半角空格）。
  3. Token 是否已被轮换：如果你此前在后台点击过 Rotate Token，旧 Token 会瞬间作废，请更新为最新的凭证。
429 请求过于频繁
  • API 提取接口限频：短时间内对提取接口或登录接口发起过高频率的死循环请求。请在代码中增加合理的重试间隔（建议间隔 1~2 秒以上）。
  • 抓取并发超限：Web Scraping API 瞬时正在处理的请求数超过了你当前套餐的允许并发数（例如 Micro 套餐最大并发为 5），调低客户端工作协程数或升级至更高并发套餐即可解决。
502 / 504 目标连接超时或网关错误
  • 目标站点不可达：说明代理节点本身已成功建连，但在尝试访问目标网站时被对方服务器阻断、拒连或目标站正在宕机。
  • 中国大陆目标限制：确认目标网站是否位于中国大陆境内。JoyProxy 的所有境外代理节点出于合规原因均无法建立指向中国大陆域名的网络连接。
  • 单节点偶发故障：如果是静态独享线路出现 502，可在控制台「已购」中点击 更换 IP，免费重新分配该地区的健康出口。
403 Forbidden 与 Connection Refused（连接被拒绝）
  • 403 Forbidden：通常代表目标网站反爬策略生效或拒绝了该请求，而非代理服务器本身挂掉；
  • Connection Refused：检查代理主机和端口是否拼写正确，协议类型（HTTP/SOCKS5）是否匹配，订单是否已经到期停止服务。

连通性与地理属地疑难排查 ​

代理提取并配置后，为什么浏览器或程序完全无法上网？

请按照以下清单快速诊断：

  1. 确认本地网络环境：请确保你当前测试的环境位于中国大陆以外（如境外 VPS、海外办公室网络）。从中国大陆境内直连代理网关会被阻断。
  2. 检查端口与协议匹配：如果选择的是 HTTP 代理模式，软件中不要勾选 SOCKS5；如果是静态独享线路，必须填写形如 isp.joyproxy.com:端口（数据中心为 dc.joyproxy.com:端口，或控制台实际显示的 Entry Point 接入地址），绝对不能填写 Dedicated Exit IP。
  3. 测试底层端口通畅：在终端中使用命令测试握手：
    bash
    curl -x http://用户名:密码@gate.joyproxy.com:9001 https://ipinfo.io
    若能返回公网 JSON 数据，说明代理链路本身完全正常，问题出在特定应用程序（如浏览器扩展或爬虫参数）的配置层。
检测到的出口 IP 属地与购买或提取时选择的地区不一致？

有时你指定了美国洛杉矶，但通过某些 IP 库查询却显示在其它城市：

  • 全球 IP 数据库同步差异：国际上存在多个主流商用 IP 地理数据库（如 MaxMind GeoIP2、IP2Location、DB-IP 等），不同数据库的更新周期存在数天到数周的延迟。
  • 平台权威判定标准：JoyProxy 严格以权威商用 IP 库（MaxMind / IPinfo 最新版本）为标准进行网络划分与路由交付。某些免费第三方查询网站的离线库可能滞后，建议以多个主流权威 IP 查询站的结果为准。
客户端连接时出现 Proxy CONNECT aborted 或连接中断？

如果客户端或爬虫发起代理连接时被中断，请按以下顺序排查：

  1. Entry Point 与 Exit IP 混淆：静态代理必须连接控制台给出的 Entry Point（接入域名:端口），切勿将 Dedicated Exit IP 当作代理服务器地址；
  2. 鉴权信息是否匹配：动态代理必须填写正确的代理用户名与密码；静态代理若未开启免密，需要将发起请求的设备公网 IP 加入白名单，或正确配置账密；
  3. 链式代理配置：如果将 JoyProxy 作为二级代理（链式后置节点），请确保前置代理本身能正常访问外部网络，且支持标准的 HTTP CONNECT / SOCKS5 转发。
Windows 命令行下 curl 报错 CRYPT_E_REVOCATION_OFFLINE？

这是 Windows 系统在使用原生 TLS 库时，本地无法联机核对目标网站的数字证书吊销列表（CRL）导致的系统阻断，并不代表代理服务器故障。

  • 在 curl 命令中加入 --ssl-no-revoke 参数即可跳过本地吊销检查：
    bash
    curl --ssl-no-revoke -x http://用户名:密码@接入地址:端口 https://ipinfo.io/json
  • 能够正常返回目标公网 IP 的 JSON 结果，即表示代理链路工作正常。
静态独享代理（ISP / 数据中心）速度慢、延迟高或对质量不满意怎么办？
  1. 更换出口 IP：在控制台「已购代理」中找到对应的静态独享线路，点击「更换 IP」，系统会在同地区重新分配一个全新的出口 IP，以排除特定出口节点的网络拥堵或被目标网站限速；
  2. 确认网络环境与协议：请确保测试环境位于中国大陆以外；
  3. 申请直连专属代理：如需超低延迟、大带宽的静态代理，请通过工单申请直连专属代理。提交工单时说明目标国家、所需带宽、协议及主要业务场景，我们将安排专人评估交付定制专线。

高效获取人工支持 ​

如何联系人工技术支持？
  • 控制台工单：登录控制台，在左侧导航栏点击「工单」即可创建工单，支持上传详细报错日志、截图与目标链接，技术人员会跟进处理。
  • 在线客服：在官网或控制台右下角打开在线客服窗口咨询。若需提交正式工单，也可在聊天窗口右上角点击快捷工单按钮直接创建。
为什么使用静态 ISP 代理访问 Payoneer、ChatGPT、Instagram 等平台频繁报错或被拦截？

国际知名金融支付平台（如 Payoneer）、AI 服务商（如 OpenAI ChatGPT、Anthropic Claude）以及社交媒体平台对连接 IP 的纯净度有极高的风险过滤机制：

  1. 原因分析：ISP 代理虽然出口标有电信运营商 ASN，但底层线路部署在托管机房，往往会被部分风控数据库标记为机房/商业属性，从而触发严格平台的自动化安全策略；
  2. 解决建议：
    • 如果只是临时遇到个别出口 IP 不顺畅，可在控制台「已购代理」中先点击一次「更换 IP」尝试切换同地区的新出口；
    • 对于长期高频使用此类高风控平台的业务，强烈建议更换为「住宅代理（Residential）」或「移动代理（Mobile）」。动态住宅与移动网络直接调度自海外真实居民家庭与 4G/5G 手机蜂窝网络，天然不带机房或商业属性标签，搭配 粘性会话（设置 1440 分钟或自定义 sesstime），既能享有无封控的超高纯净度，又能维持稳定的业务会话。
客户端或软件只认数字 IP，输入 isp.joyproxy.com 报错格式错误怎么解决？

很多自动化工具、特定协议客户端或指纹浏览器内部写死了 IP 格式校验正则，只允许输入类似 123.123.123.123 纯数字 IPv4 地址。 快速解决步骤：

  1. 在本地电脑打开命令行窗口（CMD、PowerShell 或 Terminal）；
  2. 运行 ping isp.joyproxy.com 命令（如果是数据中心代理请运行 ping dc.joyproxy.com）；
  3. 复制命令返回信息中括号里的纯数字 IPv4 地址；
  4. 将该纯数字 IPv4 地址直接填入软件的代理 IP 栏，端口、用户名与密码依然填写控制台给出的信息即可正常连接。