diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index 567ef4b0..4eb098cd 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -93,11 +93,11 @@ php xcat cloudRepairInstanceMetadata --apply ### 对象存储应用 -后台 `/admin/object-storage` 可配置一个全局 S3 兼容对象存储应用,适用于 AWS S3、MinIO 及实现 AWS Signature Version 4 的兼容服务。该功能复用业务库已有的 `configurations` 表,不需要导入新表。Endpoint 必须是带有效证书的 HTTPS origin;MinIO 通常选择路径寻址,AWS S3 通常选择虚拟主机寻址。 +后台 `/admin/object-storage` 可配置一个全局 S3 兼容对象存储应用,适用于 AWS S3、MinIO 及实现 AWS Signature Version 4 的兼容服务。该功能复用业务库已有的 `configurations` 表,不需要导入新表。Endpoint 必须是带有效证书的 HTTPS origin;MinIO 通常选择路径寻址,AWS S3 通常选择虚拟主机寻址。页面默认展示运行概览、就绪条件和脱敏连接详情;只有超级管理员可从编辑抽屉修改连接。对象清理异常位于独立工作区,`delete_uncertain` 只显示系统核对进度,只有 `delete_attention` 提供人工“重新核对”入口。 Access Key ID 与 Secret Access Key 只在超级管理员提交时进入 PHP,使用 `cloud_data_key` 的独立用途密钥密封后保存,读取页面不会回显。修改任一配置或停用应用都会清除原就绪标记;必须重新执行“验证连接并启用”。连接验证只发送签名的 `HeadBucket` 请求,需要目标 Bucket 的 `s3:ListBucket` 权限,不上传、覆盖或删除对象。管理员虚拟机管理已接入完整系统盘备份和新实例恢复,目标可以是原宿主机或其他合格宿主机;用户自动备份使用同一对象存储,在实例设置中按每天或每周于 UTC 00:00 调度并保留最多两份。云镜像导入还会先把经过校验的内容发布到 `cloud-templates/` 不可变主副本,再向宿主机签发该精确版本的只读地址;没有旧本地模板路径或直接暂存分发回退。运行账户需要在配置前缀下同时授予 `vm-backups/` 与 `cloud-templates/` 的上传、`GetObject`、`HeadObject` 和 `DeleteObject` 权限;开启 Bucket 版本控制时还必须授予 `s3:GetObjectVersion` 与 `s3:DeleteObjectVersion`,让 HEAD 与删除准确绑定 `versionId`。维护迁移使用宿主机间 PeerMigration V3 直传,不创建 S3 迁移对象,也不需要 `vm-migrations/` 权限。当前不包含增量链和管理员手工备份的自动保留策略,具体安全边界见 `docs/PORTABLE_VM_BACKUPS.md`。 -生产 Bucket 必须把生命周期规则作为控制面之外的最后兜底:在短周期内终止未完成 multipart upload;开启版本控制时,按业务保留要求清理 `vm-backups/` 的非当前版本和过期删除标记。生命周期不得提前删除仍由面板备份或云镜像目录引用的当前版本。面板会保存 HEAD 返回的 ETag 与 `version_id`,删除时精确定位该版本;删除结果不明时先进行间隔稳定 HEAD,只有对象身份完全一致才创建新的删除代次,每个自动周期最多三次。达到上限的对象进入后台人工核对,不再自动删除;云镜像的人工重试只恢复对象存储核对,不会再次删除宿主机副本。 +生产 Bucket 必须把生命周期规则作为控制面之外的最后兜底:在短周期内终止未完成 multipart upload;开启版本控制时,按业务保留要求清理 `vm-backups/` 的非当前版本和过期删除标记。生命周期不得提前删除仍由面板备份或云镜像目录引用的当前版本。面板会保存 HEAD 返回的 ETag 与 `version_id`,删除时精确定位该版本;删除结果不明时先进行间隔稳定 HEAD,只有对象身份完全一致才创建新的删除代次,每个自动周期最多三次。达到上限的对象进入后台人工核对,不再自动删除;对象存储页面的“重新核对”只恢复稳定 HEAD 证据流程,不会重放原 DELETE。云镜像的人工重试同样只恢复对象存储核对,不会再次删除宿主机副本。 生产环境应为面板创建独立服务账户,把权限限制到配置的 Bucket 和备份前缀。数据库备份必须与原始 `cloud_data_key` 一起保管,重新生成主密钥无法恢复全局配置及各备份冻结的对象存储凭据。 diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md index cd16ac1d..0e05de91 100644 --- a/docs/VALIDATION.md +++ b/docs/VALIDATION.md @@ -129,6 +129,7 @@ jq empty deploy/*.json.example - 法律内容在保存、预览和公开读取时都必须经过服务端清洗;脚本、事件属性、表单、外链资源和未知标签不能进入预览或公开页面。 - 落地页、服务条款、隐私政策和后台法律编辑页必须分别在桌面与窄屏视口验收,导航、目录、编辑控件和正文不得横向溢出。 - 对象存储配置页面不得回显 Access Key ID、Secret Access Key 或数据库密文;普通管理员只能查看,保存、连接验证和停用必须同时经过超级管理员与 CSRF 校验。 +- 对象存储页面必须在桌面与窄屏视口验收运行概览、编辑抽屉和清理异常工作区;编辑抽屉默认保持现有凭据,只有明确启用“替换凭据”才显示空白凭据输入框。停用和重新核对必须使用站内确认对话框,不使用浏览器原生 `confirm()`。 - 对象存储保存后必须处于未启用状态;只有当前配置版本的签名 `HeadBucket` 成功后才能就绪。修改或停用时旧验证立即失效;失败响应只显示稳定的本地错误,不泄露 Endpoint 响应正文、凭据或服务器路径。 - 使用受控的 S3/MinIO 测试 Bucket 分别验收路径寻址和虚拟主机寻址、错误 Region、错误凭据、缺少 `s3:ListBucket`、无效证书和连接超时;验证过程中 Bucket 对象数与内容不得变化。 - 可移植备份必须拒绝额外可写盘、backing chain、LUN 和活动 pivot/mirror;运行实例分别验证文件系统一致性与 Guest Agent 不可用时的崩溃一致性路径,关机实例验证稳定完整副本。 @@ -138,6 +139,7 @@ jq empty deploy/*.json.example - 维护迁移阶段注册表必须通过完整性测试:每个 Agent 任务种类只能对应一个账本字段、完成处理和不确定结果核对动作,每个人工恢复动作只能对应一个执行入口。页面必须直接使用后端返回的恢复选项和阶段进度;接口在加锁后使用同一判定重新授权。资源结算模块只能在源删除或目标接管得到明确证明后移动订单预留和公网 IP。没有持久化字节遥测时只能显示阶段进度,不能合成传输百分比。 - 独立恢复可选择原宿主机或其他合格宿主机;无论目标是否为原宿主机,都必须单独校验并预留容量与全新公网 IP。目标使用 `bridge:br0`;校验下载对象字节数与 SHA-256,新实例 UUID、MAC、seed、NVRAM、网络过滤器和流量状态均不得复用源实例,且不得继承订单、账单、服务期、到期时间或流量周期。 - 对备份/恢复断连、超时和回执丢失执行故障注入:同一 Agent operation ID 只能查询收敛,不能再次派发。恢复失败只有在全部托管产物明确不存在时才能释放容量与 IP。对象删除响应未知时不得重放原 DELETE;必须用两次间隔 HEAD 证明同一大小、ETag 和 `version_id` 仍存在,才允许创建新的删除代次。验证每轮最多三次、超限转人工、手动重试重新建立稳定证据、精确版本删除、清理债务不占保留份数,并确认大量异常债务不会饿死新的保留清理。 +- 清理异常工作区不得显示对象键或 `version_id`。`delete_uncertain` 必须显示下一次自动核对时间且没有人工重试按钮;`delete_attention` 必须显示停止时间,只有超级管理员可点击“重新核对”,该动作必须先执行精确对象身份检查并返回稳定核对流程,不能直接调用 DELETE。 ## 7. 非生产宿主机验收 diff --git a/web/public/cloud/admin-object-storage.css b/web/public/cloud/admin-object-storage.css index 6de6b64a..bd0b78a6 100644 --- a/web/public/cloud/admin-object-storage.css +++ b/web/public/cloud/admin-object-storage.css @@ -197,7 +197,6 @@ display: none; } -.os-head, .os-card-head { display: flex; align-items: flex-start; @@ -205,13 +204,6 @@ gap: 18px; } -.os-head h1 { - margin: 0 0 7px; - color: #0f172a; - font-size: 28px; -} - -.os-head p, .os-card-head p { margin: 0; color: #64748b; @@ -330,14 +322,6 @@ font-family: SFMono-Regular, Consolas, "Liberation Mono", monospace; } -.os-secret-state { - display: inline-flex; - align-items: center; - gap: 6px; - color: #047857; - font-weight: 700; -} - .os-actions { display: flex; flex-wrap: wrap; @@ -380,11 +364,6 @@ background: #fef2f2; } -.os-alert.is-info { - color: #1d4ed8; - background: #eff6ff; -} - .os-inline-alert { margin-top: 14px; } @@ -982,7 +961,6 @@ body.os-dialog-open { gap: 16px; } - .os-head, .os-hero { display: grid; } @@ -1000,10 +978,6 @@ body.os-dialog-open { margin-left: auto; } - .os-head h1 { - font-size: 24px; - } - .os-card { padding: 17px; } diff --git a/web/resources/views/venix/layout_assets.tpl b/web/resources/views/venix/layout_assets.tpl index ed3c103b..51bdefb3 100644 --- a/web/resources/views/venix/layout_assets.tpl +++ b/web/resources/views/venix/layout_assets.tpl @@ -1,2 +1,2 @@ {* Shared Venix CSS/JS cache key. Increment whenever a shared browser asset changes. *} -{assign var=venix_asset_version value='2026103112' scope='global'} +{assign var=venix_asset_version value='2026103113' scope='global'} diff --git a/web/tests/CloudObjectStorageAdminContractTest.php b/web/tests/CloudObjectStorageAdminContractTest.php index e677144d..6bdfd418 100644 --- a/web/tests/CloudObjectStorageAdminContractTest.php +++ b/web/tests/CloudObjectStorageAdminContractTest.php @@ -21,6 +21,7 @@ $client = $read('app/Services/Cloud/CloudObjectStorageS3Client.php'); $template = $read('resources/views/venix/admin/object_storage.tpl'); $pageCss = $read('public/cloud/admin-object-storage.css'); $pageJs = $read('public/cloud/admin-object-storage.js'); +$assets = $read('resources/views/venix/layout_assets.tpl'); $sidebar = $read('resources/views/venix/admin/static_header.tpl'); $deployment = file_get_contents(dirname($root) . '/docs/DEPLOYMENT.md'); $validation = file_get_contents(dirname($root) . '/docs/VALIDATION.md'); @@ -86,11 +87,15 @@ $assert(str_contains($template, "admin_title value='对象存储'") && !str_contains($template, '