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/VALIDATION.md

1176 lines
109 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 本版验证记录
## 2026-10-14:VPC 退出清理与后台回执读取
- 现场退出任务在私网网卡已移除后停留于 `vpc_remote_command_failed`:
Debian ifupdown 文件由 apply 写入完整 VPC/revision/digest 头,但 remove
两处错误要求整行等于不含 revision/digest 的短头,导致合法自有文件被拒绝。
两处统一提取精确 owner 前缀后的身份,并保留既有 VPC、版本、摘要、权限、
非符号链接及拓扑校验;不放宽跨 VPC 或未来版本的删除条件。
- 修复独立租户 worker 的单目标 VPC GET 被管理员门槛拒绝的问题。PHP 仍负责
租户归属校验并签名内部请求;全量 VPC 列表及宿主/Fabric 管理仍仅管理员可读。
- 页面优先显示当前工作流已暂停及其原因,避免底层等待回读掩盖手动接管状态。
- Python 3.12:dataplane 文件 **67 passed**;边界文件 **187 passed、1 failed**。
唯一失败是既有 Fabric `vpc_ready` 断言,已在修改前 HEAD 的同环境复现。
新增回归直接执行真实 apply 生成的文件头和 remove 两阶段代码;旧实现四项
均以 71 失败,新实现通过。签名租户单目标 GET 在旧实现返回 403,新实现通过,
并验证无签名及管理员资源仍拒绝访问。
- Node 页面行为、成员选择及语法检查通过;PHP 8.5 WASM 页面契约通过。
- 现场已快进部署 `1d858ff`,源码权限限定为本次受版本管理的普通文件 `0644`;
引擎、PHP-FPM 和常驻 worker 按顺序恢复,签名健康检查通过。部署前没有进行中
的普通任务,原退出操作为 paused。
- 按用户确认,通过面板正常关机(任务 20 succeeded),再对原退出操作
`15de1269a559c1078ea86c111baa0cf1` 点击一次“核对 / 重试”。该操作保持
revision 3 并完成,`config_confirmed=true`、`resume_cancelled=true`;
面板目标/观测均为 3、sync=`applied`、错误为空,VPC 保留为待添加实例。
MariaDB 只读核对确认成员与私网 IP 行均为 0,没有直接写库或新建退出任务。
- Debian 宿主实测:目标实例 `virsh domstate` 为 `shut off`;持久 XML 仅保留
公网 `br0` 网卡;VPC 私网桥、ifupdown/nft/sysctl/owner/state/proxy 文件及
事务目录均不存在,路由表 11069 为空,规则 29748/29749 和该 VPC nft 表
已清除,WireGuard AllowedIPs 与 proxy ARP 均无原私网地址 `10.0.0.1`。
- 本次完成了既有单成员退出的真实宿主验收;未重新开机、创建新成员或进行
跨宿主流量测试。最初自动关机没有留下引擎子操作回执的原因仍缺少现场日志,
不将它归因于本次已证实的 ifupdown 清理缺陷;正常关机任务的现场路径已成功。
## 2026-10-14:VPC 加入暂停后的回执恢复
- 修复运行中的成员已在引擎完成配置,但 PHP `applying`/暂停步骤在读取回执前
要求再次停机的问题。仅对已进入 apply 的工作流先 GET 原 VPC 回执;严格匹配
operation、revision、digest,并复用完整宿主/成员证据校验。404 或合法旧版本
才回到原停机门;不完整证明不完成流程,错误目标/摘要/新版本不重新派发。
- 回执恢复保留 root、operation、instance 身份与租约保护,以及后续手动电源意图。
读回执失败时保留原 `paused_from`,避免重复暂停产生非法步骤。配置证明确认后
才进入既有开机恢复逻辑;原本停机或已手动接管的实例不发送电源命令。
- 宿主完整配置已验证但来宾停止时,Python 继续输出已验证的 `acl_revision`;
运行可用性仍等待来宾证据。旧 revision、错误 digest、缺少 nft 证明仍拒绝确认。
- 在线更新器纳入 `virt-cloud-vpc-worker.service`,随已安装且正在运行的服务停止,
引擎健康后恢复,避免源码更新后独立 PHP daemon 继续运行旧类。
- Python 3.12:`test_vpc.py`、`test_vpc_dataplane.py`、`test_update_worker.py`、
`test_update_preflight_coordination.py`、`test_updater.py` 合计 **192 passed、
20 subtests passed**,24 条已有警告。新增 ACL/更新服务测试已在旧实现复现失败。
- PHP 8.5 WASM/SQLite:`CloudVpcPowerWorkflowTest`、`CloudVpcFailedReconcileTest`、
`CloudVpcRootDeletionTest`、`CloudVpcTombstoneConvergenceTest`、
`CloudVpcMutationAdmissionTest`、`CloudPowerReceiptWorkflowTest`、
`CloudVpcControlPlaneContractTest`、`CloudVpcMemberCandidateRecoveryTest`
**8 项脚本通过**。新增暂停回执测试在 `d8debc5` 的独立源码快照失败。
覆盖无额外 apply/电源调用、证据缺失、读失败、租约/版本/实例变化和手动接管。
- 现场已将 `48ecd03` 快进部署至面板 `venix`,重启引擎及 PHP 常驻服务,
签名健康检查通过。首次手动部署因新 checkout 文件为 `0600` 导致 apache
无法加载 PHP 类;已仅将本提交的源码/文档文件恢复到既有 `0644` 并以 apache
验证可读。手动部署不可遗漏正式 updater 的 `_normalize_checkout_permissions`
步骤;不能把 runtime/凭据文件一起放宽。
- 原 VPC `cs` 的 revision 2 加入任务经页面“核对 / 重试”恢复:成员
`vm-s6x9eb`/`10.0.0.1` 显示已生效,自动流程已完成,目标与观测 revision
均为 2,sync=`applied`,错误为空;刷新后仍保持完成。宿主只读 `virsh domstate`
确认实例仍为 running。没有新建加入任务、直接改写成功状态或发送 VM 电源命令。
- 本地测试不替代 MariaDB 并发、真实宿主新增/退出或跨宿主流量验收。本次现场
验收覆盖既有单成员的精确回执恢复,不包含新增第二成员或双向跨宿主流量测试。
## 2026-10-14:VPC 自动加入/退出及默认组内 ACL
- 新版页面确认短暂中断后提交 `auto_power: true`。VPC 操作独立保存电源进度:
正常关机回执、确认停止、既有严格配置/清理证明、恢复原运行状态。
原本停止或已经在关机的实例不会被自动启动;120 秒关机等待超时暂停,
不自动强制断电,不把 QGA 私网核验加入普通电源任务完成条件。
- `cloud_vpc_operations.power_workflow_json` 和带索引的 `power_instance_id`
是可空增量字段。按实例索引定位待核对任务,避免加锁查询扫描全部操作;不改变 VPC
immutable payload/digest。旧任务、缺省 `auto_power` 的 API 请求保持原行为;
未升级字段时普通电源任务仍可入队,新自动流程拒绝接纳。
- 子电源操作先保存固定 ID 再派发,恢复时查询原回执。后续手动电源意图取消
自动开机,也禁止旧流程补发尚未执行的关机。最后成员的 NIC/IP 已清理、
但电源恢复未结束时,禁止该实例被另一 VPC 工作流接纳。
- 新 VPC 在同一创建事务中保存自身 `/24` 的两条全协议 allow ACL,分别为
ingress 32760、egress 32761。现有规则不回填,创建请求重放不恢复用户删除的
默认规则。空 VPC 仅完成地址/规则预留,不伪造宿主已安装 ACL 的证据。
- Python 3.12:`test_vpc.py`、`test_vpc_dataplane.py` **137 passed**;保留
19 条既有 ElementTree truth-value 弃用警告。额外将 PHP 实际生成的默认 ACL
DTO 交给 Python 解析和 coordinator,验证摘要一致、空 VPC 预留,以及同宿主/
跨宿主 nft 输出仍先执行身份、防伪与跨 VPC 隔离检查。
- PHP 8.5 WASM/SQLite:自动电源完整 worker 流程、普通电源回执、创建策略、
根 VPC 删除、tombstone 收敛、失败重试、实例任务准入、页面契约、控制面契约、
快照、未派发创建失败共 **11 项脚本通过**。自动流程测试复用成员/私网 IP
复用测试;覆盖开机回执丢失、旧版本任务、超时手动 force-off、初始 shutdown、
持久进度损坏、跨 VPC 竞争和旧数据库结构。准入测试对 MariaDB NOWAIT 错误
作注入验证;SQLite 不能证明真实 MariaDB 并发行为。
- Node 页面行为和成员选择 **2 项脚本通过**,包含确认取消不发送请求、显式
auto_power、当前操作进度、最后成员退出后的重试入口和错误提示。
- 扩展财务工作流在旧创建核对断言处失败;防火墙工作流因既有
`GuzzleHttp\\Handler\\HandlerStack` 导入失败。两项均在修改前 `387237a` 的
独立源码快照、相同运行时复现,未为本次功能放宽断言。
- 未操作生产、未做真实 MariaDB/libvirt/QGA/转发验收。部署需通过
`php xcat cloudInit` 应用增量字段,再加载新版 PHP/worker;在线更新器已有
该步骤。使用和验收边界见 [VPC 自动成员流程](VPC_AUTOMATIC_MEMBERSHIP.md)。
## 2026-10-13:按镜像配置首次启动脚本
- 管理员镜像目录新增启动脚本对话框和独立接口;超级管理员可写、普通管理员
只读、租户不可访问或通过创建请求覆盖。脚本存入加密镜像记录,使用 revision
与镜像 created_at 防止过期页面覆盖;公开目录和任务 DTO 不返回脚本正文。
- 仅初次创建时封存所选镜像脚本到 NoCloud seed;重装、ISO 和现有实例不注入。
guest 内 root/Bash 在 final 阶段执行,系统盘原子标记阻止密码/主机名变更带来的
instance-id 轮换重新执行;成功、失败及中断均不自动重试,不依赖 QGA 或电源锁。
- Python 3.12 定向回归:`test_startup_script_seed.py`、`test_cloud_init.py`、
`test_libvirt_service.py` 合计 **325 passed、81 subtests passed**;
`test_cloud_template_startup.py` 与 `test_cloud_template_runtime.py` 合计
**56 passed**;`test_startup_script_dispatch.py` **5 passed**。
- 扩展既有 `test_engine_boundary.py`、`test_app.py`、`test_cloud_templates.py`
回归 **296 passed、3 failed**。三个失败已在修改前 `699e0d6` 的独立源码快照、
相同依赖下逐项复现:Fabric `vpc_ready` 断言、旧创建测试缺少平台策略预期字段、
旧重装测试读取不存在的 `detail`。未修改或放宽这些断言。
- Node 对话框行为测试、PHP 8.5 WASM 控制器权限/转发测试及镜像错误合同测试通过。
覆盖 CAS、读取失败禁止保存、关闭/切换后的旧响应、重复提交、UTF-8 字节上限及
文本转义;PHP 测试不等于 MariaDB/线上会话验收。
- 使用真实 Chrome、本地模拟 API 和项目 CSS/JS 验证 1440 px 桌面及 390 px
手机对话框的打开、编辑、保存和 Escape 关闭,无 JS 错误或水平溢出。
完整 Smarty 编译测试因本机测试依赖缺少 Smarty 未执行成功,未记作通过。
- 无新数据库表;未部署生产,未执行真实来宾 cloud-init 首次启动验收。
配置与运行日志说明见 [镜像首次启动脚本](IMAGE_STARTUP_SCRIPTS.md)。
## 2026-10-13:在线更新预检失败不再遗留全局维护占用
- Git/令牌/版本只读预检先于全局维护接纳,且不持有 `active_job()` 使用的本地
更新器锁;远端查询缓慢或初次返回 502 时,无关宿主 VM 仍可写入。
维护 claim 初始即绑定随机任务 ID,创建任务时再次核对本地与远端版本。
- 新任务首次保存之前的明确失败返回 `UpdateNotQueued`,释放本次占用;进入任务
发布后的数据库回执丢失、取消等待但线程仍可能发布等情况继续保留保护。
即使发布后返回 HTTP 409,也不误用 4xx 作为“没有执行”的证明。
不改变独立更新服务 fetch 后的版本核验、终态释放及旧未知记录恢复边界。
- 新增 12 项真实 Updater、签名 ASGI、持久协调回归:初次 502、慢预检期间其他
宿主写入、最终版本变化/502/普通异常释放、job 与 active pointer 落库后丢回执、
两次 apply 竞争只发布一个任务,以及取消后线程继续发布仍受保护。
两项核心复现测试在修改前 `3ca8cfa1316e8b53bb5d93f3130c4c25139bfdce`
独立源码快照中均失败,分别观察到无任务却返回 `coordination_uncertain`、
预检未结束便返回 `coordination_busy`;新代码全部通过。
- 9 个相关文件统一回归:**308 passed、18 subtests passed、1 failed**,21.84 秒。
范围包含更新器、更新 worker、维护协调、引擎并发/HTTP 边界、持久协调、停机和
旧面板数据库 HTTP 接口。唯一失败为
`test_fabric_is_engine_global_and_super_admin_write_only` 的 `vpc_ready` 断言;
已在上述修改前源码快照、相同 Python 3.12 依赖中复现,未修改或放宽该断言。
- `git diff --check` 与独立复核通过。无 schema 变更,未部署生产、未核查或清除
线上旧维护占用/更新任务;未执行真实 Gitea/systemd/MariaDB 更新验收。
状态发布边界与记录位置见 [更新维护协议](ENGINE_COORDINATION.md#在线更新预检与任务发布2026-10-13)。
## 2026-10-13:成功写入后的查询与连接关闭不再封锁宿主机
- libvirt RPC 改为逐次持久化待确认写入和对应成功回执;正常回执确认后,后续
`info()` 超时只报告观察失败,`close()` 超时记录独立清理错误,不再因历史写入
留下宿主级阻断。VMService 保留已确认的电源命令结果,清理错误写入脱敏日志。
工作流累计写入证据不清零,多步骤任务仍需各自完成与清理证明。
- 真正丢失回执、响应格式错误、回执持久化失败及停机竞态仍保留保护;后续成功
不覆盖前一次未知写入。原生 libvirt 错误保留独立记录,允许原有存储池
`build()` 失败后 `create()` 的回退核验;后续连接失败不会将它误确认为成功。
快照冻结/解冻凭据独立保留,流 `finish()` / `abort()` 纳入写入回执边界。
- Python 21 个相关测试文件统一执行:**764 passed、81 subtests passed、3 failed**,
耗时 65.65 秒。新增两套真实 spawn/socket 故障注入回归,覆盖 domain/QGA 写后
读取及关闭超时、同宿主其他 VM 继续写入、重启后行为、第二次写回执丢失、
unlink/fsync 失败、并发 ACK 串行化、已关闭句柄、原生错误回退与旧记录保护。
同时覆盖 VMService 持久锁释放、快照恢复、未派发证明、资源锁及停机回归。
- 三项失败在修改前 `e55b26f1fd31fc2304c56d8a8f7841cffdf1f871` 的独立
源码快照及相同 Python 3.12 依赖中再次复现,失败位置一致:
`test_cloud_template_import_job_and_create_dispatch`(策略快照旧断言)、
`test_reinstall_cleanup_pending_is_not_reported_success`(错误字段旧断言)、
`test_fabric_is_engine_global_and_super_admin_write_only`(Fabric readiness)。
未修改或放宽这些断言,不宣称整个测试集通过。
- `git diff --check` 通过,独立复核未发现阻断项。无 schema 变更,不迁移或
自动清理旧任务、协调锁及版本 1 RPC 文件。未部署生产,未执行真实 Linux
libvirt/SSH/QGA/systemd/MariaDB 验收或大镜像上传性能测试。
协议与恢复边界见 [libvirt 执行说明](LIBVIRT_EXECUTION.md#写入结果未知与恢复)。
## 2026-10-13:未派发失败不再留下或扩散 VM 持久锁
- 状态/XML/创建前检查失败、RPC 排队超时以及被其他 VM 的存储占用拒绝,
仅在当前执行具备完整无写入证明时保存 `failed`、`mutation_started=false`、
`execution_outcome=not_dispatched` 并释放本次占用。旧阻塞执行保持原样。
写入、取消、数据库/CAS 提交不明和未完成的后台交接继续保留保护。
- 重装、快照、救援的后台未派发失败须成功处理本地目录与任务记录;公网 IP
变更须先回滚新 IP 预留。创建退款仍单独核对不存在与清理证明。
PHP 只对精确绑定的未派发删除失败恢复用户操作准入,不恢复到期删除实例。
- Python 19 套相关回归统一执行:**738 passed、81 subtests passed、3 failed**。
覆盖四个新增 prewrite 测试文件,以及 RPC、libvirt 服务、资源锁、持久协调、
后台交接、停机、宿主范围、连接准入、应用并发与签名引擎边界。
新增负向用例包括写后失败、伪造/缺少证明、旧锁不变、丢失 CAS 回执、
先被拒绝后发生未知结果、后台交接竞态、数据库错误经 HTTP 序列化、
IP 与快照目录回滚失败、救援 force/exit 恢复原任务归属。
- 三项 Python 失败均在修改前 `2b87fe89f2fb570be9a3a1f10e952a9fa36efda8`
的独立源码快照、相同 Python 3.12 依赖中复现:
`test_cloud_template_import_job_and_create_dispatch`、
`test_reinstall_cleanup_pending_is_not_reported_success`、
`test_fabric_is_engine_global_and_super_admin_write_only`。
本次仅为跳过 RPC 的已有模拟创建/删除服务补上写入标记,未放宽上述失败断言。
- PHP 8.5 WASM + SQLite/Eloquent:扩展的 `CloudPowerReceiptWorkflowTest.php`、
新增 `CloudPrewriteFailureWorkflowTest.php`、`CloudSnapshotWorkflowTest.php`、
`CloudOperationErrorCatalogTest.php` 均通过。使用真实客户端/worker 验证
503 明确失败只退款释放一次、缺少清理证明不退款、后续强制断电、删除准入恢复
及到期策略保持。额外执行 `CloudFirewallWorkflowTest.php` 遇到第 517 行既有
`GuzzleHttp\Handler\HandlerStack` 导入错误;同样在上述修改前源码快照复现。
- `git diff --check` 通过,独立复核未发现剩余阻断问题。本次无数据库 schema
变更、历史任务迁移或自动解锁;未部署生产、未执行真实 libvirt/MariaDB 验收。
执行协议见 [引擎协调说明](ENGINE_COORDINATION.md#执行前失败与准入拒绝2026-10-13)。
## 2026-10-13:普通电源命令回执与状态观察分离
- `start/shutdown/reboot/poweroff/reset` 的 libvirt 调用成功后返回
`{uuid, action, command_accepted: true}`,不再等待最终电源状态或读取展示数据。
来宾忽略正常关机时任务仍完成,后续强制断电可接纳;真实回执丢失仍为未知结果,
不从瞬时状态推断成功,也不自动重放。
- PHP 仅对绑定原 POST actions 路径、UUID、action 和操作编号的确认回执,跳过
私网协调及 VPC expectation 完成门禁;不伪造 VPC 可用性、不改变到期/流量策略。
VPC 仍由独立周期协调核验。删除、重装、网络及服务策略的证明要求不变。
- 页面确认任务后释放按钮,实际状态独立刷新;移除专用 60 秒关机等待,新命令使
旧状态请求失效。救援预挂载后的开机回执也不承担救援启动证明,由救援 GET 回读。
静态资源版本为 `2026101301`。本次没有旧任务、协调锁或 RPC 标记的迁移/自动解锁。
- Python 相关回归合计 **571 passed、81 subtests passed、3 failed**:
`test_libvirt_service.py`、`test_resource_locks.py` 为 256 passed / 81 subtests;
`test_app.py`、`test_engine_boundary.py`、`test_engine_coordination.py`、
`test_app_vm_concurrency.py` 为 265 passed / 3 failed;
`test_libvirt_service_rpc.py`、`test_durable_coordination.py`、
`test_libvirt_rpc_failures.py` 为 50 passed。
三项失败已在修改前 `c9f2fdb9` 独立源码快照以相同依赖逐项复现:
`test_cloud_template_import_job_and_create_dispatch`(策略快照旧断言)、
`test_reinstall_cleanup_pending_is_not_reported_success`(错误字段旧断言)、
`test_fabric_is_engine_global_and_super_admin_write_only`(Fabric readiness)。
本次未放宽或修改这些断言。强化后的救援 HTTP 用例另行通过,不重复计数。
- 新增 `CloudPowerReceiptWorkflowTest.php` 使用 PHP 8.5 WASM、SQLite/Eloquent
与真实 worker/任务准入服务,覆盖五种电源回执、失效 QGA/私网、revision 变化、
后续强制断电、未知回执仍阻断、错误身份不豁免和其他生命周期门禁。
`CloudPowerActionBehaviorTest.mjs` 执行真实前端函数,覆盖按钮立即释放、
慢查询、失败查询、迟到响应隔离与未知任务提示;上述两项及
`CloudInstanceReadPerformanceTest.php` 均通过。
- 其余 PHP 回归 `CloudOperationErrorCatalogTest.php`、`CloudInstanceMetadataTest.php`、
`CloudVpcTombstoneConvergenceTest.php`、`CloudVpcControlPlaneContractTest.php` 通过。
扩展检查另有三项既有失败,已用 `c9f2fdb9` 源码及相同依赖复现相同失败点:
`CloudFinancialWorkflowTest.php:504`(reconciliation/email 断言)、
`CloudBillingLifecycleTest.php:838`(未知删除与策略串行断言)、
`CloudProtocolTest.php:60`(缺少 `CloudOperationErrorCatalog` 导入)。
本次未修复这些无关失败,未宣称完整 PHP 测试集通过。
- 验证使用模拟 libvirt、内存/SQLite 数据库,没有连接生产宿主、部署或重启服务。
不代表真实 libvirt、QGA、MariaDB 并发或浏览器端到端验收。
API 依据与契约详见 [执行协调说明](ENGINE_COORDINATION.md)。
## 2026-10-12:VPC 添加实例候选归属修复
- 根因是用户页面仅排除当前 VPC 的成员,实例列表未携带其他 VPC 的归属。
后端原有全局成员唯一约束与加入校验仍会拒绝重复加入;本次修复可选列表,
没有开放一台实例同时加入多个 VPC。
- bootstrap 批量核对成员、私网租约及用户自己的 VPC:已占用、清理中及
归属无法核实的实例均禁用,并说明原因;查询失败不沿用旧的可加入结果,
不泄露其他用户的 VPC 名称。切换、创建、成员修改和轮询会刷新候选,
10 秒读取超时释放页面等待状态,过期响应不能覆盖新状态或清除未保存草稿。
- 兼容旧版本已完成删除却残留成员/租约的记录:在原 VPC 显示“核对 / 重试”,
仅显式核对且没有待处理操作时,复用原有严格删除凭据校验释放残留。
普通 GET 不清理记录;无凭据、有路由引用或存在未决操作时仍拒绝释放。
- 两套 Node 行为回归 `CloudVpcUserPageBehaviorTest.mjs`、
`CloudVpcMemberChoicesTest.mjs` 通过;PHP 8.5 WASM + SQLite/Eloquent 环境中
`CloudVpcPageMembershipTest.php`、`CloudVpcMemberCandidateRecoveryTest.php`、
`CloudVpcMutationAdmissionTest.php`、`CloudVpcFailedReconcileTest.php` 和
`CloudVpcUserPageContractTest.php` 通过。复用测试夹具执行的成员/私网 IP
回收合同也通过,不将重复执行统计为新增用例。
- 本次未更改数据库结构、Engine、宿主网络或 ACL 策略;前端资源版本提升为
`2026101203`。验证范围为源码回归,未部署线上面板,也未执行真实浏览器或
MariaDB 验收;此前双宿主通信验收记录不等同于本次页面变更的线上验收。
## 2026-10-12:VPC 邻居持久化与双宿主互通
- 真机根因:无 IPv4 地址的私网 bridge 发出的 ARP 使用宿主公网源地址,
来宾私网接口的严格 `rp_filter=1` 与该源地址的公网反向路由不一致,导致
邻居解析失败。手工 PERMANENT 邻居能恢复通信,但旧周期 apply 会重新
down/up bridge 并清掉邻居,不能作为持久修复。
- 本次将本地成员的精确私网 IP/MAC 纳入受管 `local_neighbor` 状态、事务
回滚、Fabric 恢复与回读;升级 helper 契约检查在网络写入前拒绝旧实现。
成功应用凭据及新鲜状态核对避免健康周期重复修改网络,XML、seed、QGA
核验仍照常执行。机制与旧环境迁移步骤见
[VPC 数据平面验收](VPC_DATAPLANE_ACCEPTANCE.md)。
- 本地受影响的 12 套 VPC/Fabric 回归 **917 passed / 19 warnings**,耗时
295.50 秒;warnings 为现有 Element truthiness 弃用提示。覆盖邻居
apply/restore/rollback、未知或冲突条目拒绝、旧 helper 门禁、重复协调、
回执失效与完整状态漂移。Python AST、12 个渲染脚本的 shell 语法及
`git diff --check` 通过,独立复核未发现阻断问题。
- 真机范围为 Debian/ifupdown 与 AlmaLinux/NetworkManager 两台宿主,
每台各一台 VM。经用户确认,仅对 `10.0.0.1/32` 与 `10.0.0.2/32`
配置双向 ingress/egress 全协议允许,面板及两台宿主均核实 revision 4。
两台 VM 的 QGA 仅增加 `virt_qemu_ga_t` 执行 `ifconfig_exec_t` 文件所需
权限,保持 SELinux Enforcing、`virt_qemu_ga_run_unconfined=off` 及
私网接口 `rp_filter=1`;该 SELinux 权限按文件类型生效,不限制命令参数。
两台宿主调用固定 QGA 路由探针均退出 0,读到真实私网路由。
- 线上已有其他热修,先备份并核对源文件哈希,只部署本次三个 Engine 文件;
未 reset/pull 覆盖原有改动。两台宿主在 Fabric 锁下完成受控 helper-only
升级并保留旧文件;恢复 timer、Engine 与 VPC worker 后,正常后台协调
自动迁移两台旧 state,无需改数据库或重存 ACL。未修改 libvirt 启动依赖。
- 2026-10-12 06:20–06:29 UTC 实测:两侧 state 均含准确的本地邻居记录,
内核均为 PERMANENT,无活动事务 journal;各 190 秒 `ip monitor link`
均无事件,跨多个正常协调周期未再出现 bridge 重置。Fabric timer 均 active。
Engine 只读状态中 Fabric、VPC、两台 host 均 active,私网/配置/传输核验
成功且无错误;用户页面两个成员均为“已生效”。
- 双向各 **180/180 ICMP**,丢包率 0%;同步就绪后双向各 **120/120 TCP**
和 **120/120 UDP** 成功。首轮一侧先于对端监听开始统计,出现 10 次启动
阶段失败,延长就绪等待后完整重测通过;两个临时监听均已自动退出。
- 本次未进行宿主重启、同宿主双 VM、拒绝规则或跨租户负向包测试;这些仍需
独立真机验收,不能由上述允许通信及本地回归推定通过。
## 2026-10-10:firewalld 支持退役
- 当前 Fabric/VPC 宿主机只支持 `native_nftables`。能力探测只在 `nft` 命令可用、
规则集可读、firewalld 无法接管,并且
`firewall_manager=nftables`、`firewall_mode=native_nftables` 时允许 readiness。
stock `nftables.service` 的 active/enabled/load 状态仅作诊断,不再作为 nft
能力或平台受管规则恢复的门禁;运行时 guard 同样直接只读核验 nft API。
旧 `firewalld_nft` 输入、manifest、journal、zone/rich-rule 所有权或实时
`inet firewalld` table 必须 fail-closed,不得在普通 apply/reconcile 中静默
映射、接管或删除。
- PHP readiness 边界会再次核验原生 nftables 模式;即使旧 Engine 将
`firewalld_nft` 回报为 ready,页面也必须关闭写入并显示维护迁移阻断。
- 本次本地已通过受影响的 Engine 完整回归 **536 passed**、Python 编译检查、
`admin-fabric.js` 语法检查、`AdminFabricWizardBehaviorTest.mjs` 前端行为回归
及 `git diff --check`。
当前工作区没有 PHP CLI 且没有 `web/vendor/autoload.php`,因此本地未能
执行 PHP lint 和 PHP 合同/readiness 测试;发布前必须在完整 PHP 依赖环境补跑。
- 本节之后仍出现的 firewalld 段落只是 2026-10-08/09 的历史实测与旧实现
记录,不表示当前仍支持该模式,也不能作为新部署验收依据。
- 仍需在 AlmaLinux 10 和 Debian 13 验证 native nftables apply/readback、
panel-owned service/timer 修复、宿主重启、WireGuard 握手、VPC 允许/拒绝流量
及失败回滚;本地静态回归不代替这些真机证据。
## 2026-10-09:严格 NM shadow 恢复与丢失回执只读查询
- Fabric 的共享 NM 归属检查只新增对固定 runtime shadow 的支持:持久/临时
文件均须 regular、无 symlink、root:root 600,runtime 父目录安全;UUID/name
唯一,来源 metadata 精确,所有网络及私钥字段在内部比较一致。仅 runtime
`zone` 与精确 shadow 元数据可不同;前后内容 hash 和 FILENAME 再读须一致。
外部 underlay profile 的通用查询规则不变,不因路径在 `/run` 就接管。
- 首次部署已发布 helper 后失败时,只有 journal 的 absent baseline、当前计划
digest、已发布文件与 desired post-image 完全一致,才允许用当前实现的临时
helper 恢复;不覆盖旧文件来绕过归属检查,不清空 nft 或删除 journal。
- BOOT/helper 在失败时新增固定 `helper_phase` 与退出码日志,正常成功和正常
`--needs-repair` 探测保持静默,原退出码保留。新增结构化记录不输出配置、
私钥或命令;这不等于已有外部工具的所有 stderr 都已净化。
- 前端丢失 POST 回执后最多 180 秒/36 次 GET 查询,连续失败上限 12 次,
期间所有写操作关闭;用请求前 operation identity 排除历史终态,只跟踪
本轮新任务或明确恢复的同一未结任务,不自动重放 POST。
- 稳定源码分组回归:既有 Fabric 六套 **530 passed**、proc **90 passed / 9 skipped**,
route/Engine boundary/VPC/dataplane/firewalld 五套 **498 passed / 23 warnings**;
完整首次部署/helper phase/NM shadow 三套 **117 passed**,完整外层 recovery
dispatcher 四个同计划/外部替换/错误 digest/runtime 密钥漂移用例通过。
前端行为、三个 PHP 合同、JavaScript/Python 语法与 diff 检查通过。
- 本段是源码交付边界。此前真机失败见下节;新的在线更新、双机 overlay、
租户 VPC 和重启恢复结果必须另行记录,不能由本地测试推定。
## 2026-10-09:26351f8 真机更新与 NetworkManager runtime shadow
- 后台在线更新成功,面板 SSH 确认 HEAD 为
`26351f8b3bb2c7782bf2fb3bdaf11a6d4690b972`,Engine 已在源码更新后重启。
fresh 检测 2/2 能力就绪;仅对现有固定计划提交一次重新核对。
- POST 返回 502,但刷新只读页面及两台宿主 journal 均证实新 operation 已接纳。
不能将响应丢失当作没有执行,也不能自动重放 POST。接纳前同步 probe 与
per-Fabric 锁等待仍可能超过网关超时;此前前端需手动刷新才能发现新 operation。
- Alma 的新失败在 `identity/ownership_conflict`。通过实际生成脚本中的只读函数
证明 emergency owner/inet/bridge shape 均成功,固定 KEY/OWNER 权限和公钥正常;
`vc_fabric_nm_profile_owned` 失败,因为 NM 活动连接的 FILENAME 指向 `/run` shadow,
而当前代码仅允许 `/etc` 持久文件。临时副本 root:600、同 UUID/接口/网络字段、
`zone=trusted`,且 `.nmmeta` 精确指向平台持久文件并标为 shadowed-owned。
- [NetworkManager 官方 IN_MEMORY 契约](https://github.com/NetworkManager/NetworkManager/blob/main/src/libnm-core-public/nm-dbus-interface.h#L1135-L1145)
说明 IN_MEMORY 使用 runtime keyfile 覆盖并保留持久来源;这是平台的
`connection modify --temporary` 正常行为,不是系统升级、chmod 或缺少 iproute2。
[官方 keyfile writer](https://github.com/NetworkManager/NetworkManager/blob/main/src/core/settings/plugins/keyfile/nms-keyfile-writer.c#L252-L262)
写入 `shadowed-storage` 与 `shadowed-owned` 来源元数据。
修复必须核验精确 runtime 路径、权限、来源和完整网络/密钥语义;不得泛化接管
任意 `/run` profile,也不得用 connection delete 清除 shadow。
- Debian 同轮推进至最终回读,主 Fabric 恢复服务退出 71、repair 退出 79,随后回滚。
尚无 helper 内部阶段证据指认具体失败条件;正在增加仅固定阶段/退出码的安全日志。
双宿主 active、双向 overlay、租户 VPC 与重启恢复仍未通过。
## 2026-10-09:真实过滤路由输出省略设备字段
- 后台在线更新与面板 SSH 均确认 `b11856d` 已部署且 Engine 已重启;fresh
检测通过后只对固定现有方案执行一轮重新核对。Debian 13 与 AlmaLinux 10
都推进到 `final_readback` 后失败,不能将能力检测通过等同 Fabric 可用。
- Alma 实际 `ip -o -4 route show table all dev wg-fabric0` 返回 peer host route
和自身 local route,但省略每行的 `dev` 字段。只读复现确认原解析把 device
置空并拒绝合法路由。这是查询/输出契约缺陷,不是缺少 chmod 执行位。
- [iproute2 官方源码](https://github.com/iproute2/iproute2/blob/v6.17.0/ip/iproute.c)
中接口过滤设置 `oifmask=-1`,序列化时故意省略 device。因此只有对应的
`dev` 过滤查询允许从其固定查询范围补回设备;无过滤查询仍要求显式设备,
显式错误/重复/畸形设备和无 OIF 的非普通路由不能被推定为受管接口。
- 当前现场保留事务及紧急隔离,不清空 nft、删除 journal 或关闭防火墙。
本段记录定位证据;修复后的真实双向 overlay 和重启验收仍须单独完成。
- 稳定源码分组回归:Fabric/proc/nft/NM/systemd 七套 **620 passed、9 skipped**;
route/Engine boundary/VPC/dataplane 四套 **454 passed、23 warnings**。
新 route 用例覆盖无设备字段、显式设备漂移、无 OIF 特殊路由、精确 local
形状,以及未过滤查询不推断设备。渲染 shell、独立交叉审查、py_compile 与
diff 检查通过;Darwin 的 Linux proc 跳过边界不变。
- 完整首次部署 helper 入口 **33 passed**,新增 12 项覆盖 `ready/refreshed`、
临时/持久 helper、已创建 UP/trusted 接口和已发布 NM/ifupdown profile 的
精确恢复;错误快照权限/digest 与同 marker 篡改 verdict 保留隔离并拒绝。
- 独立静态审查发现 VPC bridge 重复 apply 与 QGA guest JSON route 探测中还有
同类依赖过滤输出 `dev` 的问题。本次只修 Fabric apply/BOOT/observe,另两项
尚未修复,不能据此宣称租户 VPC 的完整接入、重试与 guest 验收已通过。
## 2026-10-09:越过 nft 安装后发现的目录与回读兼容问题
- `6a99181` 已通过后台在线更新部署,SSH 确认 Engine 为新进程;新一轮真实
operation 中 Alma 的 nft journal 已到 `refreshed`,两份 root-only snapshot
已发布,证明原 nft 归属误拒绝已越过。Alma 随后的 profile 发布遇到现有
NetworkManager 目录 `root:755`,原代码只允许 `700`;现只接受 root 自有、
无符号链接的 `700/750/755`,不 chmod 管理员已有目录,新目录仍建为 700,
含私钥的 keyfile 和事务快照仍为 600,其他用户/不安全权限继续拒绝。
- Debian 本轮推进至 `final_readback`。实际渲染路由校验可复现合法裸 IPv4
host prefix 被 `/32` 字符串误拒绝;apply、boot 与 observe 统一只归一化
canonical IPv4 host 地址,不改 `/24` 等更宽前缀、table/device、VPC proto
186/完整 tuple 或重复路由门禁。boot 也精确排除自身 kernel local route。
- boot nft 校验不再要求 8 个 ASCII 空格缩进,完整有序语义与 8 条精确 digest
仍保留;observe 的错误嵌套 AWK `BEGIN` 改为顶层。NetworkManager profile
以 metric 50 创建 peer route,apply/boot 的 replace 现在使用同一 metric,
避免创建另一个 metric 0 的路由;ifupdown 行为不变,不清除未知旧路由。
- 依据:[NetworkManager keyfile 安全规则](https://networkmanager.dev/docs/api/latest/nm-settings-keyfile.html)、
[IPv4 route metric](https://networkmanager.dev/docs/api/latest/settings-ipv4.html)、
[iproute2 host-prefix 输出](https://github.com/iproute2/iproute2/blob/main/ip/iproute.c)
与 [Linux FIB replace 的 priority 匹配](https://github.com/torvalds/linux/blob/master/net/ipv4/fib_trie.c)。
- 新增 NM 目录 26 项与 route/boot nft/observe/metric 67 项独立回归通过;只读
交叉审查执行全部渲染 apply/BOOT/observe 的 shell 检查及 166/67/59 个 AWK
程序语法检查,无错误。最终稳定源码分组回归:Fabric/proc/helper/nft/NM
八套联合 **641 passed、9 skipped**;route/Engine boundary/VPC/dataplane
四套联合 **345 passed、23 warnings**。py_compile 与 diff 检查通过。
- 最新修复完成后电脑锁屏,浏览器与 SSH 控制明确阻断,故未执行这一版在线更新
或新 operation。需解锁后继续;上方真实推进结果属于此前 `6a99181`,不得
把当前回归通过误写成宿主已部署或组网成功。
- 本轮未手动清空规则、删除事务、停用 firewalld/SELinux 或改公网接口策略。
两台真实宿主尚未最终 active,双向 overlay、租户 VPC 与重启验收仍未通过。
## 2026-10-09:真实 nft 安装后归属校验修复
- 接管两台 electerm SSH 会话后,Debian 13 与 AlmaLinux 10 均确认 journal 为
`nft.phase=installing`;`nft -c -f nft_rules.desired` 返回 0,主 Fabric table 已存在。
在宿主机仅提取并执行本轮 apply 的只读校验函数,Debian 得到完整语义检查成功,
而附加计数为 `8:0:0`,归属判断失败;这不是宿主机 nft 安装失败。
- 根因是原始 Python 模板中的二次转义被原样插入 shell:链正则中的两个反斜杠
无法匹配真实 `{`,导致合法表的两项链计数均为 0。修复只恢复正则/换行的实际
shell 表达;完整表语义、8 条 owner/digest、3 条精确 chain 与回滚快照门禁保留。
- 新回归直接从完整生成 apply 提取实际事务函数执行,不用单独常量或 mock 归属
函数替代,覆盖正常规则、canonical output priority 和外部/篡改规则拒绝。
- 同时发现首次 Debian 激活会在 generator 发布前执行 ifupdown hook。现将已有、
journal 覆盖的 generator 发布提前至 network_activate;hook 与普通启动的所有
权限/digest 门禁仍无条件执行,daemon-reload 与 libvirt 激活门禁仍在最终持久化阶段。
- 分批验证:Fabric 既有四套与 proc 套件 538 passed、9 skipped;实际 nft 事务
56 passed;完整首次部署/helper 入口 21 passed(包括 11 个新增 hook/顺序用例)。
修改后 nft/systemd/ifupdown 联合复跑 80 passed;Engine boundary/VPC/dataplane
278 passed、23 warnings。py_compile、diff 检查与独立安全审查通过;Linux proc
本地跳过边界不变,上述测试不替代真实流量或重启验收。
- 真实部署与下一轮状态以后台在线更新、同轮 operation 日志和双向 overlay 流量为准;
本段定位证据本身不代表 Fabric 或租户 VPC 已可用。
## 2026-10-09:接管真实 SSH 后的 proc 读取与首次部署入口修复
- 在用户指定的 electerm Debian 13 会话真实复现:`cat /proc/sys/net/ipv4/ip_forward`
为 1,而 dash 的逐字节 `IFS= read -r` 返回 1 且变量已是 `1`。整数 proc sysctl
在非零读取偏移直接 EOF;原脚本把这误判为 sysctl 不兼容。apply、boot、observe 和
rp_filter 写后回读改用缓冲读取并保留末尾换行,仅接受精确单行 0/1/2;I/O 失败、
空值、额外换行、多行及畸形值继续拒绝,ip_forward 必须等于 1 的门禁保留。
- AlmaLinux 10 真实会话确认 SELinux Disabled、脚本所在文件系统无 noexec,旧 journal
为 ready/installing,generator 与 timer 的基线为 absent。完整渲染 helper 测试进一步
发现入口提前展开未定义 config_fabric/network、过早要求未发布的 gate generator、
timer.absent 分支缺少 TIMER_UNIT 声明。现用已绑定的 plan 常量初始化 loader,常规
manifest 精确匹配;恢复-only 完整 journal/plan/nft 证明后可退出,正常启动仍校验 gate。
恢复全程保留 emergency 隔离,不会提前启动 libvirt。
- 分批回归:Fabric 既有四套用例 448 项通过,新增 proc 读取与完整 helper 入口 100 项
通过;9 项真实 Linux /proc 用例在本地 Darwin 跳过,由上方 SSH 复现补充现场证据。
联合首轮中的两个尚在编辑的新 manifest 测试已由稳定文件完整重跑(10/10)通过。
Engine boundary/VPC/dataplane 278 passed、23 warnings;py_compile、diff 检查与独立
安全审查通过。成功/外部 gate/错 plan/普通启动/manifest 偏移均走完整 helper 控制流,
不注入 TIMER_UNIT/config_fabric/network 来掩盖入口缺陷。
- 代码回归后通过管理员在线更新部署,再由同一地区的新 operation 验证旧事务收敛和
WireGuard 回读;组网验收以实际页面、宿主 journal 和双向 overlay 流量为准。
## 2026-10-09:Debian 13 / AlmaLinux 10 Fabric 启动与恢复核对
- 按 Debian 13 的 systemd/ifupdown 文档与源码、RHEL 10 的 systemd 文档核对生成脚本。
runner 与临时 helper 本就有 `chmod 700`;剩余临时/固定恢复 helper、持久 unit 和
ifupdown hook 的直接执行入口现统一改为绝对 `/bin/sh`,仍保留 root 所有权、模式、
plan digest、journal 镜像和精确 nft 回读检查。执行位不能覆盖 `noexec`。
- 经典 ifupdown 会过滤普通 `VC_*` 调用环境。父 apply/recovery/service 现在通过其保留的
`IFUPDOWN_*` 前缀传递锁与事务上下文;helper 只在 ifupdown hook 入口导入合法值,冲突
一律拒绝。ifupdown2 同时收到原有变量;命令级赋值不遗留父进程过渡标志。主 service 在
ifup 后继续完整配置和运行态回读。
- libvirt 启动门禁只覆盖实际 daemon services 和 libvirt-guests;socket activation
仍触发同一受门禁 daemon。去掉 socket 与 Fabric 之间的晚期依赖,消除默认
socket → sockets.target → basic.target → Fabric → socket 启动循环。
- repair 不再查询不存在的 service `Result=dependency`。只有当前 boot PID 1 最新的
unit 记录自身为本轮 Fabric 失败之后的 start/dependency、当前 inactive/无 job、
有效门禁匹配时才消费一次性证据;每 daemon 每 boot 最多一次。Fabric 恢复后再次
回读并以 `--no-block --job-mode=fail start` 排队,不重置非 Fabric 服务。
- 安全日志增加 `journal_dispatch` 与八类 `preflight_*` 检查点,PHP/UI 严格白名单同步。
旧 preflight 未知命令错误不再误标为资源归属冲突;共享资产版本为 `2026100906`。
- Python 3.12 最终回归:Fabric 主套件、systemd 顺序、job 证据与 ifupdown 环境过滤
联合 **448 passed**;Engine boundary/VPC/dataplane **278 passed、23 warnings**。
四项 PHP/WASM 合同、PHP/JS 语法、Node Fabric 向导行为、py_compile、diff 检查及
独立交叉审查通过。测试包含直接执行被拒而 interpreter 可读、经典环境过滤、旧 socket
循环反例、手动 stop/后续 job/普通服务失败/伪造与漂移 job 证据不重试。
- 本轮用户提供的真实日志证明 runner 已启动,Alma 停在 journal_recovery,Debian 停在
preflight;这些阶段不足以证明具体冲突对象或 SELinux/noexec 根因。代码缺陷已修复,
下一轮同 ID 状态、journal/guard 收敛、双宿主握手、跨宿主允许/拒绝流量与重启恢复
仍须在真实宿主验收;上述模拟与本地回归不代表组网已成功。
## 2026-10-09:Fabric 宿主 systemd 异步 operation 与安全回读
- Fabric apply/reconcile 不再让 HTTP/SSH 长连接等待完整宿主配置。Engine 先持久化同一轮
32 位小写十六进制 `operation_id`,HTTP 以 `202 Accepted` 返回;每台宿主把不可变脚本、
manifest 和固定枚举 status 放入 root-only 的
`/run/virt-cloud/fabric-operations/<operation_id>`,再由有运行上限的 transient systemd
oneshot 独立执行。原始 stdout/stderr、命令、路径、私钥和 peer 全量配置不会进入 API 或
安全阶段日志。
- transient oneshot 固定以绝对路径 `/bin/sh <operation-dir>/runner` 启动,runner、update
及 apply 内的状态更新也全部显式交给 `/bin/sh`,因此 Debian 将 `/run` 挂载为 `noexec`
时不会再以 `203/EXEC` 失败。oneshot 使用有效的 `TimeoutStartSec=840s` 约束整个启动任务,
不再使用 systemd 明确会忽略的 `RuntimeMaxSec=` 组合。
- 页面只通过 Fabric GET 轮询原 ID,replacement、缺失地区、连续读取失败或 CDN 超时均停止
自动跟踪并进入结果未知,绝不 POST 重放。PHP 写边界强制 operation ID、kind 和 status;
首次 apply 只返回回执且不发布地区映射,只有后续显式“重新核对”完成平台代次、宿主闭集、
VPC pin、active 与 `next_stage_allowed` 权威回读后才能激活映射。
- 周期 reconcile 与页面 GET 始终只读。只有显式 POST 能在严格 immutable hash、systemd unit
和逐节点 dispatch fence 证据下继续原 ID:恢复 publish-before-systemd 的 queued runner,
或在已接纳节点精确收敛后续派确定未接纳节点;不得重派已接纳节点或生成替代 ID。
- 版本升级若改变 immutable runner/apply/update 哈希,绝不覆盖或执行旧 spool。只有旧任务仍
精确为 `queued/dispatch/none`、从未开始/结束,且 transient unit 已证明为 `not-found`,或
精确为 `loaded/failed + exit-code/exited/203`,一次显式“重新核对”才会把该旧任务原子关闭为
`failed/dispatch/systemd_failed`;下一次显式“重新核对”再创建使用当前脚本的新 operation ID。
运行中阶段因此只开放“重新核对”,检测与再次自动配置仍保持禁用。
- journal 恢复安全日志新增 `journal_artifact_restore`、`journal_nft_restore`、
`journal_runtime_restore`、`journal_finalize` 四个固定子检查点。更新日志本身是 best-effort,
只有 root-owned `0700` operation 目录与 update 文件同时通过无符号链接校验才写入;写入失败
不改变恢复与 fail-closed 语义。宿主已确定失败时,尚未越过 dispatch fence 的节点关闭为
`skipped`,地区 operation 收敛为终态,后续显式 reconcile 才允许新建 ID。
- 最终 Python 3.12 聚焦回归:`engine/tests/test_fabric.py` **384 passed**;
`test_engine_boundary.py + test_vpc.py + test_vpc_dataplane.py` **278 passed、23 warnings**。
后一组与 Fabric 全测并行时曾触发一个既有云模板后台 GC 计时断言,取消并行后完整重跑通过。
`py_compile` 与 `git diff --check` 通过。
- PHP 8.5/WASM 下 6 个修改/相关 PHP 文件语法、Fabric 静态合同、operation 严格投影、宿主
网络池/调度、资源调度、多公网池、资产和防火墙 UI 合同通过;Node JavaScript 语法及 Fabric
向导行为测试通过。当前隔离 vendor 缺少 `Illuminate\\Database\\Capsule\\Manager` 实体文件,
因而 `AdminFabricReadinessWorkflowTest.php` 仅完成语法检查,未执行数据库流程;该测试必须在
部署端完整 Composer dev 依赖与 PDO SQLite 环境复跑。
- 尚未连接真实 Debian 13 / AlmaLinux 10 宿主机验证 SSH 断线、transient unit、journal、重启、
NetworkManager/ifupdown 及 native nftables。部署后必须用页面显示的同一 ID 查询
`journalctl --utc -u virt-cloud-fabric-apply-<operation_id>.service --no-pager -o short-iso-precise`,
并完成双宿主 WireGuard 握手、跨宿主 VPC 流量和重启恢复后,才能认定生产组网验收完成。
## 2026-10-09:真实宿主探针兼容修复
- AlmaLinux 10 现场证明配置的 endpoint 唯一属于 `br0`,firewalld 使用
nft backend 且 `br0` 的持久 NetworkManager profile 存在;误报来自探针调用了不受
支持的 detail 字段 `GENERAL.FILENAME`。readiness、Fabric/VPC apply/remove/observe
与开机恢复现统一读取有界的 `UUID,FILENAME` 列表,按 UUID 精确唯一匹配,并继续要求
endpoint profile 位于 `/etc/NetworkManager/system-connections`、非符号链接、root 所有且
模式为 `0600`。
- 运行中 VM 的 `vnet1`、`vnet3`、`vnet10` 等 tap 可能对应 NetworkManager 在 `/run`
下生成的临时 profile。它们会逐接口标为不可持久验证,但只要不是 endpoint,就不会再
连带阻断 `br0`;若 endpoint 自身只有临时、重复或不可验证 profile,仍然 fail-closed。
- Debian 13 现场的 iproute2 6.15 在 WireGuard 模块未加载时会让
`ip -j -d link show type wireguard` 返回成功且包含逐 link 的 `{}` 占位。解析器只在
模块状态精确为 `not_loaded` 时允许 WireGuard typed 段中的精确空对象;模块已加载、
其他 link/address/bridge 段或任意非空畸形记录继续拒绝。页面同时区分 `ip` 命令与发行版
包名:Debian 安装包为 `iproute2`,AlmaLinux/RHEL 安装包为 `iproute`。
- `ip`、`nft` 与 `modinfo` 均改为执行能力探针实际发现的绝对路径,覆盖 `/usr/sbin`、
`/usr/bin`、`/sbin` 和 `/bin`,避免非 merged-/usr 布局出现“已发现但执行阶段假缺失”。
- 直接相关三组 Engine 回归为 **295 passed**;Python `compileall`、生成 shell 的 POSIX
语法、管理员 Fabric Node 行为、JavaScript 语法、PHP 静态合同和 `git diff --check`
通过。完整 Engine 回归为 **1312 passed、10 skipped、5 failed、80 subtests passed**;
5 个失败仍是既有 cloud-template spec、reinstall cleanup envelope 与 3 个公网池 fixture,
不涉及本次探针代码。
- 上述现场输出是修复输入,不代表新版本已经在宿主机验收。部署本提交后仍须重新点击
“检测宿主机”,确认两个旧阻断消失;随后执行地区自动配置、WireGuard 握手、跨宿主流量、
native nftables/NetworkManager reload 与重启恢复验收,才能认定生产组网完成。
## 2026-10-09:Fabric canonical nft 回读与首装事务恢复
- AlmaLinux 现场的 nftables 1.1.x 会把 inet `output` hook 的数值优先级 `-100`
回读为标准名 `dstnat`。Fabric 严格 grammar 现在只在该精确 hook/priority 组合接受
`dstnat`,`input`/`forward` 或其他命名优先级仍拒绝;owner、plan digest、三条 chain、
八条规则、空 tenant set 和完整二次回读要求不变。
- 旧版本可能已原子安装主 Fabric table,却在写入 `nft.installed` 快照前因上述误判退出,
从而留下 `state=ready`、`nft.phase=installing`、emergency guard 仍生效的安全隔离态。
新 apply 只在当前计划与 journal 的 digest、UUID、部署/防火墙模式及 underlay 参数全部
一致时使用临时 helper;缺失快照还必须证明首次部署空基线、desired 规则哈希与完整
live table 一致且连续两次回读不变,才会原子补写快照并进入既有回滚状态机。
- 首次部署尚未发布固定 helper 时,`before_mutation`、`installing`、`installed`、
`refreshing` 与 `refreshed` 均由当前计划绑定的临时 helper 恢复;固定 helper 已存在时仍
必须与 journal baseline 或 desired 镜像逐字一致。`firewalld_nft` 的 manifest 基线必须
absent;`native_nftables` 的主配置基线必须 present,live 文件只能逐字匹配 baseline 或
安全 desired,并包含受支持的唯一/通配 include。符号链接、权限漂移、内容漂移、非空
tenant set、额外 nft 对象或任一次 TOCTOU 回读变化均保留隔离与 journal,不执行删除。
- 远端 `identity`/`observe` 仍使用 35 秒读超时;仅 `apply` 扩展为 300 秒,避免完整
隔离、恢复、回读流程被旧的短 SSH 超时中断。浏览器/CDN 的请求窗口可能仍早于后台
mutation 完成,因此 502 只表示 HTTP 结果未知,不能重复自动配置;应等待当前宿主命令
结束后使用“重新核对”。
- 本节最终本地验证:`engine/tests/test_fabric.py` 为 `302 passed`;远端宿主与 Engine
边界为 `296 passed, 4 warnings`;VPC/Fabric 数据面为 `153 passed, 19 warnings`;完整
Engine 为 `1496 passed, 10 skipped, 5 failed, 80 subtests passed, 24 warnings`。5 个失败
与本轮前一致,分别是 cloud-template spec 新字段、reinstall cleanup detail envelope 和
3 个公网池 fixture,均不在本次 Fabric 改动范围。`git diff --check`、生产/测试 Python
`py_compile` 与最终只读源码审计通过。上述静态与本地回归不替代真实宿主机验收;部署后
仍须证明 journal/emergency guard 收敛、两台主机 WireGuard 握手、跨宿主 VPC 流量
以及 native nftables reload 与重启恢复。
## 2026-10-08:公网优先 underlay 与已退役 firewalld+nft 实验
- 当时的 Fabric/VPC 实验曾接受两个互斥模式:native nftables 要求
`nftables.service` active/enabled 且 firewalld 不存在或 inactive+masked;
firewalld 模式要求 active/enabled、nft backend、`NftablesTableOwner=yes`,native
nftables unit 则只能不存在或 inactive+disabled/masked。能力探针不会查询 inactive
firewalld 的 D-Bus API,避免为了检测而把仅 disabled 的服务重新激活。
- firewalld 继续管理 endpoint 所在 zone 及精确 UDP rich rule;平台受管 Fabric/VPC
table 仍由 nft 原子加载并用 owner/revision/digest/完整语义快照回读。公网物理接口永不
trusted,只有已验证 profile/fragment 的 overlay/VPC 接口在 ACL 完整回读后临时进入
runtime trusted。失败、回滚和开机恢复均先隔离而不拆除 bridge/tap 拓扑。
- firewalld 事务会先安装带随机 token 的独立 emergency nft guard,并把 token 写入
root-only owner intent;删除前必须再次证明 token、完整 table 形状和 stateless snapshot
均未变化。仅没有 VPC state、manifest 或未完成 journal 的空宿主,才允许在失败的
firewalld 前置尝试纠正为 native 后接管并清理这份 guard;已有 VPC 时必须保留 guard 并
报告维护迁移,不会以 owner comment 数量代替三族 ACL 的完整语义证明。缺少 owner intent
的同名外部 table 始终不触碰。nft journal 区分 mutation/install/refresh 的提交阶段,
崩溃恢复不能把“命令已返回”误当成持久规则已完成回读。
- underlay 普通路由和显式 `from endpoint` 路由必须选择同一接口及配置的源地址;多地址
同接口不能再靠 `dev` 相同误通过。fresh readiness 还拒绝 endpoint 落入实际全局租户
VPC CIDR 池;Engine 在 Fabric 变更与 VPC apply 两端拒绝 endpoint 与既有 VPC CIDR
重叠,避免目的策略路由把 WireGuard 外层 UDP 重新导向租户表。
- Fabric apply/reconcile 与 VPC apply/delete/reconcile/lifecycle reconcile/observe 现在由
`EngineApplication` 显式注入同一个 lazy catalog mutation lock,锁序固定为每资源锁、
catalog 锁、排序后的 VM 锁。VPC 从读取 Fabric gate 到完整远端 mutation 和根/子记录
提交都保持共享锁;Fabric reconcile 先在锁内持久化关闭 gate,SSH 只读观测期间释放,
发布前重新取锁并复核资源互斥。并发回归覆盖 Fabric-first、VPC-first、删除、普通收敛、
lifecycle 收敛和外部观测发布,阻止旧 active gate 或变化后的 endpoint/CIDR 被继续使用。
该保证以部署的单 Uvicorn worker 为边界;多 worker 必须先增加跨进程 durable
reservation/CAS,不能依靠 asyncio 锁。
- VPC 准入会扫描全部持久化 `fabric_desired` endpoint,不仅检查当前 VPC 固定的
Fabric;每条记录都必须能重建计划且已存 `plan_digest` 与重建 digest 一致,
损坏或 stale 记录 fail-closed。根删除不能改变已有 region/Fabric identity/revision/CIDR;
无历史记录但需清理宿主的删除目标同样先执行全局 endpoint/digest 准入。取消回归证明
caller cancellation 不会让 catalog 锁越过尚未返回的 `asyncio.to_thread` mutation
提前释放;引擎在持锁期间 drain 底层任务、完成 desired state/receipt 提交后才传播
`CancelledError`。
- 每个 VPC 数据面计划携带权威 `fabric_plan_digest`;apply、remove 与 observe 均重建并
严格校验 Fabric nft grammar、owner/digest、精确 tenant set 和完整最终 snapshot。
因此即使 VPC 自身三张表看似正确,Fabric revision 漂移或租户集合不一致也不能发布
active。
- repair timer 不会 restart 主 service:主 service failed 时,它只排队一次主 service
和此前确因 dependency 失败的 libvirt 单元;主 service active 且精确核验到 firewalld
runtime trusted 漂移时,reconcile service 直接执行同一份带 flock 的完整 ACL-first
helper,不重启主 Fabric unit 或 libvirt。健康状态不会进入 helper。
NetworkManager 的合法无持久 keyfile/运行期 profile 只把对应接口标成不可验证,不再
连坐无关 endpoint;被选中的 endpoint 接口仍必须具有持久、root-only 的可验证 profile。
- 首次 apply 只有在事务目录持久写入 `committed` 后才释放 Fabric flock,并同步启动独立
reconcile dispatcher;主 oneshot 已 active 时直接执行同一份完整 helper,inactive/failed
时则等待 systemd start 完成。apply 随后重新取得 flock,复核当前 CONF digest、防火墙模式、
Fabric/VPC nft、WireGuard、主 service/timer active,以及 emergency owner 和 inet+bridge
两张 guard table 均已消失,才返回成功。`RemainAfterExit=yes` 为首启后的 repair timer 提供
稳定 active 语义;提交后的旧进程无权删除共享 journal,dispatcher 失败时由 timer/helper
或下一次持锁 apply 消费。boot quarantine 使用有界、逐步校验的 bridge 端口快照并在每次
`link down` 后明确回读无 `UP`,命令失败、畸形/重复/超量输出、端口变化或
NetworkManager 重新拉起接口均 fail-closed。
- Python 3.12 全量 Engine 回归为 **1302 passed、10 skipped、5 failed、80 subtests
passed**。5 个失败仍是本轮前已存在的 cloud-template spec snapshot、reinstall cleanup
detail envelope 和 3 个公网池 fixture;Fabric、VPC、firewalld、endpoint 与 repair 新增
用例全部通过;Fabric 单文件最终为 **148 passed**,聚焦组合为 **650 passed、2 个上述
已知失败、5 subtests passed**。PHP/WASM 下 14 个相关管理/资源/资产合同与流程测试、
VPC 创建和 CIDR
allocator 回归、Fabric Node 行为测试、两份 JavaScript 语法检查及 `git diff --check`
通过。
- 这些结果没有替代真实宿主机验收。AlmaLinux 10、Debian 13、native nftables reload、
NetworkManager/ifupdown 重启、libvirt socket activation、宿主重启、跨宿主 WireGuard
握手、MTU、SELinux、外部 NAT/安全组和允许/拒绝流量仍须按验收矩阵执行。
- nft CLI 不提供跨进程 CAS。本轮以完整 stateless snapshot、`nft -c` 后的最后
precommit 回读、原子 batch 和提交后回读关闭已知检查窗口;同机 root/CAP_NET_ADMIN
或其他 out-of-band nft 管理器仍须遵守维护互斥,不在事务中并发替换同名 table。
## 2026-10-08:Fabric underlay 地址与 SSH 管理地址解耦
- Engine 宿主机配置增加可选 `fabric_endpoint_ip`;空值仅在 SSH `host` 为安全的字面
IPv4 时回退,当前公网组网无需重复填写。未来同地区宿主机已有互通内网时,可以逐台填写
本机内网 IPv4,而无需改变 Fabric/VPC overlay 架构。
- endpoint 仍由 Engine HostProfile 单点持久化,面板 `cloud_hosts` 不复制该运行配置。
管理员宿主机表单安全透传可选 IPv4;fresh probe 验证显式地址属于对应宿主机。
- Fabric readiness 只展示生效的 endpoint 和受限来源(专用配置或 SSH IPv4 回退),未知
来源会被折叠,不会增加 SSH 地址、凭据或原始输出字段。每台宿主机仍只公布一个 endpoint,
因此所选公网或内网地址必须能被同地区所有成员直接访问。
- PHP/WASM 下 endpoint、宿主地区、宿主错误、Fabric 静态契约和动态 readiness、公网池、
共享资产/抽屉回归通过;管理员 Fabric Node 行为测试和两份修改 JavaScript 的语法检查
通过。真实公网/内网 endpoint 可达性仍须按宿主机验收矩阵确认。
## 2026-10-08:宿主机显示位置与 Fabric 地区解耦
- 宿主机编辑页把 `CloudHost.region` 明确标为“位置标签(仅展示)”;该字段仍按引擎边界
要求为 1 至 64 字符,但不再代表销售地区、Fabric identity 或 VPC 归属。权威归属由
active/draining 宿主机成员关系沿资源池、线路到 `CloudRegion` 唯一解析。
- Fabric readiness、fresh probe 和 VPC 成员门禁不再比较宿主显示标签或探针回传标签与
`fabric_region`。成员关系缺失、重复、断裂或跨地区仍 fail-closed,Fabric/VPC 固定的
identity、region、revision 回读仍要求精确一致。
- 引擎中存在但没有平台映射的自定义 Fabric 不会被自动认领或改写,继续进入
`migration_required`。没有增加旧配置兼容;仅保留本地区确定性 Fabric 在下发结果未知或
部分成功后的原有“重新核对”恢复路径。
- 静态宿主位置契约覆盖了表单与校验文案,Fabric/VPC 回归覆盖“显示标签不同但权威成员
关系相同”的正常路径,并覆盖实例 pool pin 不一致、多条 live membership、
pool/line/region 断链与跨地区拒绝。本轮 Engine Fabric/VPC/边界回归 `268 passed`,
21 个聚焦 PHP 测试脚本、7 个变更 PHP 文件语法检查和管理员 Fabric Node.js 行为测试
通过。开发环境仍未替代真实多宿主 WireGuard、native nftables、libvirt 和重启恢复验收。
- 扩大探测仍命中未修改的既有测试问题:`SourceSyntaxTest` 被
`AdminSystemLogsContractTest.php` 的双引号插值语法错误阻断;
`CloudEngineReadinessTest` 保留了已过时的静态次数断言;`CloudProtocolTest` 未导入
`CloudOperationErrorCatalog`。三个文件均未在本轮修改。
## 2026-10-08:raw JSON 部署收口为地区级向导
- 管理员“地区私网”页面改为四阶段内联向导:选择地区、检测宿主机、自动配置、重新
核对;全页仍只有对应后三步的三个操作按钮。浏览器只消费服务端 `workflow` 门禁和
`plan_preview` 只读摘要,不生成、编辑或提交节点/endpoint/raw JSON 计划。
- 公开管理 API 已移除 raw plan apply、按 Fabric ID 直接 reconcile 和地区映射
PUT/PATCH;只保留 Fabric/映射只读回读和三个按地区执行的空 body 动作。PHP 仍在服务端
生成并校验固定 DTO,再调用不对浏览器公开的 Engine 内部 apply/reconcile。
- 服务端按权威库存、映射与引擎回读投影引擎不可用、无宿主机、待检测、阻断、可配置、
待核对、active、需要迁移和需要恢复阶段。只在 fresh probe 完整通过后开放自动配置;
固定 desired state 不一致或缺失时不会在原 revision 下重建。
- “自动配置”仅接受无映射且无 desired state 的全新地区;活动/disabled 映射和未映射的
确定性部分成功只能走“重新核对”。所有 reconcile 都在宿主写入前重新校验平台拓扑、
fresh probe、详情/目录、冲突与精确计划;disabled 映射可在同 identity/region/revision
的 active 回读后安全激活,但每个未删除 VPC 也必须精确固定到同一三元组;旧空 pin 或
任一漂移都会进入迁移门禁,不会在宿主写入后才失败。
- 前端不会把非 `active` 的成功 HTTP 响应显示为配置成功;地区切换、重复点击、引擎不可用、
请求超时、网络中断和 HTTP 5xx 均有独立门禁。写操作结果未知按地区隔离,禁止重放
自动配置,只开放服务端 reconcile 恢复路径;其他地区成功不会解除该保护。
- 列表和地区动作响应不再携带冗余的完整 `fabrics`/`region.fabric` 节点计划;向导只收到
readiness 宿主行、标量回读和有界方案摘要。管理员按 Fabric ID 的显式 GET 详情仍保留
为只读诊断入口。
- PHP 8.5/WASM + SQLite 下 Fabric readiness、Fabric/VPC 控制面、VPC 创建/复用/CIDR/
删除/tombstone、管理员资源调度、路由、模板、资产和防火墙相关回归通过;路由目标为
273 项、Smarty/email 模板 105 个、前端模块 52 个。新增 Node 向导行为测试、JS 语法、
修改 PHP 语法和 `git diff --check` 通过;未改 Engine 的 Fabric/boundary 定向回归为
**210 passed**。
- 扩大检查中的 `SourceSyntaxTest` 仍被既有 `AdminSystemLogsContractTest.php` 双引号插值
语法错误阻断,`CloudEngineReadinessTest` 仍保留与当前源码次数不符的旧静态断言;两处
文件均不在本次 diff。本节所列相关回归全部通过,但没有宣称这两个既有测试已修复。
- 结果未知集合当前属于页面内保护;彻底覆盖刷新或第二管理员需要服务端持久 operation
ID/lease/phase。映射提交前已在长网络操作后重读拓扑,并在事务中锁地区、映射和 live
VPC;跨全部库存写路径的 topology generation/CAS 仍是后续并发强化项。
- 开发环境没有连接真实多宿主 SSH、
WireGuard、native nftables 或 libvirt,生产部署仍须执行 Fabric 宿主机验收矩阵。
## 2026-10-08:管理员地区宿主机 readiness 与自动组网
- 管理员“地区私网”页面现在以地区为唯一操作入口,正常操作严格只保留“检测宿主机”、
“自动配置地区私网”和“重新核对”三个按钮。页面新增地区 readiness 汇总、逐宿主机
清单与 Fabric 只读回读,不再让浏览器编辑 Fabric ID、overlay、revision、端口、节点
JSON 或地区映射;普通管理员只读,三个动作仍要求具有管理权限的超级管理员与 CSRF。
- 地区必须宿主机集合由 active/draining 资源池成员、非删除实例、非删除 VPC deployment
以及当前/冲突 Fabric 节点合并。缺失宿主机、资源池、线路、地区或 VPC 根,同一宿主机
存在多个 live membership,工作负载归属漂移、未映射自定义/跨地区 Fabric 占用和
重复/不可用 endpoint 均 fail-closed,不会因内连接缩小清单后继续写宿主机。宿主机
显示位置标签不参与地区归属判断。
- “检测宿主机”调用新的只读引擎探针;未知宿主机不会构造运行时或数据目录,每台失败独立
返回白名单状态。一次引擎请求最多 64 台、固定 16 路并发,同一进程不排队执行重叠
探针而返回稳定 409;PHP 可把最多 128 台 readiness 清单拆成两个批次。真正自动配置的
Fabric 仍限制为 2 至 64 台,并在写入前重新探测,不能复用浏览器里的旧检测结果。
- 自动 Fabric ID、地区、CGNAT `/24`、revision、UDP 端口、排序后的节点与 overlay `/32`
全部由服务端确定生成。既有映射要求 desired state 精确一致;映射缺失时只允许恢复形状
完全一致的确定性 partial success,不会用变化后的 inventory 在同 revision 重建。写入后
通过引擎精确回读、平台拓扑复读及数据库映射 CAS 才发布 active/ready,HTTP 超时则要求
使用“重新核对”读取固定 desired state。其他未绑定的自定义 Fabric 保持
`migration_required`,不作为旧配置自动兼容或认领。
- PHP 8.5.10/WASM + SQLite 下 `AdminFabricReadinessWorkflowTest`、
`AdminFabricContractTest`、`DrawerMotionAssetsTest` 及 7 个 VPC 策略/收敛契约测试通过;
275 条路由目标、105 个 Smarty/email 模板、52 个前端模块和 schema 契约通过。
`admin-fabric.js`、`vpc.js`、`drawer-motion.js` Node 语法、修改 PHP 语法、Python
`py_compile` 与 `git diff --check` 通过。Engine Fabric/boundary 定向回归为
**210 passed**。
- Python 3.12.14 全量 Engine 回归为 **1097 passed、10 skipped、5 failed**。5 个失败
与本轮前的基线类别一致,分别属于既有 cloud-template spec snapshot、reinstall cleanup
detail envelope 和 3 个公网池 fixture;本轮 Fabric/readiness 与 Engine boundary 没有
新增失败。
- 当前未连接真实 PHP-FPM、MariaDB、浏览器或 SSH/libvirt 多宿主机。生产验收仍须覆盖
WireGuard 握手、UDP/51820 underlay、MTU、SELinux、native nftables 持久化、
网络/防火墙重启修复和跨宿主机租户流量。不受支持或所有权不明确的组合
继续 fail-closed,不能直接清空生产防火墙。
反代与 PHP-FPM 请求终止/读超时建议至少 270 秒。
## 2026-10-08:租户单自动子网与创建页简化
- 租户创建页只保留 VPC 名称和地区;CIDR、前缀、唯一子网、成员容量与成员私网 IP
均由平台管理。详情页不再显示子网管理卡片,成员加入也不再选择子网或手填地址;共享
前端资产版本已提升,避免部署后继续使用旧表单缓存。
- 删除租户 `POST/DELETE /vpcs/{vpc_key}/subnets...` 路由、Controller 入口和 Service
mutator。新成员加入意图严格只有 `instance_id` 与 `request_key`,先锁 VPC 根及其全部
子网,确认恰好一个非删除、非清理中的有效子网,再从成员租约与 route `/32` 保留地址
之后自动选择最低可用 IP。仅为滚动升级重放已存在的同 key operation 才读取旧版
`subnet_key/private_ip`;这些字段不能创建新成员,新请求携带时返回 422,且不产生
member、lease、operation 或 revision 副作用。
- 自动子网缺失或正在清理时返回 409;历史数据若存在多个活动子网或无效子网账本则
fail-closed 为 503,不静默选择任一行。数据库表、引擎多子网 DTO 读取能力、根删除和
历史 `subnet_remove` tombstone 收敛逻辑继续保留;本轮没有增加会阻断历史升级的
`UNIQUE(vpc_id)`,也没有自动合并或删除历史数据。
- 成员加入继续把服务端选出的 `subnet_key` 与 `private_ip=null` 写入旧版 request hash,
保持旧自动分配请求可重放。重放检查先于当前子网和实例状态,并从不可变 operation
payload 验证旧自动分配或旧显式 IP hash;因此丢失响应后,即使子网随后进入清理,刷新
到新版页面可用原 `request_key + instance_id` 安全读取结果,未刷新的旧页面也只能在
`subnet_key/private_ip` 与原 hash 精确一致时重放,参数变化返回 409。
- PHP 8.5/WASM + SQLite 下 `CloudVpcCreatePolicyTest`、
`CloudVpcMemberReuseTest`、`CloudPrivateCidrAllocatorTest`、
`CloudVpcRootDeletionTest` 和 `CloudVpcTombstoneConvergenceTest` 通过;源码契约
`CloudVpcControlPlaneContractTest`、`CloudVpcUserPageContractTest`、
`VirtualizationConfigTest`、272 条路由目标、105 个 Smarty/email 模板、52 个前端资产
模块及 schema 契约通过。修改 PHP 语法、`vpc.js` Node 语法和
`git diff --check` 通过。
- SQLite 不实现 MariaDB 的 `SELECT ... FOR UPDATE` 竞争语义,当前也未连接真实
MariaDB、PHP-FPM、浏览器或宿主机。上线前先只读审计所有非删除 VPC;下列查询必须
没有结果,再在隔离 MariaDB 中并发加入同一 VPC、并发重放同一 key,并确认只有一个
member、lease 和 operation:
```sql
SELECT v.id, v.vpc_key,
SUM(CASE WHEN s.state IN ('applying', 'active', 'degraded', 'uncertain')
THEN 1 ELSE 0 END) AS live_subnets,
SUM(CASE WHEN s.state = 'deleting' THEN 1 ELSE 0 END) AS deleting_subnets
FROM cloud_vpcs AS v
LEFT JOIN cloud_vpc_subnets AS s
ON s.vpc_id = v.id AND s.state <> 'deleted'
WHERE v.state <> 'deleted'
GROUP BY v.id, v.vpc_key
HAVING live_subnets <> 1 OR deleting_subnets <> 0;
```
## 2026-10-08:租户 VPC 创建策略、账户配额与幂等加固
- 租户创建 API 现在只接收 `name`、`region_id` 和 `request_key`;CIDR、前缀、首个
子网、成员容量和 Fabric 身份全部改为平台策略。新 VPC 固定自动分配独立 `/24`,首个
子网覆盖该 `/24`,成员上限为 200;历史大 VPC 的 4096 协议/观测上界不变。
- 默认每账户最多保留 5 个非 `deleted` VPC,可用
`cloud_max_vpcs_per_account` 在 1 至 100 内调整。创建事务先锁账户行,再核对根、配额、
Region/Fabric 和 CIDR 分配;`deleting` 根仍占账户配额,`deleting` 成员仍占成员容量,
只有精确收敛为 `deleted` 才释放。
- 同一创建键的回放先于当前配额、Region/Fabric 状态和分配器策略;请求摘要只包含稳定的
名称与地区。历史创建摘要继续按确定性 root、owner/name/region、operation 和 allocator
链接兼容,但缺 operation、network/subnet 或精确 CIDR claim 闭集时 fail-closed。已删除
root 只返回原 tombstone,不复活 CIDR;released allocation 出现残留 claim 同样拒绝回放。
- CIDR 分配、root、首个 subnet 和 operation 位于同一默认数据库事务。删除了失败后的
二次 `release()` 补偿,避免事务回滚后与同 request key 重试竞态、误释放胜者 CIDR。
租户创建表单同步移除高级网络字段并提升资产版本,旧缓存不会继续提交已禁字段。
- PHP 8.5/WASM + SQLite 下 `CloudVpcCreatePolicyTest`、
`CloudVpcControlPlaneContractTest`、`CloudPrivateCidrAllocatorTest`、
`CloudVpcMemberReuseTest`、`CloudVpcRootDeletionTest`、
`CloudVpcTombstoneConvergenceTest`、`CloudVpcUserPageContractTest` 和
`VirtualizationConfigTest` 通过;覆盖强制 post-allocation 失败零泄漏、满配额回放、历史
hash、平台状态变化、deleted tombstone、live/released claim 损坏和 deleting 容量。
另通过 105 个 Smarty 模板编译、274 条路由目标、52 个前端资产契约、schema 契约、
修改 PHP 语法、`vpc.js` Node 语法和 `git diff --check`。
- SQLite 不实现 MariaDB 的 `SELECT ... FOR UPDATE` 并发语义;上线前仍须在隔离 MariaDB
上并发争抢账户最后一个名额、并发同 key 丢响应重试,并核对最终仅有一条 root、network、
claim 和 create operation。当前未连接真实数据库、PHP-FPM、浏览器或宿主机,也未改变
WireGuard/libvirt 宿主数据面。额外全仓 `SourceSyntaxTest` 仍被未修改的
`AdminSystemLogsContractTest.php:108` 既有解析错误阻断,不归因于本轮 VPC 修改。
## 2026-10-08:VPC 来宾网络启动代次门禁
- 私网 MAC、`/32` 地址和唯一的 VPC CIDR scope-link 路由共同生成独立
guest-network generation;成员、自定义 route、ACL/Fabric 等纯宿主变化不改变该
generation。
- 运行中 VM 的新来宾网络不改写 NoCloud seed、inactive XML 或 live device;完全停机
后由 reconcile 写入 seed 与持久 XML,再启动消费。在完成 stop/reconcile/start 且
live metadata 匹配之前,宿主保持
`applying/pending_restart`,PHP 拒绝将缺失 `restart_required=false` 的证据视为
active/usable。
- 相同私网目标重试返回原 seed 字节,不重复轮换 NoCloud `instance-id`;写入
后会在 libvirt define 前重新下载 seed 并核对 MAC/IP/routes;缺少安全 boot 网络策略
的旧 seed 明确要求迁移,不通过新 instance-id 重放 credentials。
- current generation 还要通过 QGA 地址、link 与 route 的精确回读;保留地址/路由但
`NO-CARRIER`/`linkdown` 的接口不能通过。显式 link-down suspension 单独由 XML/config
证明隔离,恢复 link-up 后才重新要求 QGA usable 证据。
- `evidence_version=2` 使历史 XML-only succeeded 证据失效;宿主 config proof、每成员
guest readiness 与 VPC 聚合健康分别收敛,tombstone 不再被无关成员的 QGA 状态阻塞。
- 本地验证:Python compileall 通过;cloud-init、VPC 数据面、libvirt、协调器及删除回执
的定向回归 **394 passed**。完整 engine 回归为 **1071 passed、10 skipped、8
failed**;8 个失败已在本轮修改前的 `6dc0d21` 干净快照复现,属于既有云模板 spec、
重装错误 envelope、Python 3.9 upload timeout/event-loop 与退役宿主盘点式公网池 fixture。
- 隔离 PHP 8.5.10/WASM 下 5 个 VPC 契约/收敛测试全部通过,10 个修改 PHP 文件语法、
`vpc.js` Node 语法和 `git diff --check` 通过。当前宿主没有原生 PHP CLI;真实
libvirt/cloud-init 验收仍需在测试 VM 内核对地址、唯一 VPC CIDR scope-link 路由与跨
VM 连通性。宿主策略路由、代理 ARP 和 WireGuard AllowedIPs 仍必须保持精确 `/32`。
## 2026-10-08:根 VPC 可恢复删除状态机
- 租户 API 新增根 VPC 删除:精确名称确认后,PHP 在事务中把根和子资源固定为
`deleting`,签署空 desired target、待清宿主机闭集及 `retiring_members` 身份清单。
普通变更不能覆盖该 revision;失败或响应丢失只能用原 operation/revision/digest
显式核对。
- 引擎在任何 SSH/libvirt 变更前持久化删除 marker,逐成员核对并移除持久化
`private0`、私网 metadata 与 cloud-init seed,再清理宿主机 VPC 数据面。部分宿主机
已确认时,重试只联系尚无精确不存在性证明的宿主机;完整 receipt 必须先持久化,
随后才能清理引擎 desired 记录。终态 receipt 只保留重放所需的操作身份、摘要、
宿主机闭集和时间戳,不永久保存成员 UUID、私网 IP 或 MAC;旧格式会自动压缩。
- PHP finalizer 严格核对 payload、receipt、历史/待清宿主机集合和子账本,然后验证
CIDR interval 与全部 /24 claim,最后用 revision CAS 释放地址。live allocation 的
幂等重放也会重新证明 claim 闭集;畸形 VPC 核心/子表、残留 claim 或未完成根删除
均会阻止账户删除。只有完成删除的子账本会被清理,以释放全局 member 唯一键;根、
宿主机和 operation 保留为审计 tombstone。
- 前端只有详情接口明确返回 `state=deleted` 才结束删除提示;分页列表缺失或 404 不会被
当作成功。`deleting` 期间锁定所有普通编辑,仅保留“核对 / 重试”。
- 直接相关 Python 模块回归:**429 passed、56 subtests passed**;覆盖 VPC 协调器、
数据面脚本、内部 API 和 libvirt 持久 XML/metadata/seed 清理。完整 engine 回归为
**1007 passed、10 skipped、80 subtests passed、5 failed**;5 个失败在未修改的
`7f9fb9c` 干净快照逐项复现,分别属于既有云模板 spec、重装错误结构和公网 IP 池
fixture,不是本次删除状态机引入。
- 隔离 PHP 8.5/WASM 下 `CloudVpcRootDeletionTest`、
`CloudPrivateCidrAllocatorTest`、`CloudVpcControlPlaneContractTest`、
`CloudVpcUserPageContractTest`、`ManualAccountDeletionSqliteTest` 和
`ManualAccountDeletionTest` 全部通过;本轮 11 个 PHP 文件语法、274 条路由目标、
`vpc.js` Node 语法、Python `compileall` 与 `git diff --check` 通过。
- 当前没有连接真实 MariaDB、SSH/libvirt、nft、NetworkManager 或 ifupdown 宿主机。
生产验收必须覆盖多宿主机部分失败/重启续跑、HTTP 回执丢失、真实 seed 重写和数据面
移除回读。含私网成员的根删除要求相关 VM 已停机;managed-save 或原生快照存在时会
保留 tombstone 并拒绝继续,处理阻断后再显式 reconcile。
## 2026-10-07:在线更新后部署页 SQL 回归修复
- 在线更新到 `521d40a` 后,`/user/cloud/deploy` 在读取销售目录时会因 `cloud_hosts` 不存在 `host` 列而返回 500;同一错误也影响管理员资源汇总。根因已在 `e7230ff` 修复,应用查询现在只使用面板资源策略、reservation 和已物化的公网 IP ledger。
- 管理 IPv4、网关和 DNS 必须在地址池 `reserved_ips` 中显式保留;代码不再从宿主机模型读取 SSH/管理地址,也不通过宿主机盘点补全地址。
- saleCatalog SQLite/WASM 首屏 smoke 通过;部署 SSR、资源调度、IP ledger、宿主机网络池/调度、模板编译、虚拟化资产和 Node JS 语法检查通过。完整财务流程继续执行到既有 reconciliation 场景后失败,不能把该失败归因于本次缺失列修复。
- 代码修复提交为 `e7230ff`,随后补充部署 smoke 与验证记录文档;提交链已推送到远端 `venix`。真实 PHP-FPM、MariaDB、浏览器和宿主机仍需部署验收;上线后应同时检查 `/user/cloud/deploy`、`/api/v1/catalog` 和 PHP-FPM 错误日志。
## 2026-10-07:移除账户实例数量上限
- 删除账户实例数量配置、购买事务中的账户级 409 检查,以及金融测试中依赖该限制的场景;账户实例数量现在只受销售库存、宿主机面板容量、reservation 和具体公网 IP 账本约束。
- 全仓精确搜索未发现该配置键或账户上限错误文案的 CSS、JS、SQL 残留;`cloud_host_capacity_policies.max_instances` 保留为单宿主机调度容量,分页大小和快照/防火墙等其他实例上限也未误删。
- 账户上限相关的财务流程已越过,完整金融测试仍在既有 reconciliation fixture 处失败;具体契约、模板、JS 语法和 `git diff --check` 通过。真实 PHP-FPM、MariaDB 和并发购买仍需部署环境验收。
## 2026-10-07:面板资源账本取代宿主机盘点
- 调度、创建放置和网络选项现在只读取面板配置的容量策略、活动资源池、reservation 账本和 `cloud_public_ips`;不再要求容量快照、盘点新鲜度、宿主机 `host/network-options` 或 VM discovery 结果。
- 创建和换 IP 的引擎路径只读取面板传入的具体地址池参数与持久 claim,并用原子 claim 防并发重复;不会为每个请求枚举宿主机全部虚拟机。
- 宿主机保存/连接测试只验证 SSH、存储池和网络资源,不调用 `list_vms()`;用户 VM 列表和指定 UUID 的状态读取仍保留为用户操作及结果核对路径,不参与容量或 IP 调度。
- 用户列表、实时状态和生命周期状态同步只向引擎发送面板已知的 UUID(每批最多 100 个);旧的无参数全量状态接口仅为未接入面板的私有兼容 UI 保留。
- 引擎本机兼容 UI 仍保留全量 `/api/v1/vms`、无参数 `/api/v1/vm-states` 和资源目录接口;它们不进入 PHP 调度链,部署只允许 `127.0.0.1:8000`,不能作为公网管理入口。`inventory-panel` 是旧 UI 的通用卡片类,不代表已保留宿主机容量盘点功能。
- 旧 `cloud_instances.spec_json` 的可验证资源与公网地址会在地址池物化时迁移到面板账本;缺失、损坏或重复数据会阻止该宿主机调度。管理宿主机 IPv4 需在 `reserved_ips` 中显式保留。
- 私有引擎仍负责最终宿主机操作和具体 IP claim。网络超时或响应不确定时保留 `operation_id` 与 reservation,先核对再决定补偿;同一 client token 重试不得重复创建。
- 最终隔离回归:`engine.tests.test_libvirt_service` **183 passed、10 skipped**;`test_app.py` 与 `test_engine_boundary.py` **205 passed、4 failed**。4 个失败均为既有的云模板平台策略断言和 Python 3.9 上传超时/事件循环兼容问题,不涉及面板调度、IP 账本或盘点删除路径。
- PHP/WASM 契约测试通过:`CloudInstanceReadPerformanceTest`、`CloudInstancePageSsrContractTest`、`AdminHostNetworkPoolsContractTest`、`AdminResourceSchedulingContractTest`、`CloudNetworkIpLedgerContractTest`、`AdminHostSchedulingContractTest`、`CloudMultiHostSchemaDefinitionTest`、`VirtualizationAssetsTest`。
- `python -m compileall` 与 `git diff --check` 已通过。当前 macOS 工作区没有 PHP CLI、Composer 依赖、真实 MariaDB、systemd journal 或 libvirt 宿主机;PHP 契约测试使用隔离 WASM 运行时,真实引擎/数据库验收仍需在部署环境复跑。
## 2026-10-06:系统日志异步读取与详情
- 系统日志首屏改为只渲染页面框架,列表 API 增加浏览器截止时间、显式停止读取、旧响应隔离和 `journalctl` 子进程的有界回收;分页游标使用 `--cursor` + `--reverse`,按 systemd 的实际 seek 语义从边界向更早记录读取,并防御性移除意外返回的边界记录。
- 新增管理员只读详情接口,按列表携带的 UTC 微秒时间戳和服务窗口重新读取单条记录,再校验 journal cursor;返回受限的完整诊断字段和完整消息。日志轮转、字段上限和敏感字段省略均有明确状态。
- 使用工作区捆绑 Node 运行并通过 `AdminSystemLogsBehaviorTest.mjs`、`AdminOperationsCancelBehaviorTest.mjs`、日志页 JavaScript 语法检查和 `git diff --check`。
- 当前 macOS 工作区没有 PHP CLI、Composer 依赖或 systemd journal,因此 PHP 契约测试、真实 PHP-FPM 子进程超时回收和远程宿主机日志读取仍需在部署环境复跑。
## 2026-10-06:修复系统日志详情抽屉不可见
- 现场复现确认:日志行的鼠标点击和键盘事件已经执行,详情请求也可发出;页面没有视觉反馈是因为日志页直接调用 `showModal()`,绕过了共享抽屉的 `is-drawer-visible` 动画类,抽屉因此保持在屏幕右侧的初始变换位置。
- 日志页现在统一使用 `VenixDrawerMotion` 打开和关闭详情,缺少共享脚本时仍有可见的降级路径,同时锁定页面滚动、恢复触发行焦点,并拦截原生 `cancel` 事件以完成动画关闭。
- 详情对话框位于日志 `<main>` 外,详情消息和字段样式已改为直接以 `#system-logs-detail` 作用域,避免样式选择器永远不匹配。
- `AdminSystemLogsBehaviorTest.mjs` 现通过嵌套消息元素模拟真实冒泡点击,并验证鼠标、Enter、空格、共享 motion、可见类和滚动锁;资产版本更新为 `2026100602` 以避免部署端继续使用旧脚本。
## 2026-10-04:盘点只读并发与删除驱动清理(历史记录,盘点方案已退役)
- `host/capacity`、`host/network-options` 与诊断查询已从引擎全局写锁、在线更新修复及 ISO/云镜像惰性清理中拆出;删除后的宿主缓存回收只由持久 tombstone 监督器重试。诊断专项回归:**33 passed**,覆盖慢盘、取消/晚完成、满接纳窗口终态、淘汰失败上界、异常引用释放及 daemon writer 退出边界。
- Python 3.12 全量隔离回归:**762 passed、10 skipped、68 subtests passed、1 failed**。唯一失败仍为 `test_app.py::test_native_public_pool_blocks_silent_default_network_change` 的既有 409“公网地址池目录存储不可用”;该失败在本轮修改前已有独立复现记录。
- 本轮没有修改 PHP 或前端源码;当前工作区没有 PHP/Node 可执行文件,因此未重复运行上一节的 PHP/WASM 与页面行为测试。
- 未连接真实 MariaDB、systemd 或 SSH/libvirt 宿主机。该轮并发盘点验证属于历史实现;当前上线验收应改为并发创建、IP reservation、相同 client token 重试及 `operation_id` 对账,并验证显式删除模板后的离线宿主重试与代际保护。
## 2026-10-04:宿主机盘点诊断(历史记录,相关页面和服务已删除)
本轮只增加过渡期诊断历史、管理员页面和跨 PHP/引擎阶段证据;每请求 8 秒预算、容量/IP 提交代际和调度判定不变。该页面和服务不再属于当前部署路径,以下结果仅用于解释迁移前的基线。
- Python 3.12 全量隔离回归:**747 passed、10 skipped、68 subtests passed、1 failed**。新增诊断用例覆盖签名/权限、锁等待、存储失败降级、嵌套阶段、取消请求与 worker 晚完成、重启和保留上限。
- 唯一 Python 失败为 `test_app.py::test_native_public_pool_blocks_silent_default_network_change`:测试创建公网池返回 409“公网地址池目录存储不可用”,预期 200。在修改前的 `fad3b4e` 独立源码快照中复现同一失败;未在本轮扩大范围修改。
- 隔离 PHP 8.5.10/WASM、精确 `composer.lock` 依赖与 SQLite 测试曾覆盖盘点客户端、诊断、同步服务和关系边界;这些盘点专项名称和结果仅保留作迁移前记录,对应页面、同步服务和诊断服务当前已删除,不再列入本版执行集。
- 扩展 PHP 检查另发现两项既有失败,均在 `fad3b4e` 快照复现:`CloudProtocolTest.php:85` 的源码断言插值 `$actor`;`CloudAdminOperationsServiceTest.php:245` 的查询字段断言与原服务选择 `payload_cipher` 不一致。本轮未修改这两个测试或其既有服务。
- 过渡期盘点页面行为测试、相关 PHP 语法、两份 JS 语法及 `git diff --check` 曾通过。该页面和测试已删除;当前前端验收应覆盖宿主机调度抽屉、面板容量计算、IP 账本筛选和操作核对。
- 未连接真实 MariaDB 或远程宿主机,没有验证生产 PHP-FPM/systemd、cURL 传输、SSH/libvirt 延迟或诊断持久化的实际 I/O 开销;不能据此声称用户当前 `unavailable` 的根因已确定。真实环境启用后,应依据新增记录验证失败层和最后确认阶段。
## 2026-09-27:集成基线
2026-09-27,集成代码的隔离验证,不代表生产验收。
- 当前 macOS 工作区 Python 3.12 回归:515 passed、10 skipped、55 subtests passed。覆盖原虚拟化逻辑及私有 API、签名/重放、多宿主机归属、持久幂等、一次性 VNC、退出后断权、带宽 XML、救援上传摘要,以及到期断网/恢复、同实例变更串行、多网卡 live+config 断网/恢复、退出救援保持计费断网、流量累计检查点和破坏性操作结果核对。生产仍按部署文档使用 Python 3.12 或更新的受支持版本复测。
- 隔离 PHP 8.5.10 验证源码语法、Smarty 模板、路由目标、精确金额/HMAC、SQLite 购买开通/退款/超时核对、宿主机面板容量/IP 账本、租户隔离、Cookie/Redis 会话撤销及内省、统一用户资源和 noVNC 模块;账户固定实例数量上限已删除。本次账期与生命周期用例应覆盖提前续费、精确扣款幂等、RX+TX 额度、断网不关机、下期恢复、到期仅断网、3 天宽限期内续费恢复,以及宽限期结束后的实例与受管磁盘删除;当前 macOS 工作区没有 PHP 可执行文件时,需在下方 PHP 8.5 环境命令中复跑。
- Chrome 使用模拟 API 检查套餐购买、VM 详情/指标/凭据、公钥、重装/救援、后台宿主机/镜像操作与 CSRF;用户账户及登录等页面进行桌面/手机布局检查。不连接真实数据库或宿主机。
- PHP 隔离环境不提供 sodium:`CloudSecretsTest` 明确跳过,原 Paytaro/易支付密钥加密测试因同一缺失无法运行;财务/会话测试的加密存储仅用明确标注的测试替身,不作为实际加密验证。生产必须安装 sodium,没有弱加密回退。
- Python 的跳过项需要真实 libvirt/网络环境。没有验证真实 MariaDB 并发、AlmaLinux systemd、宿主机 VM 操作、SMTP、支付和大文件上传。
## 2026-10-12:libvirt 超时隔离与统一关闭期限
- 修复可靠性审查的第 3、4 项。生产 libvirt 连接/RPC 使用真实 spawn 子进程隔离、连接总预算和单次 RPC 预算;关闭 socket 后回收 worker 及 SSH 进程组。写入结果未知时保留 fsync 意图文件、宿主写入保护、原任务与 `safe_to_refund=false`,不把本地取消当成远端回滚。
- 六个宿主任务池、共享导入池、指标线程、Fabric/VPC 维护、各宿主生命周期及默认 asyncio 执行器共用 20 秒关闭预算。Uvicorn 请求排空 10 秒,unit 的 systemd 最终停止期限为 45 秒、`KillMode=control-group`。配置及维护恢复流程见 [执行期限与停机说明](LIBVIRT_EXECUTION.md)。
- 最新专项回归 **61 passed**,覆盖真实子进程卡死/回收/进程组、native 错误字段与句柄、VMService 吞异常、重启后持久写入保护、关机竞态、unlink/fsync/信号失败、默认执行器与后台线程无法返回时的 Python 进程退出、总关闭 deadline。测试使用假 libvirt 后端,不连接真实宿主。
- 最终 Python 3.12 全量引擎回归:**2178 passed、19 skipped、10 failed、80 subtests passed**(`PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=engine python -m pytest -q -p no:cacheprovider engine/tests`)。10 个失败均为下一项已在修改前源码复现的既有失败,本轮未发现新增失败。
- 使用修改前 `cda57ce93e6206f30612aab30ef85843713b3065` 的独立源码快照核对既有失败:`test_app.py` 两项旧契约期望;Fabric helper 两文件共五项 phase/owner/function 失败;`test_registration_http.py` 三项公网地址排除/池耗尽期望失败。这些不属于本轮超时/停机改动,未修改相应业务逻辑或放宽其断言。注册测试仅更新指标替身接口,并让多个会话共享一个应用生命周期。
- Python 源码语法解析与 `git diff --check` 通过。当前 macOS 未执行真实 Linux systemd、SSH/libvirt、QGA、大镜像或长快照验收;没有部署或重启服务。AnyIO 等外部框架同步线程、文件系统或操作系统异常仍可能需要 systemd 的最终强制终止,不能据此宣称任意阻塞均可优雅取消。
## 2026-10-12:资源隔离与持久执行协调
- 修复可靠性审查第 1、8 项。删除全进程 `_CREATE_LOCK` 和整请求更新协调锁,改为按 VM、宿主分配/存储、救援模板区分资源;宿主应用的状态锁不再覆盖普通 VM 的远程调用。历史 VM 的本地锁可回收,宿主身份更换仍受维护准入保护。
- 使用现有加密 `engine_records` 与数据库 CAS 持久化执行身份、资源和维护占用。HTTP 取消不释放仍在执行的请求;后台线程池、Fabric 异步任务及缓存维护在交接前持久占用,VPC 成员线程继承执行上下文。未知结果跨重启保留,不按 TTL 接管、不自动重放或据瞬时不存在退款。协议、旧任务升级与人工核验流程见 [执行协调说明](ENGINE_COORDINATION.md)。
- 新增专项回归 **110 passed**:覆盖真实 spawn 进程争抢同一加密数据库记录、资源/操作/维护排他、CAS 提交回执丢失、取消及重启保留、不同宿主与同宿主不同 VM 并行、后台交接、排队快照取消、Fabric 完整执行收据、VPC 线程上下文、本地锁回收、救援模板互斥和明确执行前失败释放。
- 最终 Python 3.12 全量引擎回归:**2286 passed、19 skipped、10 failed、80 subtests passed**(`PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=engine python -m pytest -q -p no:cacheprovider engine/tests`)。10 个失败与上一节修复前基线逐项一致:`test_app.py` 两项、Fabric helper 五项、`test_registration_http.py` 三项;未扩大范围修复或放宽这些断言。全量后补充的本地模板锁超时用例已包含在上述 110 项专项结果中。
- 现有维护准入测试调整为活动 VM 请求期间返回 409、结束后重试成功;未知写入测试改为保留原 operation、凭据和 IP,且不触发缺失性核对。停机测试仅补齐新状态字段,原期限断言保留。源码语法解析与 `git diff --check` 通过。
- 多进程测试使用真实加密 `DatabaseStore`,以 SQLite `BEGIN IMMEDIATE` 适配 MariaDB 行锁语法;不能代替真实 MariaDB 事务、故障和吞吐验收。未运行真实 Linux systemd、SSH/libvirt、QGA 或宿主机测试,没有部署。未修改 PHP 源码,未运行 PHP 测试。本次仍保留单 worker 部署;未来多 worker/Go 写入者必须遵循同一协议,其他目录及运行时状态仍需单独验收。
## 2026-10-12:VPC 应用与 libvirt 启动隔离
- 新组网不再为宿主 libvirt 安装 generator/drop-in、添加启动依赖或自动启动 daemon。
旧版平台 generator 仅在精确模板、归属与摘要匹配后,通过带快照的事务移除;未知
文件保持原样。新增 helper/unit 版本标记,使同 revision/digest 的旧成功计划也会
在管理员“重新核对”时真实更新。升级动作和映射恢复分支见
[Fabric 验收说明](FABRIC_HOST_ACCEPTANCE.md#保持-libvirt-原有启动配置)。
- 实际执行生成的宿主程序,复现并修复 VPC observe 的嵌套 AWK 语法错误、裸 IPv4 与
`/32` 差异、按设备过滤时省略 `dev`,以及协议 186 被显示为 `bgp` 的误判。
宿主使用数字路由输出,QGA 只补回固定查询已确定的设备,仍拒绝漂移和未知记录。
- 尚未写入私网的运行中 VM,可通过重复核对 live/inactive XML、受管 seed 和空 QGA
账本确认已不存在;真实私网残留仍要求停机。未决 QGA 记录、成员和 IP 只能在精确
清理证明后释放。页面补齐停机、原操作核对、启动验证的步骤及受控错误原因。
- 明确失败的创建/加入/移除操作允许用户显式核对,固定原 operation/revision/digest;
worker 无权自动重试 failed。原 running/uncertain/waiting_observed 操作再次收到
4xx 仍保留未知结果。普通 VPC 修改在成员有未完成实例任务时回滚;任务锁使用
NOWAIT 当前读,避免与任务完成流程互相等待,缺少支持时拒绝变更,不回退到快照读。
- 专项回归通过:宿主路由与 VPC 数据面 **119 passed**;libvirt/VPC 协调与执行账本
**110 passed**;Fabric 版本迁移、路由与真实 artifact 观察 **205 passed**。
测试覆盖已发布旧模板的事务迁移/回滚、篡改文件保留、同计划升级及升级后二次跳过。
- 最终 Python 3.12 全量引擎回归:**2380 passed、19 skipped、10 failed、80 subtests
passed**(`PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=engine python -m pytest -q -p no:cacheprovider engine/tests`)。
10 个失败 ID 与 `9f3a090` 基线逐项一致:`test_app.py` 两项、Fabric helper 五项、
`test_registration_http.py` 三项,没有新增失败。旧测试中要求重启 libvirt、必须存在
generator、使用旧路由命令格式的契约已按本轮行为更新,最终全量包含这些回归。
- 隔离 PHP/WASM 最终 **12 个 PHP 测试文件、1 个页面行为测试**通过,JavaScript
及 5 个 PHP 文件语法检查通过。SQLite 实际事务覆盖任务冲突回滚、原操作显式重试、
清理证据不足不释放、受控停机原因透传,以及 worker 候选切换后不自动重试新 failed。
NOWAIT 查询另覆盖 SQL 编译、锁冲突和数据库故障注入。扩展检查中的
`CloudEngineReadinessTest.php` 仍有既有静态断言失败:它要求两处观察跳过判断,
`9f3a090` 与当前相关生命周期源码均只有一处;这些文件本轮未修改。
- 未连接真实宿主、SSH/libvirt、QGA、systemd 或 MariaDB;没有部署或重启服务。
PHP 使用隔离 WASM 与实际 SQLite 事务,SQL 编译和异常注入不能替代 MariaDB 并发
验收。真实 stop/reconcile/start、旧宿主升级、重启后 ACL 和跨 VM 连通性仍按
[VPC 验收步骤](VPC_DATAPLANE_ACCEPTANCE.md) 执行。旧未知电源任务未自动终结。
## 2026-10-12:用户 VPC 页面排版与全新安装命令
- 收紧 VPC 列表宽度,扩大详情工作区;统一说明、成员 IP 和状态的字号与间距。
路由和 ACL 改为随宽度分行的表单,修复桌面展开高级策略后字段和保存按钮被裁切。
窄屏列表限制高度并可滚动,成员、诊断和创建弹窗按移动端排布。资产版本更新为
`2026101202`;不改变 API、任务状态或清理证明。
- Node 页面行为及 JavaScript 语法检查通过;隔离 PHP/WASM 的
`CloudVpcUserPageContractTest`、`CloudFirewallUiContractTest` 和
`CloudHostFabricEndpointContractTest` 通过。浏览器使用真实模板/JS/CSS、模拟
用户壳与本地 API 数据,覆盖 1440、1280、1024、768、390、320 像素,包含已生效、
待添加成员、部分失败、展开策略、空列表和创建弹窗。48 个常规场景和 16 个长名称、
最大端口等边界场景通过,无横向溢出、控件裁切或脚本错误;列表按钮均可滚动到达。
没有连接真实账户或宿主。
- 新增 [已有运行环境的全新安装命令](FRESH_INSTALL_COMMANDS.md),覆盖 `venix`
拉取、Python 虚拟环境、配置/空库导入、密钥及 FPM 权限、所有必需 systemd 服务
和签名健康检查。命令已对照当前代码与 unit,Bash/Python 语法检查通过;未在本机
执行安装、导库或服务启动,真实服务器安装仍需按实际目录、PHP 路径和 FPM 用户配置。
## 2026-10-12:宿主连接测试和保存的执行身份
- 修复 `b3ea192` 引入的暂存连接构造回归:`new_service` 开始使用执行身份后,
注册路径仍传入只有 URI 和资源设置的临时配置,导致 `host_scope` 读取不存在的
`host` 字段并报 503。该临时配置自最初实现就未含 `host_id`,问题不来自套餐或
用户接口移除宿主字段。
- 私有引擎从可信 `StableHostManager.host_id` 显式传入执行身份;首次注册、编辑、
连接测试及保存后的 VM 操作继续共享同一宿主预算、存储锁和未决写保护。
身份异常在 libvirt 写入前返回 409;独立模式仅使用已验证的地址、端口、指纹。
不改变数据库结构、指标哈希、VM 归属键或用户 API。详见
[宿主注册与执行身份](ENGINE_COORDINATION.md#宿主注册与执行身份)。
- 新增宿主作用域回归 **25 passed**,保留真实 `VMService` 构造、资源查询、存储
准备和连接适配逻辑;SSH、RPC 运行时及远端对象使用替身,资源锁入口记录实际键。
覆盖首次添加/编辑、测试/保存、变化的暂存 URI、非法内部身份、请求体注入、独立
模式和存储失败回滚,并校验读写预算及 `storage:7`。隔离加载修复前 HEAD 的
`app.py` 运行其中 7 个正常场景,全部复现 `KeyError: 'host'`。额外通过真实签名
请求和 `EngineApplication` 协调器验证非法身份:请求期间存在活动占用,409 后
暂存连接清理且占用释放,未启动 libvirt 操作。
- libvirt RPC、持久协调及资源锁回归 **67 passed**。扩展应用、私有边界、引擎协调、
数据库 HTTP 和指标回归 **293 passed、2 failed**;两项失败在修复前 HEAD
同样复现:模板创建期望缺少 `platform_network_policy_snapshot`,重装未决错误
用例仍读取 `detail` 而实际返回 `error`。未放宽断言或修改这些无关业务逻辑。
三个既有测试替身仅补齐生产已有的暂存 metadata 和可信 manager 身份契约。
- 使用 Python 3.12.14 与真实 pytest 9.1.1。本轮修复验证没有连接生产 SSH/libvirt、
部署或重启服务;真实新增宿主流程仍需更新引擎后验收。旧未决协调记录保持原样,
不因修复自动清空或重放。
## 2026-10-12:连接失败占用、快照解冻和停机 VPC 路由回归
- 连接建立失败现在使用 `libvirt_connection_failed`,明确尚无远端写入时释放本次
请求和资源占用;恢复连接后可重新保存宿主或提交新的 VM 操作。同执行的嵌套
资源和线程池任务共享写入证据,不能用后一次连接失败掩盖前一次写入。VPC/Fabric
混合 SSH 流程不放宽。宿主指纹扫描、暂存准备和只读 SSH 探测失败还须持久化未开始
凭据,全局/指定宿主入口一致;凭据保存失败则保留保护。旧 uncertain 占用不会自动解除。
- 新文件系统快照在冻结前绑定原任务、VM、实时运行代令牌和备份目标,并持久记录
冻结/启动/解冻边界。原 RPC 超时回收后立即尝试受限解冻;启动核对复用该入口。
解冻前的身份/备份核对与解冻后的异常分开,避免将已发送但结果未知的解冻当成
未执行而重放。解冻确认后原 libvirt 意图、协调占用和备份 uncertain 状态保持;
旧记录或证据不足时显示立即人工核对提示。恢复步骤见
[快照冻结后的限定解冻](LIBVIRT_EXECUTION.md#快照冻结后的限定解冻)。
- 受管私网 bridge 的单个 `linkdown` 保留在路由回读中,可证明停机时配置存在,
但不能证明 host 或对应成员 active/usable。WireGuard、guest 路由、未知/重复
flags 继续拒绝。覆盖停机首次加入、开机、停止最后成员、停机修改重试和再次启动。
原始路由生成脚本的两个新增关键场景在修复前 `b82f3b8` 副本失败,修复后通过。
- 新增签名请求/真实 VMService 协调回归 24 项;宿主身份相关 25 项继续通过。
VPC 相关 7 个测试文件 252 项通过。快照恢复通过真实 spawn 子进程和持久模拟远端
覆盖冻结后超时、精确备份目标、错误任务/VM/运行代、旧 worker 存活、阶段落盘失败、
响应未知不可重放、解冻后异常及普通写仍被阻挡;另通过 HTTP 后台入口验证无轮询
即发起恢复,以及 `safe_to_refund=false` 和原占用仍保留。快照恢复专项组合
82 项通过,其中包含 24 项新增 RPC 恢复和 2 项新增 HTTP 后台入口测试。
- 最终全量引擎回归:**2471 passed、19 skipped、10 failed、80 subtests passed**,
本轮共增加 66 个测试场景。10 项失败与修复前 `cda57ce` 隔离基线逐项一致:
`test_app.py` 两项既有契约期望、Fabric helper 五项、`test_registration_http.py`
三项公网地址池期望;没有新增失败,未修改这些业务逻辑或放宽断言。快照测试替身
补齐新增恢复任务参数,原运行中快照阻止断网的断言继续通过。
- Node `CloudVpcUserPageBehaviorTest` 通过;隔离 PHP/WASM 的
`CloudVpcUserPageContractTest`、`CloudVpcFailedReconcileTest` 和
`CloudVpcMutationAdmissionTest` 通过。Python 修改文件 AST 与 `git diff --check`
通过。此轮没有修改宿主机 libvirt 启动项、启动依赖或执行生产部署。
- 使用 Python 3.12.14 和 pytest 9.1.1;没有连接真实 SSH/libvirt/QGA 宿主,
未执行真实 Linux bridge/WireGuard 或 MariaDB 验收。部署后仍需在专用测试宿主验收
丢失 libvirt 响应、来宾解冻、停机 VPC 修改与再次启动;隔离测试不能代替这些检查。
## 2026-10-12:VPC 真实回读和活动网桥重复核对
- 修复 nft ARP 规则的 Ethernet/ARP 元组、数字 hook priority 回读、WireGuard
AllowedIPs 完整字段读取、overlay 地址范围和 `ip -j` 空对象解析。所有观察仍校验
owner、revision、digest、成员集合及完整规则,不用省略检查换取 active。
- 统一严格 bridge-port 解析;apply 在 DOWN 前保存路由、proxy 与 sysctl,早期失败
不删除尚未修改的原路由。回滚恢复运行态并证明桥身份;后续提交失败重新隔离,
不能留下已开放但归属写入失败的网桥。已有 tap 的 NetworkManager 网桥保留
原连接 UUID、ifindex 和端口集合,不再通过 managed no 或 connection up 拆除端口。
- 修复 Fabric 本地 catalog 事务取消边界,以及尚未进入宿主操作的 VPC 锁冲突被
错误保留成新的未知执行占用。已有远程写入证据、存储故障及操作中取消仍保持未知。
- 回归分别通过:VPC/Fabric 活动桥与回滚组合 **876 passed**,冻结后的 Fabric
保桥专项 **35 passed**;补充既有协调、探针、libvirt 接入等范围 **780 passed、
14 skipped**(缺少 Linux proc/netns 条件)。三处历史 helper 测试替身已按当前
native nftables 事务契约适配,所在日志模块 **41 passed**。这些范围部分重叠,
不能相加作为唯一用例数,也不代表全量引擎测试。
- 用户 VPC Node 行为、JavaScript 语法、修改 Python AST 与 `git diff --check`
通过。真实 nft 内核隔离矩阵、系统重启和完整故障注入仍需 Linux 验收环境。
- QGA 固定路由探针的权限拒绝返回单独原因,保持未核验;严格拒绝畸形 exitcode、
截断或非预期 stderr。最终 libvirt 服务模块 **246 passed、73 subtests passed**;
PHP/WASM 8.5 的 VPC 收敛回归与修改 PHP 语法检查通过。该模块与上述范围重叠。
- 现场进一步修复 observer 的三个 Shell 兼容问题:无可选 `nmcli`、空 proxy
集合不再触发 `set -e` 提前退出;NetworkManager/ifupdown 持久化分支显式分组,
避免 `&&`/`||` 同优先级导致合法 NM 配置被判失败。两个新增真实 Shell
回归模块 **56 passed**,覆盖缺失、外来、重复与双重归属的拒绝边界;与既有
dataplane 模块的组合 **82 passed**,范围重叠。
- 现场两台宿主机核对证明:私网 tap、精确 `/32` 路由、proxy ARP、WireGuard
AllowedIPs 及三类 nft 规则均可恢复并回读。未改动 libvirt unit、启动依赖或
enable/mask 状态。成员间 ping 命中未配置允许规则的默认拒绝;来宾 SELinux
另行拒绝 QGA 的路由查询。两者都不能通过修改数据库成功标记或放宽证据门槛处理。
默认 ACL、来宾权限和恢复验收步骤见 [VPC 验收说明](VPC_DATAPLANE_ACCEPTANCE.md)。
## 在具备依赖的环境复测
不要使用生产数据库/宿主机运行额外真实集成测试;以下默认单元/隔离测试:
```bash
cd /home/virt-cloud/web
for test_file in tests/*Test.php; do php "$test_file" || exit $?; done
cd /home/virt-cloud/engine
.venv/bin/python -m pip install -r requirements-dev.txt
PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -m pytest -q -p no:cacheprovider
```
PHP 测试需 Composer 开发可用依赖和测试所用 PDO SQLite。测试中的模拟凭据、地址与密钥不是部署配置。
上线前按 [部署说明](DEPLOYMENT.md) 完成测试用户的实际购买、首次 SSH 登录、重装、救援、VNC 撤销、故障清理退款与无人登录时持续采样。另须使用短测试账期实际验证:到期只断网、宽限期续费恢复网络、宽限期结束后 VM 定义/系统盘/cloud-init 盘均被删除,以及删除失败或响应丢失时不会错误标记成功。共享公网网桥的 IP/MAC 防欺骗及宿主容量调度尚未提供,不能只凭单元测试开放不受信任客户的资源销售。