Smart VPN Proxy - Chrome Extension

一个轻量级、现代化的Chrome VPN代理扩展，支持自定义HTTP、HTTPS、SOCKS4和SOCKS5代理服务器。

✨ 主要特性

• 🔒 多协议支持: HTTP、HTTPS、SOCKS4、SOCKS5
• 🎯 自定义代理: 添加、编辑、删除自定义代理服务器
• 🚀 一键连接: 快速连接/断开代理
• 🧪 连接测试: 测试代理连接状态和响应时间
• 💾 数据持久化: 自动保存代理配置和连接状态
• 🎨 现代化UI: 美观的用户界面，支持响应式设计
• 🔐 认证支持: 支持用户名/密码认证的代理服务器
• 📱 跨平台: 支持Windows、macOS、Linux

🚀 快速开始

安装方法

1. 在Chrome中加载

   • 打开Chrome浏览器
   • 访问 chrome://extensions/
   • 开启"开发者模式"
   • 点击"加载已解压的扩展程序"
   • 选择项目文件夹

2. 开始使用

   • 点击工具栏中的扩展图标
   • 添加你的代理服务器
   • 选择代理并连接

📋 系统要求

• Chrome 88+ 或基于Chromium的浏览器
• 支持Manifest V3

🔧 配置说明

支持的代理协议

协议	端口范围	说明
HTTP	1-65535	HTTP代理服务器
HTTPS	1-65535	HTTPS代理服务器
SOCKS4	1-65535	SOCKS4代理服务器
SOCKS5	1-65535	SOCKS5代理服务器

代理配置参数

• Name: 代理名称（必填）
• Protocol: 代理协议（必填）
• Host: 代理服务器地址（必填）
• Port: 代理服务器端口（必填，1-65535）
• Username: 用户名（可选）
• Password: 密码（可选）
• Country: 国家/地区（可选）

🎯 使用指南

添加新代理

1. 点击"Add New"按钮
2. 填写代理服务器信息
3. 可选择测试连接
4. 点击"Save Proxy"保存

连接代理

1. 从下拉列表选择代理
2. 点击"Connect"按钮
3. 等待连接成功提示

断开连接

1. 点击"Disconnect"按钮
2. 等待断开成功提示

管理代理

• 编辑: 点击代理项的"Edit"按钮
• 删除: 点击代理项的"Delete"按钮
• 测试: 在添加/编辑模式下点击"Test Connection"

🏗️ 项目结构

smart-vpn-proxy/
├── manifest.json          # 扩展清单文件
├── background.js          # 后台服务脚本
├── popup.html            # 弹窗界面
├── popup.css             # 弹窗样式
├── popup.js              # 弹窗逻辑
├── icon16.png            # 16x16图标
├── icon48.png            # 48x48图标
├── icon128.png           # 128x128图标
└── README.md             # 说明文档

🔒 安全特性

• 最小权限原则
• 本地数据存储
• 安全的代理认证
• 输入验证和清理

🛠️ 开发说明

技术栈

• 前端: HTML5, CSS3, JavaScript (ES6+)
• 后端: Chrome Extension API
• 存储: Chrome Storage API
• 通信: Chrome Runtime Message API

核心类

• VPNProxyManager: 后台代理管理器
• VPNPopup: 前端弹窗控制器

消息协议

扩展使用标准的Chrome消息传递机制进行前后端通信：

// 发送消息
chrome.runtime.sendMessage({
    action: 'connect',
    proxyId: 'proxy123'
});

// 接收响应
chrome.runtime.onMessage.addListener((request, sender, sendResponse) => {
    // 处理消息
});

📝 更新日志

v1.0.0

• 初始版本发布
• 支持HTTP/HTTPS/SOCKS4/SOCKS5代理
• 现代化用户界面
• 完整的代理管理功能

🤝 贡献指南

欢迎提交Issue和Pull Request！

1. Fork项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启Pull Request

📄 许可证

本项目采用MIT许可证 - 查看 LICENSE 文件了解详情

⚠️ 免责声明

本扩展仅用于教育和研究目的。用户需要确保：

• 遵守当地法律法规
• 获得代理服务器的合法授权
• 不用于非法活动

开发者不对用户的使用行为承担责任。

📞 支持

如果你遇到问题或有建议：

• 提交GitHub Issue
• 查看项目Wiki
• 联系开发者

---

注意: 这是一个开源项目，请确保你了解并遵守相关的法律法规。