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.
 
 
 
codex 913f0fadff Fix admin instance detail rendering 1 month ago
agent fix: isolate libvirt domain names 1 month ago
config feat: enforce default platform network policy 1 month ago
deploy fix: harden agent dispatch and reconciliation 1 month ago
docs build: publish isolated domain name amd64 binaries 1 month ago
gateway fix: preserve VM creation failure cause 1 month ago
release build: publish isolated domain name amd64 binaries 1 month ago
web Fix admin instance detail rendering 1 month ago
.gitignore feat: replace Python engine with Go host agents 1 month ago
AGENTS.md feat: replace Python engine with Go host agents 1 month ago
README.md feat: adopt outbound agent gateway 1 month ago

README.md

Virt Cloud

Virt Cloud 是 PHP 8.5 面板与宿主机 Go Agent 组成的虚拟机销售平台。独立开发线固定为 go;不导入旧数据库,不保留旧 Python 引擎或兼容 API。

架构与功能

  • PHP 负责账户、授权、余额、支付、订单、账期、资源账本、Agent 注册和持久任务协调。管理员在 /admin/agents 为每台宿主机配置独立 Agent 密钥;宿主机不再向面板暴露管理端口。
  • PHP 使用 cloud_data_key 的用途隔离密钥密封 Agent 密钥、任务载荷和凭据;只接受当前版本密文,不导入或尝试解密旧格式。
  • 每台虚拟化宿主机运行 virt-agent,只连接本机 qemu:///system,执行 libvirt、存储、网络、快照、救援、指标和控制台后端操作。面板不保存 SSH/libvirt 登录凭据,也不直接执行宿主机命令。
  • Agent 以 panel_url + agent_id + agent_secret 主动建立 WSS 长连接。PHP 先持久化任务,再通过面板本机 Go Agent Gateway 转发带 SHA-256、时间戳、nonce、操作者上下文和 HMAC-SHA256 签名的请求。断线后只按原 operation_id 对账,不自动重放。
  • 所有虚拟机使用宿主机能力支持的 Q35 UEFI,并明确关闭 Secure Boot。不要硬编码某个发行版的 OVMF 路径。
  • 每个云镜像可配置仅首次安装执行的启动脚本。创建任务会快照脚本版本;脚本成功、失败或中断后都不会自动重放,租户不能读取或覆盖脚本正文。
  • 用户购买套餐开通一台 VM;每次购买或续费生成独立预付费账期及流量额度。额度用尽只断网、不关机;下一已付费账期恢复网络。最终到期只断网;未支付续费账单进入三天宽限期,之后永久删除 VM 定义和面板管理的磁盘。
  • 用户页面及登录页保持原虚拟机面板样式,管理员页面保留 venix 主题。普通用户不获得宿主机管理、Agent 设置或退役节点管理入口。
  • 超时或断线后的破坏性操作保持 uncertain。系统保留原 operation_id 并先核对实际状态,不自动重放、退款或再次删除磁盘。

目录

virt-cloud/
  agent/     宿主机 Go Agent 与测试
  web/       PHP 面板、页面、全新 SQL schema 与测试
  deploy/    Agent、PHP workers、Agent Gateway 和更新 helper 的部署样例
  runtime/   安装时生成的私有状态与密钥,不入 Git
  docs/      架构、部署、运维和验证说明

HTTP 文档根目录必须是 web/public/。普通页面和 API 全部由 PHP 提供。面板侧 virt-cloud-agent-gateway 同时承载 Agent 主动控制通道和反向控制台:浏览器只提交 PHP 签发的一次性票据;Gateway 仅在已连接会话的内存中暂存该 Agent 握手密钥,用于每次普通请求或控制台打开前向 PHP 复核,绝不持久化。未部署并验收 Gateway 时必须将 Agent 操作和控制台标记为不可用,不能回退到旧引擎。

Agent、更新 helper 和 Agent Gateway 只校验配置文件是否可读、JSON 与字段内容是否有效;它们不审计 owner、group 或 mode,不会因为可读文件是 0600、0640 或 0644 而拒绝启动。最小权限仍是运维加固建议,不是应用启动的权限位合规检查。

云镜像只接受经过校验的独立 QCOW2 内容;远程导入只允许可公开解析的 HTTPS 直链,并对初始地址及全部跳转执行 SSRF、大小与摘要校验,自制镜像通过管理员上传入口导入。拒绝 raw/ISO、加密镜像、外部 data file、backing file 和超过限制的文件。镜像来源的发行方可信度由管理员负责确认。

安装与验证

这是全新数据库版本。只能向空的业务库和日志库安装,旧表、旧密文、旧宿主机凭据及旧任务不能迁移或复用。完整步骤见 部署说明,职责与协议见 集成架构,验证门槛见 验证说明。

开放销售前必须在非生产宿主机完成 MariaDB 并发、Agent WSS/HMAC、UEFI、cloud-init 启动脚本、VM 生命周期、反向控制台、指标、流量、HTTPS 镜像/救援、付款和故障核对验收。单元测试通过不代表生产环境已验收。