专业的 Chrome 浏览器代理管理与智能分流扩展（Manifest V3）。
仓库地址： https://github.com/gradient30/ProxySwitch
ProxySwitch 是一款基于 Chrome Manifest V3 的轻量级代理管理扩展，纯 Vanilla JS、无构建工具、零 npm 依赖。在浏览器内完成代理模式切换、域名分流、规则管理与可选云备份，数据默认仅存于本地。
| 模式 | 说明 | 典型场景 |
|---|---|---|
| 名单/GFW走代理 | 默认直连，黑名单 / GFWList 命中走代理 | 按名单精细分流 |
| 全局+ | 默认走代理，白名单（含子域名）直连 | 日常推荐，配合 Clash |
| 直连 | 全站强制直连，忽略所有规则与 GFWList | 临时彻底不走代理 |
| 系统代理 | 跟随操作系统代理，扩展规则不生效 | 与 Clash 系统模式一致 |
配合 Clash Verge： 服务器填
127.0.0.1:7897，协议选 SOCKS5，使用「全局+」或「名单/GFW走代理」。若需浏览器独立规则，请勿使用「系统代理」。
总开关 vs 直连 vs 系统： 关闭右上角 代理总开关 时扩展强制直连（规则与模式保留）；「直连」模式同理但属于显式模式选择；「系统代理」则读取 OS 代理，与总开关关闭不同。
- 代理总开关：一键暂停扩展接管流量（强制直连），模式与规则保留
- 智能分流：GFWList + 自定义订阅 + 按模式分 Tab 的黑白名单 + 临时规则
- 弹窗一键添加：当前域名显示后即可加入规则（页面加载中也可用）
- 子域名继承：添加
baidu.com自动匹配www.baidu.com等子域 - 多协议服务器：SOCKS5（推荐）/ HTTP / HTTPS / SOCKS4
- 云备份：GitHub Gist / WebDAV（可选，JSON 明文存储于你的账户）
- 延迟测试、诊断日志、多语言界面（中/英/西/俄）
- 快捷键：
Alt+Shift+1~4切换四种模式 - 上下文帮助：Popup / Options 内「?」说明模式、协议、GFWList 与规则管理
ProxySwitch/
├── manifest.json # 扩展清单（当前 v7.10.1）
├── CHANGELOG.md # 更新说明
├── README.md # 本文件
├── Privacy.md # 隐私政策（简版）
├── Privacy_Policy.md # 隐私政策（完整版）
├── assets/
│ ├── icon.png # 扩展图标
│ └── ProxySwitch-logo.svg
├── html/
│ ├── popup.html # 弹窗面板
│ └── options.html # 设置页
├── js/
│ ├── background.js # Service Worker 入口
│ ├── domain-matcher.js # 统一域名匹配 / 路由
│ ├── pac.js # PAC 脚本生成
│ ├── icon-manager.js # 工具栏图标
│ ├── cloud-sync.js # 云备份
│ ├── gfw-parser.js # GFWList / 订阅解析
│ ├── popup.js
│ ├── options.js
│ ├── utils.js
│ └── logger.js # 本地诊断日志
├── scripts/
│ └── verify-release.js # 发布前自动化验证
└── _locales/ # 多语言文案
- 克隆或下载源码：
git clone https://github.com/gradient30/ProxySwitch.git- 打开 Chrome：
chrome://extensions/ - 开启右上角 开发者模式
- 点击 加载已解压的扩展程序
- 选择包含
manifest.json的ProxySwitch文件夹
- 安装后进入 设置 → 服务器
- 确认 启用浏览器代理 总开关为开启
- 添加服务器（Clash 示例）：
- 协议：SOCKS5
- 地址：
127.0.0.1 - 端口：
7897
- 点击 测试延迟 确认连通
点击工具栏图标打开弹窗：
- 名单/GFW：国内站直连，GFWList / 黑名单走代理；可一键加入黑名单或临时规则
- 全局+：默认走代理，可点「加入直连列表」将当前站加入白名单
- 直连 / 系统：见上表；弹窗「?」可查看与总开关的区别
弹窗右上角 总开关 可快速暂停扩展代理（强制直连），不影响已保存的规则。域名卡片在页面加载中也会显示，可提前添加规则。
- 规则管理：按模式分 Tab——「名单/GFW」管理黑名单、临时规则、强制直连；「全局+」管理直连白名单（两模式列表互不混用）
- GFWList：更新官方列表，可添加自定义订阅源合并规则
- 云端备份：GitHub Gist 或 WebDAV 跨设备同步配置
各区域旁 「?」 按钮提供上下文帮助（协议、GFWList、规则说明等）。
| 快捷键 | 模式 |
|---|---|
| Alt+Shift+1 | 名单/GFW走代理 |
| Alt+Shift+2 | 全局+ |
| Alt+Shift+3 | 直连 |
| Alt+Shift+4 | 系统代理 |
node scripts/verify-release.js
node --check js/background.js
node --check js/popup.js开发者重载提示： 在 chrome://extensions 禁用再启用扩展后，请等待约 1 秒再打开 Popup；若仍无响应，可重启浏览器或重新「加载已解压的扩展程序」。Popup 不得使用内联 <script>（MV3 CSP 限制）。
本扩展不收集用户浏览数据至开发者服务器。详情见 Privacy_Policy.md。
本项目基于 MIT License 开源。
Copyright © 2026 gradient30