S3 兼容矩阵

imgli 通过 S3 API（path-style 或 virtual-host）访问对象存储。下表记录已验证与待验证状态；欢迎用仓库脚本提交报告。

如何自测

建专用测试桶（关闭匿名 Get/List）。
复制 scripts/imgli-s3-vendors.env.example → 本机密钥文件（勿提交）。
运行：

./scripts/s3-vendor-matrix.sh minio   # 或其它 vendor 名
# 可选更深 e2e：
./scripts/s3-vendor-e2e.sh

用 GitHub Issue 模板「S3 vendor test report」反馈，或 PR 更新矩阵（不含密钥）。

矩阵（摘要）

厂商	状态	备注
MinIO	已验证	本地 / CI 友好；常需 path-style
RustFS	已验证	生产路径之一（运维侧）
Cloudflare R2	未在树内自动化报告	需求高，欢迎贡献
AWS S3	未在树内自动化报告	基线预期
阿里云 OSS（S3 API）	未报告	env 模板有
腾讯云 COS（S3 API）	未报告	桶名常带 APPID
七牛 Kodo（S3 API）	未报告
又拍（S3 API）	未报告	优先 S3 端点
WebDAV	单测覆盖	非 S3，并列说明

完整列（endpoint 风格、Presign 等）以仓库 docs/s3-compatibility.md 为准。

运维提示

桶保持私有；公开 CDN 只卸 public 表面。
MinIO 多需 force path style。
策略里配置 CDN / presign 域。

完整列与脚本以仓库为准（工程 SSOT）：https://github.com/yixian-huang/imgli/blob/main/docs/s3-compatibility.md

相关：存储与 CDN · WebDAV · FTP · 安全

FTP / 传统供应商（双轨）

FTP 不是 first-class 对象存储。 优先供应商 S3 API；仅 FTP 时：OpenList/rclone → WebDAV 或 local/S3，或使用内置 FTP 兼容驱动（限制见 FTP）。仓内 docs/s3-compatibility.md 有 dual track 说明。

最后更新: 2026-08-06