15-排错速查表
分类：支持与排查 | 更新日期：2026-09-14
把“现象 → 原因 → 处理”做成一张表，遇到问题先查表、再做三步自检。
本页目录
- 先做三步分诊
- 常见故障速查表
- 最小自检脚本
- 提交工单时请附上这些信息
先做三步分诊
出现问题时，先用 30 秒判断问题出在哪一层，再去查对应表格，能省下大量来回沟通的时间。
- 代理本身能不能用？ 在终端执行 curl -x http://用户名:密码@主机:端口 https://api.ip.cc 。 能返回结果 说明提取侧正常，问题在客户端配置； 不能返回 继续第 2 步。
- 前置网络环境正常吗？ 直接执行 curl -s api.ip.cc 确认本机 / 前置节点能访问境外网络；同时记录其出口 IP，用于核对白名单。
- 参数完整吗？ 把控制台生成的用户名或链接 原样复制 粘贴一次再试，重点检查下划线参数段是否缺失、是否有多余空格。
把这两条命令存成脚本 在排查阶段，一个“对比直连与代理出口”的小脚本能让 80% 的问题当场定性：直连显示 SG、走代理显示 DE 即为正常。
常见故障速查表
| 现象 | 最可能的原因 | 处理动作 |
|---|---|---|
| 提取时提示无可用子账号 / 无法生成 | 子账号被禁用或已被自动暂停（30 天无流量） | 到「认证账号管理」确认状态，重新启用或新建子账号。 |
| 代理连不上（超时） | 前置网络环境异常、主机 / 端口写错、端口被本地防火墙拦截 | 先直连验证网络；核对主机与端口；换端口 / 协议重试。 |
| 认证失败（407 / 鉴权错误） | 用户名或密码不完整、参数段被截断、协议填错 | 原样复制四项信息；HTTP 与 SOCKS5 各试一次。 |
| 提示「账号不可用」或提取报错 | 用了其他套餐的子账号（子账号与套餐绑定，不可跨套餐复用） | 到目标套餐的「认证账号管理」中选择 / 新建该套餐的子账号后重新提取。 |
| API 提取返回空 / 鉴权失败 | 白名单未添加或前置 IP 已变化、app_key 被截断 | 更新白名单，或先在浏览器直接打开提取链接验证。 |
| 返回的 IP 归属地与预期不符 | 地区代码拼写错误、随机分配、第三方库未更新 | 重新从下拉框选择并复制；用多个检测站点交叉验证。 |
| 同一账号在多个环境表现异常 / 被限 | 多个环境共用同一 session 或同一出口 IP | 为每个环境重新生成独立 session 并重新分配。 |
| 指纹浏览器「检查代理」失败，但终端可用 | 客户端协议 / 解析差异、客户端缓存了旧配置 | 把协议切成 HTTP；保存后关闭并重新打开环境。 |
| 在客户端里选了 SOCKS4 / SSH / HTTPS 等协议后连不上 | 达可云代理只支持 HTTP 与 SOCKS5 | 把代理类型改回 HTTP 或 SOCKS5 后重新检测。 |
| 打开环境后仍显示本机 IP | 代理未保存、环境未重启、存在直连规则 | 确认保存并重启环境；检查分组 / 全局代理策略。 |
| SOCKS5 下部分域名无法访问 | 本机解析域名导致拿到不可路由地址 | 改用 HTTP，或让客户端远端解析（socks5h）。 |
| 缓存代理开启后站点打不开 / 证书告警 | 证书未安装到受信任根、目标站点仅支持 HTTPS | 重装证书到“受信任的根证书颁发机构”；或关闭缓存。 |
| 速度慢 / 请求频繁超时 | 区域距离远、并发过高、目标站点限速 | 换更近的区域；降低单 IP 并发；按需使用静态住宅代理。 |
| 流量消耗异常快 | 未限制子账号上限、被重复提取、缓存未开启 | 为子账号设置日 / 总量上限；开启缓存代理（若属可重复请求场景）。 |
| 想按业务查用量却对不上账 | 只看了主账号汇总，未下钻到子账号维度 | 到「数据统计」切换子账号维度，结合子账号备注中的业务归属逐项核对。 |
| 比特浏览器配置正常但访问异常 | 控制台开启了缓存代理（使用缓存代理时不支持比特浏览器） | 关闭缓存代理后重试，或改用其他指纹浏览器。 |
| 缓存代理开启后仍无加速 | 资源类型不在支持清单、两次请求不完全一致、未重启程序 | 核对支持格式清单与请求一致性；安装证书后重启调用程序。 |
| 证书已导入但仍提示不受信任 | 装到了“个人”等错误存储区，或程序未重启 | 重新导入并选择「受信任的根证书颁发机构」，然后重启浏览器 / 程序。 |
示例主机不是固定值 us.duckip.net:1000（动态住宅代理）与 as.duckip.net:2000（静态住宅代理）只是文档示例，不同地区与产品线的主机前缀可能不同；实际以控制台「复制」到的主机与端口为准，不要照抄示例。
最小自检脚本
# 1) 直连出口（记录国家与 IP，用于核对白名单）
curl -s -m 15 https://api.ip.cc
# 2) 走代理访问（把四项信息替换为控制台生成结果）
curl -sS -m 25 -x "http://子账号:子账号密码@us.duckip.net:1000" https://api.ip.cc
# 3) 只测试连通性，不打印正文（HTTP:000 表示没连上）
curl -s -o /dev/null -w "HTTP:%{http_code} time:%{time_total}s\n" -m 25 -x "http://子账号:子账号密码@us.duckip.net:1000" https://api.ip.cc| 命令输出（实测） | 含义 / 下一步 |
|---|---|
返回 JSON，含 ip / country_code / asn_type | 链路正常。核对 country_code 是否等于目标区域，asn_type 是否为 residential。 （实测：直连 curl -s api.ip.cc 与经代理访问都会返回这一结构） |
curl: (56) CONNECT tunnel failed, response 407 | 代理要求认证但凭据未通过：核对用户名 / 密码是否完整复制（含参数段）。（实测：用占位凭据连 us.duckip.net:1000 会返回该提示） |
response 612 | 静态代理端口在凭据 / 白名单不符时的返回；按四项信息重新核对。（实测：占位凭据连 as.duckip.net:2000 返回 612） |
HTTP:000（来自 -w 输出） | 没有建立连接。配合上一条错误信息区分“网络问题”还是“认证问题”。 |
curl: (5) Unsupported proxy syntax ... Port number was not a decimal number | 把 主机:端口:用户名:密码 四段原样塞给了 -x；要改成 http://用户名:密码@主机:端口。 |
| 自检结果 | 结论 |
|---|---|
| 第 1 步失败 | 前置网络环境有问题，先解决出网问题。 |
| 第 1 步成功、第 2 步失败 | 代理凭据 / 参数 / 协议有问题，回控制台核对四项信息。 |
| 第 2 步返回的国家与预期不符 | 区域参数写错，重新选择区域后生成新的代理。 |
| 三步都成功，但客户端仍失败 | 问题在客户端配置（协议、保存状态、直连规则、DNS 解析）。 |
提交工单时请附上这些信息
为了减少往返，联系客服时请一次性提供以下内容（敏感信息可脱敏，但请保留结构与错误原文）：
| 需要提供 | 示例 / 说明 |
|---|---|
| 账号与订单号 | 用于定位套餐与权限。 |
| 问题现象与复现步骤 | 什么时间、用什么方式（账密 / API）、访问什么目标。 |
| 所用参数（脱敏） | 主机、端口、用户名结构（保留参数段，密码用 *** 代替）。 |
| 完整错误信息 | 错误码 / 报错原文，不要只写“用不了”。 |
| 关键截图 | 控制台页面、客户端报错、终端命令输出。 |
| 已做过的排查 | 例如“直连正常、HTTP 与 SOCKS5 都试过、已核对白名单”。 |
不要在公开渠道张贴完整提取链接 提取链接包含 app_key。需要交给他人协助排查时，请先更换密钥或只提供必要片段。