Quantumult X 一键去广告开源配置:自动聚合、更新并本地化常用去广告规则,导入即可使用,也可以完全按自己的需求定制。
QX-Config-Sync 不只是一套“配置同步脚本”。它首先是一份面向日常使用的 Quantumult X 去广告配置(插件集合),帮助你减少 App 开屏、信息流、网页和视频场景中的常见广告;自动同步能力则负责让这份配置持续更新、稳定可用。
不想研究规则语法?直接使用生成好的配置。想自己掌控?Fork 后只维护一份 config.yaml,剩下的交给 GitHub Actions。
- 一键启用常用去广告规则:集中管理 App、网页、视频等场景的分流与重写规则。
- 覆盖常见应用场景:项目当前整合了微博、知乎、小红书、哔哩哔哩、高德地图、网易、百度网盘、YouTube、Spotify 等相关规则。
- 每天自动更新:默认每天北京时间 06:00 拉取最新底包和上游规则,无需手动追更。
- 把远程规则保存到自己的仓库:降低上游链接失效、限速或变更带来的影响。
- 保留完整控制权:所有配置和规则公开可见,可增删、替换、审查,不依赖封闭服务。
- 不仅能去广告:同时支持自定义分流、策略组、DNS、MITM、重写和定时任务。
去广告效果取决于上游规则、App 版本和 Quantumult X 的 MITM 配置,无法保证覆盖所有广告。部分 HTTPS 重写规则需要安装并信任 Quantumult X 证书后才会生效。
适合只想快速获得去广告配置、不准备维护规则的用户。
-
先备份你当前的 Quantumult X 配置。
-
复制下面的配置地址:
https://raw.githubusercontent.com/suversal/qx-config-sync/main/MyQuantumultX_Local.conf -
在 Quantumult X 中打开配置文件管理,选择“下载配置”,粘贴地址并导入。
-
如需使用 HTTPS 重写规则,请在 Quantumult X 中生成、安装并信任 MITM 证书。
MyQuantumultX_Local.conf 会优先引用本仓库保存的规则文件,适合日常使用。导入完整配置可能替换你现有的策略与分流,因此第一步请务必备份。
适合需要添加节点订阅、调整策略组或选择去广告插件的用户。
-
点击右上角 Fork,把仓库复制到你的 GitHub 账号。
-
编辑
profiles/config.yaml:- 在
rewrite_remote中启用、移除或添加去广告插件。 - 在
local_filters中维护自己的分流规则。 - 在
policy中调整策略组。 - 如需节点,在安全环境中配置
server_remote。
如果仓库是公开的,请勿提交带有 Token 的机场订阅地址或其他敏感信息。
- 在
-
在仓库的
Settings→Secrets and variables→Actions中添加:Secret 是否必需 用途 URL_RAW_PREFIX推荐 https://raw.githubusercontent.com/你的用户名/qx-config-sync/main/rulesTELEGRAM_BOT_TOKEN可选 Telegram 构建通知的 Bot Token TELEGRAM_CHAT_ID可选 接收构建通知的 Chat ID -
打开仓库的
Actions,启用工作流后进入QX Builder,点击Run workflow完成第一次构建。 -
构建成功后,将你仓库中的
MyQuantumultX_Local.confRaw 地址导入 Quantumult X。
之后 GitHub Actions 会每天自动更新;有变化时,生成结果和本地化规则会自动提交回你的仓库。
完成配置导入、证书安装和功能开关后,HTTPS 去广告规则才能正常工作。不同版本的 Quantumult X 和 iOS 界面可能略有差异,请以实际显示为准。
打开 Quantumult X,点击右下角的风车图标进入设置页面。
滑动到页面底部的“配置文件”区域,可以看到两种导入方式:
- 下载配置:粘贴远程地址,直接下载并导入配置。
- 导入配置:从 iPhone 本地选择已经下载的配置文件。
建议先尝试“下载配置”,使用本项目的本地化配置地址:
https://raw.githubusercontent.com/suversal/qx-config-sync/main/MyQuantumultX_Local.conf
如果当前网络无法访问 GitHub Raw,可以先在电脑或浏览器中下载 MyQuantumultX_Local.conf,发送到 iPhone 后再选择“导入配置”。
导入完整配置可能替换现有的策略组、分流和重写设置,请先备份当前配置。
部分去广告规则需要处理 HTTPS 请求。Quantumult X 只有在安装并信任 MitM 证书后,才能按照规则解密和修改指定域名的 HTTPS 请求与响应。
MitM 证书权限较高。请只安装由你自己的 Quantumult X 生成的证书,不要安装来历不明的描述文件,也不要向他人分享证书或私钥。
-
在 Quantumult X 设置页面进入
MitM,点击“生成证书”。 -
点击“配置证书”,在弹窗中确认继续。
-
跳转到 Safari 后,点击“允许”下载描述文件。
-
Safari 提示描述文件已下载后,返回 iPhone 主屏幕。
-
打开 iOS“设置”,点击“已下载描述文件”。如果没有看到该入口,可前往“通用”→“VPN 与设备管理”查找。
-
选择 Quantumult X 描述文件并完成安装。系统会要求输入锁屏密码并再次确认。
-
安装完成后,打开“设置”→“通用”→“关于本机”。
-
滑动到页面底部,进入“证书信任设置”。
-
找到刚安装的 Quantumult X 根证书,开启完全信任。
返回 Quantumult X 设置页面,同时打开“重写”和 MitM 开关。
最后回到主页面,确认右上角的总开关已经开启,让 Quantumult X 接管网络流量。随后可以重新打开常用 App,检查广告拦截效果;已经缓存的广告可能需要重启 App 或等待缓存更新后才会消失。
更换完整配置后,请重新检查证书信任、“重写”、
MitM和主开关是否仍处于开启状态。
操作流程参考:iPhone 通过 Quantumult X 去广告教程。
- 默认配置已经整合常用去广告、分流和重写规则,可以直接导入使用。
- 集中管理 App 开屏、信息流、网页、视频等场景的规则,不必到处寻找和拼接插件。
- 所有规则和最终配置公开可见,可以随时审查、增删或替换,不依赖封闭服务。
- GitHub Actions 每日自动运行,无需你手动操作。
- 自动拉取最新底包、同步上游规则并生成最新配置。
- 检测到变化后自动提交回你的仓库,让日常使用的配置持续更新。
- 构建成功:显示本次下载了多少规则、哪些文件发生变化。
- 构建失败:直接推送错误信息,不必先去 GitHub Actions 中翻找日志。
- 配置有变化时会提醒,无变化时也会报告当前状态。
- 支持 HTML 格式消息,仓库、提交、统计和错误信息更清晰。
- 自动遍历配置中的
filter_remote和rewrite_remote远程链接。 - 自动将能够下载的规则文件保存到你自己的 GitHub 仓库。
- 自动把配置中的原始链接替换成你仓库的 Raw 链接。
- 降低上游链接失效、服务器限速、地址变更或 CDN 异常对配置可用性的影响。
- 核心理念仍然是:「底包 + 你的增量配置 = 最终可用配置」。
- 只需维护一份较小的
profiles/config.yaml,只写你与底包不同的部分。 - 不需要反复复制粘贴或手动维护几千行完整配置。
- 更新底包时重新注入你的自定义规则、策略、节点和重写,保留个性化设置。
- 支持按关键词删除底包中不需要的内容。
- 可以清理不需要的策略组、DNS 或分流规则,让最终配置更精简。
- 同时支持黑名单和白名单两种过滤策略。
- 自定义远程分流和重写规则会优先插入,确保个性化规则具有更高匹配优先级。
- 本地分流支持两种位置模式:
top:插入最前面,适合需要优先匹配的自定义规则。bottom:插入最后面,适合 GeoIP、兜底等低优先级规则。
- 策略映射:把第三方规则中的策略名(例如
us-node)自动替换成你自己的策略组名称。 - MITM 智能追加:合并底包与自定义 Hostname,避免直接覆盖原有 MITM 配置。
- 模块化管理:支持通过
file://把分流、重写和 Hostname 拆分到独立文件中维护。 - KV 配置覆盖:按需覆盖
general、mitm、http_backend等配置项。 - 下载间隔保护:每次下载后等待 1 秒,降低请求过于频繁而被上游限制的概率。
- 单项失败兼容:某个远程文件下载失败时保留原链接并继续构建,不让单个上游故障拖垮整份配置。
- 双配置输出:同时生成保留原始链接的
MyQuantumultX.conf和优先使用本地规则的MyQuantumultX_Local.conf。
qx-config-sync/
├── .github/workflows/
│ └── build.yml # GitHub Action 自动构建配置
├── profiles/
│ └── config.yaml # 👈 你的核心配置文件(改这里!)
├── images/ # README 使用的 Quantumult X 操作截图
├── rules/ # 存放本地化后的规则文件
│ ├── filter_remote/ # 本地化后的远程分流规则
│ └── rewrite_remote/ # 本地化后的远程重写规则
├── src/
│ ├── main.py # 主程序入口
│ └── qx_core.py # 核心处理逻辑
├── MyQuantumultX.conf # [生成] 最终原始配置文件
├── MyQuantumultX_Local.conf # [生成] 本地化后的配置文件(所有规则都存在你仓库,推荐用这个)
└── README.md如果你想在自己电脑上运行:
- Python 3.9+
- 安装依赖:
pip install -r requirements.txtpython src/main.py生成了两个配置文件,两个都可以直接导入 Quantumult X 使用:
| 配置文件 | 说明 | 推荐使用场景 |
|---|---|---|
MyQuantumultX.conf |
保留所有规则的原始远程链接,只合并你的配置,不下载规则到本地 | 原链接都稳定可用,想保持最小仓库大小 |
MyQuantumultX_Local.conf |
所有可下载的远程规则都已经下载到你自己的仓库,链接也替换成你的仓库地址 | 担心原链接失效、原链接限速,想要更稳定的体验 |
💡 如果使用原始链接时发现部分规则加载失败,直接切换到
MyQuantumultX_Local.conf就能解决问题。
profiles/config.yaml 是你唯一需要维护的文件,下面逐段解释每一部分怎么用:
base:
url: "https://ddgksf2013.top/Profile/QuantumultX.conf"作用:你的整个配置基于这个"底包"来修改,底包一般是大佬维护好的完整配置,你只需要增量修改它。
推荐:默认已经填好了 ddgksf2013 的底包,直接用就好。
patches:
policy:
keywords:
- "Hijacking" # 删除所有名字里带 "Hijacking" 的策略组
- "广告" # 删除所有名字里带 "广告" 的策略组作用:在注入你的配置之前,先把底包里你不想要的内容删掉,让配置更干净。
用法:
patches.策略组名称:你要清洗哪个段落(比如policy就是策略组段落)keywords:列出你要删除的内容包含的关键词
general:
geoip-url: "https://github.com/Hackl0us/GeoIP2-CN/raw/release/Country.mmdb"
resource_parser_url: "https://raw.githubusercontent.com/KOP-XIAO/QuantumultX/master/Scripts/resource-parser.js"作用:这里配置 Quantumult X 的全局参数,会强制覆盖底包里的对应参数。
常用配置:
geoip-url: 更新 GeoIP 数据库(解决底包数据过时问题)resource_parser_url: 资源解析器地址server_check_url: 节点测速地址
dns:
- "server=/suversal.com/192.168.1.1" # 你的内网域名走内网 DNS作用:添加自定义 DNS 规则。
policy_map:
us-node: "美国节点" # 外部规则叫 us-node → 实际走你配置的「美国节点」策略组
direct: "direct"
reject: "reject"作用:当你引用第三方远程规则时,第三方规则里的策略名需要映射到你自己的策略组名字,这里就是做这个映射的。
用法:"第三方规则里的名字": "你自己策略组的名字"
policy:
# 1. 自动测速分组:定期自动选延迟最低的节点
- "url-latency-benchmark=香港节点, server-tag-regex=(?=.*(港|HK|(?i)Hong))^((?!(台|日|韩|新|美)).)*$, check-interval=900, tolerance=0, img-url=https://raw.githubusercontent.com/Orz-3/mini/master/Color/HK.png"
# 2. 静态分组:固定包含这些节点/策略
- "static=苹果服务, direct, 香港节点, 台湾节点, 美国节点, img-url=..."作用:这里定义你自己的所有策略组,这是配置的核心部分。
两种类型:
url-latency-benchmark=:自动测速分组,根据延迟自动选择最优节点static=:静态分组,你手动指定包含哪些节点/其他策略
参数说明:
server-tag-regex=正则表达式:自动从你的订阅里匹配符合规则的节点check-interval=900:测速间隔,单位是秒(900秒 = 15分钟)img-url=:策略组图标链接
server_remote:
- "https://你的机场订阅链接, tag=我的机场, enabled=true"作用:需要代理分流时,填写你自己的节点订阅链接,Quantumult X 会自动拉取节点。项目本身不提供代理节点;如果你只使用去广告或直连规则,可以不填写。
请勿把带有 Token 的私人订阅地址提交到公开仓库。
local_filters:
top:
- "file://rules/my_custom.list" # 从本地文件读取规则
- "ip6-cidr,::/0,direct" # 或者直接写在这里
bottom:
- "geoip,cn,direct"作用:添加你自己的本地分流规则。
位置说明:
top:插到所有分流规则最前面,优先级最高(适合你自己的规则优先匹配)bottom:插到所有分流规则最后面,优先级最低(适合兜底规则)
格式说明:
file://路径:从rules/目录下读取文件,方便你把大量规则分开管理
filter_remote:
- name: "TikTok"
source: "blackmatrix7" # 内置简写,自动生成正确链接
policy: "us-node" # 这些分流走哪个策略
tag: "TikTok"作用:引用第三方远程分流规则。
支持内置简写:source: "blackmatrix7" 会自动拼接正确的规则地址,不用你记长链接。
rewrite_local:
- "file://rules/my_rewrites.list" # 从本地文件读取
- "^https://google.cn url 302 https://google.com" # 直接写在这里作用:添加你自己的本地重写规则(重写用来做去广告、修改响应、跳转等)。
rewrite_remote:
- "https://limbopro.com/Adblock4limbo.conf, tag=毒奶特供(去网页广告计划), enabled=true"作用:引用第三方远程重写规则(一般用来去广告)。
本工具会自动下载这些文件到你自己仓库,并替换链接为你的仓库地址,不怕原链接失效。
task_local:
- "0 9 * * * https://example.com/sign.js, tag=每日签到"作用:添加 Quantumult X 定时任务(比如自动签到)。
mitm:
hostname: "file://rules/my_mitm_hosts.list"作用:配置 HTTPS 解密需要的域名列表。
💡 提示:如果域名很多,建议放在
rules/目录下的单独文件里引用,不要直接写在config.yaml里,更干净。
如果你是第一次使用 Quantumult X,或者希望进一步了解策略组、分流、重写和 MITM,可以参考以下资料:
-
适合系统了解 Quantumult X 的基础概念、配置方式和常见用法。
-
社区整理的 Quantumult X Wiki,可用于查询各项功能和配置说明。
-
面向熟悉 Quantumult X 的用户,可直接查阅作者提供的完整示例配置和参数写法。
-
一份可直接参考的示范配置,包含较完整的配置结构和注释说明。
A: 不提供。它提供的是 Quantumult X 去广告配置、规则和自动更新工具。需要代理分流时,请使用自己的合法节点订阅,并注意保护订阅地址中的 Token。
A: 去广告规则无法保证覆盖所有 App 和版本。请先确认对应重写已启用;涉及 HTTPS 内容时,还要安装并信任 Quantumult X 的 MITM 证书。若设置无误,可能是 App 更新后接口发生变化,需要等待上游规则更新。
A: 很多去广告规则会持续更新,但原链接有时会限速、变更或失效。本地化会把能够下载的规则保存到你自己的 GitHub 仓库,让 Quantumult X 优先从自己的仓库拉取,降低上游单点故障带来的影响。
A: 默认是每天北京时间早上 6 点自动构建一次,保证你拿到最新规则。你也可以随时手动构建。
A: 两个配置文件都可以用,根据你的需要选:
- 推荐用本地化版本:复制
https://raw.githubusercontent.com/你的用户名/qx-config-sync/main/MyQuantumultX_Local.conf - 如果想用原始链接:复制
https://raw.githubusercontent.com/你的用户名/qx-config-sync/main/MyQuantumultX.conf
打开 Quantumult X → 配置 → 下载配置 → 填入链接 → 导入就可以用了。
A: 检查一下:
- Bot Token 和 Chat ID 是否正确
- 你需要先给你的 Bot 发一条消息,否则 Bot 没法主动给你发消息
- 检查 GitHub Secrets 名字是否正确,不能有空格
A: Telegram 会通知你构建失败,并且告诉你错误原因。你可以去 GitHub → Actions → 最新一次运行那里看完整日志。大部分情况是:
- 你的
config.yaml格式错了(YAML 对缩进要求严格,仔细检查) - 某个远程链接下载失败(一般重试一次就好,或者换个链接)
- ✅ 添加 Telegram 通知,成功失败都提醒,显示变化文件
- ✅ 添加 1 秒下载间隔,防止被风控拦截
- ✅ 统一 HTTP 客户端,更稳定
- ✅ 所有配置支持环境变量,安全适配 GitHub Secrets
- ✅ 自动检测配置文件和规则目录变化
本项目配置中使用了以下大佬分享的底包、规则和资源,在此特别感谢:
- 底包: ddgksf2013 - 提供了非常完善的 Quantumult X 基础配置
- 分流规则: blackmatrix7 - 维护了完整全面的去广告和分流规则
- 去广告:
- limbopro - 毒奶特供去网页广告计划
- blackmatrix7 - 多种应用去广告规则
- keleecn - 提供了多款国内 App 去广告 Loon 规则(兼容 QX)
- 工具:
- 图标资源:
- Orz-3 - 极简风格图标
- Koolson - 彩色风格图标
- ddgksf2013 - 应用图标
如果你在使用过程中遇到问题,欢迎联系我:
- Telegram: @suversal
- Email:
contact@suversal.com
感谢各位规则大佬分享的规则,也感谢前辈们的思路让这个项目更完善。













