订阅导入失败，尝试使用 Clash 代理导入怎么办？
简答：这句话通常表示直连下载订阅失败，客户端准备改用已有的 Clash 内核代理重试。首次导入没有可用节点时，应先检查链接、返回内容和格式；已有订阅更新失败时，才适合尝试“通过代理更新”。
定义：“尝试使用 Clash 代理导入”是客户端在直连获取远程订阅失败后，改用本机 Clash 内核当前可用代理再次请求订阅地址的重试动作，不是要求你更换成另一个 Clash 客户端。
先做这一步：判断是首次导入还是已有订阅更新
先不要删除配置、重置订阅链接或关闭证书校验。把订阅链接从服务页面重新复制一次，确认没有被截断、漏掉参数或复制成网页地址，并暂时保留当前配置文件。
| 场景 | “使用 Clash 代理”是否有用 | 先做什么 |
|---|---|---|
| 首次导入，客户端里没有可用节点 | 通常无效，因为本机还没有可供下载订阅的节点 | 检查链接、网络、返回内容、格式；必要时换网络或使用本地配置文件 |
| 已有订阅，更新时失败 | 可能有用，前提是旧配置里仍有可用节点 | 先用直连更新；失败后再选择“通过代理更新” |
| 导入成功，但节点列表为空 | 不是下载失败，重点检查返回格式和内核兼容性 | 查看配置内容是否包含代理定义或代理集合 |
Clash Verge Rev 的界面文案包含“Update”和“Update via proxy”，配置项也提供“Use System Proxy”“Use Clash Proxy”和证书校验选项；其项目源码显示，订阅更新会先尝试直连，失败后再尝试 Clash 代理，之后还可能尝试系统代理。可参考 Clash Verge Rev 界面文案 和 Clash Verge Rev 订阅更新源码。
按错误关键词和状态码处理
| 提示或状态 | 优先判断 | 可执行处理 |
|---|---|---|
failed to fetch remote profile | 客户端没有拿到可解析的远程配置，可能是网络、超时、鉴权或返回格式问题 | 重新复制完整链接；在浏览器或命令行保存返回内容；再检查状态码、跳转和内容类型 |
client error (Connect)、timeout | 订阅域名或中间链路无法建立连接 | 先换手机热点或其他网络；已有可用节点时再试“通过代理更新”；首次导入不要反复点击代理重试 |
| 401 | 服务器要求认证，常见方向是 token 缺失、失效或链接已重置 | 回到提供订阅链接的页面重新复制，不要手工删改参数 |
| 403 | 服务器拒绝当前请求，可能与权限、出口地址、User-Agent 或访问策略有关 | 先关闭“通过代理更新”改用直连；如果直连仍失败，再检查链接权限和订阅服务端限制 |
| 404 | 地址不存在、路径变化或链接已失效 | 重新生成或复制订阅地址，不要把网页首页地址当作订阅地址 |
| 502、503、504 | 网关或上游服务没有正常返回，504 表示网关未能及时得到上游响应 | 稍后重试并换网络对比；持续出现时保存状态码和时间，交由订阅服务方核查 |
invalid yaml、缺少 proxies 或 proxy-providers | 返回内容不是客户端能够解析的 Clash/Mihomo 配置，或字段结构不完整 | 确认订阅目标格式选择为 Clash/Mihomo，而不是 V2Ray、Base64 或通用分享链接 |
unsupport proxy type | 订阅中包含当前内核不支持的代理类型 | 更新客户端或内核到项目支持的版本；也可以让订阅服务方生成兼容格式 |
HTTP 状态码的含义可对照 MDN HTTP 响应状态码说明。其中 401 表示请求需要身份认证，403 表示服务器拒绝访问，404 表示资源不存在；502、503、504 则分别涉及网关响应异常、服务暂不可用和网关等待上游超时。
用浏览器检查订阅地址，但不要把“能打开”当成“能导入”
- 重新复制完整地址。确认地址从协议头开始，到最后一个参数结束；不要使用浏览器地址栏自动补全后的网页首页。
- 观察返回内容。如果打开后看到登录页、验证码页、套餐页面、HTML 错误页或空白内容，它就不是可直接导入的配置。
- 检查跳转。订阅地址如果跳转到登录页或其他域名，浏览器可能能继续显示页面，但客户端未必能按相同方式完成鉴权。
- 对比请求身份。Clash Verge Rev 添加远程配置时会发送以
clash-verge/v<版本号>为基础的 User-Agent，除非你为该配置设置了其他值；因此浏览器能打开，不代表服务端一定会对客户端返回相同内容。相关说明见 Clash Verge Rev 隐私与网络请求说明。 - 保存返回文件再看格式。在电脑上可以使用
curl -L -D headers.txt -o subscription.out "你的订阅地址"保存响应头和响应内容；文件名只是本地示例，命令中的链接不要公开。打开文件前先确认它没有包含账号密码或其他敏感信息。
求助时不要直接发送完整订阅链接。订阅地址通常含有账号 token，截图、日志和命令输出中应打码，只保留域名、状态码和不敏感的错误片段。
已有订阅时，正确使用“通过代理更新”
- 先打开 Clash 客户端，确认当前配置仍然存在，并且至少有一个节点或策略组可以正常使用。
- 先执行普通的“更新”或“直连更新”，记录完整错误信息。
- 如果直连失败且旧配置仍可用，在订阅卡片的菜单中选择“通过代理更新”或英文界面中的“Update via proxy”。
- 更新完成后检查更新时间、配置文件是否重新生成，以及代理列表是否仍然存在。
- 如果通过代理后出现 403，改回直连。代理出口地址可能触发订阅服务的访问策略，代理并不是所有失败的通用解法。
- 如果更新成功但节点为空，检查订阅服务是否返回了空配置、过期页面或与当前内核不兼容的代理类型。
不要长期打开“允许无效证书”来绕过导入问题。证书错误应先检查系统时间、网络是否被中间设备改写，以及订阅域名的证书是否正常；只有在你明确了解风险并确认来源可信时，才考虑临时测试，测试后应恢复证书校验。
首次导入没有节点时的替代路径
- 更换网络：使用手机热点或另一条网络，判断是当前网络无法访问订阅域名，还是链接本身失效。
- 检查系统代理：如果电脑已经有可用的系统代理，可以在远程配置选项中暂时启用“使用系统代理”，完成测试后按需关闭。
- 使用本地配置文件：让订阅提供方导出 Clash/Mihomo 格式的配置文件，再在客户端导入本地文件。不要把 V2Ray、Base64 或单条分享链接直接改名成 YAML。
- 核对格式字段：Mihomo 使用 YAML 配置；远程代理集合通常通过
proxy-providers声明，并由策略组通过use引用。可参考 Mihomo 配置语法 和 Mihomo 官方配置示例。
如果返回的是完整 YAML，但提示缺少 proxies 或 proxy-providers，不要只补一个字段就直接使用。应先确认订阅服务生成的是完整配置，尤其是策略组引用的 provider 名称是否实际存在，代理类型是否被当前内核支持。
最小风险排查清单
- 保留现有配置和订阅记录，不先删除。
- 重新复制完整订阅链接，检查是否过期、重置或被截断。
- 用浏览器或命令行确认返回的是配置，而不是登录页、HTML 错误页或空内容。
- 记录状态码、完整错误关键词、是否发生跳转，以及直连和代理更新的差异。
- 首次导入没有节点时，优先换网络、检查格式或使用本地配置文件。
- 已有订阅更新失败时，才尝试“通过代理更新”；出现 403 时优先改回直连。
- 不要公开完整 token，不要一开始就重置订阅或长期关闭证书校验。
按这个顺序处理，可以把“链接问题、访问路径问题、返回格式问题和内核兼容问题”分开，避免反复重试却无法判断失败发生在哪一环。
常见问题
“尝试使用 Clash 代理导入”是不是让我换成 Clash？
不是。它通常表示客户端第一次直连获取订阅失败，准备使用本机已有的 Clash 内核代理重新请求。首次导入没有可用节点时，这个重试通常没有实际帮助。
首次导入订阅失败，可以直接开启“使用 Clash 代理”吗？
如果客户端里没有已经可用的节点，通常不能。先检查订阅链接、返回内容和格式，再尝试换网络、使用系统代理或导入本地 Clash/Mihomo 配置文件。
为什么订阅链接在浏览器能打开，Clash 还是导入失败？
浏览器和客户端可能使用不同的 User-Agent、代理路径、重定向处理和鉴权方式。浏览器看到网页，不等于客户端拿到的是可解析的 YAML 配置。
403 错误时应该使用代理更新吗？
不一定。403 表示服务器拒绝当前请求，代理出口地址可能正是触发拒绝的原因。先关闭代理更新并改用直连，同时重新复制链接检查权限。
导入成功但没有节点，算订阅导入失败吗？
这通常是另一类问题：下载动作可能成功，但返回内容为空、格式不匹配、代理集合没有被策略组引用，或其中的代理类型不受当前内核支持。应查看配置内容和客户端日志。
分享错误日志时要注意什么？
订阅链接通常含有账号 token。截图、日志、命令输出和配置文件中都应遮挡完整链接、token、用户名、密码及其他鉴权信息。