# SILO 与 MinIO 用户可感知行为变化

> 从上游 MinIO 分叉基线到 SILO 20261112，全部用户可感知的接管条件、部署身份、权限、S3 读写、复制、多池、生命周期、Batch、mcli 与 Console 行为变化对照。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

**标准 S3 应用通常无需修改代码即可从 MinIO 切换到 SILO，现代 `xl` / `xl-single` 数据卷也可原地挂载读取，无需重写对象。** 但从上游 MinIO 迁移到 SILO 属于**全集群协调停机切换**（不支持新旧节点混跑滚动升级），且安全加固与一致性修复对交付身份、IAM 策略求值、请求签名、Object Lock、多池写入及后台作业引入了明确的边界。

> [!IMPORTANT] 当前核查基线：SILO 20261112
> 本页完整覆盖从上游分叉基线 [`minio/minio@27742d469462`](https://github.com/minio/minio/commit/27742d469462e1561c776f88ca7a1f26816d69e2)（`2025-12-03`，位于上游最后发行版 `RELEASE.2025-10-15T17-29-55Z` 之后）至 **[SILO Server 20261112](/zh/blog/release/silo-20261112/)**（`RELEASE.2026-11-12T00-00-00Z`，源码 [`44e848fedf8c`](https://github.com/pgsty/silo/commit/44e848fedf8cec3d8c0da4b1aa8422390a2b7a8b)，内嵌 **[Console v2.7.2](/zh/blog/release/console-2.7.2/)** [`0e7953ff59c4`](https://github.com/pgsty/silo-console/commit/0e7953ff59c4a1eb77c7d203b265e6783ff18d01)、配套 **[mcli 20261112](/zh/blog/release/mcli-20261112/)** [`a37a9f054fba`](https://github.com/pgsty/mc/commit/a37a9f054fba828a0bbbceb4e9ff247ccf09c28d)、`silo-pkg v3.16.1`、Helm chart `7.0.5`、Go `1.27.4`）的全部用户可感知变化。高层分类见[三层兼容性总览](/zh/compatibility/)，操作步骤见[迁移指南](/zh/compatibility/migration/)。


- [旧集群接管判定矩阵](#takeover) (先看这里) — 判断存量 MinIO 数据盘能否原地挂载、哪些拓扑必须停机切换，以及降级回滚的真实前提。
- [按起点版本速查](#by-version) (4 条路径) — 按“上游 MinIO”“SILO 202608–09”“SILO 20260916–1026”“SILO 20261109”筛选与你直接相关的升级门禁。
- [12 大领域行为对照](#deployment) (完整清单) — 逐项核查部署交付、IAM 授权、S3 签名与读写、分片、复制、存储池、桶配置、ILM、Batch、mcli 与 Console 变化。
- [切换前核查与回滚](#upgrade) (5 步清单) — 上线前排空、备份、配置审计、切换后逐节点 S3 数据面验收及一致性恢复点要求。


## 现有 MinIO 集群能否直接在 SILO 上运行？ {#takeover}

评估存量集群能否直接接管时，需要把**磁盘格式能否直接读取**、**切换过程能否滚动混跑**、**切换后策略与后台任务是否按预期运行**三件事分开判断：

| 场景或边界                                                    | 判定结果                                          | SILO 20261112 实际行为                                                                                                                                    | 升级与运维要求                                                                                           |
| :------------------------------------------------------------ | :------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------- |
| 现代单盘（`xl-single`）与分布式（`xl`）数据卷                 | **原地挂载**      | `.minio.sys/format.json` 与 XL 元数据头保持兼容；历史对象、多版本、分片上传、加密元数据与存量 IAM 记录可直接加载，无需逐对象导出重导                      | 切换前以只读方式确认 `.minio.sys/format.json` 为 `xl` 或 `xl-single`，并确认所有纠删集具备健康读仲裁     |
| 历史 `fs` 或 `gateway` 模式目录                               | **不支持直接挂载** | 上游 MinIO 已于 `2022-10-29` 移除；SILO 启动时拒绝旧 `fs` 目录（注：现代单目录 `server /data` 实际使用 `xl-single`，可正常接管）                          | 按 [FS / Gateway 迁移流程](/zh/operations/deployments/baremetal-migrate-fs-gateway/)通过镜像同步导出迁移 |
| 跨产品逐节点混跑（MinIO 与 SILO 同时在线）                    | **禁止混跑**       | 分布式启动会校验对端二进制校验和，内部 StorageREST 已移除私有 `/rmpl`（`ReadMultiple`），IAM 修订与复制对端协议也已演进                                   | 从上游 MinIO 切换到 SILO 必须按**全集群协调停机切换**执行，不要逐台滚动替换                              |
| 同池不同纠删集使用不同主机集合（自动布局通常 ≥ 18 台主机）    | **必须全停切换**  | `20261109` 之前的进程将单池对象锁固定发往第 0 个纠删集，新进程发往对象所属纠删集；新旧混跑时锁域不一致，会失去互斥保护                                    | 升级到 `20261109` 及以上版本前，必须排空流量并停齐全部旧进程后再启动新进程                               |
| 多存储池集群在 SILO 版本间滚动升级                            | **排空并发写入**  | 跨池条件写、锁顺序、批量删版本与暂停桶锁定的 `null` 版本保护需要全部节点升至 `20261112` 才能统一生效                                                      | 跨越混合版本窗口时排空或暂停并发 S3 写入                                                                 |
| 多站点复制与共享 IAM 切换                                     | **全站协同**      | 持久 IAM 撤销墓碑（`20260916+`）与三态服务账号内联策略（`20261112`）若遇到未升级旧站点的账号编辑与回写，可能被旧语义覆盖                                  | 混合站点窗口期内禁止在旧站点编辑服务账号或策略；全站升齐后再核对有效策略                                 |
| 未完成的 Batch 后台作业（`expire`、`replicate`、`keyrotate`） | **升级前排空**    | `20261109+` 使用绑定提交者的 `SILO-BATCH` v2 清单与报告；旧版运行中／排队／暂停作业不承诺跨版本续跑，且 `≤ 20261026` 拒绝读取 v2 记录                     | 升级前停止提交新作业，等待旧作业结束或主动取消；全部节点升齐后重新提交                                   |
| 原生 S3 归档恢复（`POST ?restore`）                           | **需全节点就绪**  | `20261109+` 的两阶段无锁恢复要求集群内所有 peer 均支持新能力且网络可达，否则 `POST ?restore` 直接返回 `503`                                               | 全部节点升齐并确认对端连通后再执行归档恢复验收                                                           |
| 自定义 IAM 策略、OIDC/LDAP、TLS/KMS 与事件通知                | **按条件核查**       | 纯对象 ARN 不再授予 12 个桶级写动作、显式删版本要求 `s3:DeleteObjectVersion`、自助改密改为 `admin:ChangeMyPassword`、拒绝 HMAC OIDC、旧数据库通知需连接串 | 切换前核对代表性策略，并在真实网络环境中验证登录、KMS 解密、复制与通知投递                               |
| 切换后直接换回旧二进制回滚                                    | **需完整恢复点**   | 能读对象不等于可安全降级：启动、扫描、IAM 变更、Batch v2 记录与桶墓碑会更新 `.minio.sys` 持久状态，旧二进制可能拒绝识别或破坏撤销历史                     | 切换前必须保留离线一致的 `.minio.sys`、IAM 导出与部署清单备份；回滚时须连同所有参与节点一起恢复          |
{.matrix .wide .expand}

## 按起点版本速查升级重点 {#by-version}

选择你当前正在运行的版本，快速查看升级到 **SILO `20261112`** 时最关键的检查项；完整细节见下方 12 个领域对照表。

**从上游 MinIO（≤ 2025\-10\-15）迁移**

从上游 MinIO（例如最后正式版 `RELEASE.2025-10-15T17-29-55Z`）迁移到 `SILO 20261112` 时，会一次性跨越分叉以来的全部交付与安全边界：

- **切换方式与磁盘确认**：确认 `.minio.sys/format.json` 为 `xl` 或 `xl-single`，保留完整离线备份，并采用**全集群停机切换**（切勿 MinIO 与 SILO 混跑）。已有单节点原地迁移实录见[迁移案例](/zh/compatibility/migration/#single-node-case)。
- **部署与交付物身份（[第 1 节](#deployment)）**：镜像改为 `docker.io/pgsty/silo:RELEASE.2026-11-12T00-00-00Z`，二进制与 systemd 服务改为 `silo`，客户端包改为 `mcli`；容器内硬编码 `/usr/bin/minio` 需改为 `silo`；Helm 升级必须保留原有资源名称并显式固定 `image.tag`；自更新（`admin update` / `mcli update`）与 SUBNET 在线服务已停用。
- **IAM 策略与外部认证（[第 2 节](#iam)、[第 3 节](#object-authorization)）**：
  - 仅写 `arn:aws:s3:::bucket/*` 的策略不再自动获得 `PutBucketPolicy`、`PutBucketLifecycle`、`DeleteBucket` 等 12 个桶级写动作，需补齐裸桶 ARN `arn:aws:s3:::bucket`；
  - 带 `versionId` 的永久删除需要 `s3:DeleteObjectVersion`；仅写 `Deny s3:DeleteObject` 的防删策略需同步加上 `Deny s3:DeleteObjectVersion`；
  - 自助改密改看 `admin:ChangeMyPassword`（内置 `readonly` 默认不再允许自助改密）；新建或修改策略执行严格 JSON 校验并拒绝裸 ARN 前缀；
  - OIDC 拒绝 `client_secret` 对称 HMAC（`HS256/384/512`）与超过 4096 位的 RSA JWK；反向代理透传来源 IP 需配置 `MINIO_API_TRUSTED_PROXIES`。
- **外部依赖与后台任务（[第 8–10 节](#bucket-config)）**：PostgreSQL / MySQL 事件通知需改为 `connection_string` / `dsn_string`；桶级 CORS 配置开始真正生效；切换前排空未完成的 Batch 作业；切换后对每个节点执行真实签名 S3 读写与 Console 登录验证。

**从 SILO 20260804–20260903 升级**

你已完成 `silo` / `mcli` 身份切换与首轮桶级 ARN、`DeleteObjectVersion`、OIDC HMAC 等分叉加固，升级到 `20261112` 重点核查 `20260916` 以来的变化：

- **权限与 IAM 协同（[第 2 节](#iam)）**：`20260916` 拆分 `admin:ChangeMyPassword` 并引入持久 IAM 撤销记录（需按 [IAM 升级指南](/zh/operations/replication/iam-upgrade/) 协同升级）；`20261018` 收紧委托管理凭据越权与根派生凭据保护；`20261112` 执行严格策略 JSON 解码，并将服务账号策略更新改为“省略保留、`{}` 清空回退继承”。
- **S3 标签与归档成员鉴权（[第 3 节](#object-authorization)）**：`GET`/`HEAD`（含双活代理、STS、预签名与匿名请求）仅在具备标签或锁读取权限时返回 `x-amz-tagging-count`、`X-Amz-Tagging` 与 `X-Amz-Object-Lock-*`；ZIP 压缩包内成员读取校验真实外层标签且不再隐式落盘索引。
- **拓扑停机与就绪门禁（[第 6–10 节](#replication)）**：≥ 18 台主机（或跨不同主机子集）的单池集群必须**全停切换**以对齐锁域；升级前排空或取消未完成的 Batch 作业（`SILO-BATCH` v2 清单不向后兼容）；混合版本期间 `POST ?restore` 返回 `503`；多池滚动窗口期内排空并发 S3 写入。
- **HTTP、TLS 与 Console（[第 11–12 节](#operations)）**：HTTP/1 请求头改用绝对读取截止时间；Go `1.27.4` 与 `-distroless` UBI 根证书收紧；内嵌 Console 升至 `v2.7.2`（游标分页、十语种 UI、文件夹用量扫描、内联策略三态编辑）。

**从 SILO 20260916–20261026 升级**

从九月或十月版本升级到 `20261112` 时，重点处理以下升级门禁：

- **曾启用 `20260916` 可选 `strict` 分片列表模式的集群（[第 5 节](#multipart)）**：`20261018+` 已退役该实验开关（启动时忽略并打印告警），恢复缓存／精确键行为，不再提供持久分片枚举与严格取消。
- **单池锁域、Batch v2 与归档恢复门禁（`20261109` 引入）**：
  - 同池不同纠删集跨不同主机集合（自动布局通常 ≥ 18 台主机）时，必须排空并停齐旧进程后再启动 `20261112`；
  - 升级前排空或取消全部未完成 Batch 作业，升级后重新提交（`20261026` 拒绝读取 v2 清单）；
  - 全部节点升齐前，原生 `POST ?restore` 返回 `503`。
- **`20261112` 新增授权、锁与多池修复**：
  - 服务账号编辑默认保留现有内联策略，显式传入 `{}` 或关闭 **Restrict beyond user policy** 才恢复继承（混合站点窗口期内切勿在旧站点编辑服务账号）；
  - IAM、STS、桶策略、`mcli` 与 Console 全面启用严格策略 JSON 解码（拒绝未知字段与尾部多余内容）；
  - `DeleteObjects` 中所有显式携带 `VersionId` 的条目（无论桶是否开启 Object Lock）均改为顺序走单对象路径，大批量清版本耗时增加；
  - 版本暂停桶与前缀排除桶中已上锁的 `null` 版本受防覆盖、防遮蔽保护；修复压缩加密对象首帧内 `Range` 读取与跨池历史版本自复制。

**从 SILO 20261109 升级到 20261112**

`20261109` 已包含单池锁域对齐、`SILO-BATCH` v2 清单与两阶段归档恢复，升级到 `20261112` 主要关注以下增量变化（详见 [20261112 发行说明](/zh/blog/release/silo-20261112/#upgrade)）：

- **服务账号策略保留与重置（SN-2026-025）**：更新服务账号或访问密钥时，省略／`null` 策略会保留原有内联限制（含历史空内联拒绝策略），显式传 `{}` 或 `{"Statement":[]}` 才移除内联策略并恢复继承母账号。多站点升级期间避免在 `20261109` 站点编辑服务账号。
- **严格策略 JSON 与 SSE-KMS 上下文校验**：Server、Console `v2.7.2` 与 `mcli 20261112` 拒绝含未知字段、尾部垃圾内容或空 `Principal: {}` 的策略 JSON；`X-Amz-Server-Side-Encryption-Context` 非法输入统一返回 `400 InvalidArgument`（不再返回 `500`），且 `keyrotate` 持久保留 KMS 上下文并将旧 `XLV1` 流式重写为 `XLV2`。
- **S3 标签、ZIP 视图与签名边界（SN-2026-022 / -023 / -024）**：本地与双活代理 `GET`/`HEAD` 按权限过滤 `x-amz-tagging-count`、`X-Amz-Tagging` 与 `X-Amz-Object-Lock-*`；标签鉴权遇到读仲裁不足时保留 `5xx` 而非误判 `403`（`#294`）；ZIP 成员读取校验真实标签且不再隐式写回索引；认证的 `STREAMING-UNSIGNED-PAYLOAD-TRAILER` 强制 15 分钟时间窗，SigV4 拒绝范围日期不匹配与超 64 KiB 尾部头。
- **Object Lock、批量删版本与存储池**：暂停版本控制桶中已锁定的 `null` 版本拒绝普通覆盖与删除标记；`DeleteObjects` 中所有带显式 `VersionId` 的条目在全部桶中均按单对象顺序执行；多池滚动期间建议排空并发 S3 写入；修复压缩加密 `Range` 读取（`decryptSkip > 0`）、跨池历史版本自复制（`#343`）、`2024-04-28` 前旧 `xl.meta` 与 `UsesDataDir` 修订号分裂（`#332`、`#344`）以及池退役嵌套子键重扫与仲裁内离线盘判空（`#334`）。
- **Helm 升级**：使用 `helm upgrade --reuse-values` 升级到 chart `7.0.5` 时，显式传入 `--set image.tag=RELEASE.2026-11-12T00-00-00Z`。

## 1. 部署、交付物身份与外联边界 {#deployment}

| 场景                                    | 引入版本                  | 旧行为 → SILO 当前行为                                                                                                                                                          | 影响与处理建议                                                                                                                                                            |
| :-------------------------------------- | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 软件包、可执行文件与 systemd 服务       | `20260806+`               | `minio` / `minio.service` / `/usr/local/bin/minio` → 服务端包与二进制统一为 `silo`（`silo.service`），客户端包与二进制统一为 `mcli`；不安装 `/usr/bin/minio` 别名               | 更新启动脚本、监控探针与运维自动化；软件包迁移步骤见[原生软件包迁移](/zh/compatibility/binary/)                                                                           |
| 系统运行账号与环境文件优先级            | `20260806+`               | 默认系统账号 `minio-user` → 全新安装默认使用 `silo:silo`；环境文件优先读取 `/etc/default/silo`，不存在时回退读取 `/etc/default/minio`                                           | 原地接管旧数据盘时，保持原运行 UID/GID 或将卷与证书目录授权给 `silo:silo`；勿同时留下冲突的两份环境文件                                                                   |
| 本地配置与 TLS 证书目录回退             | `20260806+`               | 固定 `~/.minio` → 全新环境默认 `~/.silo`；仅存在 `~/.minio` 时自动回退复用，且当 `~/.silo/certs` 缺少证书时仍会回退读取 `~/.minio/certs`                                        | 建议在启动参数中显式指定 `--config-dir` 或 `--certs-dir`，避免误建空 `~/.silo` 后遮蔽旧配置                                                                               |
| 容器镜像、入口与 `-distroless` 变体     | `20260806+` / `20261109+` | `minio/minio`（含 `/usr/bin/minio`） → `docker.io/pgsty/silo`（提供经典 UBI 与 `-distroless` 镜像）；entrypoint 兼容参数形式的 `minio server ...`，但镜像内只有 `/usr/bin/silo` | 将写死 `/usr/bin/minio` 的 `command` 或健康检查改为 `silo`；`-distroless` 不含 shell 与 `mcli`，探针请用 `["CMD", "silo", "healthcheck", "ready"]`                        |
| Helm chart 升级与资源命名（`7.0.5`）    | `20260806+` / `20261112`  | 旧版 `minio` chart 资源名与默认运行身份 → SILO chart 默认使用 `silo` 命名与非 root 安全上下文，且 `--reuse-values` 会保留旧 `image.tag`                                         | 接管存量 PVC/Service 时固定 `nameOverride`、`fullnameOverride`、`serviceAccount.name` 与 `securityContext`，升级时显式传入 `--set image.tag=RELEASE.2026-11-12T00-00-00Z` |
| 在线自更新、SUBNET、遥测与 Windows 归档 | `20260804+` / `20261026+` | 支持 `mc admin update`、`mc update`、SUBNET 注册上传与默认 `play` 别名 → 在线自更新、遥测与 SUBNET 全面停用并显式返回错误；Windows 产物改为 `.zip`                              | 清理定时 `update` 脚本与 SUBNET 自动化，改用软件包、容器镜像或编排器发布                                                                                                  |
| TLS 密码套件与系统 CA 信任根            | `20260903+` / `20261109+` | 旧版 Go TLS 默认项与较宽根证书集 → 采用 Go `1.27.4` TLS 实现，且 `-distroless` 对齐 UBI `ca-certificates`（移除已停用的旧 GlobalSign R2 与部分泛域名受信根）                    | 若 KMS、OIDC、LDAP、etcd、Webhook 或复制对端使用老旧 TLS 实现或旧私有 CA，需提前在 `certs/CAs/` 补齐根证书并实测握手                                                      |
| Go 模块嵌入与共享库路径                 | `20260903+`               | 通过 `github.com/minio/pkg/v3` 间接引用 → 服务端保留 `github.com/minio/minio` 模块名，但维护代码直接依赖 `github.com/pgsty/silo-pkg/v3`（当前 `v3.16.1`）                       | 仅影响在 Go 代码中直接 import 内部包的二次开发者；标准 S3 SDK 用户完全无感                                                                                                |
{.wide .expand}

## 2. 认证、IAM、权限策略与代理信任 {#iam}

| 场景                                                                                                     | 引入版本                  | 旧行为 → SILO 当前行为                                                                                                                                                                                                                                                                                                                                                                                                                         | 影响与处理建议                                                                                                                                                  |
| :------------------------------------------------------------------------------------------------------- | :------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 桶级高危写动作不再接受纯对象通配 ARN（[SN-2026-004](/zh/about/security-advisories/#sn-2026-004)）        | `20260804+`               | 策略仅写 `arn:aws:s3:::bucket/*` 即可放行桶策略、生命周期、复制、版本控制、删桶等操作 → `PutBucketPolicy`、`DeleteBucketPolicy`、`PutBucketObjectLockConfiguration`、`PutBucketVersioning`、`PutReplicationConfiguration`、`PutBucketLifecycle`、`DeleteBucket`、`ForceDeleteBucket`、`PutBucketCors`、`DeleteBucketCors`、`PutBucketQOS`、`PutInventoryConfiguration` 共 12 个动作必须在同一 `Allow` 语句中包含裸桶 ARN `arn:aws:s3:::bucket` | 检查自动化建桶与管理凭据策略，按需同时声明 `["arn:aws:s3:::bucket", "arn:aws:s3:::bucket/*"]`；短期应急可设环境变量 `MINIO_API_LEGACY_BUCKET_RESOURCE_MATCH=on` |
| 用户／用户组启停权限按目标状态拆分（[SN-2026-009](/zh/about/security-advisories/#sn-2026-009)）          | `20260903+`               | `SetUserStatus` 与 `UpdateGroupStatus` 无论启用还是禁用都只检查 `Enable*` → 启用检查 `admin:EnableUser` / `admin:EnableGroup`，禁用检查 `admin:DisableUser` / `admin:DisableGroup`                                                                                                                                                                                                                                                             | 为需要封禁账号或用户组的运维角色补齐 `admin:DisableUser` 与 `admin:DisableGroup`                                                                                |
| 自助改密与创建／改他人密码权限拆分                                                                       | `20260916+`               | `admin:CreateUser` 同时覆盖建用户与自助改密，内置 `readonly` 含自助改密能力 → 自助改密独立检查 `admin:ChangeMyPassword`，内置 `readonly` 默认不再允许自助改密                                                                                                                                                                                                                                                                                  | 需要普通只读用户自行改密时，显式附加 `admin:ChangeMyPassword`；详见[密码权限迁移说明](/zh/compatibility/password-permissions/#migration)                        |
| 服务账号与访问密钥策略的三态编辑语义（[SN-2026-025](/zh/about/security-advisories/#sn-2026-025)）        | `20261112`                | 编辑描述、名称、状态或过期时间时若未附带策略，可能清空原有内联限制并回退为继承母账号完整权限 → 省略或传 `null` 保留现有内联策略（含 `20261111` 前遗留的空内联全拒绝账号）；显式传 `{}` 或 `{"Statement":[]}` 才移除内联策略并恢复继承；非空策略缺省 `Version` 自动补齐默认值                                                                                                                                                                   | 升级 Console `v2.7.2` 与 `mcli 20261112`；跨站点滚动升级期间切勿在旧站点修改服务账号元数据，全站升齐后复核存量访问密钥权限                                      |
| 策略写入与导入的严格 JSON 及裸 ARN 校验（[SN-2026-005](/zh/about/security-advisories/#sn-2026-005)）     | `20260804+` / `20261112`  | 容忍未知 JSON 字段、尾部多余内容及 `arn:aws:s3:::` 裸命名空间前缀 → IAM 命名策略、服务账号会话策略、STS `Policy`、桶策略及导入／复制全面拒绝未知字段、尾部载荷、空 `Principal: {}`、`NotPrincipal` 与裸 ARN 前缀；磁盘存量策略读取保持兼容                                                                                                                                                                                                     | 修正手写或模板生成的非标策略 JSON（如拼写错误的 `Conditions`、`Principals`）；导入前先在测试环境校验策略包                                                      |
| 内置策略覆盖后的 Reset 恢复                                                                              | `20261026+`               | 对被同名覆盖的内置策略（如 `readonly`、`readwrite`）执行删除后，可能删除记录却未恢复内置定义 → Reset 会移除覆盖层并立即恢复原生内置策略（仍保留在用检查）；普通自定义策略删除逻辑不变                                                                                                                                                                                                                                                          | 若历史集群曾误删内置策略导致缺失，升级后可通过重置或重建恢复                                                                                                    |
| 策略合并保留显式 `Deny` 与残缺加载失败关闭                                                               | `20261018+` / `20261109+` | 多策略合并或部分策略读取失败时可能漏掉某条策略中的 `Deny` → 合并去重严格保留显式 `Deny`，且任一绑定策略读取错误即对依赖该结果的请求按拒绝处理                                                                                                                                                                                                                                                                                                  | 若升级后原本“侥幸放行”的请求变为 `AccessDenied`，检查是否存在此前被忽略的 `Deny` 语句或损坏策略记录                                                             |
| 委托管理接口越权收敛与根派生凭据保护（[SN-2026-017](/zh/about/security-advisories/#sn-2026-017)）        | `20261018+`               | 受限会话策略或带 `Deny` 的管理员凭据仍可能创建更宽权限的子凭据或操作根用户派生账号 → 实时核查调用者完整有效权限与自身 `Deny`，禁止非 root 管理员读取、修改或删除 root 及其服务账号／STS 派生凭据                                                                                                                                                                                                                                               | 自动化 IAM 管理账号需具备直接覆盖目标权限集的有效授权；涉及 root 服务账号的操作必须使用 root 凭据执行                                                           |
| 持久 IAM 撤销墓碑与按主体精确撤销 STS（[SN-2026-013](/zh/about/security-advisories/#sn-2026-013)）       | `20260916+` / `20261018+` | 删除用户／访问密钥无持久撤销记录（跨站旧节点可能回写复活），禁用单个用户可能顺带清空全局 STS 缓存 → 引入跨站同步的持久 IAM 撤销记录，且禁用或改密仅失效该主体关联的派生凭据                                                                                                                                                                                                                                                                    | 多站点或外部 IAM 部署按 [IAM 升级指南](/zh/operations/replication/iam-upgrade/) 协同升级，避免旧节点回写已删除账号                                              |
| IAM ZIP 导入保留禁用状态且非事务执行（[SN-2026-025](/zh/about/security-advisories/#sn-2026-025)）        | `20261109+` / `20261112`  | 导入可能将原本 `disabled` 的账号恢复为启用，或静默吞掉部分用户组错误 → 导入前先整体校验策略文件，严格保留账号／服务账号／用户组的禁用状态并汇总报错；但整个 ZIP 导入并非原子事务                                                                                                                                                                                                                                                               | 导入前先用 `mcli admin cluster iam export` 备份，并在维护窗口内检查导入返回码与逐项报告                                                                         |
| OIDC 非对称签名要求与 RSA 4096 位上限（[CVE-2026-33322](/zh/about/security-advisories/#cve-2026-33322)） | `20260321+` / `20261018+` | 允许使用 `client_secret` 对称 HMAC（`HS256/384/512`）验签 ID Token，且未限制超大 RSA JWK → 仅接受通过 JWKS 发布的非对称签名令牌，且拒绝超过 4096 位的 RSA 公钥                                                                                                                                                                                                                                                                                 | 将 IdP 切换为 RS256 / ES256 等非对称签名（RSA 密钥 ≤ 4096 位），并在升级前验证单点登录                                                                          |
| LDAP STS 统一错误、限流与超长 DN 登录（[CVE-2026-33419](/zh/about/security-advisories/#cve-2026-33419)） | `20260417+` / `20261026+` | LDAP STS 报错文本可区分“用户不存在”与“密码错误”，且超 255 字节归一化 DN 会阻断组登录 → 认证失败统一返回 `InvalidParameterValue`，按来源实施限流（超限返回 `429 ThrottlingException` 与 `Retry-After: 6`），并允许超长 DN 用户跳过不存在的可选本地记录完成组登录                                                                                                                                                                                | 客户端遇到 `429` 按 `Retry-After` 退避；反向代理部署需配置 `MINIO_IDENTITY_LDAP_STS_TRUSTED_PROXIES` 防止所有请求共享同一限流桶                                 |
| 来源 IP 代理信任边界（[SN-2026-018](/zh/about/security-advisories/#sn-2026-018)）                        | `20260804+`               | 无条件采信客户端发来的 `X-Forwarded-For` / `X-Real-IP` / `Forwarded` 参与 `aws:SourceIp` 判定 → 提供 `MINIO_API_TRUSTED_PROXIES`（`none` 或可信代理 IP/CIDR 列表）；未设置时虽保留旧兼容行为，但直连暴露时可被伪造来源 IP                                                                                                                                                                                                                      | 直连部署设为 `MINIO_API_TRUSTED_PROXIES=none`；经反向代理或集群对端转发时，填入精确代理与全部集群节点网段                                                       |
| 外部授权插件响应限制与布尔判定                                                                           | `20261109+`               | 外部 Access Plugin 响应体无严格体积／耗时边界 → 响应上限收紧为 `1 MiB`、超时 `1 分钟`，且仅当返回明确布尔允许结果时才放行                                                                                                                                                                                                                                                                                                                      | 确保自定义外部授权服务在 1 分钟内返回精简、规范的布尔授权 JSON                                                                                                  |
{.wide .expand}

## 3. 请求签名与 S3 对象级授权 {#object-authorization}

| 场景                                                                                                                                                                                    | 引入版本                 | 旧行为 → SILO 当前行为                                                                                                                                                                                                                                                                                                                                                                                                                | 影响与处理建议                                                                                                                                       |
| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------- |
| SigV4 `X-Amz-*` 头签名覆盖与范围日期校验（[SN-2026-011](/zh/about/security-advisories/#sn-2026-011)）                                                                                   | `20260916+` / `20261112` | 部分未列入 `SignedHeaders` 的 `X-Amz-*` 头或 `Credential` 日期与请求时间戳不一致的签名可能被放行 → 所有发送的 `X-Amz-*` 头（及复制内部 `X-Minio-Replication-*` 头）必须纳入 `SignedHeaders`，且签名范围日期必须与请求 UTC 日期一致                                                                                                                                                                                                    | 标准 AWS SDK 与 `mcli` 均已符合；自研手写 SigV4 客户端或签名网关若在签发后追加 `X-Amz-*` 头，需改为签名前一并纳入                                    |
| 仅签头部的预签名上传校验 SHA-256（[SN-2026-012](/zh/about/security-advisories/#sn-2026-012)）                                                                                           | `20260916+`              | 带固定 `X-Amz-Content-Sha256` 载荷哈希的预签名上传未完整校验实际字节流 → 服务端强制核对实际上传内容的 SHA-256 与签名承诺值一致                                                                                                                                                                                                                                                                                                        | 若预签名 URL 供浏览器上传任意内容，签发时应使用 `UNSIGNED-PAYLOAD`，或传入与实际请求体完全匹配的 SHA-256                                             |
| `STREAMING-UNSIGNED-PAYLOAD-TRAILER` 预签名拒绝与重放窗口（[CVE-2026-41145](/zh/about/security-advisories/#cve-2026-41145)、[SN-2026-023](/zh/about/security-advisories/#sn-2026-023)） | `20260804+` / `20261112` | 查询串预签名可搭配无签名流式 trailer，且头部签名流式无签名 trailer 缺少时间窗与未签头检查 → 预签名查询串一律拒绝该模式（`SignatureVersionNotSupported`）；已认证请求强制 15 分钟时钟偏差窗口与未签名头覆盖检查（桶策略放行的纯匿名上传仍可用）                                                                                                                                                                                        | 预签名上传改用普通单次 `PUT` 或标准签名的 `aws-chunked` 流式上传；确保上传客户端主机时钟同步                                                         |
| Snowball 归档上传先鉴权后解包（[CVE-2026-40344](/zh/about/security-advisories/#cve-2026-40344)）                                                                                        | `20260804+`              | `PutObjectExtract` 可能在完成权限校验前先解析 tar 流 → 先完成认证与桶／前缀写权限检查，未授权请求直接返回 `403`                                                                                                                                                                                                                                                                                                                       | 仅阻断未授权请求，正常授权的批量归档提取不受影响                                                                                                     |
| 策略条件键防请求头／查询串遮蔽（[SN-2026-003](/zh/about/security-advisories/#sn-2026-003)）                                                                                             | `20260804+`              | 客户端可通过原始请求头或查询参数伪造 `s3:VersionId`、`s3:ExistingObjectTag/<key>`、`s3:RequestObjectTag/<key>`、`s3:signatureAge` 条件输入 → 条件键严格取自服务端解析并核实的真实版本、落盘标签与签名时间                                                                                                                                                                                                                             | 消除绕过风险；若测试脚本曾靠伪造请求头模拟策略条件，需改用真实带标签对象或版本测试                                                                   |
| 显式指定版本的永久删除要求 `s3:DeleteObjectVersion`（[SN-2026-010](/zh/about/security-advisories/#sn-2026-010)）                                                                        | `20260903+`              | `DeleteObject?versionId=...` 与带 `VersionId` 的 `DeleteObjects` 仅凭 `s3:DeleteObject` 即可永久删历史版本 → 显式删版本必须具备 `s3:DeleteObjectVersion`（批量删除逐条独立鉴权）                                                                                                                                                                                                                                                      | 需要清历史版本的角色需补充 `s3:DeleteObjectVersion`；使用 `Allow s3:*` + `Deny s3:DeleteObject` 防删的策略必须同步加上 `Deny s3:DeleteObjectVersion` |
| `GET`/`HEAD`（含双活代理）过滤标签与对象锁响应头（[SN-2026-022](/zh/about/security-advisories/#sn-2026-022)）                                                                           | `20261112`               | 仅有 `s3:GetObject` 即可在响应头看到 `x-amz-tagging-count`、`X-Amz-Tagging`（`ACCESS`）或对端透传的 `X-Amz-Object-Lock-*` → 仅当调用者具备对应标签读取权限（`s3:GetObjectTagging` / `s3:GetObjectVersionTagging` 且无显式 `Deny`）或对象锁读取权限（`s3:GetObjectRetention` / `s3:GetObjectLegalHold`）时才返回这些响应头                                                                                                             | 对象正文与基础元数据读取不受影响；依赖响应头读取标签计数或锁状态的应用需补授相应只读权限                                                             |
| 带 `versionId` 的读取、标签与 `GetObjectAttributes` 鉴权（[SN-2026-024](/zh/about/security-advisories/#sn-2026-024)）                                                                   | `20261112`               | 版本化读取／标签操作可能忽略显式版本级 `Deny` 或未绑定目标版本的真实落盘标签；`GetObjectAttributes` 权限与零字节 SSE-C 校验不完整 → `GET` 与标签接口在存在 `s3:GetObjectVersion*` 显式 `Deny` 时优先拒绝（无显式版本 `Deny` 时保留基础动作兼容放行）；`GetObjectAttributes` 同时核查 Attributes 与 GetObject（带 `versionId` 时直接检查 `s3:GetObjectVersionAttributes` 与 `s3:GetObjectVersion`）并校验真实版本标签与 SSE-C 客户密钥 | 调用带 `versionId` 的 `GetObjectAttributes` 时，确保策略同时授予 `s3:GetObjectVersionAttributes` 与 `s3:GetObjectVersion`                            |
| 标签条件鉴权遇到读仲裁不足时保留 `5xx`（[#294](https://github.com/pgsty/silo/pull/294)）                                                                                                | `20261112`               | 策略含 `s3:ExistingObjectTag/*` 时，底层磁盘故障导致元数据读仲裁失败可能被当作空标签求值并误判为 `403 AccessDenied` → 存储层非 `ObjectNotFound` 错误原样返回 `5xx`（如 `503 SlowDown`）                                                                                                                                                                                                                                               | 客户端重试逻辑可正常对 `503` 退避重试，不再被假性 `403` 误导中断                                                                                     |
| `ListObjectsV2` / `ListObjectVersions`（`metadata=true`）与双活标签代理                                                                                                                 | `20261112`               | 元数据列表与双活复制标签代理对逐版本／对端副本的标签核查不一致 → 普通元数据列表检查当前对象权限，`ListObjectVersions(metadata=true)` 逐版本检查；标签代理（`GET`/`PUT`/`DELETE`）对所有现存副本逐一鉴权，遇到不可读副本立即失败关闭（仅复制延迟尚未落盘的副本可跳过）                                                                                                                                                                 | 双活站点需确保两端 IAM 策略已同步一致                                                                                                                |
| `CopyObject`、`SelectObjectContent` 与 ZIP 压缩包成员视图（[SN-2026-024](/zh/about/security-advisories/#sn-2026-024)）                                                                  | `20261112`               | 复制／Select 可能未按源版本真实标签鉴权；`CopyObject` 在 `COPY` 模式下目标标签条件可能用错输入；打开 ZIP 内文件可能绕过外层标签条件并在盘上静默写回索引 → 源端统一按真实落盘标签鉴权，`COPY` 模式按实际复制过去的标签评估目标请求标签条件；ZIP 成员 `GET`/`HEAD`/列表均校验外层 ZIP 真实标签（列表还需桶 `s3:ListBucket`），且仅在内存中构建临时索引、不再改写原对象                                                                  | 只读账号现在可安全浏览授权的 ZIP 对象成员而无需写权限；若需持久化索引，可在上传 ZIP 时显式带 `x-minio-extract: true`                                 |
{.wide .expand}

## 4. S3 对象读写、加密、校验和与 S3 Select {#objects}

| 场景                                                                                               | 引入版本                  | 旧行为 → SILO 当前行为                                                                                                                                                                                                       | 影响与处理建议                                                                            |
| :------------------------------------------------------------------------------------------------- | :------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------- |
| 损坏或被篡改对象的 `Range` 读取状态码                                                              | `20260804+` / `20261018+` | 首字节写出前发生位腐烂或解密失败时，个别路径可能仍先回 `200`/`206` 再断流 → 响应头提交前检测到解密／校验失败统一返回 `500` 错误响应                                                                                          | 客户端无需再把截断的 `206` 当成成功部分内容缓存，应按 `5xx` 告警并执行 `mcli admin heal`  |
| 压缩且服务端加密（SSE-S3 / SSE-KMS / SSE-C）对象的索引 `Range` 读取                                | `20261112`                | 目标压缩分块起点落在首个 `64 KiB` 加密帧内部（`decryptSkip > 0`）时，索引 `Range` 读取可能解压失败或返回错误字节 → 精确定位并跳过帧内前缀字节，无需重写存量对象即可正常分段读取                                              | 存量压缩加密对象升级后直接恢复正常 `Range` 读取                                           |
| 新写入的 SSE-C 对象与加密分片大小展示                                                              | `20260903+` / `20261018+` | SSE-C 与服务端透明压缩组合存在元数据及副本边界隐患，加密分片大小偶发按密文长度计算 → 新 SSE-C 上传默认不再启用服务端压缩（历史已压缩 SSE-C 对象继续可读）；`HeadObject`/`GetObjectAttributes` 准确返回逻辑明文大小与分片信息 | 开启默认压缩桶中的新 SSE-C 对象占盘体积接近原始大小；如需压缩请客户端先压缩再加密上传     |
| SSE-C 原地密钥轮换与零字节校验（[SN-2026-006](/zh/about/security-advisories/#sn-2026-006)）        | `20260903+`               | 零字节 SSE-C 读取不验密钥，原地 `CopyObject` 轮换密钥或带校验和复制可能写成不可读密文或报源密钥校验和 → 零字节 SSE-C 同样验证客户密钥；原地轮换正确重加密并按目标密钥输出校验和                                              | 若客户端曾不带 SSE-C 头探测零字节加密对象，需补齐正确的 SSE-C 请求头                      |
| `X-Amz-Server-Side-Encryption-Context` 严格输入校验                                                | `20261112`                | `PutObject`、`CopyObject`、`CreateMultipartUpload` 或表单 `POST` 传入空串、非法 Base64/UTF-8/JSON 或非字符串成员值时可能触发 `500 InternalError` → 统一拒绝并返回 `400 InvalidArgument`                                      | 检查传入自定义 KMS 加密上下文的客户端，确保其为合法 Base64 编码的扁平字符串键值 JSON 对象 |
| S3 Select 单条记录 `1 MiB` 上限（[CVE-2026-39414](/zh/about/security-advisories/#cve-2026-39414)） | `20260618+`               | CSV / JSON Lines 超大单行记录可触发无界内存增长或 SIMD 越界 → 单条记录上限固定为 `1 MiB`（与 AWS S3 Select 一致），超限返回 `OverMaxRecordSize`                                                                              | 单行超过 `1 MiB` 的大文档无法通过 S3 Select 扫描，请改用客户端流式 `GET` 或分块存储       |
| 流式上传尾部头大小与负数长度防护                                                                   | `20261112`                | 负数 `X-Amz-Decoded-Content-Length` 或超大／截断的 `aws-chunked` trailer 错误归类不一致 → 明确拒绝负数解码长度以及截断或超过 `64 KiB` 的流式 trailer                                                                         | 仅拦截畸形流式请求，合规 SDK 不受影响                                                     |
| 跨池历史版本自复制与联邦 `CopyObject`（[#343](https://github.com/pgsty/silo/issues/343)）          | `20260916+` / `20261112`  | 源版本位于旧池而新版本写入另一存储池时，自复制（含加密、多块 S2 压缩索引）或跨集群联邦复制可能损坏逻辑长度／索引 → 正确保留逻辑字节流、加密重封装、校验和与多块 S2 寻址索引                                                  | 扩容新存储池后对历史版本执行原地元数据更新或自复制无需额外绕行                            |
{.wide .expand}

## 5. 分片上传、条件请求与批量删除 {#multipart}

| 场景                                                                                  | 引入版本                  | 旧行为 → SILO 当前行为                                                                                                                                                                                                          | 影响与处理建议                                                                                                          |
| :------------------------------------------------------------------------------------ | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------- |
| 分片序号顺序、重复分片与校验和组合校验                                                | `20260804+` / `20260903+` | `CompleteMultipartUpload` 可能放行重复或乱序的 `PartNumber` → 严格要求分片号递增且不重复（否则返回 `InvalidPartOrder`），拒绝 `CRC64NVME + COMPOSITE` 非法组合，并在响应中返回 `ChecksumType` 与准确的 `FULL_OBJECT` 校验和     | 修正提交未排序或重复分片列表的自研分片客户端；解析器需容忍完成响应中的 `ChecksumType` 字段                              |
| 分片身份隔离、`Abort` 与过期残片清理                                                  | `20261018+` / `20261109+` | 并发重传、放弃上传或后台清理过期未完成分片时可能出现锁顺序死锁或时间判断偏差 → 统一锁获取顺序并修正分片目录时间戳与归属校验                                                                                                     | 消除高并发分片场景卡死问题，无需业务侧改动                                                                              |
| `ListMultipartUploads` 实验性 `strict` 模式退役                                       | `20261018+`               | 仅 `20260916` 曾提供可选 `strict` 持久分片列表模式（单页上限 1,000） → `20261018` 起退役该模式，设置开关仅输出告警并继续使用默认的缓存／精确键查询                                                                              | 曾依赖 `20260916` `strict` 模式的部署需移除对该开关及跨重启持久分片枚举的假设                                           |
| 多池条件写入（`PUT`、`CreateMultipartUpload`、`CompleteMultipartUpload`）             | `20260916+` / `20261109+` | 多存储池下 `If-None-Match` / `If-Match` 可能只看局部池状态；元数据池不可读时可能误判“对象不存在”而放行覆盖 → 跨全部存储池核实权威版本；任一池元数据因故障不可读时返回 `503` 而非误覆盖                                          | 多池集群出现磁盘／节点故障时，条件写可能返回 `503`（即便普通 `GET` 仍命中健康池），客户端应按 `503` 退避重试            |
| 单对象条件删除 `DeleteObject`（`If-Match`）                                           | `20260916+`               | `DeleteObject` 忽略 `If-Match` 请求头 → 单对象 `DeleteObject`（含指定 `versionId`）正式校验 `If-Match` ETag，不匹配时拒绝删除；批量 `DeleteObjects` 仍不校验逐项 `<ETag>`                                                       | 切勿再向 `DeleteObject` 随手附带过期或错误的 `If-Match` 值                                                              |
| 单池批量删除路径越界防护（[SN-2026-020](/zh/about/security-advisories/#sn-2026-020)） | `20261112`                | 单池 `DeleteObjects` 对包含 `..` 路径段的畸形对象键缺少统一词法边界拦截 → 拒绝含路径穿越段的键并返回错误，不再拼入底层存储路径                                                                                                  | 仅拦截含 `..` 的非法键请求                                                                                              |
| `DeleteObjects` 显式版本删除与锁定 `null` 版本的顺序执行                              | `20261109+` / `20261112`  | 批量删除走并行快速通道，跨池或暂停桶场景可能绕过锁核查 → `20261109` 在对象锁桶对删版本走单对象顺序路径；**`20261112` 起所有桶中只要条目显式带 `VersionId`，以及可能触及已锁定 `null` 版本的不带版本删除，一律顺序走单对象路径** | 一次性批量永久删除成百上千个历史版本时耗时明显长于不带 `VersionId` 的普通删除标记批量写入，建议调大客户端超时或拆小批次 |
{.wide .expand}

## 6. Object Lock 与跨集群复制 {#replication}

| 场景                                                                                                                                                              | 引入版本                 | 旧行为 → SILO 当前行为                                                                                                                                                                                                                                         | 影响与处理建议                                                                                             |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------- |
| 复制专用头鉴权与伪造剥离（[CVE-2026-34204](/zh/about/security-advisories/#cve-2026-34204)、[SN-2026-008](/zh/about/security-advisories/#sn-2026-008)）            | `20260417+` / `20261112` | 普通写请求若附带 `X-Minio-Source-*` / `X-Minio-Replication-*` 头可能干扰副本状态 → 所有 `X-Minio-Replication-*` 头必须纳入 SigV4 `SignedHeaders` 且调用者具备 `s3:ReplicateObject` / `s3:ReplicateDelete`，否则验签后立即剥离                                  | 普通应用切勿自行构造 `X-Minio-Source-*` 或 `X-Minio-Replication-*` 私有头                                  |
| `PutObjectRetention` 治理绕过与基础权限双重校验（[SN-2026-015](/zh/about/security-advisories/#sn-2026-015)）                                                      | `20261018+`              | 缩短保留期或切换锁模式在部分边界上未同时核实基础保留期写权限与 `s3:BypassGovernanceRetention` → 严格同时要求 `s3:PutObjectRetention` 与适用的治理绕过权限，并在写锁内复核目标状态                                                                              | 为需要缩短 `GOVERNANCE` 保留期的管理角色同时授予 `s3:PutObjectRetention` 与 `s3:BypassGovernanceRetention` |
| 暂停版本控制桶与前缀排除桶中已锁定 `null` 版本保护（[SN-2026-016](/zh/about/security-advisories/#sn-2026-016)、[#336](https://github.com/pgsty/silo/issues/336)） | `20261018+` / `20261112` | 桶暂停版本控制或排除版本前缀后，普通覆盖写、不带版本的 `DELETE` 或复制写入可能覆盖或遮蔽仍在锁定期内的 `null` 版本 → 单池与多池统一在变更锁下拦截对受保护 `null` 版本的普通覆盖、删除标记与永久删除                                                            | 若桶内留有未到期保留期或 Legal Hold 的 `null` 版本，在锁释放前无法用同名新对象直接覆盖                     |
| `x-minio-force-delete` 遇到桶锁配置读取错误时失败关闭                                                                                                             | `20261112`               | 底层故障导致桶 Object Lock 配置读取失败时，`x-minio-force-delete` 可能跳过锁检查继续强删 → 桶锁元数据读取失败时直接拒绝删除并返回错误                                                                                                                          | 修复底层读仲裁后再重试管理强删                                                                             |
| 目标端复制 `DELETE` 强制遵守本地 Object Lock 与 `COMPLIANCE` 底线                                                                                                 | `20261109+` / `20261112` | 源端发来的复制永久删除或较晚时间戳可能缩短／清除目标端尚未到期的锁 → 目标端复制 `DELETE` 核查本地保留期与 Legal Hold，且任何对端时间戳均不能剥离或缩短未过期的 `COMPLIANCE` 保留期                                                                             | 双活或主备复制两端时钟与锁规则应保持一致；被目标端锁拒绝的复制删除会进入重试／失败指标                     |
| 标签、保留期、Legal Hold 与默认桶保留期的独立排序                                                                                                                 | `20260916+` / `20261112` | 标签更新与锁更新共用粗粒度时间戳可能相互覆盖，开启 Legal Hold 时可能漏掉桶默认保留期 → 按字段独立维护更新时间戳并在副本落盘时协调合并；设置 Legal Hold 不再阻断默认桶保留期计算                                                                                | 减少多站点并发打标与加锁时的状态回退；升级无法自动找回旧版已被覆盖的历史状态                               |
| 副本落盘前完整性核验、分片复制与 `resync` 终态                                                                                                                    | `20261026+` / `20261112` | 副本暂存阶段缺少内容哈希／SSE-C／压缩 `ActualSize` 终检，复合 CRC 分片复制缺少 `FULL_OBJECT` 标记 → `renameData` 提交前强制校验内容 SHA-256、SSE-C 状态与 `ActualSize`；转发 `FULL_OBJECT` 校验和类型；修正 `replicate resync` 状态机与排队重试（MRF）指标语义 | 升级源端与目标端至同一版本，并检查 `mcli replicate status` 与 MRF 丢弃计数器                               |
{.wide .expand}

## 7. 多存储池、对象列表、池迁移与自愈 {#pools}

| 场景                                                                                                                      | 引入版本                  | 旧行为 → SILO 当前行为                                                                                                                                                                                                                         | 影响与处理建议                                                                                                                     |
| :------------------------------------------------------------------------------------------------------------------------ | :------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- |
| 多池读取、写入与删除的权威池协同                                                                                          | `20260916+` / `20261026+` | 多存储池下部分视野可能导致读请求误报 `404`、或删除时先删了权威副本留下旧池残影 → 部分池不可读且无法排除更高版本时返回 `503` 而非假 `404`；删除先清理非权威副本再删权威副本，并保护共享远程分层引用                                             | 应用与备份工具需把 `503` 视为临时可重试错误，切勿把列表／读取报错当成“桶已清空”                                                    |
| 跨异构纠删比存储池的 `LIST` 与残缺条目恢复                                                                                | `20261018+`               | 不同池采用不同纠删条带布局时，`LIST` 恢复不确定条目可能漏项或把错误静默吞成空列表 → 逐页确认不确定条目，无法确认时显式报错（不承诺跨页全局快照）                                                                                               | 同步与清点脚本必须逐页检查返回错误，严禁将列表报错当作空目录执行下游镜像删除                                                       |
| 写入提交（`renameData`）失败后的目录清理                                                                                  | `20261109+`               | `renameData` 失败回滚时若盲目递归删目录可能误伤同键并发版本，完全不删又会留下空幽灵目录 → 仅清理确实为空的对象目录，绝不删除兄弟版本数据                                                                                                       | 兼顾并发版本安全与空目录回收                                                                                                       |
| 存储池再平衡（`rebalance`）与并发写／标签保留                                                                             | `20260916+` / `20261112`  | 池迁移／排空期间原地更新副本元数据可能把旧内容搬错池或丢标签／删除标记，`rebalance stop` 状态收敛不及时 → 原地元数据更新保留在原权威池（仅需重算加密／校验和的复制改写活跃池），完整保留标签与删除标记，单桶失败不中断其余桶并准确收敛停止状态 | 执行 `rebalance` 期间仍建议避开大规模桶级重加密或批量删除高峰                                                                      |
| 存储池退役（`decommission`）子键重扫、无进展停止与离线盘容忍（[#334](https://github.com/pgsty/silo/issues/334)）          | `20261112`                | 同一路径同时存在父对象与嵌套子对象（如 `a/b` 与 `a/b/c`）时可能漏迁子键；存在离线盘时判空卡死；无物理进展时可能空转重扫 → 自动重扫隐藏嵌套子键，对无物理进展轮次有界停止并返回取消错误，且在满足纠删集读仲裁前提下容忍离线盘完成源池判空       | 遵循更新后的[存储池退役流程](/zh/operations/deployments/baremetal-decommission-server-pool/)；离线盘数量不得突破该纠删集读仲裁底线 |
| `heal --dry-run` 只读保证                                                                                                 | `20261109+`               | 个别修复路径在 `--dry-run` 下仍可能触发元数据写回 → 严格禁止 `--dry-run` 修改任何盘上对象或元数据                                                                                                                                              | 巡检时可放心使用 `mcli admin heal --dry-run` 评估健康度                                                                            |
| 移除私有内部 StorageREST `/rmpl`（`ReadMultiple`）接口（[CVE-2026-42600](/zh/about/security-advisories/#cve-2026-42600)） | `20260618+`               | 节点间私有存储 RPC 暴露 `ReadMultiple` 批量读端点 → 完全移除该私有端点并对内部存储路径做词法越界与内存上限约束（[SN-2026-002](/zh/about/security-advisories/#sn-2026-002)）                                                                    | 标准 S3 客户端从不调用该接口；但它直接导致旧版 MinIO 节点无法与 SILO 节点组成混合集群                                              |
{.wide .expand}

## 8. 桶配置、CORS 与事件通知 {#bucket-config}

| 场景                                                                                              | 引入版本                               | 旧行为 → SILO 当前行为                                                                                                                                                                                                                                   | 影响与处理建议                                                                                   |
| :------------------------------------------------------------------------------------------------ | :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- |
| 桶级 CORS 配置真正持久化并优先生效                                                                | `20260903+`                            | 上游社区版中桶级 `?cors` 接口形同占位，实际始终回退全局 CORS → `PutBucketCors` / `GetBucketCors` / `DeleteBucketCors` 真实持久化、支持导出恢复与跨站收敛，且配置了桶级规则时覆盖全局 `MINIO_API_CORS_ALLOW_ORIGIN`                                       | 若此前桶上残留过测试用 CORS XML，升级后浏览器跨域行为将按该桶规则执行，请用 `mcli cors get` 核查 |
| 桶配置并发更新串行化、防旧缓存回写与删除墓碑                                                      | `20260903+` / `20260916+` / `20261112` | 并发更新桶策略／生命周期／标签易互相覆盖，`GetConfig` 偶发用旧缓存覆盖新配置，多站点删桶配置易被对端旧副本复活 → 统一通过 `metadata.lock` 串行化并防护旧缓存覆盖；多站点配置删除墓碑可通过 `MINIO_SITE_REPLICATION_METADATA_TOMBSTONES` 在全站升齐后启用 | 多站点部署先将所有站点升至新版，再按需一致开启配置墓碑开关                                       |
| PostgreSQL / MySQL 事件通知强制要求连接串                                                         | `20260903+`                            | 允许使用零散的旧主机／端口／用户名字段拼装数据库连接 → 启动时强制要求显式配置 `connection_string`（PostgreSQL）或 `dsn_string`（MySQL），否则拒绝启用对应通知目标                                                                                        | 升级前将分散的数据库通知环境变量或配置键合并为标准连接串                                         |
| NATS / AMQP 配置键识别与报错凭据脱敏（[SN-2026-019](/zh/about/security-advisories/#sn-2026-019)） | `20260804+` / `20260916+`              | 部分 NATS / AMQP 有效配置键未被注册识别，或连接串校验失败时把明文密码打入错误信息 → 补齐合法键注册，并对通知校验错误与调试输出中的内嵌密码脱敏                                                                                                           | 若日志采集脚本曾解析原始报错中的完整连接串文本，需适配脱敏格式                                   |
{.wide .expand}

## 9. 生命周期（ILM）、远程分层与归档恢复 {#lifecycle}

| 场景                                                                                                                                                              | 引入版本                  | 旧行为 → SILO 当前行为                                                                                                                                                                                                                                      | 影响与处理建议                                                                                                     |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
| 单独配置 `ExpiredObjectDeleteMarker` 与整键全版本清理边界                                                                                                         | `20261026+` / `20261109+` | 版本过期与整键清理在跨池、远程分层或锁边界上可能误删共享分层数据或留下孤儿数据 → 仅写删除标记的过期保留前序版本的远程分层对象；精确整键全版本清理先复核所有版本，遇到任一版本处于锁定期、远程分层或恢复期时拒绝整键清除；对单独配置删除标记过期规则激活修复 | 核查现有 ILM 规则：确认 `DelMarkerExpiration` 与全版本清除规则仅作用于预期前缀，已锁或已分层版本不会被静默整键抹除 |
| 远程分层内部 `FreeVersion` 条目隐藏                                                                                                                               | `20261026+`               | 生命周期释放远程分层数据所产生的内部 `FreeVersion` 记录偶发暴露在用户侧列表或统计中 → 对普通用户列表隐藏内部释放记录                                                                                                                                        | 用户侧 `ListObjectVersions` 输出更干净，不再看到内部过渡条目                                                       |
| 两阶段无锁原生归档恢复（`POST ?restore`）与全节点门禁                                                                                                             | `20261109+`               | 恢复下载远程冷存储对象期间长时间持有对象锁，或并发重复提交恢复行为不明确 → 改为无锁两阶段下载提交，进行中重复请求返回 `409 RestoreAlreadyInProgress`，修正恢复副本到期时间精度；**集群内任一 peer 未升级或不可达时，`POST ?restore` 返回 `503`**            | 必须在全集群所有节点升齐且健康连通后再放开 `POST ?restore` 业务请求；客户端对 `409` 视为“已在恢复中”即可           |
| `2024-04-28` 前历史 `xl.meta` 头与 `UsesDataDir` 修订号归一化（[#332](https://github.com/pgsty/silo/pull/332)、[#344](https://github.com/pgsty/silo/issues/344)） | `20261112`                | 早期版本写入后经部分自愈或恢复副本过期的老对象，因头部编码版本或时间相关的 `xlFlagUsesDataDir` 标志位差异导致不同盘计算的修订号不一致，进而分裂读仲裁 → 统一归一化历史 `xl.meta` 头并清除 `xlFlagUsesDataDir` 对修订号的影响                                | 修复升级存量老集群后周期性出现的历史冷数据读仲裁分裂问题，无需重写存量数据                                         |
{.wide .expand}

## 10. Batch 后台作业（`expire`、`replicate`、`keyrotate`） {#batch}

| 场景                                                         | 引入版本                 | 旧行为 → SILO 当前行为                                                                                                                                                                                                                                                                                   | 影响与处理建议                                                                                                                 |
| :----------------------------------------------------------- | :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |
| 作业绑定提交者实时权限与运行中重验                           | `20261109+`              | Batch 作业提交后以内部宽泛身份在后台持续执行，提交者被禁用或撤权后作业仍继续运行 → 作业持久绑定提交者身份，启动与执行期间实时重验提交者凭据状态与有效策略；后台无请求上下文无法满足的条件按受限处理，外部授权插件临时不可达时暂停重试                                                                    | 提交长期 Batch 作业请使用专用的持久管理服务账号（不要用短时过期 STS 令牌），并确保该账号持续拥有作业所需的完整 S3 / Admin 权限 |
| `SILO-BATCH` v2 清单与报告版本门禁                           | `20261109+`              | 旧版无版本标识或 v1 清单缺少提交者绑定元数据 → 新作业写入 `SILO-BATCH` v2 清单与报告；旧版未完成作业不保证跨版本自动续跑，且 `20261026` 及更早版本拒绝加载 v2 记录                                                                                                                                       | **升级前停止提交新 Batch 作业，排空或取消所有运行中／排队／暂停作业**；全部节点升至 `20261112` 后再重新提交                    |
| 逐版本对象锁核查、连续进度与 `complete-with-skips`           | `20261109+`              | 个别版本因锁或权限跳过时进度位点可能越过未完成项，或把含跳过的作业标成完全成功 → 逐版本校验锁与权限，仅推进连续已完成进度，存在跳过项时以明确的 `complete-with-skips` 状态与计数结项；`replicate` 恢复时执行完整重扫避免漏项                                                                             | 巡检脚本除检查作业结束外，还应检查 `complete-with-skips` 及跳过／失败计数器                                                    |
| `keyrotate` 保留 KMS 上下文、池／标签／过期时间并重写 `XLV1` | `20261109+` / `20261112` | 批量密钥轮换可能丢失配置的 KMS Encryption Context、改动对象所在存储池／标签／`Expires`，或无法安全处理远古 `XLV1` 对象 → 执行、重试与重载全程保留 KMS Context（换密钥前先校验合法 UTF-8），保留原池、版本、标签、内部多片／分层头与过期时间，并将历史 `XLV1` 对象流式重写为带密封明文 MD5 ETag 的 `XLV2` | 使用 `keyrotate` 前参考更新后的[批量密钥轮换文档](/zh/administration/batch-framework-job-keyrotate/)核对 YAML 配置             |
{.wide .expand}

## 11. HTTP 超时、监控、健康检查与 `mcli` 客户端 {#operations}

| 场景                                                      | 引入版本                  | 旧行为 → SILO 当前行为                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 影响与处理建议                                                                                                                                                                                                                               |
| :-------------------------------------------------------- | :------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| HTTP/1 请求头绝对读取截止时间                             | `20260916+`               | 慢速逐字节发送请求头可能不断顺延超时占用连接 → 请求头读取采用绝对截止时间；请求体传输仍保持原有的滚动空闲超时，大对象正常慢速流式上传不受影响                                                                                                                                                                                                                                                                                                                                                                                                   | 仅阻断 Slowloris 类慢速请求头连接占用；检查前置代理是否在建立后端连接后长期挂起不发头                                                                                                                                                        |
| Webhook / Kafka 审计与通知日志热加载及坏 `queue_dir` 防护 | `20261109+`               | 动态修改审计／日志 Webhook 或配置了不可写的 `queue_dir` 时，对端节点不同步或可能触发进程崩溃 → 配置变更在对端同步热生效，非法 `queue_dir` 返回配置错误而非 panic，AMQP 单帧大小亦增加安全上限                                                                                                                                                                                                                                                                                                                                                   | 在线变更日志目标后仍建议通过 `mcli admin info` 确认全部节点状态一致                                                                                                                                                                          |
| Prometheus 指标修正与新增诊断项                           | `20260903+` / `20260916+` | 桶配额指标、CPU 并发采集、MRF 复制丢弃计数与 IAM 撤销状态缺失或语义偏差 → 保留 `minio_*` 指标命名空间，修正有效桶配额数值与 CPU 并发保护，新增 MRF 队列项计数与 IAM 撤销同步指标；内嵌 Console 仪表盘切换至 Metrics V3                                                                                                                                                                                                                                                                                                                          | 复核自定义 Grafana 面板与告警阈值（注意 MRF 计数统计的是队列条目而非唯一丢失对象数）                                                                                                                                                         |
| `silo healthcheck` 与 S3 数据面就绪边界                   | `20260903+` / `20261109+` | 容器无内置探针子命令（或仅看端口连通） → 提供原生 `silo healthcheck ready` / `live` / `cluster`；但健康端点通过不替代真实签名 S3 读写验证                                                                                                                                                                                                                                                                                                                                                                                                       | 容器编排可使用 `silo healthcheck ready` 做探针；升级放行前仍须对每个节点跑一次有界签名 S3 写读校验                                                                                                                                           |
| `mcli` 配置目录、退出码、搬移保护与空策略重置             | `20260806+`–`20261112`    | 上游 `mc` 默认读 `~/.mc`，部分批量／镜像／权限失败仍返回退出码 `0`，同 IP 别名自搬移可能误删源，访问密钥编辑无法显式发 `{}` 恢复继承 → 以 `mcli` 调用时默认使用 `~/.mcli`（容器镜像保持 `/root/.mc` 且预建 `1777` `/.mc` 供非 root 使用）；`cp`/`mv`/`mirror`/`rm`/导入出现逐项失败时返回非 `0` 退出码；`mv` 拒绝同协议＋端口＋IP 的疑似自搬移；`mcli 20261112` 支持 `--policy '{}'` 显式重置访问密钥内联策略并启用严格策略 JSON 校验；新增只读 [`mcli checksum verify`](/zh/reference/minio-mc/mc-checksum-verify/#command-mc.checksum.verify) | 首次在宿主机改用 `mcli` 时执行 `cp -a ~/.mc ~/.mcli` 或显式固定 `MC_CONFIG_DIR`；检查自动化脚本对非 `0` 退出码与 JSON 流式进度字段 `totalCount`/`totalSize`（动态累计值而非最终分母）的处理，详见 [mcli 兼容性说明](/zh/compatibility/mcli/) |
{.wide .expand}

## 12. 内嵌与独立 Web Console {#console}

| 场景                                                                                            | 引入版本              | 旧行为 → SILO 当前行为                                                                                                                                                                                                                                                                                                                                                                | 影响与处理建议                                                                                                                 |
| :---------------------------------------------------------------------------------------------- | :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------- |
| 保留完整 Web 管理台（相对于上游精简版）                                                         | `v2.0.0+`             | 上游将社区版 Console 缩减为纯对象浏览器 → SILO 完整保留仪表盘、桶、对象、生命周期、复制、通知、分层、IAM 用户／组／服务账号／策略、IdP、KMS 与集群配置管理                                                                                                                                                                                                                            | 无需额外部署第三方管理界面；普通 S3 API 不受影响                                                                               |
| 对象浏览器改为游标分页与当前页作用域                                                            | `v2.4.0+`             | 一次性拉取大量对象并在前端全量排序／全选 → 默认每页 100 条（可选 50–1,000），提供首页／上一页／下一页游标翻页；**排序、名称过滤与全选仅作用于当前页**；回溯与已删版本视图最多展示 1,000 条并提示截断                                                                                                                                                                                  | 目录超过单页大小时，大批量操作请改用 `mcli` 命令行而非网页“全选删除”                                                           |
| 服务账号内联策略三态编辑器与校验（[SN-2026-025](/zh/about/security-advisories/#sn-2026-025)）   | `v2.7.1` / `v2.7.2`   | 编辑访问密钥描述或过期时间时可能把继承的母账号策略固化为内联副本，或接受空策略变体 → 区分“继承母账号策略”与“内联限制策略”；仅修改元数据保持继承不变；关闭 **Restrict beyond user policy** 发送空策略恢复继承（需配合 `Server 20261112`）；开启限制时阻止保存 `{}` / 空 `Statement` 并在弹窗内直接展示错误                                                                             | 独立部署 Console 的用户请将 Console 升至 `v2.7.2` 并配合 `Server 20261112` 使用                                                |
| 权限感知界面、显式治理绕过开关与错误保真                                                        | `v2.4.1+`–`v2.7.2`    | 无权限按钮点击后报错模糊、网络抖动易误踢登出、删除或版本暂停错误被吞 → 按会话有效权限展示操作，提供显式 Governance 绕过开关，区分临时网络／后端错误与 `401` 会话过期，保留底层 S3 错误码（如锁阻止暂停版本控制时返回 `InvalidBucketState`）                                                                                                                                           | 排障信息更直观；调用 Console REST API 的脚本可解析新增的 `accountAccessKey` 与 `size: 0` 字段                                  |
| 分享下载代理收紧与原生流式打包下载（[SN-2026-014](/zh/about/security-advisories/#sn-2026-014)） | `v2.4.1+` / `v2.5.1+` | 匿名分享下载代理解析外部 URL 边界较宽 → 严格校验目标归属本集群配置端点；多对象打包下载支持有界原生流式 ZIP，首字节前失败保留真实 S3 错误状态码                                                                                                                                                                                                                                        | 若反向代理改写了对外分享域名，确保正确配置 Console 外部 URL 设置                                                               |
| 实时桶列表、有界文件夹大小统计、`1 MiB` 文本预览与十语种 UI                                     | `v2.5.1+`–`v2.7.2`    | 新建／删桶后刷新偶发读到旧缓存列表；无有界目录统计；仅英中双语 → `account-info` 读取实时桶清单（需 `Server 20261026+`）；新增可取消的文件夹／桶用量扫描（含普通 HTTP 下可用与可选 `usage-worker`）；安全文本预览上限 `1 MiB`；支持含阿拉伯语 RTL 在内的十种界面语言；修复 `--host 0.0.0.0` 下 `CONSOLE_SECURE_TLS_REDIRECT` 跳转至 `0.0.0.0` 的问题、OIDC 数组组声明与 UTF-8 凭据导出 | 若启用了独立 `console usage-worker`，升级前先停齐旧 worker 再启动新版本；详见 [Console 兼容性说明](/zh/compatibility/console/) |
{.wide .expand}

## 13. 已撤回实验特性与不承诺事项 {#limits}

以下特性在研发或单次历史版本中出现过但**已撤回**，或属于升级后**不会自动代劳**的边界：

| 项目                                              | 当前状态与说明                                                                                                                    | 用户侧结论                                                                                        |
| :------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |
| 按访问频率的池间自动冷热分层                      | 分叉后曾短暂实验，在 `20260916` 发布前已彻底移除，从未进入公开正式版（详见[撤回说明](/zh/compatibility/access-tiering-removal/)） | 普通生命周期过期、远程对象存储分层（S3/GCS/Azure/SILO）、`rebalance` 与 `decommission` 均正常保留 |
| `20260916` 可选 `strict` 分片列表模式             | `20261018` 起已退役，保留配置项仅打印告警并忽略                                                                                   | 不要依赖跨进程重启的持久未完成分片枚举                                                            |
| 实验性写代际隔离（`consistency_strict` 编译标签） | 默认发行版未启用；超时或租约失效不等同于底层磁盘 I/O 已立即终止                                                                   | 保持标准纠删仲裁与运维规程，不要假设分布式强隔离栅栏                                              |
| 历史已受损对象或被覆盖策略的自动修复              | 新版修复未来写入、复制、轮换与策略编辑逻辑，但**不会在升级启动时自动猜想或重建历史已丢失的标签、锁、分层数据或 `Deny` 子句**      | 升级后使用 `mcli checksum verify`、`mcli admin heal --dry-run` 与策略审计核查关键存量资产         |
{.wide .expand}

## 14. 切换前核查与回滚准备清单 {#upgrade}

准备将生产 MinIO 或早期 SILO 集群切换到 **SILO `20261112`** 时，按以下 5 步执行：

1. **确认磁盘格式、仲裁健康与拓扑切换方式**：以只读方式检查 `.minio.sys/format.json` 确认为 `xl` 或 `xl-single`，通过 `mcli admin info` 确认所有池与纠删集具备健康读仲裁。从上游 MinIO 迁移，或单池跨 ≥ 18 台主机（不同纠删集跨不同主机集合）从 `≤ 20261026` 升级时，规划**全集群停机切换窗口**；多池 SILO 滚动升级前排空并发 S3 写入。
2. **排空后台作业并留存离线一致恢复点**：停止提交新 Batch 作业，等待运行中／排队／暂停的 Batch 作业完成或主动取消；记录当前镜像 digest／二进制版本、systemd／Compose／Helm 渲染结果，导出 IAM 与桶元数据备份（`mcli admin cluster iam export`、`mcli admin cluster bucket export`），并在停机切流后保留 `.minio.sys` 与配置文件的一致恢复点。
3. **完成配置与策略预审**：将硬编码 `/usr/bin/minio` 改为 `silo`，Helm `--reuse-values` 显式附带 `--set image.tag=RELEASE.2026-11-12T00-00-00Z`；核查自定义策略中的 12 个桶级写动作（裸桶 ARN）、`s3:DeleteObjectVersion`、`admin:ChangeMyPassword`、严格 JSON 语法与服务账号内联策略；确认 OIDC 使用非对称 JWKS（RSA ≤ 4096 位）、PostgreSQL/MySQL 通知已改用连接串、`MINIO_API_TRUSTED_PROXIES` 与外部 TLS 根证书配置无误。
4. **原子切换并逐节点验证真实 S3 数据面**：启动新版本后，除确认 `silo healthcheck ready` 通过外，务必**直连每一个节点**执行一次有界签名 S3 写入、读取、条件请求与历史对象抽检（覆盖加密对象、分片对象、压缩对象 `Range` 读取），再验证 Console 登录、代表性子账号权限、复制队列与事件通知。
5. **在全站升齐后收尾后台任务与策略复核**：确认全部节点与复制对端站点均已稳定运行 `20261112` 后，再重新提交 Batch 作业、恢复归档 `POST ?restore` 请求，并复核多站点服务账号策略是否符合预期。
{.steps}

> [!CAUTION] 关于降级与回滚的硬边界
> **“新版本能直接挂载旧盘”不代表“上线运行一段时间后还能随时换回旧二进制”。** 进程启动、后台扫描、IAM 增删改（持久撤销墓碑与三态内联策略）、`SILO-BATCH` v2 清单写入以及桶配置墓碑都会更新 `.minio.sys` 持久元数据。一旦需要回退到旧版 MinIO 或早期 SILO，必须使用切换前留存的一致备份连同所有参与节点与复制对端同步恢复，切勿仅替换单台节点的容器镜像或二进制。

## 15. 核查范围与延伸参考 {#references}

- **分叉对照起点**：服务端 [`minio/minio@27742d469462`](https://github.com/minio/minio/commit/27742d469462e1561c776f88ca7a1f26816d69e2)（`2025-12-03`），客户端 [`minio/mc@77f82e18b540`](https://github.com/minio/mc/commit/77f82e18b5401a65958f1619df6ebb994634bd88)，控制台 [`silo-console@feff71e48e39`](https://github.com/pgsty/silo-console/commit/feff71e48e39547834399a84a9460edb4fb50563)。
- **当前发布基线（`2026-11-12`）**：[SILO Server 20261112](/zh/blog/release/silo-20261112/)（[`44e848fedf8c`](https://github.com/pgsty/silo/commit/44e848fedf8cec3d8c0da4b1aa8422390a2b7a8b)）、[Console v2.7.2](/zh/blog/release/console-2.7.2/)（[`0e7953ff59c4`](https://github.com/pgsty/silo-console/commit/0e7953ff59c4a1eb77c7d203b265e6783ff18d01)）、[mcli 20261112](/zh/blog/release/mcli-20261112/)（[`a37a9f054fba`](https://github.com/pgsty/mc/commit/a37a9f054fba828a0bbbceb4e9ff247ccf09c28d)）、`silo-pkg v3.16.1`（[`433f7eefa714`](https://github.com/pgsty/silo-pkg/commit/433f7eefa714a30b72ca70c4dffcd5faca25804f)）。
- **配套深入文档**：[三层兼容性总览](/zh/compatibility/) · [组件版本矩阵](/zh/compatibility/versions/) · [迁移操作指南](/zh/compatibility/migration/) · [原生软件包迁移](/zh/compatibility/binary/) · [服务端源码审计台账](/zh/compatibility/server/) · [mcli 兼容性](/zh/compatibility/mcli/) · [Console 兼容性](/zh/compatibility/console/) · [安全公告汇总](/zh/about/security-advisories/)。
