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 97a17edb92 feat: replace Python engine with Go host agents 1 month ago
agent feat: replace Python engine with Go host agents 1 month ago
config feat: enforce default platform network policy 2 months ago
deploy feat: replace Python engine with Go host agents 1 month ago
docs feat: replace Python engine with Go host agents 1 month ago
gateway feat: replace Python engine with Go host agents 1 month ago
web feat: replace Python engine with Go host agents 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: replace Python engine with Go host agents 1 month ago

README.md

Virt Cloud

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

架构与功能

  • PHP 负责账户、授权、余额、支付、订单、账期、资源账本、Agent 注册和操作协调。管理员在 /admin/agents 为每台宿主机配置固定 IP HTTPS Agent endpoint 与独立 HMAC 密钥。
  • PHP 使用 cloud_data_key 的用途隔离密钥密封 Agent 密钥、任务载荷和凭据;只接受当前版本密文,不导入或尝试解密旧格式。
  • 每台虚拟化宿主机运行 virt-agent,只连接本机 qemu:///system,执行 libvirt、存储、网络、快照、救援、指标和控制台后端操作。面板不保存 SSH/libvirt 登录凭据,也不直接执行宿主机命令。
  • 面板与 Agent 使用 TLS、请求体 SHA-256、时间戳、随机 nonce、操作者上下文和 HMAC-SHA256 签名;每个请求都必须认证,不能把 Agent 端口暴露为公共管理 API。
  • 所有虚拟机使用宿主机能力支持的 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、控制台 relay 和更新 helper 的部署样例
  runtime/   安装时生成的私有状态与密钥,不入 Git
  docs/      架构、部署、运维和验证说明

HTTP 文档根目录必须是 web/public/。普通页面和 API 全部由 PHP 提供。浏览器控制台需要面板侧 virt-cloud-console-relay;它只接收 PHP 签发的一次性票据,不持有宿主机长期密钥。未部署并验收 relay 时必须将控制台功能标记为不可用,不能回退到旧引擎。

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

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

安装与验证

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

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