https://yangyang233333.github.io/tags/3fs/ Recent content in 3FS on Hellokitty's Blog Hugo zh-CN Fri, 14 Aug 2026 19:10:00 +0800 https://yangyang233333.github.io/posts/3fs-foundationdb-metadata-design/ Fri, 14 Aug 2026 19:10:00 +0800 https://yangyang233333.github.io/posts/3fs-foundationdb-metadata-design/ <p>3FS 是面向 AI 训练和推理负载设计的分布式文件系统。它没有把 FoundationDB 当成普通的持久化 KV 使用，而是围绕 FoundationDB 的有序键空间、乐观事务、冲突检测和 Versionstamp，构建了一套强一致的文件系统元数据服务。</p> <p>本文从源码出发，梳理 3FS 如何接入 FoundationDB，如何编码 inode 和目录项，以及 create、rename、remove、list 等文件系统操作怎样映射为 FoundationDB 事务。</p> <p>本文分析的源码位于 3FS 仓库中的以下目录：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>src/fdb/ FoundationDB C API 封装 </span></span><span style="display:flex;"><span>src/common/kv/ 通用 KV 和事务接口 </span></span><span style="display:flex;"><span>src/meta/store/ inode、目录项和元数据操作 </span></span><span style="display:flex;"><span>src/meta/components/ ID 分配、服务分布和 GC 等组件 </span></span><span style="display:flex;"><span>src/meta/service/ Meta Service RPC 入口 </span></span></code></pre></div><h2 id="一3fs-中-foundationdb-的定位">一、3FS 中 FoundationDB 的定位</h2> <p>3FS 将数据面和元数据面分开：</p> <ul> <li>文件的 chunk 数据由 Storage Service 保存。</li> <li>文件系统元数据由 Meta Service 管理，并持久化到 FoundationDB。</li> </ul> <p>FoundationDB 中保存的主要内容包括：</p> <ul> <li>inode；</li> <li>directory entry，也就是目录项；</li> <li>文件打开会话；</li> <li>RPC 幂等记录；</li> <li>Meta Server 分布信息；</li> <li>用户、配置和其他全局状态。</li> </ul> <p>整体调用链可以简化为：</p>