故障排查
遇到问题了吗?大多数问题都属于以下八种模式之一。找到匹配的症状,按照诊断步骤操作,然后应用修复方法。
网关连接被拒绝或超时
Section titled “网关连接被拒绝或超时”症状: 客户端在调用 p.shifter.io:443 时报告 “connection refused”、“connection timed out” 或 “no route to host”。
诊断:
- 确认你使用的是新网关地址:
p.shifter.io:443。旧版套餐使用的是按端口划分的子域名,例如apollo.p.shifter.io:<port>。 - 检查你的源 IP 是否处于阻止出站 443 端口的防火墙之后。
- 测试原始连接:
nc -vz p.shifter.io 443。
修复: 如果原始连接正常但代理失败,问题出在身份验证上。请参阅下方的 407 部分。如果原始连接失败,请检查出站防火墙规则,并从其他网络重试。
HTTP 407 需要代理身份验证
Section titled “HTTP 407 需要代理身份验证”症状: 每次请求都返回 407 Proxy Authentication Required。
诊断:
- 凭据错误: 用户名或密码拼写错误。
- 未知标志: 扩展用户名中包含格式错误的国家代码、城市 slug 或会话字符串。
- 密码已重置: 在面板中轮换后,旧密码已失效。 修复:
- 先去掉所有标志,仅使用原始用户名和密码重试。如果可行,再逐个添加标志。
- 前往 shifter.io/panel 的 Residential Proxies 部分确认你的密码。
- 如果你最近轮换过密码,请将新密码同步到所有客户端。
住宅 IP 响应速度缓慢
Section titled “住宅 IP 响应速度缓慢”症状: 请求耗时 5-10 秒以上。之前速度较快的 IP 变慢了。
诊断: 住宅 IP 来自真实的 ISP 连接。延迟出现一定波动是正常的。持续缓慢通常意味着:
- 该 IP 的终端用户正在大量占用连接(如 Netflix、大文件上传)。
- 目标网站正在限制该 IP。
- 池筛选条件过于狭窄,导致你获取到的是积压的 IP。
修复:
- 更积极地轮换 IP(取消粘性会话或缩短
ttl)。 - 放宽筛选条件(去掉城市限制,只保留国家)。
- 对于 ISP 代理:使用 Managing IPs → Replace 将缓慢的 IP 替换为新的 IP。
IP 地理位置与目标不匹配
Section titled “IP 地理位置与目标不匹配”症状: 你请求的是 country-us-city-new_york,但目标网站认为你位于其他地方。
诊断:
- 住宅 IP 的地理位置由第三方数据库(MaxMind、IP2Location)确定。这些数据库与目标网站自身的地理定位来源并不总是一致。
- 移动运营商 IP 和新分配的 ISP 网段可能会有数周的分类错误。
修复:
- 重试该请求。Shifter 会在每次请求(或每个粘性会话)时分配一个新 IP,下一个 IP 在目标数据库上的地理位置可能更准确。
- 如果你需要针对特定目标保证地理位置准确,请联系支持团队并提供目标 URL 和期望的位置。我们可以针对该目标预先验证 IP。
HTTPS 错误、SSL/TLS 失败
Section titled “HTTPS 错误、SSL/TLS 失败”症状: SSL handshake failed、certificate verify failed,或 tls: bad record MAC。
诊断:
- 你使用的 OpenSSL 或 Node 版本过旧,拒绝了网关的加密套件。
- 企业代理的信任链被破坏。
修复:
- 更新客户端的 TLS 库。已知可用的版本包括 Node 18+、Python requests 2.28+、curl 7.80+。
- 如果你的环境要求严格的主机校验,可以固定网关证书以绕过信任链问题。
- 仅用于调试:curl 的
--proxy-insecure会在代理这一环节禁用证书验证。切勿在生产环境中使用此标志。
目标网站仍然屏蔽我
Section titled “目标网站仍然屏蔽我”症状: 即使使用带轮换功能的住宅代理,某个特定目标仍然返回验证码、403 错误或空响应体。
诊断: 目标网站部署了分层反机器人系统(Cloudflare、Akamai、DataDome),其指纹识别不仅限于 IP。常见的暴露迹象包括:
- User-Agent 与 TLS 指纹不匹配(JA3/JA4 不一致)。
- 请求头的发送顺序与真实浏览器不同。
- 浏览器 API(WebDriver 检测、navigator.webdriver 标志)暴露了自动化行为。
- IP 轮换频率对目标的会话模型来说过于激进。
修复:
- 从原始代理切换到 Web Scraping API,该产品包含隐身模式和验证码破解功能。
- 或者:提交工单并附上目标 URL。许多情况可以从我们这边进行调整。
Web Scraping API 返回 509 带宽限制超出
Section titled “Web Scraping API 返回 509 带宽限制超出”症状: 即使你的套餐仍有剩余额度,Scraping API 仍返回 509。
诊断: 509 表示套餐配额已用尽。如果仪表盘上仍显示有剩余额度,请检查:
- 你使用的是正确的 API 密钥(而不是旧套餐的密钥)。
- 如果你希望超额部分转为按需付费,请确认已启用 Extra Traffic。
修复:
- 在 Web Scraping API → API Keys 中确认密钥与当前有效套餐匹配。
- 启用 Billing → Extra Traffic,将超额部分自动转换为按额度计费。
- 如果你经常用尽额度,请升级套餐。
支付失败或订阅未激活
Section titled “支付失败或订阅未激活”症状: 你已完成付款,但套餐显示为未激活,或续订静默失败。
诊断:
- 发卡机构阻止了该笔交易(国际线上无卡交易中常见)。
- 卡片已过期,或 3DS 验证未完成。
- 加密货币支付尚未确认(需要 6 次确认)。
修复:
- 在你的银行应用中查看该卡片的交易记录。如果扣款被拒绝,请更换其他卡片重试。
- 对于加密货币,支付处理商会在获得 6 次区块链确认后检测到付款。BTC/ETH 通常需要 15-60 分钟。
- 如果扣款已成功,但 30 分钟后套餐仍未激活,请将发票 ID 发送至
hi@shifter.io。