OneClickVirt 深度分析

OneClickVirt 深度分析

项目概览

Star
• 说明: 348（比 Incudal 16 和 CLICD 175 都高）

Commits
• 说明: 955（非常活跃）

许可证
• 说明: GPL-3.0

技术栈
• 说明: Go + Vue 3 + MariaDB

部署
• 说明: Docker 一键 / 源码编译

API
• 说明: ✅ 完整 REST API（Swagger 文档）+ WebSocket

多语言
• 说明: 中英文双语

MCP
• 说明: ✅ 支持 AI Agent 接入

支持的虚拟化平台（8 个！）

Proxmox VE
• 实例类型: VM + 容器
• 说明: 你正在用的

Incus
• 实例类型: VM + 容器
• 说明: LXD 继任者

LXD
• 实例类型: VM + 容器
• 说明: 传统方案

Docker
• 实例类型: 容器
• 说明: 最广泛

Podman
• 实例类型: 容器
• 说明: 无守护进程

Containerd
• 实例类型: 容器
• 说明: K8s 底层

QEMU/KVM
• 实例类型: VM
• 说明: 纯 KVM

KubeVirt
• 实例类型: VM
• 说明: K8s 虚拟化

不仅仅是开 Windows！ 这个项目是一个通用虚拟化管理平台，可以管理 VM（Linux/Windows）和容器。

核心功能

1. 自动 NAT 端口映射 — 支持 6 种网络类型（NAT IPv4、独立 IPv4、纯 IPv6 等）
2. 流量统计 — IP 级 + 接口级精确统计，每月自动重置
3. 邀请码系统 — 非公开注册，用户等级配额
4. 资源限制 — 实例数/CPU/内存/磁盘/带宽/流量配额
5. 镜像管理 — 自带镜像种子，支持自定义
6. WebSSH + VNC — 终端和图形界面访问
7. 用户管理 — 多用户、角色权限
8. API 文档 — Swagger 自动生成（/swagger/index.html）

对比 PVE 商业模块

虚拟化
• OneClickVirt: PVE + 7 个其他平台
• WHMCS + proxmoxVPS: 仅 PVE

开源
• OneClickVirt: ✅ GPL-3.0
• WHMCS + proxmoxVPS: ❌ ionCube 加密

API
• OneClickVirt: ✅ 完整 REST API + Swagger
• WHMCS + proxmoxVPS: ⚠️ 有限

NAT 映射
• OneClickVirt: ✅ 自动（6 种网络类型）
• WHMCS + proxmoxVPS: ⚠️ 需手动或模块支持

流量统计
• OneClickVirt: ✅ IP 级精确统计
• WHMCS + proxmoxVPS: ⚠️ 依赖 PVE 镜像/宿主机

用户管理
• OneClickVirt: ✅ 自研
• WHMCS + proxmoxVPS: ✅ WHMCS 完整系统

计费
• OneClickVirt: ❌ 自研（简单）
• WHMCS + proxmoxVPS: ✅ WHMCS 完整计费

支付
• OneClickVirt: ❌ 无
• WHMCS + proxmoxVPS: ✅ 几十种支付网关

工单
• OneClickVirt: ❌ 无
• WHMCS + proxmoxVPS: ✅ WHMCS 工单系统

发票
• OneClickVirt: ❌ 无
• WHMCS + proxmoxVPS: ✅ WHMCS 发票系统

前端
• OneClickVirt: ✅ Vue 3 现代 UI
• WHMCS + proxmoxVPS: ⚠️ WHMCS 前端

部署
• OneClickVirt: Docker 一键
• WHMCS + proxmoxVPS: WHMCS + 模块安装

社区
• OneClickVirt: ⭐⭐⭐⭐（348 star）
• WHMCS + proxmoxVPS: ⭐⭐（ModulesGarden）

优劣势总结

优势：

1. 统一管理多个平台 — 一个面板管 PVE + Docker + Incus + LXC
2. NAT 自动映射 — 比 PVE 模块手动配 iptables 强太多
3. 流量精确统计 — IP 级，每月自动重置
4. 开源可改 — GPL-3.0，可以二开
5. API 完整 — 可以对接 WHMCS 或其他系统
6. 活跃开发 — 955 commits，社区比其他项目活跃

劣势：

1. 不能替代 WHMCS 计费 — 没有账单/发票/支付/工单
2. 独立系统 — 不是 WHMCS 插件，需要自己对接
3. GPL-3.0 — 二开必须开源
4. 没有 WHMCS 模块 — 需要自己写

能否替代 PVE 商业模块？

可以部分替代，但不能完全替代。

能替代的部分：

• ✅ VM 创建/删除/启停
• ✅ NAT 端口映射
• ✅ 流量统计
• ✅ 镜像管理
• ✅ 用户管理
• ✅ 资源配额

不能替代的部分：

• ❌ WHMCS 计费（账单/发票/支付）
• ❌ WHMCS 工单系统
• ❌ WHMCS 用户中心
• ❌ WHMCS 促销/优惠码

最佳方案：OneClickVirt 做虚拟化管理层，WHMCS 做计费层，通过 API 对接。

整合方案（通过 API）

WHMCS（计费）←→ OneClickVirt API（虚拟化）←→ PVE/Docker/Incus（底层）

具体做法：

1. 部署 OneClickVirt 面板
2. 添加 PVE 节点（它原生支持 PVE）
3. 写一个 WHMCS Server Module，调用 OneClickVirt API：
   • Create → 调用 OneClickVirt 创建实例
   • Terminate → 调用 OneClickVirt 删除实例
   • Start/Stop → 调用 OneClickVirt 启停
   • GetUsage → 调用 OneClickVirt 获取流量/CPU/内存
4. WHMCS 继续负责计费、账单、支付

这是目前最理想的方案：

• 保留 WHMCS 的计费优势
• 用 OneClickVirt 替代 PVE 模块的虚拟化管理
• 获得 NAT 自动映射 + 流量统计 + 多平台支持

研究 OneClickVirt 的 API 文档，然后写一个 WHMCS 对接模块。目前替换掉pve商业模块最优解。