RustFS 持久化模式Durability Modes完全指南从 fsync 分级到按桶覆盖【免费下载链接】rustfs2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.项目地址: https://gitcode.com/GitHub_Trending/rus/rustfs导读RustFS 允许运维人员在对象写入路径上分级控制 fsync 工作量在掉电持久性与写入延迟/IOPS 之间做显式取舍。本文以官方运维文档 durability-modes.md 为主线结合 disk/local.rs、bucket/durability.rs 与管理 API 实现 handlers/durability.rs 的源码细节完整讲解strict | relaxed | none | legacy-off四种模式的含义、各 fsync 写点的处理矩阵、系统关键命名空间的钉扎规则、按桶覆盖的配置方法与传播时延以及可靠的性能评估方式。读完本文你将能为单机或多机集群正确选择持久化档位并通过管理 API 实现全局 strict 指定桶 relaxed的混合部署。适用场景为某套部署或某个桶选择/调试 fsync 档位strict|relaxed|none|legacy-off或调整任何写路径同步行为时阅读本文。1. 三种环境变量与解析规则持久化模式完全由进程环境变量控制属于服务端配置任何请求头都无法提升或降低它见 local.rs 对应语义。共涉及三个环境变量# 新增的分级开关设为合法值时优先 RUSTFS_DURABILITY_MODEstrict|relaxed|none # 默认: strict # 历史二元开关为兼容保留已被上面取代 RUSTFS_DRIVE_SYNC_ENABLEtrue|false # 默认: true # 注入到新创建桶自身 override 中的档位见新桶默认值 RUSTFS_NEW_BUCKET_DURABILITY_MODErelaxed|strict|none|inherit # 默认: relaxed1.1 解析优先级规则表RUSTFS_DURABILITY_MODERUSTFS_DRIVE_SYNC_ENABLE生效模式未设置未设置strict默认未设置truestrict未设置falselegacy-off历史全关语义strict/relaxed/none任意以命名模式为准非法值任意记录告警日志回退到 legacy 开关再回退默认该逻辑在源码中对应resolve_durability_mode()local.rs只有当RUSTFS_DURABILITY_MODE解析为合法档位时它才胜出否则回落到RUSTFS_DRIVE_SYNC_ENABLEtrue→strictfalse→LegacyOff。模式枚举定义于 local.rsStrict—— 每个提交点都 fsyncRelaxed—— 数据分片仍 fdatasync元数据提交交给页缓存与 MinIO 默认姿态对齐None—— 对象数据路径完全无 fsync但系统关键命名空间仍被钉扎为strictLegacyOff——RUSTFS_DRIVE_SYNC_ENABLEfalse的历史语义全路径无任何 fsync含format.json等系统关键元数据仅能通过 legacy 开关到达。1.2 大小写、空白与进程级缓存所有取值大小写不敏感且容忍首尾空白DurabilityMode::parse()内部先trim().to_ascii_lowercase()再匹配local.rs按桶配置同样如此BucketDurabilityConfig::is_valid_mode见 durability.rs。模式每进程只解析一次并缓存OnceLocklocal.rs。这正是对旧二元开关的优化旧开关在每个 PUT 中会反复执行十余次getenv而现在热路径上只是读取缓存值。因此修改环境变量必须重启进程才能生效。解析完成后启动日志会以disk_local_durability_mode事件输出最终生效的模式源码中该事件常量定义于 local.rs。重要legacy-off不是RUSTFS_DURABILITY_MODE的合法取值只能通过RUSTFS_DRIVE_SYNC_ENABLEfalse触达目的是让存量部署保持逐比特一致的既有行为。它已被标记为弃用至少保留一个大版本。2. 各模式 fsync 什么写点矩阵对象路径上的写点与各模式的处理方式如下这也是本文档最核心的决策表写点strictrelaxednonelegacy-off纠删码分片文件commit rename 前 fdatasync✅✅❌❌Multipart 分片 payloadrename_part提交前 fdatasync✅✅❌❌xl.meta 内容commit rename 前的临时写入✅❌❌❌内联对象数据嵌在 xl.meta 中✅❌❌❌旧元数据回滚备份✅❌❌❌commit rename 的目录项父目录 fsync✅❌❌❌系统关键写入见钉扎节✅✅被钉扎✅被钉扎❌这个矩阵在源码中由DurabilityMode的两个谓词精确对应local.rssyncs_data_shards()—— 对象 payload纠删分片文件、multipart 分片文件是否必须 fdatasyncStrict | Relaxed返回truesyncs_commit_metadata()—— 元数据提交xl.meta 内容、回滚备份、commit rename 产生的目录项是否必须 fsync仅Strict返回true。以一个真实提交点为例UploadPart 的rename路径中local.rs代码先按effective_durability(dst_volume)判断——若syncs_data_shards()则对源分片文件执行os::sync_filerename 之后再按syncs_commit_metadata()决定是否os::fsync_dir(parent)刷父目录。也就是说relaxed下分片数据先落盘、目录项交给页缓存的行为是代码层面逐点实现的而不是整体一刀切。3. 掉电保证如实陈述3.1strict默认每个被确认的写入PUT、UploadPart、CompleteMultipartUpload、删除标记、元数据更新在返回 200 OK 之前已在该单块盘上持久化payload 字节、xl.meta、回滚备份、commit rename 的目录项全部 fsync。因此整节点甚至整个集群掉电不会丢失任何已确认的数据。这是当前主线行为未做任何改动。3.2relaxed非内联对象的 payload 字节与 multipart 分片在确认前仍 fdatasync 到设备但元数据提交——xl.meta 内容、回滚备份、commit rename 的目录项——全部留给页缓存。掉电后果必须清醒认识在受影响盘上最近已确认的版本可能整体丢失而不仅仅是目录项回滚。当 xl.meta 字节与 rename 的目录项都未同步时提交本身可能消失幸存的 shard 字节在该盘上变成无引用的孤儿数据内联小对象在该模式下完全没有逐对象 fsync其数据存在 xl.meta 内部而 xl.meta 不同步。这与 MinIO 的默认姿态无逐对象 fsync一致但也意味着小对象拥有最宽的丢失窗口因此已确认写入的持久性只能依靠跨节点的纠删冗余 之后的脏关机 heal 收敛该受影响盘。relaxed部署规则仅适用于节点处于独立供电域独立电源/UPS的多节点集群。若所有节点可能同时掉电relaxed可能在集群范围内丢失最近确认的对象。单节点部署必须保持strict。3.3none对象数据路径完全无 fsync已确认的对象在掉电时可能连同 payload 一起整体消失。系统关键写入仍被钉扎见下节。这等价于旧的逃生舱口仅适用于一次性/基准测试数据。3.4legacy-offRUSTFS_DRIVE_SYNC_ENABLEfalse的历史语义为存量部署逐比特保留任何地方都不 fsync包括format.json等系统关键元数据。建议优先使用RUSTFS_DURABILITY_MODEnone它仍会保护系统关键写入。4. 系统关键写入的钉扎pinning无论配置成哪个档位legacy-off除外写入系统命名空间的提交都会被钉扎为strict.rustfs.sys——format.json、IAM 与集群配置、桶元数据以及 scratch 命名空间之外的一切.minio.sys—— MinIO 迁移期间的同一命名空间。源码中is_system_critical_volume()local.rs对这两个元数据桶及其子树返回true先排除 scratch而is_scratch_volume()local.rs识别.rustfs.sys/tmp与.rustfs.sys/multipart及其子树。scratch 命名空间暂存进行中的用户对象数据正好跟随配置档位——它们正是 relaxed 档位存在的意义。关键细节scratch 暂存数据在提交时按目标卷决定持久性。因此一个在 tmp 中暂存的 IAM 或桶元数据对象提交时仍然以完整的strict持久性落盘因为目标卷是系统命名空间。持久化模式是纯服务端配置不能由任何请求头提升或降低。5. 按桶持久化覆盖Per-bucket durability桶可以携带自己的档位来覆盖进程级模式。override 存储在桶元数据中.rustfs.sys/buckets/bucket/.metadata.bin内一个durability.json扩展条目以 RustFS 扩展字段写入MinIO 的 decoder 会跳过它并在每个提交点按写入实时解析无需重启。5.1 管理 API 配置# 设置 override管理员凭据需要 ConfigUpdateAdminAction 权限 curl -X PUT http://host/rustfs/admin/v3/bucket-durability/bucket \ -d {mode:relaxed} # strict | relaxed | none # 读回mode: null 表示桶继承全局模式 curl http://host/rustfs/admin/v3/bucket-durability/bucket # 清除桶重新继承全局模式 curl -X DELETE http://host/rustfs/admin/v3/bucket-durability/bucket路由注册与三个 Handler 位于 handlers/durability.rsPUT/GET/DELETE /rustfs/admin/v3/bucket-durability/{bucket}。请求体校验要求非空 JSON否则返回InvalidRequest档位经normalize_mode()规范化——大小写不敏感、容忍空白非法值返回InvalidArgument且legacy-off明确不是合法的按桶档位durability.rs。写操作PUT/DELETE还通过桶元数据 incarnation 做乐观并发控制capture_bucket_metadata_incarnationupdate_if_incarnation避免并发修改互相覆盖。mc集成属于后续工作现阶段管理 API 就是配置面。5.2 新桶默认值渐进式迁移新创建的桶会在创建时向自身元数据注入一个relaxedoverride默认从而在不触碰进程级默认值的前提下对齐 MinIO 默认姿态对象数据仍 fdatasyncxl.meta 与目录项 fsync 交给页缓存。这是一次渐进式迁移存量桶不受影响。没有durability.json条目的桶继续跟随进程级模式默认strict与之前完全一致进程级默认保持strict。RUSTFS_DURABILITY_MODE与RUSTFS_DRIVE_SYNC_ENABLE均未改变只有新建桶自带自己的relaxedoverride系统关键命名空间无论如何都钉扎为strict见上文钉扎节。注入档位由环境变量控制每次桶创建时读取一次桶创建不是热路径RUSTFS_NEW_BUCKET_DURABILITY_MODErelaxed # 默认: 注入 relaxed RUSTFS_NEW_BUCKET_DURABILITY_MODEstrict # 改为注入 strict RUSTFS_NEW_BUCKET_DURABILITY_MODEnone # 改为注入 none RUSTFS_NEW_BUCKET_DURABILITY_MODEinherit # 不注入: 跟随全局模式源码依据DEFAULT_NEW_BUCKET_DURABILITY_MODE relaxeddurability.rsnew_bucket_durability_config_json()对inherit、空串与任何无法识别的值包括legacy-offfail closed 返回空即不注入任何 overridedurability.rs桶元数据构造函数new_with_default_durability()在创建时填充该 JSONmetadata.rsstore 层创建桶时调用store/bucket.rs。inherit以及任何未识别值都 fail closed 到inherit意味着新桶无 override跟随进程级模式。在全集群范围设置它即可整体退出新默认。注入只发生在桶创建时永远不会回溯改写存量桶。要修改存量桶的档位请使用上面的按桶管理 API。5.3 解析顺序对提交到卷V的一次写入生效档位按如下顺序解析effective_durability()local.rs系统关键命名空间.rustfs.sys、.minio.sys中 scratch 目录之外永远是strict——桶 override 不可能附着其上任何尝试都会被拒绝并记日志bucket_durability::set中的防御性拒绝local.rs否则若目标桶有 overrideoverride 双向生效——桶既可以在全局strict下设为relaxed也可以在全局relaxed下钉为strict否则应用进程级模式。legacy-offRUSTFS_DRIVE_SYNC_ENABLEfalse下按桶 override完全不生效legacy 开关保持其历史语义逐比特一致且legacy-off也不是合法的按桶档位。由于 scratch 暂存数据按目标卷提交暂存在.rustfs.sys/tmp中的对象遵循其提交目标桶的 override——与全局档位的行为完全一致。5.4 传播与生效时延override 搭乘现有的桶元数据缓存没有自己的失效通道在应用配置变更的节点上新档位对更新完成后才解析持久性的写入立即生效其他节点会被立刻通知重载该桶元数据与每次桶配置变更所用的对端通知相同若某对端错过通知周期性桶元数据刷新循环15 分钟会收敛它——该周期在 metadata_sys.rs 中定义为Duration::from_secs(15 * 60)进行中的操作保留其在开始时解析到的档位——单次提交绝不会出现一半旧档位、一半新档位删除桶会连同其余元数据一起丢弃 override。在对端重载元数据之前其写入继续使用旧档位。这与策略、配额、版本控制等所有桶配置共有的最终一致性窗口相同。5.5 掉电保证按桶与对应的全局档位完全一致只是作用域限定在该桶。特别地relaxed的部署规则仅限独立供电域的多节点集群按桶适用在单节点部署中把某个桶覆盖为relaxed掉电时可能丢失该桶内最近确认的对象。6. 性能预期与评估纪律在依赖任何具体数字之前请在目标平台Linux ext4/xfs上实测relaxed。要点完全关闭 syncnone或legacy-off测得的吞吐增量不能迁移到relaxedrelaxed保留每个 shard 的 fdatasync其收益必然更小不要用none的数字来为relaxed做容量/性能规划。值得强调的是relaxed的收益来源在代码层面是精确的它只跳过syncs_commit_metadata()对应的提交xl.meta 内容、回滚备份、rename 目录项 fsync而保留syncs_data_shards()对应的分片 fdatasynclocal.rs。因此它的实际加速比取决于你的写入中元数据提交 fsync 占比有多大必须在真实硬件上以真实负载测量任何理论倍数都不可信。7. 相关恢复指南无奇偶校验位腐烂恢复讲解如何诊断历史无校验no-parity对象——其原始part.N文件存在但 bitrot 校验失败。这与relaxed/none模式下孤儿分片的清理与恢复场景相互衔接建议一并阅读。附源码速查表关注点位置模式枚举、解析、进程级缓存crates/ecstore/src/disk/local.rs生效档位解析钉扎 按桶 全局crates/ecstore/src/disk/local.rs按桶 override 注册表与拒绝逻辑crates/ecstore/src/disk/local.rs系统关键/scratch 卷判定crates/ecstore/src/disk/local.rsUploadPart 提交点同步示例crates/ecstore/src/disk/local.rs新桶默认档位与环境变量crates/ecstore/src/bucket/durability.rs桶元数据中的 durability 扩展字段crates/ecstore/src/bucket/metadata.rs桶元数据刷新周期15 分钟crates/ecstore/src/bucket/metadata_sys.rs按桶管理 API 路由与校验rustfs/src/admin/handlers/durability.rs【免费下载链接】rustfs2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.项目地址: https://gitcode.com/GitHub_Trending/rus/rustfs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
RustFS 持久化模式（Durability Modes）完全指南：从 fsync 分级到按桶覆盖
RustFS 持久化模式Durability Modes完全指南从 fsync 分级到按桶覆盖【免费下载链接】rustfs2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.项目地址: https://gitcode.com/GitHub_Trending/rus/rustfs导读RustFS 允许运维人员在对象写入路径上分级控制 fsync 工作量在掉电持久性与写入延迟/IOPS 之间做显式取舍。本文以官方运维文档 durability-modes.md 为主线结合 disk/local.rs、bucket/durability.rs 与管理 API 实现 handlers/durability.rs 的源码细节完整讲解strict | relaxed | none | legacy-off四种模式的含义、各 fsync 写点的处理矩阵、系统关键命名空间的钉扎规则、按桶覆盖的配置方法与传播时延以及可靠的性能评估方式。读完本文你将能为单机或多机集群正确选择持久化档位并通过管理 API 实现全局 strict 指定桶 relaxed的混合部署。适用场景为某套部署或某个桶选择/调试 fsync 档位strict|relaxed|none|legacy-off或调整任何写路径同步行为时阅读本文。1. 三种环境变量与解析规则持久化模式完全由进程环境变量控制属于服务端配置任何请求头都无法提升或降低它见 local.rs 对应语义。共涉及三个环境变量# 新增的分级开关设为合法值时优先 RUSTFS_DURABILITY_MODEstrict|relaxed|none # 默认: strict # 历史二元开关为兼容保留已被上面取代 RUSTFS_DRIVE_SYNC_ENABLEtrue|false # 默认: true # 注入到新创建桶自身 override 中的档位见新桶默认值 RUSTFS_NEW_BUCKET_DURABILITY_MODErelaxed|strict|none|inherit # 默认: relaxed1.1 解析优先级规则表RUSTFS_DURABILITY_MODERUSTFS_DRIVE_SYNC_ENABLE生效模式未设置未设置strict默认未设置truestrict未设置falselegacy-off历史全关语义strict/relaxed/none任意以命名模式为准非法值任意记录告警日志回退到 legacy 开关再回退默认该逻辑在源码中对应resolve_durability_mode()local.rs只有当RUSTFS_DURABILITY_MODE解析为合法档位时它才胜出否则回落到RUSTFS_DRIVE_SYNC_ENABLEtrue→strictfalse→LegacyOff。模式枚举定义于 local.rsStrict—— 每个提交点都 fsyncRelaxed—— 数据分片仍 fdatasync元数据提交交给页缓存与 MinIO 默认姿态对齐None—— 对象数据路径完全无 fsync但系统关键命名空间仍被钉扎为strictLegacyOff——RUSTFS_DRIVE_SYNC_ENABLEfalse的历史语义全路径无任何 fsync含format.json等系统关键元数据仅能通过 legacy 开关到达。1.2 大小写、空白与进程级缓存所有取值大小写不敏感且容忍首尾空白DurabilityMode::parse()内部先trim().to_ascii_lowercase()再匹配local.rs按桶配置同样如此BucketDurabilityConfig::is_valid_mode见 durability.rs。模式每进程只解析一次并缓存OnceLocklocal.rs。这正是对旧二元开关的优化旧开关在每个 PUT 中会反复执行十余次getenv而现在热路径上只是读取缓存值。因此修改环境变量必须重启进程才能生效。解析完成后启动日志会以disk_local_durability_mode事件输出最终生效的模式源码中该事件常量定义于 local.rs。重要legacy-off不是RUSTFS_DURABILITY_MODE的合法取值只能通过RUSTFS_DRIVE_SYNC_ENABLEfalse触达目的是让存量部署保持逐比特一致的既有行为。它已被标记为弃用至少保留一个大版本。2. 各模式 fsync 什么写点矩阵对象路径上的写点与各模式的处理方式如下这也是本文档最核心的决策表写点strictrelaxednonelegacy-off纠删码分片文件commit rename 前 fdatasync✅✅❌❌Multipart 分片 payloadrename_part提交前 fdatasync✅✅❌❌xl.meta 内容commit rename 前的临时写入✅❌❌❌内联对象数据嵌在 xl.meta 中✅❌❌❌旧元数据回滚备份✅❌❌❌commit rename 的目录项父目录 fsync✅❌❌❌系统关键写入见钉扎节✅✅被钉扎✅被钉扎❌这个矩阵在源码中由DurabilityMode的两个谓词精确对应local.rssyncs_data_shards()—— 对象 payload纠删分片文件、multipart 分片文件是否必须 fdatasyncStrict | Relaxed返回truesyncs_commit_metadata()—— 元数据提交xl.meta 内容、回滚备份、commit rename 产生的目录项是否必须 fsync仅Strict返回true。以一个真实提交点为例UploadPart 的rename路径中local.rs代码先按effective_durability(dst_volume)判断——若syncs_data_shards()则对源分片文件执行os::sync_filerename 之后再按syncs_commit_metadata()决定是否os::fsync_dir(parent)刷父目录。也就是说relaxed下分片数据先落盘、目录项交给页缓存的行为是代码层面逐点实现的而不是整体一刀切。3. 掉电保证如实陈述3.1strict默认每个被确认的写入PUT、UploadPart、CompleteMultipartUpload、删除标记、元数据更新在返回 200 OK 之前已在该单块盘上持久化payload 字节、xl.meta、回滚备份、commit rename 的目录项全部 fsync。因此整节点甚至整个集群掉电不会丢失任何已确认的数据。这是当前主线行为未做任何改动。3.2relaxed非内联对象的 payload 字节与 multipart 分片在确认前仍 fdatasync 到设备但元数据提交——xl.meta 内容、回滚备份、commit rename 的目录项——全部留给页缓存。掉电后果必须清醒认识在受影响盘上最近已确认的版本可能整体丢失而不仅仅是目录项回滚。当 xl.meta 字节与 rename 的目录项都未同步时提交本身可能消失幸存的 shard 字节在该盘上变成无引用的孤儿数据内联小对象在该模式下完全没有逐对象 fsync其数据存在 xl.meta 内部而 xl.meta 不同步。这与 MinIO 的默认姿态无逐对象 fsync一致但也意味着小对象拥有最宽的丢失窗口因此已确认写入的持久性只能依靠跨节点的纠删冗余 之后的脏关机 heal 收敛该受影响盘。relaxed部署规则仅适用于节点处于独立供电域独立电源/UPS的多节点集群。若所有节点可能同时掉电relaxed可能在集群范围内丢失最近确认的对象。单节点部署必须保持strict。3.3none对象数据路径完全无 fsync已确认的对象在掉电时可能连同 payload 一起整体消失。系统关键写入仍被钉扎见下节。这等价于旧的逃生舱口仅适用于一次性/基准测试数据。3.4legacy-offRUSTFS_DRIVE_SYNC_ENABLEfalse的历史语义为存量部署逐比特保留任何地方都不 fsync包括format.json等系统关键元数据。建议优先使用RUSTFS_DURABILITY_MODEnone它仍会保护系统关键写入。4. 系统关键写入的钉扎pinning无论配置成哪个档位legacy-off除外写入系统命名空间的提交都会被钉扎为strict.rustfs.sys——format.json、IAM 与集群配置、桶元数据以及 scratch 命名空间之外的一切.minio.sys—— MinIO 迁移期间的同一命名空间。源码中is_system_critical_volume()local.rs对这两个元数据桶及其子树返回true先排除 scratch而is_scratch_volume()local.rs识别.rustfs.sys/tmp与.rustfs.sys/multipart及其子树。scratch 命名空间暂存进行中的用户对象数据正好跟随配置档位——它们正是 relaxed 档位存在的意义。关键细节scratch 暂存数据在提交时按目标卷决定持久性。因此一个在 tmp 中暂存的 IAM 或桶元数据对象提交时仍然以完整的strict持久性落盘因为目标卷是系统命名空间。持久化模式是纯服务端配置不能由任何请求头提升或降低。5. 按桶持久化覆盖Per-bucket durability桶可以携带自己的档位来覆盖进程级模式。override 存储在桶元数据中.rustfs.sys/buckets/bucket/.metadata.bin内一个durability.json扩展条目以 RustFS 扩展字段写入MinIO 的 decoder 会跳过它并在每个提交点按写入实时解析无需重启。5.1 管理 API 配置# 设置 override管理员凭据需要 ConfigUpdateAdminAction 权限 curl -X PUT http://host/rustfs/admin/v3/bucket-durability/bucket \ -d {mode:relaxed} # strict | relaxed | none # 读回mode: null 表示桶继承全局模式 curl http://host/rustfs/admin/v3/bucket-durability/bucket # 清除桶重新继承全局模式 curl -X DELETE http://host/rustfs/admin/v3/bucket-durability/bucket路由注册与三个 Handler 位于 handlers/durability.rsPUT/GET/DELETE /rustfs/admin/v3/bucket-durability/{bucket}。请求体校验要求非空 JSON否则返回InvalidRequest档位经normalize_mode()规范化——大小写不敏感、容忍空白非法值返回InvalidArgument且legacy-off明确不是合法的按桶档位durability.rs。写操作PUT/DELETE还通过桶元数据 incarnation 做乐观并发控制capture_bucket_metadata_incarnationupdate_if_incarnation避免并发修改互相覆盖。mc集成属于后续工作现阶段管理 API 就是配置面。5.2 新桶默认值渐进式迁移新创建的桶会在创建时向自身元数据注入一个relaxedoverride默认从而在不触碰进程级默认值的前提下对齐 MinIO 默认姿态对象数据仍 fdatasyncxl.meta 与目录项 fsync 交给页缓存。这是一次渐进式迁移存量桶不受影响。没有durability.json条目的桶继续跟随进程级模式默认strict与之前完全一致进程级默认保持strict。RUSTFS_DURABILITY_MODE与RUSTFS_DRIVE_SYNC_ENABLE均未改变只有新建桶自带自己的relaxedoverride系统关键命名空间无论如何都钉扎为strict见上文钉扎节。注入档位由环境变量控制每次桶创建时读取一次桶创建不是热路径RUSTFS_NEW_BUCKET_DURABILITY_MODErelaxed # 默认: 注入 relaxed RUSTFS_NEW_BUCKET_DURABILITY_MODEstrict # 改为注入 strict RUSTFS_NEW_BUCKET_DURABILITY_MODEnone # 改为注入 none RUSTFS_NEW_BUCKET_DURABILITY_MODEinherit # 不注入: 跟随全局模式源码依据DEFAULT_NEW_BUCKET_DURABILITY_MODE relaxeddurability.rsnew_bucket_durability_config_json()对inherit、空串与任何无法识别的值包括legacy-offfail closed 返回空即不注入任何 overridedurability.rs桶元数据构造函数new_with_default_durability()在创建时填充该 JSONmetadata.rsstore 层创建桶时调用store/bucket.rs。inherit以及任何未识别值都 fail closed 到inherit意味着新桶无 override跟随进程级模式。在全集群范围设置它即可整体退出新默认。注入只发生在桶创建时永远不会回溯改写存量桶。要修改存量桶的档位请使用上面的按桶管理 API。5.3 解析顺序对提交到卷V的一次写入生效档位按如下顺序解析effective_durability()local.rs系统关键命名空间.rustfs.sys、.minio.sys中 scratch 目录之外永远是strict——桶 override 不可能附着其上任何尝试都会被拒绝并记日志bucket_durability::set中的防御性拒绝local.rs否则若目标桶有 overrideoverride 双向生效——桶既可以在全局strict下设为relaxed也可以在全局relaxed下钉为strict否则应用进程级模式。legacy-offRUSTFS_DRIVE_SYNC_ENABLEfalse下按桶 override完全不生效legacy 开关保持其历史语义逐比特一致且legacy-off也不是合法的按桶档位。由于 scratch 暂存数据按目标卷提交暂存在.rustfs.sys/tmp中的对象遵循其提交目标桶的 override——与全局档位的行为完全一致。5.4 传播与生效时延override 搭乘现有的桶元数据缓存没有自己的失效通道在应用配置变更的节点上新档位对更新完成后才解析持久性的写入立即生效其他节点会被立刻通知重载该桶元数据与每次桶配置变更所用的对端通知相同若某对端错过通知周期性桶元数据刷新循环15 分钟会收敛它——该周期在 metadata_sys.rs 中定义为Duration::from_secs(15 * 60)进行中的操作保留其在开始时解析到的档位——单次提交绝不会出现一半旧档位、一半新档位删除桶会连同其余元数据一起丢弃 override。在对端重载元数据之前其写入继续使用旧档位。这与策略、配额、版本控制等所有桶配置共有的最终一致性窗口相同。5.5 掉电保证按桶与对应的全局档位完全一致只是作用域限定在该桶。特别地relaxed的部署规则仅限独立供电域的多节点集群按桶适用在单节点部署中把某个桶覆盖为relaxed掉电时可能丢失该桶内最近确认的对象。6. 性能预期与评估纪律在依赖任何具体数字之前请在目标平台Linux ext4/xfs上实测relaxed。要点完全关闭 syncnone或legacy-off测得的吞吐增量不能迁移到relaxedrelaxed保留每个 shard 的 fdatasync其收益必然更小不要用none的数字来为relaxed做容量/性能规划。值得强调的是relaxed的收益来源在代码层面是精确的它只跳过syncs_commit_metadata()对应的提交xl.meta 内容、回滚备份、rename 目录项 fsync而保留syncs_data_shards()对应的分片 fdatasynclocal.rs。因此它的实际加速比取决于你的写入中元数据提交 fsync 占比有多大必须在真实硬件上以真实负载测量任何理论倍数都不可信。7. 相关恢复指南无奇偶校验位腐烂恢复讲解如何诊断历史无校验no-parity对象——其原始part.N文件存在但 bitrot 校验失败。这与relaxed/none模式下孤儿分片的清理与恢复场景相互衔接建议一并阅读。附源码速查表关注点位置模式枚举、解析、进程级缓存crates/ecstore/src/disk/local.rs生效档位解析钉扎 按桶 全局crates/ecstore/src/disk/local.rs按桶 override 注册表与拒绝逻辑crates/ecstore/src/disk/local.rs系统关键/scratch 卷判定crates/ecstore/src/disk/local.rsUploadPart 提交点同步示例crates/ecstore/src/disk/local.rs新桶默认档位与环境变量crates/ecstore/src/bucket/durability.rs桶元数据中的 durability 扩展字段crates/ecstore/src/bucket/metadata.rs桶元数据刷新周期15 分钟crates/ecstore/src/bucket/metadata_sys.rs按桶管理 API 路由与校验rustfs/src/admin/handlers/durability.rs【免费下载链接】rustfs2.3x faster than MinIO for 4KB object payloads. RustFS is an open-source, S3-compatible high-performance object storage system supporting migration and coexistence with other S3-compatible platforms such as MinIO and Ceph.项目地址: https://gitcode.com/GitHub_Trending/rus/rustfs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
