Chrome 浏览器扩展,用于管理 Clash 代理规则。致敬 SwitchyOmega / ZeroOmega。
![]() 扩展图标与 Chrome 工具栏 |
![]() Clash 规则列表 + 扩展脚本规则管理 |
![]() 节点设置 |
| 功能 | 说明 |
|---|---|
| 三模式切换 | 系统代理 → 直连 → Clash 代理,一键切换,图标颜色实时变化 |
| 域名匹配检测 | 检测当前域名匹配的 Clash 规则,显示匹配的分组和策略(支持 RULE-SET 回退到 /connections API 查询) |
| 快捷添加规则 | 将当前域名添加到代理组(动态获取 Clash 代理组列表) |
| 智能域名分组 | 检测页面所有域名,自动分组建议(如 i1.art.com, i2.art.com → *.art.com) |
| 系统代理状态 | 实时显示系统代理状态(Native Host 读取注册表 + 浏览器代理 API 兜底,兼容部分 Chromium 内核浏览器) |
| 规则管理 | 查看、添加、删除 Clash YAML 配置文件中的规则(增删后自动热重载) |
| 重启 Clash | 一键将 profile 规则同步到 Clash Verge Rev 快照文件并重启内核(热重载失效时使用) |
⚠ 从 v1.3.6 及以下升级到 v1.3.7+:扩展 ID 已固定,必须重新运行
native-host/install.ps1(回车使用默认 ID 即可),否则 Native Host 因 ID 不匹配而无法启动。详见 v1.3.7 Release Notes。
- 打开
chrome://extensions/ - 开启右上角「开发者模式」
- 点击「加载已解压的扩展程序」
- 选择
extension/目录
Native Host 用于读写 Clash 本地 YAML 配置文件(仅 Windows)。
📖 开启 PowerShell 脚本执行权限(点击展开)
Native Host 依赖 PowerShell 脚本(
.ps1),Windows 默认禁止运行脚本,需先开启执行权限,否则 Native Host 无法启动。
方式一(推荐):Windows 设置
- 打开「设置」→「隐私和安全性」→「开发者选项」(Windows 11 为「设置」→「系统」→「开发者选项」)
- 找到「PowerShell」→「更改执行策略以允许本地 PowerShell 脚本在没有签名的情况下运行」→ 开启
方式二:PowerShell 命令
- 以管理员身份打开 PowerShell
- 执行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 输入
Y确认
- 右键
native-host/install.ps1→ 使用 PowerShell 运行(需先开启脚本执行权限,见上方说明) - 扩展 ID 已固定为
llfbhodadhnfobbbkipelhknkjdflggm,直接回车即可 - 刷新扩展
- 启动 Clash Verge → 设置 → 外部控制 → 启用外部控制器 → 配置 Clash API 地址和密钥
- 启动 Chrome 打开 ClashOmega → 设置 → 填写 Clash API 地址(默认
http://127.0.0.1:9097)和密钥 - 配置文件路径留空则自动检测
📖 使用说明(点击展开)
会。增删规则成功后,扩展会自动通过 Clash API /configs?force=true 热重载配置(500ms 防抖)。
底部的「重启 Clash」按钮是更彻底的方式:将 profile 规则写入 Clash Verge Rev 快照文件(clash-verge.yaml)并重启内核,仅在热重载失效时使用。
Clash 内核自上而下顺序匹配,第一个匹配的规则生效。如果你的自定义规则位于 RULE-SET,... 等规则集之后,且域名被包含在规则集中,则永远不会命中自定义规则。
解决方案:将自定义规则移到 rules 列表顶部(RULE-SET 之前)。
可能原因:
- 域名确实没有匹配任何规则,落到
MATCH兜底规则 - 规则类型是
RULE-SET,浏览器端无法解析规则集内容,扩展会回退到 Clash API/connections查询实际匹配结果(需该域名有活跃连接)
注:MATCH 兜底规则对应的代理组名称由你的订阅配置决定(如「最终」「漏网之鱼」等),本扩展只负责显示实际匹配结果。
部分 Chromium 内核浏览器对 Native Host 的支持存在异常,导致无法通过注册表读取系统代理。v1.3.0 已添加 chrome.proxy.settings.get() 浏览器 API 作为兜底方案,支持 5 种代理模式检测(direct / auto_detect / pac_script / fixed_servers / system)。
🔧 技术栈与项目结构(点击展开)
- 前端: Chrome Extension Manifest V3 + Vanilla JS + CSS3 (MD3)
- 后端: Native Messaging Host (PowerShell)
- 通信:
chrome.runtime.sendMessage+chrome.runtime.sendNativeMessage - API: Clash REST API (
GET /configs,/rules,/proxies,/connections)
extension/ # Chrome 扩展
├── manifest.json # MV3 清单(含 CSP)
├── background.js # Service Worker(消息分发 + 热重载)
├── lib/ # 模块
│ ├── clash-api.js # Clash REST API 封装
│ ├── native-bridge.js # Native Host 通信桥接(含 sendToNativeSafe)
│ ├── proxy-manager.js # 代理模式切换
│ └── domain-detector.js # 页面域名检测
├── popup/ # 弹窗 UI
│ ├── popup.html # 四标签页结构
│ ├── popup.js # 标签页系统 + 拖拽排序 + 主题切换 + 域名匹配 + 规则增删
│ └── popup.css # MD3 多主题样式
├── locales/ # 多语言文件(zh_CN / en / ja)
└── icons/ # 模式图标
native-host/ # Native Messaging Host(Windows)
├── install.ps1 # 安装脚本(注册 Native Host)
├── clash_rules_manager.bat # 启动入口
├── clash_rules_manager.ps1 # 主程序(YAML 读写 + 系统代理查询)
└── com.clash.omega.json # Native Host 清单模板
- 浏览器: Chrome / Edge / 360 / QQ / Brave / Opera / Vivaldi 等 Chromium 内核浏览器(需支持 MV3)
- 代理内核: 本扩展基于 Clash Verge Rev 开发与测试,其他 Clash 内核(如 Clash for Windows / Mihomo 等)未测试,可能可用但不保证
- 操作系统: Windows(Native Host 依赖 PowerShell 5.1+)
📦 相关推荐:sublink-worker(点击展开)
One Worker, All Subscriptions — 轻量级订阅转换与管理面板,可部署于 Cloudflare Workers / Vercel / Node.js / Docker。
Fork 自 7Sageer/sublink-worker,在原版基础上做了以下重点增强:
- AnyTLS 协议支持 — 新增
anytls://协议解析器,AnyTLS 链接会被正确解析并转换为 Clash / Sing-Box 原生 AnyTLS 节点(原版会静默丢弃) - GFWList 规则 — 基于
geosite:category-gfw新增 GFWList 规则组,默认走代理 - GFWList 自动合并 — 选中 GFWList 但未选 Social Media / Google / Youtube / Github 时,自动拉取
twitter/google/youtube/github/gitlab站点规则,修复x.com等 GFW 屏蔽但被 v2fly 归类到geosite:twitter而非category-gfw的域名
- 非中国域名和兜底规则默认改为直连(原版为节点选择)
- GFWList 默认走节点选择(代理)
- 规则优先级:特定规则(Google / Telegram / Github...)> GFWList > 非中国(直连)> 兜底(直连)
- 实现白名单代理模式:只有 GFW 屏蔽的域名走代理,其他全部直连
- 禁用 proxy-provider — 返回 Clash YAML 格式的订阅不再自动转为
proxy-providers,所有节点内联到最终配置,避免 UA 限制或 token 认证导致运行时拉取失败 - proxy-groups 隔离 — 订阅自带的
proxy-groups不再合并到输出配置,只保留 Web UI 中选择的规则组
ShadowSocks、VMess、VLESS、AnyTLS、Hysteria2、Trojan、TUIC
Sing-Box、Clash(Meta/Mihomo)、Xray/V2Ray、Surge
可配合本扩展使用:sublink-worker 负责订阅转换与节点生成,ClashOmega 负责运行时规则管理与域名匹配检测。
🤖 相关推荐:AOS — Agent Operating System(点击展开)
自我拆任务 → 自我执行 → 自我验证 → 自我进化
纯文件系统驱动的 Agent 协作框架,零代码依赖。通过结构化目录和规则文件,让 AI Agent 在多会话间保持状态一致、知识积累和任务协同。ClashOmega v1.3.0 的开发全程基于 AOS 框架协作完成。
- 纯文件系统:所有状态、记忆、知识存储在磁盘文件中,不依赖运行时内存
- 多会话协同:不同对话独立 Agent 实例,通过文件系统交互
- Skill/Loop/Agent 模块化:可演化的工具体系,持续积累经验与坑点
- Maker/Checker 分离:同一任务不在同一会话中执行+验证
- Clash — 由 Dreamacro 创建的 Clash 内核,本项目所控制的核心代理引擎
- mihomo — Clash.Meta 更名后的项目,Clash Verge Rev 默认使用的代理内核,本项目实际运行所依赖的内核
- Clash Verge Rev — 基于 Tauri 的 Clash GUI 客户端,本项目开发与测试的主要运行环境,其配置文件格式与扩展脚本机制为本项目提供了规则管理的基础
- SwitchyOmega / ZeroOmega — 本项目灵感来源,致敬其在浏览器代理管理领域的开创性工作
- MagicalYu — 首席小白鼠兼 AI 编码调教师。本项目开发期间,以独到的"调教"技巧让 AI 高效产出可用的代码。没有他的阴阳怪气,就没有现在的 ClashOmega。
- 本项目基于 AOS(Agent Operating System)框架协作完成
完整版本历史请查阅 CHANGELOG.md。
MIT License


