vpnctl

vpnctl é um plano de controle leve e à prova de falhas projetado para gerenciar infraestrutura de VPN auto-hospedada em Linux. Ele fornece um workspace unificado contendo um CLI, um daemon e uma interface de administração web, permitindo que operadores gerenciem nós de VPN sem instalar agentes neles. O sistema é construído como sucessor de toolkits de implantação baseados em bash, enfatizando estado com tipo seguro, inventário transacional e capacidades de auditoria por mutação. A arquitetura depende de duas abstrações ortogonais: Kernels (daemons do lado do nó como sing-box, amneziawg, caddy e xray) e Protocolos (formatos de fio como vless+reality, hysteria2, tuic-v5 e wireguard). Esse design plug-in permite fácil extensão; adicionar um novo kernel ou protocolo envolve criar um único arquivo e registrá-lo, sem afetar o CLI core, o inventário ou as camadas SSH. O plano de controle usa SSH para transporte e SQLite para gerenciamento de inventário, garantindo consistência de dados e auditabilidade. Recursos principais incluem uma interface de administração bilíngue (EN/RU) que serve como a principal superfície do operador, com toda ação do CLI espelhada por um botão web. O sistema suporta operações complexas como adicionar servidores via um wizard, gerenciar concessões de usuário, gerar URLs de assinatura (compatíveis com Mihomo e sing-box) e lidar com contabilização de tráfego. Inclui mecanismos robustos de backup e recuperação, com bundles criptografados agendados e capacidades de auto-teste. Recursos de monitoramento fornecem SLOs de uptime, sparklines de tráfego e alertas de infraestrutura via Telegram. O projeto está atualmente na v0.9, com desenvolvimento contínuo para recursos como suporte a Xray/XHTTP e gerenciamento de versão de kernel de frota.