一句话定位RustFS 是面向 AI 时代、从零原生打造的高性能分布式对象存储100% 兼容 S3 APIApache 2.0 协议底层用 Rust 构建可作为 MinIO 的 drop-in 替代方案。目录问题背景加密不是开关选错模式后面全要返工三种模式的核心区别SSE-S3 与 SSE-KMS密钥都进 KMSSSE-C密钥在客户端手里落地前的几条注记总结与下一步1. 问题背景加密不是开关选错模式后面全要返工一次合规审计里最常见的一类返工存储桶早就开了加密但问一句密钥在谁手里、丢了能不能恢复没人答得上来。S3 兼容存储的服务端加密不是一个布尔开关——RustFS 提供 SSE-S3、SSE-KMS、SSE-C 三种模式区别不在加不加密而在谁生成密钥、谁保管密钥、谁能在不出密钥的情况下读到数据。这三种模式对应到哪个配置项、背后要不要先起一套 KMS直接决定你后面能不能过合规审查以及密钥泄露时的影响半径。下面把三者的边界、KMS 后端的接法、以及客户端自持密钥的做法一次列清。所有变量名与命令都对照官方加密文档核对过。2. 三种模式的核心区别一句话区分SSE-S3 与 SSE-KMS 的密钥都由 RustFS 服务端生成并交给 KMS 封装区别只是你能不能指定密钥 IDSSE-C 的密钥从头到尾只在客户端RustFS 不存、也不碰明文密钥。落到写入请求上SSE-S3 / SSE-KMS 是你告诉服务器用哪种模式SSE-C 是你每次请求都带上密钥。这决定了 SSE-C 的对象即使服务器被攻破、KMS 配置泄露没有客户端密钥也解不开——代价是密钥管理完全是你自己的事。3. SSE-S3 与 SSE-KMS密钥都进 KMS两种模式共用同一套 KMS 后端。先用官方 CLI下文统称rc把桶默认加密设成 SSE-S3rc bucket encryptionsetrustfs/my-bucket--modesse-s3 rc bucket encryption info rustfs/my-bucket# 应回显 SSE-S3rc object copy /path/to/hello.txt rustfs/my-bucket/hello.txt单个对象想覆盖桶默认加--enc-s3 目标。SSE-KMS 只是在此基础上允许指定密钥 IDrc bucket encryptionsetrustfs/my-bucket--modesse-kms --key-id rustfs-default-key rc object copy /path/to/hello.txt rustfs/my-bucket/hello.txt\--enc-kms rustfs/my-bucket/hello.txtrustfs-default-key前的选择器要和rc object copy的目标完全一致否则匹配不上。后端怎么接取决于RUSTFS_KMS_BACKEND默认locallocal后端最简单密钥文件落在指定目录、只授权属主sudoinstall-d-m0700-orustfs-grustfs /var/lib/rustfs/kms然后在环境文件如/etc/default/rustfs里写RUSTFS_KMS_ENABLEtrueRUSTFS_KMS_BACKENDlocalRUSTFS_KMS_KEY_DIR/var/lib/rustfs/kmsRUSTFS_KMS_LOCAL_MASTER_KEYyour-kms-master-key生产用 Vault 时KV2 与 Transit 两条路线把密钥材料交给 HashiCorp Vault 集中管理配置换成RUSTFS_KMS_VAULT_ADDRESS、RUSTFS_KMS_VAULT_TOKEN、RUSTFS_KMS_VAULT_MOUNT_PATHRUSTFS_KMS_ENABLEtrueRUSTFS_KMS_BACKENDvault-kv2RUSTFS_KMS_VAULT_ADDRESShttps://vault.example.com:8200RUSTFS_KMS_VAULT_TOKENyour-vault-tokenRUSTFS_KMS_VAULT_MOUNT_PATHtransit服务端默认用secret作 KV 挂载点、rustfs/kms/keys作密钥前缀。先把默认密钥 ID 配出来再用——RUSTFS_KMS_DEFAULT_KEY_ID只是选择已有密钥不会帮你创建rc admin kms key create rustfs--namerustfs-default-key rc admin kms key status rustfs rustfs-default-keyRUSTFS_KMS_DEFAULT_KEY_IDrustfs-default-key一个硬性前提KMS 必须真的可用。否则桶默认设置能写进去但之后加密对象写入会直接失败——上线前先验证一次加密读写为宜。4. SSE-C密钥在客户端手里SSE-C 完全不经过 KMS。客户端用 OpenSSL 生成一个 32 字节的 AES-256 密钥派生出 Base64 密钥与它的 MD5SSE_C_KEY_HEX$(openssl rand-hex32)SSE_C_KEY_B64$(printf%s$SSE_C_KEY_HEX|xxd-r-p|openssl base64-A)SSE_C_KEY_MD5$(printf%s$SSE_C_KEY_HEX|xxd-r-p|openssl dgst-md5-binary|openssl base64-A)上传时通过三个 S3 头把密钥交给 RustFS读取时用同一组头rc object copy /path/to/hello.txt rustfs/my-bucket/hello.txt\-Hx-amz-server-side-encryption-customer-algorithm:AES256\-Hx-amz-server-side-encryption-customer-key:$SSE_C_KEY_B64\-Hx-amz-server-side-encryption-customer-key-md5:$SSE_C_KEY_MD5读的时候三个头一个都不能少且必须与写入时相同。密钥丢了 RustFS 无法恢复所以密钥要进密钥管理器不能落日志、不能进版本库。命令行-H会把展开后的密钥写进进程参数其他进程可能读到——生产自动化优先用能在受保护内存里接收密钥的 S3 SDK别走命令行参数。5. 落地前的几条注记密钥丢失 对象永久不可读RustFS 不在后端之外保存可恢复的 KMS 主密钥副本。启用加密前先备份本地密钥文件及其主密钥或保护好 Vault 数据与恢复凭证。rc 版本边界官方加密文档里的rc admin kms密钥生命周期命令在rc 0.1.29上不存在该版本只支持桶/对象加密命令要跑密钥创建/轮换先rc admin --help确认有 KMS 子命令或用更新版本。别开开发默认项除非显式设RUSTFS_KMS_ALLOW_INSECURE_DEV_DEFAULTStrueRustFS 会拒绝临时密钥目录、缺失本地主密钥这类开发默认值生产环境切勿开启这个覆盖开关。SSE-C 不受桶默认影响桶默认改成 SSE-S3/SSE-KMS不会动到已有的 SSE-C 对象SSE-C 由每次请求的客户密钥头决定且对该请求优先。6. 总结与下一步选模式的顺序可以很简单只想要静态加密、不想碰密钥管理→ SSE-S3桶默认一开就行。合规要求不同数据用不同密钥、或要集中轮换→ SSE-KMS后端按规模选local单机/已备份或vault-kv2/vault-transit集中式生产。密钥主权必须在客户端、服务端不能存密钥→ SSE-C自己管密钥生命周期。起服务前先把 KMS 跑通再开加密比上线后排查写入失败便宜得多。验证一次往返最直接rc bucket create rustfs/verify-bucket rc bucket encryptionsetrustfs/verify-bucket--modesse-s3 rc object copy /path/to/hello.txt rustfs/verify-bucket/hello.txt rc object show rustfs/verify-bucket/hello.txtRustFS 的源码与 issue 都在 GitHub 上https://github.com/rustfs/rustfs加密相关的变量与命令随版本更新落地前以官方文档当前版本为准。以下是深入学习 RustFS 的推荐资源RustFS官方文档 RustFS 官方文档- 提供架构、安装指南和 API 参考。GitHub 仓库 GitHub 仓库 - 获取源代码、提交问题或贡献代码。社区支持 GitHub Discussions- 与开发者交流经验和解决方案。意见反馈GitHub Issues