# proxy-tool

**Repository Path**: meepo_vip/proxy-tool

## Basic Information

- **Project Name**: proxy-tool
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-09
- **Last Updated**: 2025-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 代理工具 (Proxy Tool)

一个功能强大、界面美观的跨平台代理管理工具，基于 Tauri + React + TypeScript 构建。

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)
![Language](https://img.shields.io/badge/language-TypeScript-blue.svg)

## ✨ 功能特性

### 🔧 核心功能
- **多协议支持** - 支持 HTTP 和 SOCKS5 代理协议
- **智能连接管理** - 一键连接/断开，实时状态监控
- **系统代理集成** - 自动配置系统网络代理设置
- **连接测试** - 内置代理连接测试，显示延迟和连接质量

### 📊 配置管理
- **配置命名和分组** - 为代理配置设置自定义名称和分组
- **搜索和过滤** - 快速查找特定配置
- **批量操作** - 支持批量测试、删除配置
- **导入导出** - JSON 格式配置文件导入导出
- **配置编辑器** - 完整的可视化配置编辑界面

### 🎨 用户体验
- **深色模式** - 支持明暗主题切换
- **智能通知** - 操作成功/失败的友好提示
- **确认对话框** - 危险操作的二次确认
- **快速菜单** - 便捷的操作快捷方式
- **键盘快捷键** - 提升操作效率

### 📈 监控统计
- **流量统计** - 实时显示上传下载流量
- **连接监控** - 连接时长、连接数统计
- **性能监控** - 服务器健康状态检查
- **响应时间** - 显示代理服务器延迟

### 🔄 高级功能
- **负载均衡** - 支持多服务器负载均衡配置
- **代理链** - 支持多级代理链配置
- **自动启动** - 开机自动启动应用
- **最小化到托盘** - 后台运行支持

## 🛠️ 技术栈

- **前端框架**: React 18 + TypeScript
- **UI 框架**: Tailwind CSS
- **桌面框架**: Tauri 1.x
- **后端语言**: Rust
- **构建工具**: Vite
- **包管理器**: pnpm

## 📦 安装和使用

### 环境要求

- Node.js 16+
- Rust 1.70+
- pnpm 8+

### 开发环境设置

1. **克隆项目**
```bash
git clone <repository-url>
cd proxy-tool
```

2. **安装依赖**
```bash
pnpm install
```

3. **启动开发服务器**
```bash
pnpm tauri dev
```

### 构建发布版本

```bash
# 构建生产版本
pnpm tauri build

# 构建特定平台
pnpm tauri build --target x86_64-pc-windows-msvc
```

## 🎯 使用指南

### 基本使用

1. **配置代理服务器**
   - 选择代理类型（HTTP/SOCKS5）
   - 输入服务器地址和端口
   - 可选：设置用户名和密码

2. **测试连接**
   - 点击"测试连接"验证代理可用性
   - 查看连接延迟和状态

3. **启动代理**
   - 点击"连接代理"启动本地代理服务
   - 可选：启用系统代理自动配置

### 高级功能

#### 配置管理
- 为配置设置名称和描述
- 使用分组组织多个配置
- 导出配置文件进行备份
- 批量测试多个配置的可用性

#### 负载均衡
- 添加多个代理服务器
- 选择负载均衡策略（轮询/随机/最少连接）
- 自动故障转移

#### 监控统计
- 查看实时流量统计
- 监控连接状态和性能
- 服务器健康检查

## ⌨️ 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+K` | 打开快速菜单 |
| `Ctrl+,` | 打开设置 |
| `Ctrl+M` | 打开性能监控 |
| `Ctrl+Enter` | 连接/断开代理 |
| `Ctrl+T` | 测试连接 |
| `Ctrl+D` | 切换深色模式 |
| `ESC` | 关闭模态框 |

## 📱 界面预览

### 主界面
- 简洁直观的连接状态显示
- 实时流量统计和连接时长
- 一键连接/断开操作

### 配置管理
- 可视化配置列表
- 搜索和分组功能
- 批量操作支持

### 设置界面
- 应用偏好设置
- 主题切换
- 自动启动配置

## 🔧 配置文件

应用配置和代理配置存储在本地文件中：

- **Windows**: `%APPDATA%/proxy-tool/`
- **macOS**: `~/Library/Application Support/proxy-tool/`
- **Linux**: `~/.config/proxy-tool/`

### 配置文件格式

```json
{
  "version": "1.0",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "configs": [
    {
      "name": "示例配置",
      "host": "127.0.0.1",
      "port": 8080,
      "type": "http",
      "group": "本地",
      "description": "本地测试代理"
    }
  ]
}
```

## 🚀 性能特点

- **轻量级** - 应用体积小，内存占用低
- **高性能** - Rust 后端保证高效的代理转发
- **跨平台** - 支持 Windows、macOS、Linux
- **现代化** - 基于最新的 Web 技术栈

## 🔒 安全特性

- **本地存储** - 所有配置数据本地存储，不上传云端
- **密码保护** - 敏感信息加密存储
- **安全连接** - 支持加密代理协议
- **隐私保护** - 不收集用户数据

## 🤝 贡献指南

欢迎贡献代码！请遵循以下步骤：

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

### 开发规范

- 使用 TypeScript 进行类型安全开发
- 遵循 ESLint 和 Prettier 代码规范
- 编写单元测试覆盖核心功能
- 提交信息使用约定式提交格式

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🐛 问题反馈

如果遇到问题或有功能建议，请在 [Issues](../../issues) 页面提交。

### 常见问题

**Q: 代理连接失败怎么办？**
A: 请检查代理服务器地址、端口和认证信息是否正确，并使用测试连接功能验证。

**Q: 如何备份配置？**
A: 使用配置管理中的导出功能，将配置保存为 JSON 文件。

**Q: 支持哪些代理协议？**
A: 目前支持 HTTP 和 SOCKS5 代理协议。

## 📞 联系方式

- 项目主页: [GitHub Repository](../../)
- 问题反馈: [Issues](../../issues)
- 功能建议: [Discussions](../../discussions)

## 🙏 致谢

感谢以下开源项目：

- [Tauri](https://tauri.app/) - 跨平台桌面应用框架
- [React](https://reactjs.org/) - 用户界面库
- [Tailwind CSS](https://tailwindcss.com/) - CSS 框架
- [Vite](https://vitejs.dev/) - 构建工具

---

⭐ 如果这个项目对你有帮助，请给个 Star！