运行要求
| 项目 | 要求 |
|---|---|
| Python | 3.10 或更高版本;持续集成当前测试 3.11、3.12、3.13、3.14 |
| 图形界面 | PySide6 6.5 或更高版本,以及可用的系统托盘环境 |
| 用户目录 | platformdirs 3.0 或更高版本 |
| 平台 | Windows、Linux、macOS;项目 CI 覆盖三类系统 |
代理协议核心本身仅使用 Python 标准库;PySide6 和 platformdirs 用于桌面界面与跨平台用户目录。
支持的协议
| 能力 | 状态 |
|---|---|
| 本地 HTTP 正向代理 | 支持 |
| HTTPS CONNECT 隧道 | 支持 |
| 本地 SOCKS4 / SOCKS4a / SOCKS5 CONNECT | 支持 |
| HTTP / SOCKS4 / SOCKS5 上游 | 支持 |
| HTTP Basic 上游认证 | 支持 |
| SOCKS5 用户名/密码认证 | 支持 |
| NoProxy 直接连接 | 支持 |
当前限制
- 仅代理 TCP 流量,不实现 SOCKS5 UDP ASSOCIATE。
- 不实现 SOCKS BIND。
- 不提供内容缓存、内容过滤、PAC 文件生成或透明代理。
- 本地入口不提供客户端身份认证;默认回环监听是主要安全边界。
- 普通明文 HTTP 每个客户端连接处理一个请求;HTTPS CONNECT 与 SOCKS 隧道不受此限制。
开发与构建
修改 Qt Designer 文件后,运行:
python tools/generate_ui.py
python tools/generate_ui.py --check
更新和编译翻译:
python tools/generate_i18n.py update
python tools/generate_i18n.py compile
python tools/generate_i18n.py --check
这些脚本使用当前 Python 环境中的 PySide6 工具,并支持 Windows、Linux 与 macOS。