You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
admin d99dca3ff3 Bust cached user interface assets 2 months ago
deploy Integrate Venix sales portal with private libvirt engine 2 months ago
docs Integrate Venix sales portal with private libvirt engine 2 months ago
engine Integrate Venix sales portal with private libvirt engine 2 months ago
web Bust cached user interface assets 2 months ago
.gitignore Integrate Venix sales portal with private libvirt engine 2 months ago
AGENTS.md Integrate Venix sales portal with private libvirt engine 2 months ago
README.md Integrate Venix sales portal with private libvirt engine 2 months ago

README.md

Virt Cloud

PHP 8.5 网站与私有 Python/libvirt 引擎集成的虚拟机销售面板。使用 venix 分支;main 的原 virsh-panel 不受影响。

本版功能

  • PHP 统一注册、邮箱登录、账户、充值、支付、SMTP、工单;注册后无需创建审核。
  • 用户购买套餐开通 VM,余额扣款、库存扣减、确认创建失败退款;不包含到期、续费和周期扣费。
  • 套餐绑定宿主机,提供 CPU、内存、磁盘、网络带宽规格,用户不能随意修改套餐资源。
  • 管理员管理多宿主机、云镜像和独立救援 ISO;用户选择已有模板及自己的 SSH 公钥。
  • 用户仅操作自己的 VM:控制台、开关机、软/硬重启、重装、救援、删除、初始 root 密码查看/复制。
  • CPU、内存、磁盘 I/O、网络带宽图表;后台持续采集,写入日志库,最长保留 30 天。
  • 全部用户页及登录页使用原虚拟机面板风格;管理员后台保留 venix 样式。
  • 宿主机凭据及任务密码等敏感数据加密保存;内部请求签名,控制台使用短时一次性凭据。

目录与部署

virt-cloud/
  web/       PHP 网站、页面、SQL、测试
  engine/    私有 FastAPI/libvirt 引擎及测试
  deploy/    引擎与开通 worker 的 systemd 配置
  runtime/   私有配置、密钥、引擎数据(安装生成,不入 Git)
  docs/      架构、部署、原清理记录

网站文档根目录必须是 web/public。引擎仅监听 127.0.0.1:8000;不能把整个网站反代到引擎,只有 /engine-console 的 WebSocket 转发给引擎。

全新安装见 部署说明,职责边界见 集成架构。配置使用 web/config/config.php,兼容旧文件名 .config.php;两者存在时前者优先。本版不导入原 Python 面板数据,也不提供在线更新按钮。

验证范围

已进行隔离 PHP 8.5 语法、模板、协议、SQLite 订单状态机和 Python 引擎测试。没有使用真实 MariaDB、SSH/KVM、付款或邮件通道完成生产联调。首次部署请先在测试宿主机验收,再开放销售。

超时后状态不明的任务保持 uncertain,不会直接退款或再次毁盘/创建。管理员需核对宿主机与任务状态,不能靠重复购买处理。这不是自动故障迁移、资源超售防护或高可用平台。

原清理边界见 清理报告。原 /html 与 /virsh-panel 项目未在本轮修改。