Proxmox Backup Server 4.2 的 S3 后端：配置、兼容性与运维边界

1. 概述

PBS 4.2（2026-04-29 发布）把 S3 兼容对象存储从 4.1 的技术预览转为正式支持。datastore 的数据块、索引与元数据全部存在桶内，本地只保留一份持久缓存。

S3 后端适合异地副本与容量弹性，不适合替代本地高性能 datastore。

2. 工作方式

• endpoint 允许 {{bucket}} 与 {{region}} 模板；桶名属于 datastore 配置，同一端点可复用于多个桶。
• 对象以 datastore 名为前缀，一个桶可以放多个 datastore。
• PBS 不创建桶、不管理访问控制。桶与密钥需预先在对象存储侧建好，密钥需要 get、put、list、delete 权限。
• 只支持 HTTPS；自建端点用自签证书必须提供证书指纹。
• 默认优先 virtual-hosted 地址，path-style 通过开关启用。
• 缓存必须是持久文件系统，不能用纯内存；已有的普通 datastore 不能直接转换为 S3 datastore 的缓存。
• 同一 datastore 同时只能由一个 PBS 实例操作；实例重建需 --reuse-datastore 与 --overwrite-in-use，并沿用原 datastore 名。

3. 配置方法

proxmox-backup-manager s3 endpoint create pbs-s3 \
  --access-key '<AK>' --secret-key '<SK>' \
  --endpoint '{{bucket}}.s3.{{region}}.amazonaws.com' --region eu-central-1

proxmox-backup-manager datastore create pbs-s3-store /mnt/datastore/pbs-s3-cache \
  --backend type=s3,client=pbs-s3,bucket=pbs-backup

自建端点带端口、指纹并使用 path-style：

proxmox-backup-manager s3 endpoint create ceph-rgw \
  --access-key '<AK>' --secret-key '<SK>' --endpoint 172.16.0.200 --port 7480 \
  --fingerprint 'XX:XX:XX:XX' --path-style true

4. 兼容性硬条件

“兼容 S3”只是接口层声明，作为 PBS 后端至少要满足：SigV4 签名；ListObjectsV2（GET /?list-type=2）并正确返回 NextContinuationToken 与 IsTruncated；对象 PUT、GET、HEAD、DELETE；分页语义稳定；错误码与重试语义接近 AWS S3。

其中 ListObjectsV2 是分水岭。PBS 4.2 使用的 proxmox-s3-client 1.4.2 只实现 ListObjectsV2，没有 V1 回退路径。

5. 上线前的验证顺序

1. 用空桶创建 datastore，先备份一个小于 1 GiB 的 guest，确认 PUT 与元数据写入正常。
2. 制造超过 1000 个对象的命名空间，或直接备份包含大量小文件的 guest，观察列举是否分页。只返回第一页的实现会在这一步暴露。
3. 执行 verify 与 prune，再跑一次 GC，确认删除、引用计数与快照列表一致。
4. 观察本地缓存增长到稳定值。缓存盘写满会直接中断备份，应按 64–128 GiB 预留并单独设配额。

6. 典型故障判定

7. 运维注意

• 4.2 为 S3 datastore 增加请求与流量计数：s3-get、s3-put、s3-post、s3-head、s3-delete，以及 s3-upload、s3-download 字节数。阈值按 datastore 配置，超限通知只发送一次，需要重置计数器或配置重置计划才会再次告警。
• 桶写满时快照目录的清理通常也会失败。处理顺序是先在对象存储侧删除该快照的残留对象，再执行 proxmox-backup-manager datastore s3-refresh <store>。
• 成本按存储、请求、流出三项监控。GC 与 verify 是 GET、POST 请求的主要来源。
• 迁移或重建 PBS 实例前，先确认没有任务在运行，并保留一份独立的配置备份。S3 datastore 的元数据在桶内，配置错误会直接导致挂载失败，而不是生成空 datastore。

8. 结论

PBS 4.2 的 S3 后端已经可用，前提是对端是完整的 S3 实现：SigV4、ListObjectsV2、分页令牌与对象读写缺一不可。上线前按第 5 节的顺序验证，可以提前发现列举与容量这两类问题；这类故障在备份阶段往往没有明显报错，等到恢复时才会暴露。