订阅无法使用排查

当您在客户端“导入订阅”或更新等遇到失败、超时或提示错误时，通常由网络权限、剪贴板权限、客户端缓存或节点格式引起。请按照以下步骤依次排查。

国内网络导入失败？试试“订阅转换”

如果您因为国内本地网络严格封锁导致直接导入屡次失败，可尝试订阅转换。您可以利用本平台的离岸转换将订阅下载为本地配置文件，再进行本地手动导入：

1. 访问 🐾 Surf Pooch 订阅转换中心 。

2. 将您在官网复制的通用订阅链接粘贴到输入框内。

3. 选择您当前对应的客户端类型，点击**“生成订阅链接”**并复制。

4. 【关键步骤】：直接将生成的纯文本链接粘贴到浏览器地址栏中并回车打开，浏览器此时会自动为您下载一个专用的配置文件（通常为 .yaml 或 .json 文件）。

5. 打开您的代理客户端，选择“从本地文件导入”或直接将下载好的配置文件拖入软件中，即可完美绕过网络限制。

   ⚠️ 缺点提示：由于是静态配置文件，当后端线路更新或密码变更时，该文件无法自动实时更新。建议仅作为国内网络首次连通的破局手段。连通后，请尽快切回正常的动态订阅链接。

快速排查步骤

第一步：检查网络权限与核心连接（最常见原因）

大多数订阅更新失败，是因为客户端的系统代理或路由规则拦截了订阅链接本身的请求。

1. 完全关闭代理模式：将客户端的运行模式切换为 直连模式 (Direct)，或者直接完全退出代理客户端。
2. 检查网络连通性：在浏览器中直接打开您的订阅链接。
   • 如果浏览器能正常显示一长串代码或配置，说明节点服务器正常，请在直连状态下尝试再次更新。
   • 如果浏览器提示无法访问，请检查您的本地宽带网络，或尝试切换手机热点后再次尝试。

第二步：清理客户端缓存与配置

长时间运行客户端会导致本地 DNS 或路由缓存冲突，引发策略组更新失败。

1. 重启客户端：彻底关闭客户端进程（确保任务栏右下角图标完全消失）并重新打开。
2. 强制更新链接：请确保您在客户端内点击了**“更新订阅”或“同步测试”**按钮。如果软件长时间未刷新，即使官网节点已恢复，本地依然会维持失效的旧数据。

第三步：检查剪贴板权限（快捷导入失败时）

如果您使用的是“一键复制订阅”或“从剪贴板导入”，由于系统安全限制，客户端可能无法正确读取链接。

1. 手动复制：不要依赖一键导入，手动去网页后台选中完整的 https://... 订阅链接进行复制。
2. 检查系统权限：
   • iOS / Android：确保在系统设置中，已允许该代理客户端访问您的“剪贴板”。
   • Windows / macOS：直接在客户端的“订阅链接管理”输入框中，使用 Ctrl + V (或 Cmd + V) 手动粘贴。

第四步：核对节点格式与后端转换

不同客户端支持的协议格式（如 Shadowrocket、Clash、Sing-box）完全不同。

1. 确保版本适配：请确保您的客户端已升级到最新版本，老旧版本无法解析全新的 Vless / Reality 等现代协议。
2. 使用正确的订阅按钮：在官网用户中心复制时，请务必点击对应您客户端名称的专用导入按钮，切勿混用。

🛠️ 常见报错与对策