fn_b/docs/content/tutorials/quantumult-x-ios.md

100 lines
8.9 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Quantumult X 可以在 iPhone、iPad 上管理代理节点、选择策略并接管连接。第一次使用时,关键是把订阅变成客户端能读取的节点,再确认流量确实使用了选中的线路。
本文只讲 **Quantumult X**。Quantumult 是另一个应用,两者的界面和配置不能混用。这里也不涉及重写脚本、广告过滤或 HTTPS 解密,先完成基本连接即可。
<figure class="guide-diagram"><div class="diagram-label">从免费订阅到第一次连接</div><div class="guide-flow"><div><b>安装 Quantumult X</b><small>核对开发者与系统要求</small></div><span>→</span><div><b>导入节点资源</b><small>必要时使用资源解析器</small></div><span>→</span><div><b>选择节点与策略</b><small>确认请求的去向</small></div><span>→</span><div><b>开启连接</b><small>允许VPN配置并实际访问</small></div></div><figcaption>图 1 · 订阅导入、策略选择和VPN开关分别对应不同环节,缺少其中一步都可能无法使用。</figcaption></figure>
<nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">下载应用</a><a href="#format">选择订阅格式</a><a href="#parser">资源解析器</a><a href="#import">导入节点</a><a href="#connect">连接与验证</a><a href="#daily">日常使用</a><a href="#faq">常见问题</a></nav>
<h2 id="install">01 从 App Store 获取 Quantumult X</h2>
打开[Quantumult X 的 App Store 页面](https://apps.apple.com/us/app/quantumult-x/id1443988620),核对应用名和开发者 **Cross Utility Ltd**。这是付费应用,实际价格与是否可购买,以你使用的商店地区为准。
以 **1.8.1** 为例,系统要求为 **iOS 15.0 / iPadOS 15.0 或更高版本**。若当前商店搜索不到,不要把名字相近的应用当成同一个客户端;先核对商店是否提供该应用。
安装后先打开应用查看初始界面。不同版本的“节点资源”“策略”和连接开关位置可能略有变化,可按功能名称查找。
<h2 id="format">02 先看订阅是什么格式</h2>
在本站[免费节点页面](/freenode)中打开较新的分享。页面会提供不同格式的资源,但**目前不能把本站通用订阅直接视为 Quantumult X 原生订阅**。
| 手里的内容 | 如何处理 |
|---|---|
| 明确标注为Quantumult X节点资源 | 可按原生节点资源导入 |
| 本站v2ray订阅 | 需要能识别其内容的资源解析器,再导入节点 |
| Clash / Mihomo或sing-box完整配置 | 不要当成Quantumult X完整配置直接覆盖 |
| 普通文章网址 | 先进入文章,复制里面真正的订阅地址 |
“资源解析”主要解决格式转换,不会让失效节点恢复,也不能保证任意协议和参数都能转换。第一批导入失败时,先确认格式与解析器,不必立刻重装应用。
<h2 id="parser">03 通用订阅需要先配置资源解析器</h2>
通用订阅可通过 [KOP-XIAO 资源解析器](https://github.com/KOP-XIAO/QuantumultX)转换为 Quantumult X 能读取的节点资源。它是**第三方脚本**,并非 Quantumult X 内置功能。可以先在作者仓库查看说明和脚本内容,再决定使用。
在应用设置中找到当前配置的编辑入口。在已有的 `[general]` 区域内加入或修改这一项,保存配置:
```ini
[general]
resource_parser_url = https://raw.githubusercontent.com/KOP-XIAO/QuantumultX/master/Scripts/resource-parser.js
```
这里展示了节名,方便定位;已有 `[general]` 时,只放入其中的 `resource_parser_url` 这一行,不要重复建立整段,也不要把当前配置全部替换成这两行。若原来已经指定了其他解析器,先保留原配置副本,再决定是否更换。
解析器由客户端下载并在本地解析资源内容。这个路径仍需要设备能够访问;下载失败时先核对脚本地址和连接条件,不能把“已填入地址”当成“脚本已加载成功”。使用上面给出的解析器地址,避免误填其他示例脚本。
<figure class="guide-diagram"><div class="diagram-label">资源解析器做了什么</div><div class="guide-flow"><div><b>下载订阅内容</b><small>取得分享链接或节点列表</small></div><span>→</span><div><b>客户端运行解析器</b><small>转换支持的格式与参数</small></div><span>→</span><div><b>生成可用节点条目</b><small>随后再测试连接</small></div></div><figcaption>图 2 · 转换成功只表示客户端能读取节点。协议兼容性、节点是否在线和实际访问仍需分别检查。</figcaption></figure>
<h2 id="import">04 添加节点资源,并确认列表出现</h2>
复制本站较新分享中的 **v2ray 订阅地址**,进入 Quantumult X 设置中的节点资源或节点引用管理,添加远程资源:
1. 为资源填写一个容易辨认的名称,例如“本站免费节点”。
2. 粘贴实际订阅地址,启用该资源。
3. 对需要转换的通用订阅开启资源解析选项,再保存并更新。
4. 返回节点列表,确认出现了实际节点,而不是只有资源名称或错误提示。
如果当前版本界面入口不易辨认,也可以按开发者配置格式,在已有的 `[server_remote]` 区域加入资源行:
```ini
[server_remote]
https://example.invalid/subscription, tag=本站免费节点, opt-parser=true, enabled=true
```
**上面的地址是占位示例,必须换成从本站复制的真实订阅链接。** 已有节名时只加入资源行,保留原来的其他配置;不要同时在界面和配置中重复添加同一份资源。`opt-parser=true` 表示对这份资源调用解析器,`enabled=true` 表示启用资源。
原生 Quantumult X 节点资源通常不需要这个转换步骤。导入结果少于原订阅节点数时,可能存在解析器或客户端不支持的参数,应检查资源更新提示,不把条目数量当成连接质量。
<h2 id="connect">05 选择策略,再开启 VPN 连接</h2>
有了节点后,先选一条线路作为当前代理使用的节点。Quantumult X 的策略组负责选择节点,分流规则负责选择策略;具体名称取决于当前配置,导入一份节点资源不会自动生成你想要的全部分流规则。
首次排查可以暂时使用应用的**全局代理模式**,并确认其当前策略选中了实际节点,而不是 `direct` / 直连;先减少规则差异,确认这一条线路能够工作。完成验证后再切回规则分流,检查常用服务是否按预期选择策略。全局代理模式也不等于已经完成所有泄漏检查。
开启应用连接开关。首次连接时,iOS 会询问是否允许添加 VPN 配置,按系统提示允许并完成设备验证。基础代理使用不需要安装用于 HTTPS 解密的根证书。
连接后打开 Safari,访问实际需要的网页;再查看应用中的请求记录,确认目标域名、命中策略和节点。看到系统VPN标记只说明VPN配置在运行,并不能单独证明节点可达或目标服务可用。
<h2 id="daily">06 日常更新与停止使用</h2>
| 要做的事 | 建议操作 |
|---|---|
| 当前节点不通 | 在当前策略中换其他节点,再重新请求 |
| 订阅节点需要刷新 | 在节点资源管理中更新对应资源 |
| 旧批次普遍失效 | 回本站免费节点页面查看较新的分享,按需要更新资源地址 |
| 停止代理 | 关闭应用连接开关,并确认VPN已断开 |
| 启动后又自动连接 | 检查是否启用了按需连接及其他相关自动化设置 |
如果同时使用 Mac,可以继续看[Mac 客户端下载指南](/a/m172.html#download)。Mac 上的 Clash Verge Rev 需要对应的 Clash / Mihomo 订阅,不能把这篇教程的 Quantumult X 配置直接搬过去。
<h2 id="faq">07 常见问题</h2>
**订阅更新成功,为什么没有节点?** 核对导入的是节点资源而非文章页;对通用订阅,检查解析器是否成功下载,以及该资源是否开启解析。再看资源是否启用、内容是否为空或包含不支持的格式。
**节点有延迟,网页还是打不开。** 延迟检查只是一次特定请求;目标网站、出口策略或当前线路仍可能失败。查看实际请求记录,再尝试其他节点或另一个目标,分开判断节点和网站的问题。
**VPN已连接,但走的是直连。** 检查运行模式、命中规则与策略组选择。只更新订阅不会自动把现有的直连策略改为某个节点。
**别的教程让我导入完整配置。** 完整配置可能同时改变节点资源、规则、DNS、脚本和重写设置。本文只需要完成节点连接,导入前先看清它会覆盖哪些部分,保留自己的原配置。
<div class="guide-footnote">参考资料:<a href="https://github.com/crossutility/Quantumult-X/blob/master/sample.conf">开发者示例配置</a>、<a href="https://github.com/KOP-XIAO/QuantumultX/blob/master/Scripts/resource-parser.js">解析器作者源码</a>。</div>