浏览器本地运行
工具:订阅导入诊断向导
选择现象获取最小排查步骤。
使用说明
此工具的输入只保留在当前页面内存中。刷新或离开页面会丢失结果;本站没有提交按钮、账户或后台记录。遇到真实订阅问题,请只分享脱敏后的必要现象。
补充更新:订阅导入失败的分层排查顺序
简答:导入失败不要先反复重装:先确认链接或二维码来源、完整性和授权状态,再判断是手机网络、客户端兼容性还是系统权限问题。本站是第三方技术博客,不是任何客户端或服务的官网;下面的顺序适用于 Android 与 iPhone 用户。
定义:订阅导入是客户端读取订阅链接、二维码或配置文件,并将其中的节点或连接配置保存到本地配置列表的过程。
先试这一步:用四层检查表定位问题
先记录你卡住的具体位置:是扫码后没有反应、粘贴链接后提示错误、导入成功但更新失败,还是连接后应用仍无法联网。不要直接删除全部配置,因为原始提示和日志通常是判断问题类型的重要证据。
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 扫码后无反应或内容为空 | 相机权限、二维码清晰度、二维码实际内容 | 重新授权相机;用系统相机或文本识别确认是否读出了链接或配置文本 |
| 提示 401、Unauthorized 或未授权 | 链接是否完整、是否过期、是否仍有访问权限 | 不要先换网络;重新复制原始链接,仍为 401 时联系提供方核验授权 |
| 提示证书无效或 TLS 错误 | 系统日期时间、域名、证书信任链 | 先开启自动设置日期与时间,再确认链接域名未被截断;不要在不明来源下安装证书 |
| 提示连接超时 | 当前 Wi-Fi 或蜂窝网络、DNS、客户端是否能访问该地址 | 分别在 Wi-Fi 与蜂窝数据下测试;记录错误原文和发生时间 |
| 导入成功但更新失败 | 更新地址、授权状态、客户端网络权限 | 打开配置详情查看更新地址;只对照测试一次,不要连续点击更新 |
| 连接后只有部分应用可用 | 规则、分流、应用权限或系统 VPN 状态 | 先确认客户端显示已连接,再用一个浏览器页面和一个应用交叉验证 |
表中的“401”属于授权层返回信号;RFC 9110 将 401 定义为需要认证的响应,并区分了代理认证相关的 407,因此这类错误应优先核验链接和权限,而不是把换网络当作主要解决办法。可查看 RFC 9110 HTTP 语义 的状态码说明。
手机端照做:链接、二维码与文件分别怎么查
- 先脱敏记录。只保留错误类型、客户端名称、手机系统版本、Wi-Fi 或蜂窝数据、发生时间;不要把真实订阅链接、二维码、UUID、密码或完整日志发到公开页面。
- 检查链接是否被破坏。从原始来源重新复制一次,确认没有少掉开头协议、末尾参数或中间换行。若链接来自聊天软件,先粘贴到纯文本编辑框观察是否被自动换行或截断。
- 检查二维码实际内容。二维码扫出来应当是客户端能够识别的链接或配置内容;如果只是一串普通文字,先不要把它当作订阅导入。可以仅在本地查看前缀和长度,不要把完整内容上传到在线解析网站。
- 检查文件来源和格式。文件导入失败时,保留原文件副本,确认文件没有被聊天软件改名、压缩或截断。客户端是否支持某种配置格式,必须以该客户端的发布说明或帮助文档为准;无法核实的格式兼容性不要强行导入。
- 做一次对照测试。同一链接只在另一款明确支持该格式的客户端中测试一次。如果另一客户端也失败,更像是链接、授权或服务端问题;如果只有当前客户端失败,则重点查看客户端版本、导入格式和日志。这是排查思路,不代表任何特定客户端一定兼容。
如果你使用的是 iPhone,系统配置描述文件可以在“设置”>“通用”>“VPN 与设备管理”中查看;删除描述文件会同时删除与其关联的设置、App 和数据,操作前应先确认是否需要保留。相关入口可参阅 Apple 官方 iPhone 配置描述文件说明。
如果你使用的是 Android,VPN 客户端需要获得系统 VPN 权限;Android 官方开发文档说明,系统同一用户或工作资料中只能有一个活动的 VPN 服务,启动新的 VPN 服务可能会停止已有服务。因此,排查时应先关闭其他正在运行的 VPN 或网络隧道应用,再重新授权当前客户端,可参阅 Android Developers VPN 文档。
Android 与 iPhone 的权限排查
Android:先看 VPN 权限,再看后台和数据限制
- 打开目标客户端,重新发起连接或导入操作;出现系统 VPN 权限提示时,确认授权对象是当前正在使用的客户端。
- 进入“设置”>“应用”>目标客户端,检查“移动数据和 WLAN”或类似网络权限。不同厂商菜单名称可能不同,找不到时使用系统设置搜索“数据使用”或“电池”。
- 如果问题只发生在蜂窝数据,检查“数据节省程序”。Google 的帮助文档说明,Android 不同版本的设置路径可能不同;在支持该入口的设备上,可从“设置”>“网络和互联网”>“数据使用情况”>“数据节省程序”>“不受限制的数据访问”检查目标应用。可参阅 Google 官方后台数据说明。
- 如果锁屏后断开,先暂时关闭“省电模式”复现一次。Android 官方说明,省电模式可能限制或关闭后台活动,并使部分网络连接和应用出现延迟;具体电池菜单以手机厂商系统为准,可参阅 Android 官方电池帮助。
- 最后再查看“设置”>“应用”>目标客户端>“电池”中的后台限制。不要把“后台不受限制”当成所有 Android 手机的统一名称;如果系统没有该选项,应以厂商提供的电池管理入口为准。
iPhone:确认描述文件、VPN 状态和蜂窝数据权限
- 打开“设置”>“通用”>“VPN 与设备管理”,确认是否存在旧的配置描述文件或不再使用的 VPN 配置。删除前先确认其来源和用途。
- 打开“设置”>“蜂窝网络”,向下找到目标客户端,确认允许使用蜂窝数据;然后分别在 Wi-Fi 和蜂窝数据下测试一次。
- 查看“设置”中的 VPN 状态,确认实际连接的是当前客户端,而不是另一款 VPN 或系统配置。Apple 文档说明,VPN 配置可以通过配置描述文件或相应的 VPN App 管理,具体支持方式取决于配置类型,可参阅 Apple 官方 VPN 设备管理概览。
错误代码与联系支持前的最小证据包
401 或 Unauthorized:先确认链接完整、没有过期或被撤销,再联系提供方核验授权。不要通过反复切换 Wi-Fi 和蜂窝数据来替代授权检查。
证书无效:先检查系统日期和时间是否自动设置,确认访问的域名没有被截断;如果客户端要求安装证书,必须先核对来源和用途。Apple 的 VPN 配置说明强调,服务器证书和证书颁发机构需要有效且受信任,可参阅 Apple 官方 VPN 代理和证书配置说明。
Connection timeout 或请求超时:分别记录 Wi-Fi、蜂窝数据下的结果,并保留错误发生的时间。HTTP 408 表示服务器在等待时间内没有收到完整请求,但客户端日志中的“timeout”也可能来自 DNS、网络路径或连接阶段,因此不能仅凭一行文字判断故障位置;可参阅 RFC 9110 状态码说明。
联系支持前准备以下内容:
- 手机系统类型与版本;版本号以设备“关于本机”页面为准。
- 客户端名称和安装来源;不要把无法核实的来源称为官方。
- 导入方式:链接、二维码还是文件。
- 完整错误原文、出现时间、Wi-Fi 或蜂窝数据环境。
- 已经尝试过的步骤,以及是否在另一款明确支持该格式的客户端中对照测试。
日志只截取与错误相关的几行,并遮住订阅地址、节点地址中的敏感参数、账号、密码、UUID 和令牌。若无法脱敏,宁可只提供错误类型和复现步骤。
什么时候停止继续尝试
出现以下任一情况时,建议停止反复导入:同一链接持续返回 401;链接来源无法确认;二维码包含未知配置或要求安装不明证书;导入后客户端反复要求 VPN 权限但无法建立连接;或者你已经清空配置却没有保存错误原文。此时最有效的做法是保留脱敏证据,向链接或配置提供方核验授权、格式和服务端状态。
本页工具只在浏览器本地生成排查顺序,不需要上传真实订阅内容。刷新或离开页面后,当前结果可能丢失;排查时仍应遵守最少分享原则。
常见问题
二维码扫出来是一串文字,能直接导入吗?
不一定。先确认文字是否为客户端支持的链接或配置内容;如果只是普通说明文字、短码或未知格式,不要直接当作订阅导入,也不要上传到在线解析网站。
订阅导入提示 401,换一个网络有用吗?
通常不应把换网络作为第一步。401 表示请求需要认证,先重新复制完整链接、确认链接未过期或被撤销;仍然返回 401 时,联系链接或配置提供方核验授权。
Android 后台断开,是否一定要把电池设置成“不受限制”?
不一定。Android 不同厂商和版本的菜单名称与策略不同。先关闭省电模式复现,再检查目标客户端的后台限制、蜂窝数据权限和数据节省程序;没有“不受限制”选项时,以手机厂商系统入口为准。
同一个链接在另一款客户端能导入,当前客户端不能导入,说明链接一定没问题吗?
不能完全说明。它只能表明该链接在另一款客户端的格式或兼容性检查中通过;当前客户端仍可能存在格式不支持、版本差异、权限或更新地址处理差异。应保存两款客户端的错误原文,再按客户端文档核对。
什么时候应该重装客户端?
重装不是首选。先保存错误原文和配置来源,确认链接、权限、网络和格式都没有明显问题;只有在客户端安装损坏或官方文档明确建议重装时,才考虑重装,并先确认配置是否能够重新获取。