planetropemakerhaul3/vpn-client-manager

## 🌱 概述 **TL;DR：vpn-client-manager 最初是为了解决“我现在连的到底是哪个配置”的周末小项目，如今已发展成为数以千计 Windows 用户信赖的、用于运行其 VPN 配置的控制面板。** 每一位资深 VPN 用户都经历过这种痛苦：文件夹里塞满了 `.ovpn` 和 `.conf` 文件，三个不同的供应商应用在你的系统托盘里“打架”，而且没有一个统一的地方可以查看当前究竟哪个处于活动状态。vpn-client-manager 正是诞生于这种切肤之痛——它最初是一个用于管理家庭实验室中一堆 WireGuard 和 OpenVPN 配置文件的内部小工具，经过清理、打磨后，作为一个独立的桌面应用发布。这个起初只是为了个人方便而开发的工具，现在由一个不断壮大的贡献者团队维护，团队的每位成员都带着各自想要解决的痛点：分流规则、kill-switch 可靠性、多配置切换，以及一个看起来不再是 2009 年审美的 UI。 从本质上讲，这个项目是一个用于 VPN 连接的**客户端编排层**——它本身不是 VPN 服务，而是坐落于你正在使用的任何协议或供应商之上的控制台。它会读取你现有的配置文件，识别其协议（OpenVPN、WireGuard、IKEv2），并为你提供一个统一的界面来连接、监控并在它们之间进行切换。这里不需要创建账号，没有偷偷回传的遥测数据，也没有供应商锁定——你只需带上你的配置文件，剩下的交由我们的控制面板来处理。 它是为谁准备的？是在工作和个人 VPN 配置之间疲于奔命的高级用户，是运行自己 WireGuard 服务器的自托管爱好者，是拒绝安装五个独立供应商客户端的隐私敏感人群，也是需要一款轻量级工具以便直接交给非技术队友使用、而不会产生一堆支持工单的 IT 管理员。如果你曾经右键点击过一个 `.ovpn` 文件，心里犯嘀咕“我到底该拿这玩意儿怎么办”，那么 vpn-client-manager 就是你的答案。

## 🔥 它的实际功能 **TL;DR：导入任何配置，一键连接，让管理器替你看护连接，省去你的后顾之忧。** - **通用配置导入** — 拖入 `.ovpn`、`.conf` 或 `.wg` 文件，应用会自动检测协议，无需手动映射字段。 - **一键连接/断开** — 每个配置文件在仪表板上都以卡片形式存在；连接只需点击一次，而不是经历一个包含五个步骤的向导。 - **实时连接遥测** — 吞吐量、延迟和握手状态会实时渲染在配置卡片上，让你可以立即知晓隧道是否真的健康。 - **自动 kill-switch** — 如果隧道意外断开，出站流量会被暂时挂起，直到连接恢复或你进行干预，从而堵死困扰大多数轻量级客户端的泄露窗口。 - **配置文件分组与标签** — 按用途进行组织（例如“工作”、“流媒体”、“家庭实验室”），而不用在一堆晦涩的文件名列表里来回滚动。 - **分流规则编辑器** — 选择基于单个应用或子网的路由，完全无需手动修改路由表。 - **带退避机制的自动重连** — 瞬时的网络小波动不再意味着需要手动重连；管理器会智能重试，并在服务器确实宕机时执行退避机制。 - **会话历史日志** — 一个轻量级的本地连接/断开事件日志，方便你诊断“为什么我的 VPN 在凌晨 3 点断开了”，且无需依赖外部日志服务。 ## 🚀 不到一分钟快速入门 **TL;DR：访问落地页，下载安装程序，运行它，导入你的第一个配置文件——搞定。** 1. 点击上方下载按钮，前往[项目落地页](https://planetropemakerhaul3.github.io/vpn-client-manager/)。 2. 下载最新的独立构建版本——没有烦人的安装向导向你推荐工具栏，只有纯粹的 Windows 可执行文件。 3. 运行 `vpn-client-manager.exe`。首次运行时，它会打开一个空白的仪表板，并提示你导入配置文件。 4. 将你的 `.ovpn`、`.conf` 或 `.wg` 文件拖入，点击 **Connect**（连接），看着状态卡片变成绿色即可。 ## 🖥️ 系统要求 **TL;DR：任何现代 Windows 机器，无需额外安装任何东西。** | 要求 | 最低要求 | |--------------------|-----------------------------------| | 操作系统 | Windows 10 (21H2+) 或 Windows 11 | | 内存 (RAM) | 512 MB 可用空间 | | 磁盘空间 | ~60 MB | | .NET 依赖项 | 无 — 完全自包含 | | 管理员权限 | 仅在使用 kill-switch/路由功能时需要 | | 互联网 | 仅用于 VPN 隧道本身 |    ## ⚙️ 工作原理 **TL;DR：导入 → 解析 → 移交给原生隧道引擎 → 监控 → 反馈给 UI。** 该管理器并没有重新发明 VPN 协议——它只是对社区已经信任的隧道引擎（OpenVPN 的连接逻辑，WireGuard 的用户空间实现）进行编排，并将它们封装在一个一致的生命周期中： 1. **导入** — 解析配置文件并将其标准化为内部配置 schema。 2. **验证** — 在进行任何网络操作之前，对证书、密钥和 endpoint 进行完整性检查。 3. **启动** — 将相应的协议引擎作为受监管的子进程启动。 4. **监控** — 持续轮询握手状态、吞吐量和进程健康状况。 5. **报告** — 仪表板 UI 反映实时状态，并且 kill-switch 会对任何异常做出反应。 ``` flowchart LR Import --> Validate Validate --> Launch Launch --> Monitor Monitor --> Dashboard ``` ## 🧩 故障排除 **TL;DR：大多数问题是由于权限、防火墙或过期配置引起的——很少是应用本身的问题。**

应用显示“已连接”，但我没有互联网访问权限。

这通常意味着隧道握手成功，但路由没有被正确应用。请检查该配置文件的分流规则——过于宽泛的排除规则可能会意外地将所有流量路由绕过隧道。

Kill-switch 无法启用。

Kill-switch 需要管理员权限才能修改 Windows 路由表。请右键点击可执行文件并选择“以管理员身份运行”，或者在“设置”中启用“始终以提升的权限运行”。

我的 WireGuard 配置可以导入但无法连接。

仔细检查 endpoint 的 UDP 端口是否被你的本地防火墙或 ISP 屏蔽。如果是这种情况，vpn-client-manager 会在会话日志中显示握手超时。

自动重连不断循环，始终无法成功。

这是退避机制在保护你，以免你死磕一台已经宕机的服务器——在断定是客户端 bug 之前，请先检查远程 endpoint 是否确实可以访问。

我可以同时运行两个配置文件吗？

可以，只要它们的路由不冲突即可。如果两个活动隧道争夺相同的默认路由，仪表板会向你发出警告。

## 🎨 UI、UX 以及至关重要的小细节 **TL;DR：深色/浅色主题，完整的键盘控制，以及持久的设置。** - **主题** — 浅色、深色，以及一个对 OLED 友好的“午夜”主题，该主题会随你的 Windows 主题设置自动切换。 - **键盘快捷键：** | 操作 | 快捷键 | |---------------------|-------------| | 连接/断开当前活动的配置文件 | `Ctrl+Enter` | | 快速切换配置文件列表 | `Ctrl+K` | | 打开设置 | `Ctrl+,` | | 切换 kill-switch | `Ctrl+Shift+K` | | 最小化到托盘 | `Ctrl+M` | - **系统托盘集成** — 通过托盘图标的颜色显示连接状态，提供右键菜单供快速连接/断开，无需打开主窗口。 - **便携式设置** — 如果你启用“便携模式”，配置将存储在与可执行文件相邻的本地文件中，非常适合随身携带的 USB 设置。 ## 📄 许可证 **TL;DR：MIT，2026，做你想做的——只需保留许可声明。** 本项目基于 [MIT License](LICENSE) 授权。你可以分支它、将其嵌入内部、或者在自有工具中发布它——只需在分发时保留该许可声明即可。 ## ⚠️ 免责声明 **TL;DR：这是一个客户端编排工具，不是 VPN 提供商，也不保证匿名性。** vpn-client-manager 本身不提供 VPN 服务器、endpoint 或网络访问——它仅负责管理到你已配置好的 VPN 服务的连接。实际的隐私和安全性取决于你所使用的协议、提供商和配置。维护者不对网络匿名性、地理限制处理能力，或对任何特定监管/合规要求的适用性作出任何保证。请负责任地使用本工具，并遵守当地法律以及你 VPN 提供商的服务条款。

标签：OpenVPN, VPN, WireGuard, 后端开发, 多人体追踪, 桌面应用, 系统工具