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.
5.2 KiB
5.2 KiB
当前保留与删除边界
本仓库是独立 Virt Cloud 项目,开发分支为 go。旧项目目录不属于本仓库,也不作为运行时依赖。
保留
- venix 管理主题,以及原虚拟机面板风格的登录页和普通用户页。
- 邮箱注册/登录、验证码、TOTP、可信设备、会话撤销、密码找回、管理员账户管理、公告、工单、邀请、充值与财务能力。
- 云套餐、库存、订单、发票、支付、独立预付费账期、流量额度和三天未支付续费宽限。
- 多宿主机、资源池、容量策略、reservation、具体公网 IP 账本、多 CIDR、云镜像、救援 ISO、快照、防火墙、指标与控制台入口。
- 同地区 direct L3 VPC:后台地区 CIDR 池、用户 VPC/IPAM、实例冷启动连接与断开、宿主机路由投影和维护迁移保留私网 IP/MAC。VPC 不提供跨地区互联、NAT 或二层广播;独立备份恢复和云快照新建实例不继承源实例 VPC。
- 管理员工单 Telegram 通知;普通用户仍只在网页处理工单。
- 公开产品落地页,以及后台统一维护、带草稿和发布历史的全局服务条款与隐私政策页面;法律内容不按域名拆分。
- 后台全局 S3 兼容对象存储应用配置、密钥密封和只读连接验证;管理员可把受支持实例的完整系统盘备份上传到对象存储,并在原宿主机或其他合格的
bridge:br0宿主机使用全新公网 IP 创建独立免计费实例。普通用户可按服务周期购买自动备份,在实例设置中选择每天或每周执行并保留最多两份;全局备份库独立于源实例生命周期,源实例删除后仍可恢复或清理对象。增量链和管理员手工备份的自动保留策略暂未接入。
删除
- 旧 Python/libvirt 引擎的全部代码、服务、配置、密文、内部 API 和数据库兼容路径。
- SSH 驱动的宿主机凭据模型。PHP 不保存 root 密码或私钥;每台宿主机改为本地 Go Agent。
- 旧节点列表、节点管理、代理订阅/流量/等级业务、旧客户端分发、签到、AI、社区聊天、DNS 策略、边缘配置和已退役监控入口。
- Material、Codex 等主题;只保留 venix 管理主题和既有用户面板样式。
- 旧账户哈希、旧代理字段、账户/等级到期、旧引擎表、旧宿主机表和旧任务载荷的导入。
- 云镜像原始来源路径、
source_type/sealed_source_url目录字段,以及面板暂存文件直接签发给 Agent 的cloud-template下载能力;新镜像必须先形成对象存储不可变主副本。
普通用户不得获得 /admin/agents、宿主机、资源池、网络池、镜像后台或系统日志管理能力。删除菜单不是授权边界;PHP 路由和服务层必须继续校验用户、资源所有权、管理员及超级管理员权限。
新职责边界
- PHP 是账户、财务、资源账本、Agent 注册、公共 HTTP 授权和操作协调的唯一权威。
- 每台宿主机的
virt-agent只负责本机qemu:///system、受管磁盘、网络、防火墙、快照、救援、指标和控制台后端。 - 面板到 Agent 的每个请求使用该宿主机独立 HMAC 密钥,并在 Agent 主动建立的 WSS 会话上转发。Agent 不连接面板数据库,浏览器不能直接调用 Agent。
- Agent Gateway 负责 Agent 主动 WSS 会话、PHP 请求转发和反向控制台,不承担账户或 VM 调度逻辑。
数据库边界
web/sql/ss.sql、web/sql/user_log.sql 和 php xcat cloudInit 只用于全新空数据库。安装过程不读取、转换或删除旧生产库;旧库应作为离线只读备份单独保存。
Agent 数字身份、启用状态、版本和测试结果保存在 PHP 业务库,不保存宿主机 endpoint;每宿主机 HMAC 密钥使用面板 cloud_data_key 的用途隔离密钥密封。云镜像及首次启动脚本同样由 PHP 保存,任务派发时快照 revision 与 generation。Agent 的操作日志只保存本机操作边界和结果,不取代业务库。旧格式密文不受理;只能创建全新数据。
配置文件必须可读且内容有效,但应用不得用 owner/group/mode 审核阻止启动。推荐最小权限只是部署加固,不是兼容条件;绝不能因此增加弱密钥、明文传输或公开端口的回退。
业务不变量
- 每次购买只创建一台 VM;同一幂等键和
operation_id不得重复扣款或重复创建。 - 每次续费创建独立账期;提前续费顺延,不提前刷新当前流量。
- RX 与 TX 都计费。额度耗尽、最终到期只断网,不关机;三天宽限结束才删除定义和面板受管磁盘。
- 派发后的超时、断线和进程中断是未知结果。破坏性操作不能自动重放、自动退款或仅靠删除任务记录释放资源。
- VM 使用 Q35 UEFI 并关闭 Secure Boot。镜像首次启动脚本只执行一次,失败或中断也不自动重放。
发布条件
删除旧代码或通过单元测试都不等于可上线。必须按 部署说明 和 验证说明 在非生产环境完成 PHP、MariaDB、Agent、libvirt、网络、UEFI、cloud-init、付款、控制台和失败核对验收。