README.zh.md

FirewallBypass 浏览器代理插件

English | 简体中文

目录

1. 简介
2. 功能特性
3. 安装步骤
4. 使用说明
5. 项目结构
6. 常见问题

简介

这是一个基于 Chrome 浏览器的简单轻量级代理插件，可以根据预设的域名列表自动切换代理。该插件支持独立的代理配置，不会影响系统的全局代理设置。

功能特性

• 支持 HTTP/HTTPS/SOCKS5 代理协议
• 基于域名的智能代理分流
• 内置大量预设代理规则
• 支持自定义添加/排除代理域名
• 支持正则表达式匹配域名
• 实时显示当前页面的代理状态
• 支持代理规则搜索和查看
• 简洁的用户界面

安装步骤

1. 克隆或下载本项目代码
2. 运行 npm install 安装依赖
3. 打开 Chrome 浏览器，访问 chrome://extensions/
4. 开启"开发者模式"
5. 点击"加载已解压的扩展程序"，选择项目目录

使用说明

1. 点击浏览器工具栏中的插件图标
2. 在弹出窗口中配置代理服务器信息：
   • 代理类型（HTTP/HTTPS/SOCKS5）
   • 服务器地址
   • 端口号
3. 可以查看和搜索内置的代理规则列表
4. 在文本框中添加自定义代理域名规则：
   • 添加代理域名：domain.com 或 *.domain.com
   • 排除域名：!domain.com 或 !*.domain.com
5. 点击"Save"按钮保存设置
6. 启用代理后，插件会在页面顶部显示当前的代理状态

界面预览

插件的主要配置界面

页面顶部的代理状态提示

项目结构

• manifest.json: 插件配置文件
• popup.html/js: 弹出窗口界面
• background.js: 后台代理控制逻辑
• content.js: 页面代理状态显示
• proxy-list.txt: 预设代理规则列表
• package.json: 项目依赖配置

常见问题

Q: 为什么配置后代理不生效？ A: 请检查：

1. 代理服务器地址和端口是否正确
2. 插件是否已启用
3. 访问的域名是否在代理规则列表中

Q: 如何添加自定义代理规则？ A: 在插件设置页面的文本框中添加域名，支持以下格式：

• domain.com: 精确匹配域名
• *.domain.com: 匹配子域名
• !domain.com: 排除特定域名
• regexp:pattern: 使用正则表达式匹配

许可证

MIT License