jmsperu/vyctl

# VyCTL [](LICENSE) [](https://vyos.io) [](https://vyctl.com) **一个功能齐全的 Web UI 和 NOC，专为 [VyOS](https://vyos.io) 路由器打造。** VyCTL 通过原生 VyOS HTTP API 与您的路由器通信。无需 agent，无需配置 模板层，也没有与路由器冲突的记录数据库：路由器的 运行配置即是事实来源，而 VyCTL 是您的驾驶舱。 诞生于一次真实的迁移：在相同的硬件上将已停止维护的 Sophos XG 防火墙替换为 VyOS， 并且需要一个整个团队都能操作的 UI。 在线演示： （欢迎页面上提供演示凭据）。 ## 功能 **配置** - 接口（ethernet、VLAN、bridge、tunnel）、DHCP、DNS、NTP、SSH 和系统服务 - 防火墙规则管理、group、NAT（源/目的）、策略路由 - 静态路由、BGP 和 OSPF（邻居、路由表、实时协议状态） - VPN（IPsec、WireGuard）、PKI/证书管理 - 高可用性（VRRP）、配置快照、diff、回滚和变更请求 - 跨节点的批量操作、Web 过滤、IPAM **监控** - 仪表板和可自定义的 NOC 壁挂式监控屏（15+ 小部件）、网络 Weathermap - 实时接口计数器、WAN 链路时间线和中断监控 - 连接表、DPI 应用可见性（可选的 ntopng 集成） - 日志、每次变更的审计跟踪、报告 **运维** - 多节点、多团队以及基于角色的访问权限（所有者 / 管理员 / 操作员 / 只读） - Web 终端、诊断工具（ping、traceroute、packet capture） - 支持 13 个通知通道的告警（电子邮件、webhook、聊天、Web 推送） - 公开只读演示模式、反馈模块、具有精细化 token 权限的 REST API ## 技术栈 Laravel 12 · Inertia.js v2 · Vue 3 · Tailwind CSS v4 · PostgreSQL（小型部署也可使用 SQLite） ## 快速开始（Docker Compose） ``` git clone https://github.com/jmsperu/vyctl.git vyctl && cd vyctl cp .env.example .env # set APP_KEY (php artisan key:generate --show), DB_PASSWORD docker compose up -d --build ``` 该应用监听 80/443 端口。首次访问将引导您完成创建管理员 帐户并添加您的第一个节点。 ### 在您的 VyOS 路由器上启用 API ``` set service https api keys id vyctl key 'YOUR-LONG-RANDOM-KEY' set service https listen-address 0.0.0.0 commit; save ``` 然后在 VyCTL 中使用 `https://` 和该密钥添加节点。 请为每个节点使用专用的密钥，并在可能的情况下将监听地址 / 防火墙限制为 VyCTL 主机。 ## 本地开发 ``` composer install && npm install cp .env.example .env && php artisan key:generate php artisan migrate --seed composer dev # serves app + queue + vite ``` ## 安全说明 - 路由器凭据在静态存储时已加密。 - API token 包含由 middleware 执行的精细化权限（`nodes:read`、`alerts:write` 等）。 - 对 webhook、安装程序和公开 endpoint 实施速率限制；nginx 配置中内置了 CSP。 - 发现漏洞？请发送邮件至 security@xcobean.com，而不是公开 issue。 ## 许可证 [Apache License 2.0](LICENSE) - 版权所有 (c) 2026 James Peru, Xcobean Systems Ltd. VyOS 是 VyOS Inc. 的注册商标。本项目未受 VyOS Inc. 的 附属或认可。

标签：Docker 部署, Laravel, Vue, VyOS, Web管理界面, 文件系统扫描, 测试用例, 网络测绘, 网络运维, 请求拦截, 防火墙管理