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

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