Quantumult X 与 sing-box 订阅配置教程：导入路径与常见问题

先确认订阅格式

这两个客户端的导入失败，九成出在格式上。开始之前先到机场用户面板确认提供哪些格式：

客户端	首选格式	退而求其次
Quantumult X	QX 专用格式	通用订阅（Base64）
sing-box 系	sing-box 格式	通用订阅（部分客户端可解析）

不要用第三方在线转换工具补格式——把订阅链接粘贴到别人的网站，等于把套餐凭证交出去，风险说明见订阅链接与账号的安全保存。正确做法是选一家提供对应格式的机场，完整对照见客户端兼容性总表。

Quantumult X：用「引用」管理订阅

圈 X 把订阅叫做引用（resource），这是它与其他客户端最大的概念差异。理解了这一点，其余操作就不难。

导入步骤：

1. 在机场用户面板复制订阅链接（优先 QX 专用格式）；
2. 打开圈 X → 设置 → 节点 → 引用；
3. 添加订阅地址，保存后执行更新；
4. 回到首页，选择节点并开启连接。

几个要点：

• 分流规则也是引用。节点引用与规则引用是分开的，只导入节点不会自动获得分流规则，需要另外添加规则引用（多数机场会提供）；
• 更新不是自动的：在引用列表里手动更新，或开启后台自动更新；
• 首次连接需要允许创建 VPN 配置，这是 iOS 的标准机制。

sing-box：优先用机场下发的完整配置

sing-box 的定位更接近「内核」而不是「成品客户端」，它的配置文件包含出站、路由、DNS 等完整定义。

• 有 sing-box 格式订阅时：直接导入，配置齐全，开箱即用；
• 只有通用订阅时：部分基于 sing-box 内核的客户端（如 Hiddify）能够兼容解析节点，但路由与 DNS 部分可能缺失，表现为「能连上但分流不对」；
• 自己写配置：可行但门槛高，且各版本字段有差异，应以官方文档为准而不是网上的旧配置片段。

新手不建议从 sing-box 入手。它的优势是对新协议的跟进速度和配置灵活度，代价是排查问题时需要读懂配置结构。想省心就从 Clash 系客户端开始，见 Clash Verge Rev 基础使用教程。

导入失败的排查顺序

两个客户端通用：

1. 用浏览器直接打开订阅链接——能拿到内容说明问题在客户端侧，拿不到就是链接或面板的问题；
2. 确认格式匹配：拿 Clash 订阅喂圈 X、拿通用订阅喂 sing-box 都可能失败；
3. 确认链接完整：复制时缺失结尾字符是高频错误；
4. 确认套餐状态：到期或流量耗尽时，多数面板会停止返回节点内容；
5. 仍不行时按订阅更新失败的完整排查方法继续。

该不该用这两个客户端

你的情况	建议
只想导入订阅、切节点	用 Shadowrocket 或 Clash 系
需要精细分流、重写、脚本	Quantumult X
想用最新协议、愿意读配置文档	sing-box 系
排查问题时希望资料最多	Clash 系（生态最成熟）

客户端只决定操作是否顺手，决定体验上限的仍然是机场的线路质量。其他平台的配置入口见新手教程栏目。