这个项目能做什么

vpnctl 是一个轻量级、容错的控制平面,专为管理 Linux 上的自托管 VPN 基础设施而设计。它提供了一个统一的工作空间,包含 CLI、守护进程和管理 Web UI,允许运营商在不安装代理的情况下管理 VPN 节点。该系统是基于 bash 的部署工具包的继任者,强调类型安全状态、事务性库存和突变审计能力。 该架构依赖于两个正交抽象:内核(节点端守护进程,如 sing-box、amneziawg、caddy 和 xray)和协议(线格式,如 vless+reality、hysteria2、tuic-v5 和 wireguard)。这种插件设计允许轻松扩展;添加新的内核或协议只需创建一个文件并进行注册,而不会影响核心 CLI、库存或 SSH 层。控制平面使用 SSH 进行传输,使用 SQLite 进行库存管理,确保数据一致性和可审计性。 主要功能包括一个双语(EN/RU)管理 UI,作为主要的运营商界面,其中每个 CLI 操作都由一个 Web 按钮镜像。该系统支持复杂操作,例如通过向导添加服务器、管理用户授权、生成订阅 URL(与 Mihomo 和 sing-box 兼容)以及处理流量会计。它包括强大的备份和恢复机制,具有计划的加密捆绑包和自检能力。监控功能提供正常运行时间 SLO、流量火花线图和基础设施警报(通过 Telegram)。该项目目前处于 v0.9 版本,正在开发 Xray/XHTTP 支持和舰队内核版本管理等功能。