SKY-EasyProxy

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 24 Open GitHub ↗

这是一款叫做面向MFv3设计的Chrome插件，是一个快捷、简单、好看的浏览器代理控制插件。提供代理管理、切换、测试等功能。本身无代理功能，需要自行准备S5/HTTP代理。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SKY-EasyProxy

一款面向 Chrome Manifest V3 设计的快捷代理控制插件，提供简洁美观的界面和完整的代理管理功能。本插件专注于代理控制，需要用户自行准备代理服务器。

[![License](https://img.shields.io/github/license/BlueSkyXN/SKY-EasyProxy)](https://github.com/BlueSkyXN/SKY-EasyProxy/blob/main/LICENSE)

## 特性

- 💡 完全支持 Chrome MFv3，无需担心 MFv2 淘汰问题
- 🚀 支持多种代理协议：HTTP、HTTPS、SOCKS4、SOCKS5
- 📋 多代理配置管理，一键切换不同代理
- 🔄 快速测试代理连通性
- 🌐 支持自定义代理绕过规则（IPv4、IPv6、CIDR、域名通配符）
- 🎨 现代化界面设计，操作简单直观
- 🔒 安全性好，不收集任何用户数据，经过全面安全加固

## 安装说明

### 手动安装（开发版）

1. 下载本仓库代码/发布包的打包版

2. 打开 Chrome 浏览器，进入扩展程序页面
   - 在地址栏输入：`chrome://extensions/`
   - 或者通过菜单：更多工具 -> 扩展程序

3. 开启开发者模式（右上角开关）

4. 点击"加载已解压的扩展程序"，选择项目文件夹。后续不可删除，否则插件就没了。

## 使用指南

### 基本操作

1. **添加代理配置**
   - 点击"Add Profile"按钮
   - 填写配置信息：
     - Profile Name: 配置名称（比如1080）
     - Proxy Type: 代理类型（HTTP/HTTPS/SOCKS4/SOCKS5）
     - Host: 代理服务器地址（比如127.0.0.1）
     - Port: 代理服务器端口（比如1080）
     - Bypass List: 代理绕过规则（可选）

2. **切换代理**
   - 点击配置列表中的代理条目即可激活
   - 使用顶部开关可以快速开启/关闭代理

3. **测试代理**
   - 点击代理条目中的"Test"按钮
   - 系统会自动检测代理连通性
   - 测试成功会显示当前 IP 地址

4. **编辑/删除代理**
   - 使用配置条目中的"Edit"或"Delete"按钮
   - 编辑配置时支持修改所有参数
   - 删除操作无需确认，请谨慎操作

### 绕过规则详解

插件支持多种绕过规则格式，满足不同场景需求：

- **IPv4地址**: `127.0.0.1`, `192.168.1.1`
- **IPv6地址**: `[::1]`, `[2001:db8::1]` 
- **CIDR网段**: `192.168.0.0/16`, `10.0.0.0/8`, `2001:db8::/32`
- **域名通配符**: `*.localhost`, `*.local`, `*.cn`

**预设模板**:
- **Basic**: 基础本地地址（localhost, 127.0.0.1, [::1], *.localhost）
- **Development**: 开发环境（包含 *.local, *.test, 192.168.0.0/16）
- **China**: 中国大陆常用（包含 *.cn, 内网段）

## 技术说明

### 开发相关

- 基于 Chrome Extensions Manifest V3
- 使用原生 JavaScript，无需额外依赖
- 采用 Chrome Storage API 存储配置
- 支持 Chrome Proxy API 进行代理控制

### 安全特性

**数据安全**:
- 输入验证与数据清理，防止恶意配置注入
- HTML转义处理，防止XSS攻击
- 配置数据完整性校验

**连接安全**:
- 代理测试时自动恢复原始配置
- 防止竞态条件导致的配置错乱
- 状态同步机制确保数据一致性

### 项目结构

```
SKY-EasyProxy/
├── manifest.json    # Chrome扩展清单文件
├── index.html       # 弹窗界面HTML
├── proxy.js         # 主要业务逻辑
├── background.js    # 后台服务工作脚本
└── README.md        # 项目说明文档
```

## FAQ

Q: 为什么选择开发新的代理管理插件？  
A: 随着 Chrome 弃用 Manifest V2，许多现有的代理管理插件将无法使用。本插件采用 MV3 开发，确保长期可用性。

Q: 配置数据保存在哪里？  
A: 所有配置数据使用 Chrome Storage API 本地保存，不会上传到任何服务器。

Q: 插件是否安全可靠？  
A: 是的。代码已经过全面安全审查，修复了所有已知的安全漏洞（XSS、输入验证、竞态条件等），采用了多层安全防护机制。

Q: 支持哪些绕过规则格式？  
A: 支持IPv4、IPv6、CIDR网段、域名通配符等多种格式，并提供实时验证和预设模板。

Q: 代理测试功能如何工作？  
A: 测试时会临时应用代理配置，通过外部API获取IP地址验证连通性，测试完成后自动恢复原始配置。

SKY-EasyProxy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README