OpenClash 配置方案、订阅转换模板、YAML 配置、规则文件、实用脚本与覆写模块资源
📖 项目 Wiki • 🧩 配置资源 • 🗂️ 规则文件 • ⚙️ 覆写模块 • 🛠️ 实用脚本
Custom_OpenClash_Rules 是一个围绕 OpenClash 维护的配置与扩展资源仓库。
本项目提供 OpenClash 设置文档、订阅转换模板、YAML 配置、规则文件、远程覆写模块及辅助脚本。各类资源可以独立使用；完整配置方案需要结合项目 Wiki 中的 OpenClash LuCI 设置。
Tip
仅需 OpenClash，无需「套娃」
本项目的所有配置方案均只需 OpenClash 一个插件，无需叠加其他代理或 DNS 插件，也无需进行任何「套娃」设置。
Important
关于 DNS 泄漏防护
使用本项目的 OpenClash 设置方案，并选择三种订阅路径中的任意一种（订阅转换、远程 YAML 覆写或手动导入 YAML），在以下条件同时满足时，可以避免本地 DNS 泄漏：
- Fake-IP、流量接管和 DNS 设置均已按 Wiki 生效；
- 终端 DNS 请求及相关流量均经过 OpenClash。
实际结果必须通过检测验证，不能仅以配置完成作为结论。客户端启用私有 DNS 或 DoH、设备或部分流量未被接管、插件或固件行为与文档不一致，或自行覆写 DNS 配置时，均超出该方案的控制范围，需要单独处理并验证。
根目录的 README.md 作为项目首页和资源导航，仅介绍各类资源的定位与入口。具体文件、版本区别、参数和使用方法，请进入对应目录查看其自动展示的 README.md。
Note
项目 Wiki 目前仅提供中文版本。
| 需求 | 建议入口 |
|---|---|
| 首次配置 OpenClash 或系统了解其工作方式 | 项目 Wiki |
| 使用订阅转换模板、YAML 配置或远程 YAML 覆写模块 | cfg/ |
| 为现有配置补充或修正规则 | rule/ |
| 使用独立游戏规则 | rule/game_rule/ |
| 使用单功能远程覆写模块 | overwrite/ |
| 安装、更新或检测 OpenClash | shell/ |
| 使用 Sub-Store 扩展脚本 | Sub-Store 脚本 |
| 排查常见故障 | 故障排除 |
项目 Wiki 是本仓库的核心内容之一，提供一套围绕 OpenWrt 与 OpenClash 整理的完整配置思路。
内容重点包括：
- OpenClash 从准备到验收的完整配置流程： 运行模式、流量接管、规则匹配和策略选择；
- DNS 策略与泄漏风险控制： 直连与代理流量的解析路径、DNS 劫持和规则跟随；
- 直连访问优化： 结合中国大陆域名与 IP 绕过机制，减少不必要的代理处理；
- IPv6 配置与兼容： 在保留 IPv6 连通性的同时正确完成分流与接管；
- 故障排除与补充教程： 覆盖启动失败、网络异常、规则命中异常等常见问题。
Wiki 负责解释「为什么这样配置」，各资源目录负责提供可以直接使用或修改的落地文件。
入口： 项目 Wiki
cfg/ 用于将上述 Wiki 中的配置思路落实为可直接使用的完整配置资源，具体包括：
| 资源 | 所在位置 | 主要用途 |
|---|---|---|
| 订阅转换模板 | cfg/ |
通过在线订阅转换生成完整 OpenClash 配置 |
| YAML 配置文件 | cfg/yaml/ |
下载后手动修改并导入 OpenClash |
| YAML 远程覆写模块 | overwrite/yaml/ |
自动下载对应 YAML、写入订阅并切换配置 |
Important
本项目提供三种完整配置的使用方式：
- 订阅转换；
- 远程 YAML 覆写模块；
- 下载 YAML 后手动修改并导入。
本项目按同一套配置设计维护三种使用方式。选择相同版本且未自行修改时，策略组定位、规则顺序和分流逻辑应保持一致；文件结构和加载方式不同，实际结果还会受到订阅转换后端及 OpenClash 版本影响。
OpenClash dev 版当前已内置本项目全部 8 个订阅转换模板，包括标准版、轻量版、极简 GFW 版、重度分流版，以及文件名以 _Fallback 结尾的对应故障转移版。旧版如未显示对应条目，可手动填写远程模板地址，具体方法和地址见 cfg/。
内置模板名称以 OpenClash dev 分支的 sub_ini.list 为准。OpenClash 后续调整内置清单时，界面显示可能与本文不同；本项目模板仍可通过远程地址手动使用。
本项目提供标准版、轻量版、极简 GFW 版、重度分流版及对应的故障转移版，并提供自建节点相关 YAML。版本定位、参数、远程地址和详细操作请进入相应目录查看。
入口：
- 订阅转换模板：
cfg/ - YAML 配置文件：
cfg/yaml/ - YAML 远程覆写模块：
overwrite/yaml/
rule/ 存放本项目维护的补充规则及其多格式派生文件，包括自定义直连、代理、Steam CDN、游戏下载 CDN、加密 DNS 等内容。
目录中的 .list 是主要规则来源；工作流据此生成 Classical YAML、Domain YAML、IP-CIDR YAML 和 MRS，供订阅转换模板或 Mihomo Rule Provider 使用。
Important
本项目的直连规则由维护者与社区用户共同收集。
请根据实际需求选择提交入口：
| 需求 | 建议入口 |
|---|---|
| 手动查询或提交少量直连域名 | 使用 Rule-Bot 公共实例 |
持续收集 Mihomo 最终由 MATCH 处理的域名 |
按照 Rule-Bot Client 接入公共 Rule-Bot 完成配置；客户端默认仅保存到本地，发送需要主动启用 |
| 批量提交已经核实的域名 | 修改 rule/Custom_Direct.list 并提交 Pull Request |
| 无法使用 Rule-Bot，或需要附带完整证据 | 使用 大陆直连域名 Issue 表单 |
| OpenClash 插件无法启动、界面异常或安装失败 | 使用 OpenClash 官方 Issue 选择页 |
提交前请先搜索现有规则、Issues 和 Pull Requests，并提供实际命中的规则、策略和可复核证据。不要在公开页面提交订阅地址、Token、节点凭据或其他敏感信息。
rule/game_rule/ 另存放人工整理的独立游戏规则。目录中的 .list 是规则来源，工作流会自动生成 YAML 和 MRS 派生文件，但不会更新规则内容或将其加载到主配置。使用前应核对适用区服、更新时间和实际命中情况。
入口： rule/
Note
维护者会根据实际情况将本项目收集到的规则内容向上游相关规则项目提交。
shell/ 提供 OpenClash 安装、更新和 CPU 架构检测脚本，支持 OpenWrt、ImmortalWrt，并适配 OPKG 和 APK 包管理器。
脚本可能涉及软件源临时切换、插件覆盖重装、UCI 设置和 OpenClash 内置更新流程。运行前请进入目录阅读完整说明。
Sub-Store 扩展脚本 用于扩展 Sub-Store 的订阅处理能力。相关脚本独立于 OpenClash 安装流程，也不会被本项目配置自动加载。
入口：
overwrite/ 存放 OpenClash 远程覆写模块及相关资源。
根目录中主要存放单功能的远程覆写模块；overwrite/yaml/ 则存放调用本项目 YAML 配置的远程覆写模块。
不同模块的修改范围、参数、组合关系和冲突风险，请进入对应目录查看。未来会不断追加其他功能的覆写模块。
入口：
- 单功能覆写模块：
overwrite/ - YAML 配置远程覆写模块：
overwrite/yaml/
本仓库主要面向 OpenWrt 与 OpenClash 使用场景，不提供其他客户端或操作系统的通用配置支持。
本项目为维护者个人使用经验与技术资料的整理，不提供个性化配置、定制开发或一对一技术支持。
欢迎加入本项目的 Telegram 讨论群组：Custom OpenClash Rules。本项目及相关项目的更新信息均统一在群组内发布。
群组欢迎一切与本项目相关的讨论，包括配置使用、规则反馈、问题排查，也欢迎其他交流。
Important
如排查后确认问题由 OpenClash 插件本身引起、与本项目配置或规则无关（如插件无法启动、界面异常、安装失败等），建议：
- 前往 OpenClash 官方 Issue 选择页 提交 Issue；
- 或加入 OpenClash 官方 Telegram 讨论群组咨询（可在插件 LuCI 首页点击 Telegram 图标进入）。
普通规则、模板、脚本和文档问题可以使用本项目 Issue 选择页。涉及凭据泄漏、下载校验绕过或脚本执行链的安全问题，请先阅读安全报告说明，不要在公开 Issue 中披露细节。
本项目提供围绕 OpenWrt 和 OpenClash 的技术文档与配置资源，不是 OpenClash 官方文档，也不提供设备、线路、订阅或托管服务。项目内容按现状提供，实际兼容性、准确性和结果需要结合当前版本与使用环境自行验证。
适用法律、第三方权利和各来源的许可证独立适用。使用者应自行确认其使用方式符合适用要求；本节不构成法律建议，也不在下方 CC BY-SA 4.0 许可之外增加平台、用途、期限或非商业限制。
转载、修改或分发时，不得暗示本项目或维护者对相关内容、产品或服务提供支持或背书。
Note
- 本项目编写于 2024 年 4 月，由维护者以非营利方式维护；这不限制 CC BY-SA 4.0 对商业用途的许可。
- 本项目内容仅为维护者个人经验的总结，用于技术交流，不具权威性，亦不构成 OpenClash 的唯一或推荐使用方式。
- 本项目未运营任何 YouTube 频道，亦未在 YouTube 或其他视频平台发布任何形式的教学或指导视频。
- 本项目文档由维护者根据实际使用经验独立整理；引用或使用的第三方项目、资料与资源在对应位置或下方「感谢」中标注。如因使用其他来源的教程、模板或配置文件产生问题，请勿在本项目的 Issues 或 Discussions 中反馈。
- 内容采用相对易于理解的表述，不代表对任何用户群体作出教学、指导或支持承诺。
感谢以下项目和资源对本项目提供基础能力、数据、工具或参考。为准确说明关系，以下内容按实际用途分类，各分类内排名不分先后；列入本节不表示相关项目对本项目提供官方支持或背书。
| 项目或资源 | 本项目中的用途 |
|---|---|
| vernesong/OpenClash | 本项目配置、覆写脚本和使用文档所面向的 OpenWrt 插件 |
| MetaCubeX/mihomo | 规则格式、配置能力以及 MRS 生成与校验工具 |
| vernesong/mihomo | 安装脚本与第三方覆写方案使用的 LightGBM 模型资源 |
| ACL4SSR/ACL4SSR | 本项目订阅转换配置的基础模板 |
| Giveupmoon/OpenClash_Overwrite | 以 Git 子模块保留的第三方完整覆写方案 |
| blackmatrix7/ios_rule_script | 中国大陆 IPTV 域名规则的数据来源 |
| v2fly/domain-list-community | 游戏下载域名与加密 DNS GeoSite 规则的数据来源 |
| HaGeZi DNS Blocklists | 加密 DNS 域名与 IP 规则的数据来源 |
| DNSCrypt/dnscrypt-resolvers | 加密 DNS 公共解析器、Relay 与 ODoH 端点的数据来源 |
| dogfight360/UsbEAm | 游戏网络地址与下载节点规则的参考工具 |
| 项目 | 与本项目的关系 |
|---|---|
| Aethersailor/SubConverter-Extended | 可选的增强型订阅转换后端，用于读取本项目 .ini 模板并生成 YAML；远程 YAML 覆写模块和手动 YAML 路径不依赖它 |
| Aethersailor/subconverter | 传统订阅转换后端，与 SubConverter-Extended 的扩展能力和维护范围不同 |
| Aethersailor/Rule-Bot | 域名检查与提交服务；项目公共实例将符合策略的域名提交到本仓库，自建实例可以使用其他目标仓库 |
| Aethersailor/Rule-Bot-Client | 从 Mihomo 的 MATCH 连接中收集域名，默认仅保存到本地；主动启用发送后才会把候选域名交给 Rule-Bot |
| Aethersailor/geoip | GeoIP 数据库与中国大陆 IPv4、IPv6 网段来源 |
其他规则、工具与历史参考来源
| 项目或资源 | 本项目中的用途 |
|---|---|
| felixonmars/dnsmasq-china-list | 补充直连域名的上游提交目标 |
| Loyalsoldier/v2ray-rules-dat | 完整配置模板中的 GeoIP、GeoSite 数据来源 |
| mottzz87/crules | Talkatone 规则的原始来源；相关规则已停止更新 |
| oooldtoy/SSTAP_ip_crawl_tool | 游戏服务器 IP 规则的抓取与整理工具 |
| alecthw/mmdb_china_ip_list | 完整配置模板及历史覆写脚本中的 MMDB 数据来源 |
| xishang0128/geoip | 完整配置模板及历史覆写脚本中的 GeoASN 数据来源 |
| sub-store-org/Sub-Store | 订阅处理脚本的运行平台 |
| 网易 UU 加速器 | 游戏网络规则的参考来源 |
| 217heidai/adblockfilters | 已归档广告过滤脚本的数据来源 |
| privacy-protection-tools/anti-AD | 已归档广告过滤脚本的数据来源 |
| TG-Twilight/AWAvenue-Ads-Rule | 已归档广告过滤脚本的数据来源 |
| Aethersailor/adblockfilters-modified | 已归档广告过滤脚本的数据来源 |
| 521xueweihan/GitHub520 | 已归档 GitHub 访问加速脚本的数据来源 |
| TraderWukong/demo | 项目早期保留的参考来源 |
| ddgksf2013/ddgksf2013 | 项目早期保留的参考来源 |
| immortalwrt/user-FAQ | IPv6 文档的历史参考来源 |
“历史”或“已归档”表示相关内容不再主动维护或推荐使用，但为保留来源记录而继续列出。
本项目有权许可的原创内容采用 Creative Commons 署名—相同方式共享 4.0 国际许可协议。在遵守许可条件的前提下，可以复制、分发、修改和用于任何用途，包括商业用途；需要适当署名、标明修改，并以相同方式共享演绎作品。不得施加会限制他人行使许可权利的附加条款或技术措施。本项目不在该许可之外增加平台、用途、期限或非商业限制。
上述说明是便于阅读的摘要，不替代 CC BY-SA 4.0 正式法律文本。
第三方项目、规则、数据、图片、工具、商标与子模块不因收录到本仓库而自动改用 CC BY-SA 4.0，仍适用对应来源的许可证、使用条款和其他权利限制。引用、修改或分发前，请核对文件标注、来源链接和上游许可。
