指南
Proxy
故障排除指南

代理故障排查指南

407 认证错误

HTTP 407 Proxy Authentication Required 响应表示请求失败，原因是缺少代理认证凭证，或凭证无效。

推荐排查步骤：

  • 在 dashboard 中确认你的用户名和密码。
  • 如果使用 IP 白名单，请确保请求来自已授权的 IP 地址。
  • 检查你的 channel 是否已达到流量限制、已过期或已被禁用。

连接问题

代理连接需要满足特定条件后，才能成功建立连接。

请确保：

  • 你的设备已连接到互联网。
  • 所需连接端口已打开。
  • 没有其他代理或 VPN 处于启用状态。
  • 你正在使用正确的代理 host 和 port（参考：How to Use a Proxy）。
  • 错误来自代理层（而不是一般网络错误或浏览器错误）。

其他排查选项：

  • 暂时禁用杀毒软件。
  • 如果使用远程服务器，请确保防火墙规则允许代理端口流量。
  • 尝试切换到其他 endpoint。
  • 使用其他代理工具或客户端进行测试。
  • 切换网络（例如移动热点或其他 Wi-Fi）。

网络性能与带宽

代理带宽通常在 2 Mbps 到 5 Mbps 之间（1 Mbps ≈ 128 KB/s）。

如果你遇到速度下降，可以尝试以下方法：

  • 减少活动 session 或打开窗口的数量
  • 检查并优化本地网络条件
  • 如有必要，切换到更稳定的网络

代理请求格式

curl --proxy <host>:<port> --proxy-user <channelId>-<proxy_type>-country_<country>-r_<sessionDuration>-s_<sessionId>:<password> https://api.ipapi.is/
  • <host>：代理 gateway endpoint 地址。
  • <port>：代理 gateway 端口。
  • <channelId>：分配的 channel 标识符。
  • <proxy_type>：代理类型。固定值：“resi”、“dc” 或 “mobile”。该参数绑定到 channel 配置，无法修改
  • <country>：目标国家代码。
  • <sessionDuration>：session 生命周期配置。支持 “rotate per request” 或固定时长（例如 “5m”、“60m” 等）。最大 session 时长为 120 分钟。
  • <sessionId>：session 标识符。每个请求可以使用一个唯一值。
  • <password>：channel 认证密码（最小长度：8 个字符）。

代理 Session 模型

Sticky Proxy：

只要代理有效，它就会保持不变。一旦失效，会自动切换。

Rotating Proxy：

每个请求都会分配一个新的代理，无论上一个代理的状态如何。

网络覆盖与 IP 池

地区

对于按流量计费的代理（Residential、Datacenter 和 Mobile），我们覆盖多个国家。你可以直接在 dashboard 中轻松选择偏好的地区，以匹配具体需求。

我们的 ISP 代理目前可用于 US、CA、DE、UK 和 HK。我们正在持续扩大全球覆盖范围，更多地区即将上线。

池大小

我们的平台不会按国家维护固定 IP 库。IP 资源通过持续刷新的分配系统进行供应，并会根据实时需求、网络可用性和路由优化参数动态调整。

在高使用率地区，系统支持最高约 ~500K 的每日聚合 IP 可用量。该基础设施经过设计，可在可变负载条件下保持高可用、受控的轮换频率和稳定的网络性能。

Gateway

Gateway 概览

为确保连接稳定，所有请求都会通过全球 gateway endpoint 进行路由。延迟可能会因用户地理位置和网络条件而有所不同。

Endpoint

Global: proxy.capsolver.com

集成CapSolver For AI Agents