Quantumult X 配置文件怎么导入?
简答:如果你只是想让 Quantumult X 识别节点,通常不必直接替换完整配置:先备份当前配置,再把节点订阅作为 [server_remote] 资源加入,最后检查节点、策略组和系统代理。Quantumult X 项目仓库提供了可核验的 sample.conf 示例,但它不是你的专属订阅,也不能证明任何节点当前可用。
定义:Quantumult X 配置文件是以 .conf 为主的文本配置,按 [general]、[dns]、[policy]、[server_remote]、[filter_remote] 等区块管理通用设置、节点订阅、策略与规则。
先分清:完整配置、节点订阅和规则资源不是一回事
搜索“Quantumult X 配置文件”时,最容易混淆的是三种资源:完整配置文件、节点订阅和规则资源。完整配置通常包含多个区块,可能同时改动 DNS、策略、节点和规则;节点订阅主要负责提供节点;规则资源则负责分流或重写。Quantumult X 的示例配置明确列出了 [general]、[policy]、[server_remote]、[filter_remote] 和 [rewrite_remote] 等区块,具体字段应以项目示例和当前版本为准。参考Quantumult X sample.conf。
| 资源类型 | 主要作用 | 导入前注意事项 | 导入后检查 |
|---|---|---|---|
| 完整配置文件 | 一次性设置多个配置区块 | 可能覆盖或改变现有配置 | 节点、策略、DNS、规则是否都符合预期 |
| 节点订阅 | 向 [server_remote] 提供远程节点资源 | 链接来源、格式和权限需自行核对 | 资源是否更新、节点是否出现 |
| 规则资源 | 提供分流或重写规则 | 不等于节点订阅,不能单独解决无节点问题 | 策略组是否引用了对应规则或节点 |
Quantumult X 项目示例还说明,远程资源可设置标签、更新间隔和启用状态;因此“导入成功”只代表资源被写入,不等于节点可连接或网页一定可访问。
最短导入流程:先备份,再添加资源
- 备份当前配置。先在 Quantumult X 中保留现有配置副本,至少记录当前节点、策略和自定义规则。停止条件:如果你无法确认当前配置在哪里恢复,不要直接导入完整配置。
- 确认资源类型。拿到的是完整
.conf文件,就按配置文件导入;拿到的是订阅链接,就优先作为远程节点资源添加,不要把订阅链接当作完整配置文件打开。 - 导入完整配置或添加远程资源。本地文件可通过 iOS 的“分享/打开方式”交给 Quantumult X;远程资源可在应用的配置或资源入口中添加。不同版本的界面名称可能变化,以当前应用显示为准。项目文档也提供了
add-resource与update-configuration两类 URL Scheme:前者保留已有资源,后者会替换已有远程资源,因此不确定时不要使用替换型入口。参考Quantumult X URL Scheme 文档。 - 保存后观察结果。检查配置是否能正常打开,确认
[server_remote]下是否出现资源标签,节点列表是否有内容。这里仅能证明配置或资源被读取,不能证明节点连通。 - 启用并验证。选择一个节点或策略组,开启 Quantumult X Tunnel,再用一个你平时访问的网页测试。若网页打不开,先关闭 Tunnel 回滚到备份配置,避免继续叠加修改。
Quantumult X 的项目示例展示了 [server_remote] 的基本写法,例如“远程地址 + tag 标签”,并支持 enabled、update-interval 等参数。不要照抄示例中的域名、标签或测试节点到实际使用中,它们只是格式示例。参考项目 sample.conf。
节点订阅怎么写进配置文件?
如果你已有服务商提供的订阅地址,核心是把它放在 [server_remote] 区块,而不是随意粘贴到 [general] 或 [policy]。一个仅展示格式的写法如下:
[server_remote]https://example.com/subscription, tag=我的订阅, enabled=true
上面的域名是占位符,不能直接使用。tag 用于识别资源,enabled=true 表示启用该资源;是否需要 opt-parser、as-policy 或其他参数,要看订阅返回格式和当前版本支持情况。项目示例确认了 [server_remote] 支持远程资源地址、标签和启用状态,但没有替你的订阅验证协议、节点数量或当前可用性。
如果资源能更新但节点仍为空,可能是订阅返回内容不是 Quantumult X 能解析的节点格式,也可能需要资源解析器。此时先查看 Quantumult X 的资源更新结果或错误提示,不要仅凭浏览器能打开订阅地址就判断订阅有效。
导入后节点为空、策略组为空或连接失败:按现象分流
| 现象 | 先检查什么 | 停止条件与下一步 |
|---|---|---|
| 配置文件打不开 | 文件是否为纯文本、区块名和括号是否完整 | 若应用提示解析错误,恢复备份后逐段删除最近加入的内容 |
| 资源更新失败 | 链接是否需要登录、是否被截断、是否能返回文本 | 浏览器能打开不等于应用能解析;查看应用资源更新提示 |
| 节点列表为空 | [server_remote] 是否启用、返回格式是否兼容 | 先不要修改 DNS 或策略,优先确认订阅内容本身 |
| 策略组为空 | [policy] 是否引用了正确的节点标签 | 节点存在但策略为空时,检查标签拼写和策略引用关系 |
| 已连接但网页打不开 | 系统 Tunnel、节点状态、DNS 和分流规则 | 单个网页成功不等于所有流量可用;先切换直连或备份配置验证 |
Quantumult X 示例配置说明,策略可以使用静态、可用性或延迟基准等方式选择节点,也支持单独设置检查地址。延迟测试结果只反映特定测试请求的响应情况,不能直接等同于长期速度或所有网站可用性。参考策略与节点检查说明。
哪些设置不要一开始就打开?
MITM、重写和脚本不是导入节点的必需条件。Quantumult X 的应用说明和项目仓库都把 MitM、HTTP 重写、脚本任务作为独立能力描述;如果你的目标只是导入节点并建立基础连接,可以先不启用这些功能。参考App Store 中的 Quantumult X 应用说明。
尤其不要为了“让配置更完整”而直接启用陌生脚本、证书或重写规则。先确认来源、用途和是否需要,再单独开启;如果开启后出现网页异常、证书提示或应用行为变化,回滚到未启用相关模块的配置。本文不提供未经核验的第三方脚本、证书或所谓一键配置。
适用范围与核验边界
本文面向已安装 Quantumult X 的 iPhone、iPad 或其他 App Store 列出的兼容 Apple 设备。App Store 页面显示该应用由 Cross Utility Ltd 发布,并列出 iPhone、iPad、Mac 和 Apple TV 兼容信息;具体系统要求与当前版本应以设备端 App Store 页面为准。参考App Store 产品页。
本文不提供实时节点、价格、测速、可用率或某个服务商的有效性结论;也不把示例配置文件当作可直接使用的订阅。配置导入成功、节点显示、Tunnel 已连接和网页可访问,是四个不同的核验层级,应分别观察。
本站是第三方使用指南站,不是 Quantumult X 官方站点;品牌版本、功能和入口以应用内显示及相关项目资料为准。
结论
最稳妥的做法是:先备份,再区分完整配置与节点订阅;仅需添加节点时优先使用 [server_remote],保存后分别检查资源更新、节点出现、策略引用和网页访问。遇到问题时先回滚,再按格式、订阅、标签、策略和连接顺序排查。
如果你正在处理跨境办公中的延迟、丢包、DNS 或客户端连接问题,可使用边界云加速的网络诊断服务,把配置问题与线路问题分开核验。
常见问题
Quantumult X 配置文件一般是什么格式?
常见是纯文本 .conf 配置,按 [general]、[dns]、[policy]、[server_remote] 等区块组织内容。具体字段和协议写法应以项目示例及当前版本为准。
导入完整配置会不会覆盖原来的设置?
有可能改变现有配置,因此应先备份。使用替换型配置或资源更新入口前尤其要确认其行为;不确定时优先采用保留已有资源的添加方式,并保留恢复副本。
为什么订阅链接能在浏览器打开,但 Quantumult X 里没有节点?
浏览器能打开只说明链接返回了某种内容,不代表 Quantumult X 能解析。请检查 [server_remote] 是否启用、返回格式是否兼容、资源是否需要解析器,以及应用内是否显示更新错误。
策略组为空但节点列表有内容怎么办?
检查 [policy] 中引用的节点标签是否与实际节点或资源标签一致。节点存在与策略组能正确引用是两个独立问题。
必须开启 MITM 才能使用配置文件吗?
不必须。仅导入节点并建立基础连接时,通常可以先不启用 MITM、重写和脚本;只有明确需要相关功能并核对来源后再单独开启。