QuantumultX 中文教程:用懒人配置一键同步脚本与分流规则
2026-09-12发表于
编程语言一、这个项目是什么
入门
很多刚接触代理工具的人会卡在同一个地方:软件装好了,但里面是空的,不知道规则从哪来,也不知道脚本怎么填。
这个仓库 w37fhy/QuantumultX 解决的正是这个问题。它不是一个需要你从零开发的脚本项目,而是一个配置与脚本的中转站:作者把网上大佬们维护的脚本、分流规则、签到任务收集起来,整理成可以直接导入的“懒人配置”。
懒人配置可以理解成一份打包好的菜单:你不需要自己研究每道菜怎么做,直接整桌端进软件里用。
仓库主要通过 JavaScript 来配合定时任务和签到脚本,但对使用者来说,你基本不需要看懂代码。
二、开始之前需要准备什么
入门
在导入任何配置之前,你需要先确认自己手里有对应的工具。
这个仓库的配置主要面向三类软件:
- Quantumult X:iOS 上常用的代理工具,也是本项目的主力适配对象
- Shadowrocket:俗称小火箭,同样是 iOS 工具
- Surge:功能更强、上手门槛也更高的 iOS 代理工具
同时,你需要一台能正常访问互联网的 iPhone 或 iPad,以及一个已经购买好的代理服务,也就是常说的“机场”。机场提供给你的是一串订阅链接,里面包含节点信息。
配置文件和节点订阅是两回事:节点订阅决定“你能连到哪些服务器”,懒人配置决定“连上之后流量怎么分流、脚本怎么跑”。所以两者都需要准备。
三、Quantumult X 配置怎么导入
入门
Quantumult X 的配置分为新版和旧版两条路线,选择哪条取决于你的手机系统。
如果你使用 iOS 14 及以上,通常走新版路线。
新版 Quantumult X 支持 gallery 订阅和 URL 测速,配置入口更直观。操作思路如下:
打开 Quantumult X
→ 点击底部「设置」
→ 找到「配置文件」相关选项
→ 选择「下载」或「添加」
→ 粘贴配置链接
→ 下载完成后保存
配置链接不要手动逐字输入,建议先在浏览器里打开确认能访问,再复制完整 URL。
新版配置列表:
主配置:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/QuantumultX_diy.conf
京东系列签到任务:
https://cdn.jsdelivr.net/gh/shufflewzc/faker@main/qx.json
除京东以外的签到任务:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/QuantumultX_Task.json
主配置负责策略组和分流规则,后面两个负责定时签到与脚本任务。
如果你还在用 iOS 14 以下的老设备,就选旧版配置。
旧版懒人配置:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/w37fhy_diy.conf
旧版主要是因为老系统不支持 Task_gallery 这类新功能,所以作者保留了兼容版本。
四、Shadowrocket 也能用
入门
不只有 Quantumult X 用户能受益。如果你手机上装的是 Shadowrocket,这个仓库同样提供现成配置。
Shadowrocket 的懒人配置地址是:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/shadowrocket_diy.conf
这份配置包含策略组和分流规则,并针对 TikTok 做了区域分流。导入思路和 Quantumult X 类似:
复制配置链接
→ 在 Shadowrocket 中添加订阅
→ 选择使用配置
→ 再填入你的机场节点订阅
另外,仓库还提供了四个 TikTok 解锁模块,分别对应日本、台湾、韩国和美国。
日本:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/TikTok_ShadowRocket/JP.conf
台湾:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/TikTok_ShadowRocket/TW.conf
韩国:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/TikTok_ShadowRocket/KR.conf
美国:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/TikTok_ShadowRocket/US.conf
这些模块是给需要观看特定地区 TikTok 内容的用户准备的。将它们理解成一种“地域解锁补丁”即可。
五、Surge 配置怎么用
进阶 · 推荐细读
Surge 的配置作者只提供了一个精简版:
https://raw.githubusercontent.com/w37fhy/QuantumultX/master/surge_lite.conf
这份精简版只包含策略组和分流规则。
注意:它不包含重写规则和定时任务,这两个部分需要你根据自己的需求另外添加。
因此,Surge 用户导入后通常还需要做两件事:
1. 添加自己的节点订阅
2. 按需补充重写和脚本任务
如果你刚开始用 Surge,建议先导入这份配置了解基础分流逻辑,再逐步添加其他模块,不建议一上来就堆大量脚本。
六、常见问题与注意事项
入门
仓库不负责维护脚本
这是最需要留意的点。作者在 README 中明确说明:这里只是搬运和同步更新大佬脚本,不负责维护脚本本身。
也就是说,脚本如果失效、报错或与最新版工具冲突,仓库作者不一定能修复。你需要等待上游脚本作者更新,或者自己寻找替代脚本。
大部分脚本只测试了作者自用部分
作者只对自己日常使用的脚本做测试,其他大部分脚本并没有一一验证可用性。
所以不要把仓库里的内容当成“全部经过严格测试的稳定集合”。遇到某个脚本不生效时,常见处理方式是:
先单独关闭该脚本
→ 观察其他功能是否正常
→ 再决定是否继续使用
配置更新有滞后性
README 中标注的更新日期停留在 2022 年左右。虽然配置链接可能仍然有效,但部分规则可能已经跟不上现在的网络环境。
建议不要把懒人配置当成永久方案。使用一段时间后,可以逐渐学会查看分流规则、替换失效脚本。

七、适合哪些人使用
进阶 · 推荐细读
这个仓库最适合以下场景:
刚接触 Quantumult X,不想从零写配置
想快速获得一套策略组和分流规则
需要签到脚本,但不想自己维护
需要 TikTok 区域解锁模块
如果你已经是进阶用户,喜欢自己控制系统里每一条规则,这个仓库对你的价值会小一些。它更偏向“开箱即用”,而不是高度可定制。
另外,由于作者提供的主要是 Quantumult X 和 Shadowrocket 配置,Surge 用户只能拿到一个精简起点,所以 Surge 重度用户可能需要结合其他配置源一起使用。
八、获取更新和帮助
入门
项目的主要更新通知放在 Telegram 频道。
https://t.me/w37fhy
视频教程则发布在 YouTube 上,包括 Quantumult X、Surge 和分流策略科普系列。对于不太擅长阅读文字配置的用户,视频教程会比纯文本更直观。
需要强调的是,这类配置分发项目通常不提供一对一技术支持。遇到问题时,建议先在评论区或相关社区搜索类似情况,看是否已经有人给出解法。
项目信息
| 项目 | 值 |
|---|---|
| 仓库 | w37fhy/QuantumultX |
| 语言 | JavaScript |
| Star | 5,915 |
| Fork | 668 |
| 主页 | 无 |
参考链接
延伸阅读
想继续探索?这些同领域的教程可能也适合你:
129
72
1
1475
文章目录
评论