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.
virt/docs/INTEGRATION_PLAN.md

4.9 KiB

Virt Cloud 集成架构

更新:2026-09-27。替代此前“尚未集成”的计划,描述本版实现边界;真实部署仍需测试环境联调。

请求链路

浏览器
  ├─ HTTPS 页面/API → PHP:账户、授权、CSRF、套餐、钱包、订单
  │                         └─ HMAC 内部 API → Python → SSH/libvirt → 宿主机
  └─ WSS /engine-console ──────────────────→ Python → SSH 隧道 → VM VNC

PHP cloudWorker → 持久任务 → Python operation_id → 实例关联/核对/退款
Python 后台采集 → 日志库 engine_vm_metric_samples → 详情页四项图表

PHP 是唯一账户入口,所有用户页面使用原虚拟化面板 CSS;后台保留 venix。没有第二套 Python 注册、SMTP、数据库设置或审核流程。

数据职责

数据 权威写入方 存储
用户、钱包、套餐、原财务/工单 PHP 原业务库表
宿主机索引、订单、实例、公钥、会话、任务 PHP cloud_hosts/orders/instances/ssh_keys/sessions/jobs
宿主机凭据、VM 元数据、镜像、操作进度 Python 主库 engine_records,敏感记录加密
引擎签名防重放 Python 主库 engine_request_nonces
四项性能指标样本 Python 日志库 engine_vm_metric_samples,保留 30 天

多个宿主机使用稳定 host_id,不共用一个可切换的全局“当前宿主机”。模板、IP 地址池、网关、DNS、虚拟机网卡前缀、磁盘/ISO/救援目录均按宿主机设置。地址池与网卡前缀分开:供应商地址池可以为 /28,虚拟机网卡可以为 /24,不能因此把售卖范围扩大为 /24。

PHP 不直接解密 Python 记录或执行任意 virsh 命令。主库与日志库可同实例或分别配置地址/端口。敏感业务数据加密;部署数据库连接配置仍是权限受限配置文件,不代表配置文件本身加密。

购买状态机

  1. 用户选择启用套餐、已有系统来源、公钥/强 root 密码,提交幂等键。
  2. PHP 事务锁定用户钱包与套餐,校验余额、库存、宿主机与实例配额,保存不可由浏览器改写的规格快照,扣款并保存加密任务。
  3. 独立 cloudWorker 获取租约,携带唯一 operation_id 请求引擎。只有经过签名的开通上下文可以创建 VM,用户不能免费创建。
  4. 成功关联实例和凭据;确认创建失败且无残留时只退款、恢复库存一次。
  5. 超时、引擎中断或残留无法确认时保持待核对,只查询原操作,不重复创建或盲目退款。

金额通过精确小数与整数最小单位换算处理,不用浮点完成扣款比较。套餐带宽转换成 libvirt 网卡双向 KiB/s 限制。本轮没有续费、月结、到期停机、自动回收或套餐升级。

安全与控制台

  • 用户 ID、角色、VM 归属由 PHP 确定,不能相信浏览器身份字段;引擎再次检查归属。
  • 管理员与 super_admin 白名单权限分开;跨用户只读不自动获得跨用户写权限。
  • 云 API 写操作校验 CSRF;未登录/无权限返回 JSON,不重定向 HTML。
  • HMAC 覆盖方法、完整路径/查询、请求体摘要、时间戳、nonce、身份。防重放存储是共享的持久数据库/Redis。
  • PHP 签名密钥与任务加密密钥独立生成;任务使用 sodium secretbox 随机 nonce,引擎有独立 master.key。备份时保存密钥,不能删除后期待解密数据。
  • root 公钥和密码可以同时设置,未填密码时生成强密码;root 密码策略独立于网站 bcrypt 的 72 字节限制。

VNC 凭据 60 秒有效、单次、绑定用户/VM/会话,通过 WebSocket 子协议传递而非 URL。连接期间持续校验 PHP 会话,退出或停权会阻止继续访问。线上使用 HTTPS/WSS。

原虚拟化功能与限制

保留云镜像/ISO 创建、UEFI/ACPI、host-passthrough、virtio 队列随 vCPU、开机自启、首次安装重启停止并弹出 ISO、磁盘删除、重装网络保留、救援挂载/卸载、SSH 隧道 VNC。救援正常关机失败不会自动断电,用户可确认硬重启,主动退出救援前 ISO 保持挂载。

重装、救援、删除使用持久操作编号,进程中断不盲目重复破坏性步骤。救援 ISO 为管理员授权原始流上传及摘要校验;线上需配置 FPM/反代超时与大小限制。

尚未实现宿主容量调度、分布式资源预留、IP/MAC 防伪、套餐磁盘 IOPS、备份、热迁移或 HA。线程中断进入待核对,并非完整步骤恢复;后续应增加运维对账与独立执行器。

上线前必须验收真实 MariaDB 并发、两库权限、宿主机固件/网桥/SELinux、cloud-init 与 SSH、浏览器 WSS、会话撤销、失败清理/退款。SMTP 沿用 venix,TLS 证书校验已恢复,自签邮件证书需修复信任链。

全新安装见 DEPLOYMENT.md,历史清理见 PRUNING_REPORT.md。