马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。
您需要 登录 才可以下载或查看,没有账号?立即注册
×
一、内容概述
" a4 u# B; p* g7 ~8 I
& w- }" r+ p) z9 z a. v% m本帖整理的是一套分布式系统与共识算法方向的学习资料:开头是 Raft 共识算法的四套主流实现,分别用 Rust、Go、Java 与 C++ 写成,接着是 etcd 这个以 Raft 为基础的分布式键值存储与 ZooKeeper 这个 Java 写的分布式协调服务;随后是四款存储引擎源码——LevelDB、带有完整中文注释与中文配套教材的 mini-lsm、LMDB 与 bbolt;再往后是 Seata 与 dtm 两套分布式事务框架;最后是 NATS 与 RocketMQ 两个消息队列。全包共 7335 个文件、约 49.25 MB,包含 4533 个 Java 文件、1167 个 Go 文件、180 个 Rust 文件、170 个 C/C++ 文件、288 篇文档与 14 份许可证原文,全部文本已统一为 UTF-8 无 BOM 编码与 LF 换行。' i/ v; y8 p$ ~/ Q
, b- H4 u9 j$ w. e
适合人群:正在学分布式系统、想先把共识算法与存储引擎这两块基础打通的同学;正在做分布式方向课程设计或毕设、需要一套能跑能读的参考实现的同学;想读 etcd、ZooKeeper、RocketMQ 这类生产级系统源码、又怕直接从大工程里找不着主线的同学;准备做后端、基础架构或中间件方向求职、想系统看一遍共识、存储、事务、消息四条主线的同学。8 d9 n0 Z; b* Z& y) I$ u% Z/ @
0 w" V% a& w) i/ u% I使用方法与注意事项:解压后先读根目录的 README.md 与 来源与版权声明.md,README 里有四个板块的目录索引与推荐阅读路线,实测结果记录在 实测验证说明.md。01 板块的 raft-rs 用 cargo 一条命令即可编译并跑它自带的 48 个单元测试,mini3d 式的短实现思路与 raft-Go 适合先看清 Raft 骨架;etcd 与 ZooKeeper 需要自己的配置文件与数据目录;02 板块的 LevelDB 与 LMDB 只依赖系统库,最容易直接编译,mini-lsm 需要在 Linux 或 macOS 下编译(它用了 os::unix 与 read_exact_at 这类 Unix 专有接口),bbolt 只需 Go;03 板块的 dtm 用 Go 编写,核心库可直接编译运行,Seata 用 Maven 构建需要 JDK 11 以上;04 板块的 NATS 可直接编译出服务端二进制,RocketMQ 用 Maven 构建。
* f7 R# H# l/ g
. l; p/ p' r2 q二、目录结构与规模
- U/ |% E) K, {) h( t0 L# F4 u" c d; V
压缩包解压后共四个部分目录与十四份许可证全文:. R6 R7 @3 k1 _# ~% _5 W# Y+ ?
; m' Y, U/ Q v2 t
01-共识算法与分布式协调,2983 个文件,含 Raft 的 Rust、Go、Java、C++ 四套实现,以及 etcd 与 ZooKeeper;: I0 ~- r6 ]' E
$ F/ n0 V1 v0 z- j
02-存储引擎与数据库内核,539 个文件,含 LevelDB、mini-lsm、LMDB 与 bbolt;' n! M u; C# B) k0 _& C
7 A7 Q `3 i i6 z3 y03-分布式事务框架,1811 个文件,含 Seata 与 dtm;( e. ~% X, f3 Y( y1 {2 q
9 ?0 G% t% k1 y- r
04-消息中间件,1984 个文件,含 NATS 与 RocketMQ;; H9 P7 z- A$ W/ @
0 ]! `# }! n, E+ {: o G" `) v根目录另有 14 份许可证原文,以及 README.md、来源与版权声明.md 与 实测验证说明.md。
) ]. e/ k c& B' j( R6 g% y5 I& I
内容总览:四个板块的文件数、体积与许可证清单
, I O8 p$ i/ F2 r. S( \
2 S3 f8 {6 c( E' q$ g6 U4 L上图为内容总览。十四个来源项目的许可证为 Apache-2.0 九份、MIT 两份、BSD-3-Clause 两份、OpenLDAP Public License 一份,全文随包附带。$ ~3 n% n7 {5 s: L
}* g7 H& h5 G% g( U2 y
分布式系统与共识算法实战手册_2026.zip
(15.62 MB)
+ _( _7 B' f. w' J$ o- v
0 b5 R2 \, ? }3 [8 W; E
三、01 板块:共识算法与分布式协调
' D7 S7 |' S( [2 Q: R! F; R5 L. o) t- {# J, m
这一部分是同一条主线上的四套写法加两个真实系统。raft-rs 是 TiKV 出品的 Rust Raft 库,带 protobuf 编解码与完整单元测试,本机用 cargo 构建通过、48 个测试全部通过,是 Rust 生态里最常被引用的共识实现;raft-Go 是更早的 Go 实现,代码量很小、结构直白,适合先把选主、日志复制与快照压缩这几块看明白;sofa-jraft 是蚂蚁 SOFAStack 的 Java 实现,配套文档里有协议说明与运维指南;braft 是百度开源的 C++ 框架,docs/cn 目录下有 11 篇中文协议与运维文档,从选主、日志复制一直讲到多副本与 witness 模式,是这一块中文材料最全的一份;etcd 是以 Raft 为基础的分布式键值存储,包含服务端、客户端、gRPC 接口定义与命令行工具源码,能看清共识算法如何被封装成可用的存储系统;ZooKeeper 是 Java 实现的分布式协调服务,包内含服务端源码、协议规范文档、配方示例与 Prometheus 指标提供者。
8 S8 |2 H1 ~' g8 x+ U, A( u z
+ x& Q, I6 _1 {/ ~9 u6 R
包内实读:mini-lsm 中文教材《分层压缩》一页原文
- e) E3 D$ t6 Y% ^# Q
4 `0 h4 @# V0 \' {$ K
四、02 板块:存储引擎与数据库内核, B. v- C$ ~( s
4 q! _2 ^5 O& ]; A/ l
这一部分是四款可以逐行读的存储引擎。LevelDB 是 Google 的 LSM 键值存储引擎,memtable、SST、压缩与写前日志这几块教科书级别的代码都在里面;mini-lsm 是带完整中文注释、并配套一套中文教材的实现,教材从 memtable、SST、合并迭代器一路讲到分层压缩、WAL、恢复、快照与布隆过滤器,是从零读懂 LSM 最省事的材料;LMDB 是 OpenLDAP 的内存映射 B+ 树引擎,mdb.c 一个文件就能看清 B 树与内存映射的实现;bbolt 是 etcd 用的 B+ 树键值引擎,纯 Go 实现,代码量小,可直接跑它的测试。
# C1 `! i& O# X; _ m( X
# d* t, V6 A3 p
包内源码实读:raft-rs 日志核心实现 raft_log.rs
5 B+ `0 z: c' e! u3 d
0 t2 d2 u! I1 p0 L% {1 x五、03 板块:分布式事务框架7 S7 F1 {! b# T3 g) h
7 ?+ _) ~! Y; e% i+ y) `3 l, n这一部分给的是两套风格不同的分布式事务框架。Seata 是 Apache 孵化项目,包内含 core、server 与 spring 集成源码,覆盖 AT、TCC、Saga、XA 四种模式;dtm 是 Go 实现的分布式事务框架,支持 TCC、Saga、XA 与两阶段消息,接口简洁并配有中文文档站。两者放在一起对照,能看出同一个问题在 Java 与 Go 生态里、在中心化与轻量化两种取舍下的不同解法。
- [+ ~8 f; R# }/ w1 L; p" E
* e& U# C5 `5 f( e' E六、04 板块:消息中间件
# }$ W$ W/ {5 a9 W6 t7 F/ Y5 g+ I, Y) F) _8 z3 n3 l, C8 Q
这一部分是两个消息队列。NATS 是 Go 实现的轻量高性能消息系统,包内含 Core 与 JetStream 持久化流两套实现与完整服务端源码,代码紧凑、适合从零读懂发布订阅与流式消费;RocketMQ 是 Apache 的完整实现,含 broker、store、client、remoting 等模块与中文文档,能看清存储设计、投递语义与事务消息这些更重的东西。
' t- R% b9 I. ]8 k3 K1 ?7 D
! {. K9 {% Y! G$ S" y$ |
包内实读:braft 中文 Raft 协议文档原文
7 n, I9 P8 t3 L0 |7 t
+ Z% l, }2 j* l: k! e4 s2 c/ T
七、整理与实测结果
' |7 ]1 d! W, ?/ q2 O/ p
, r' D' D8 n, c4 a i6 h外链逐条实测。成品保留 1104 处唯一外链引用,抽取的 1173 条不同 URL 逐条探测:985 条返回 200,13 条返回 403(对方站点反爬拦截,非链接失效),24 条返回 429(站点限流),1 条返回 500,124 条因对端直接断开连接或本身是文档里的本地示例地址而未能完成探测;其中 26 条返回 404 的逐条确认为失效链接,已在原位改写为「(原链接经实测已失效)」。此外作者个人主页与邮件列表改为文字说明,提交永久链接改写为短提交号,已停用的第三方镜像站与商业站点一律移除并保留署名。; L2 R9 b5 I. {* W6 }
: D) o7 r# @" d8 {5 q- ?8 t9 z9 f
图片全部不做收录。301 处配图引用统一改为文字说明并保留图题,包内 0 张图片、0 处远程图片引用;各来源自带的架构图、流程图与截图同样未随包收录。 O$ O/ W4 W8 E# {: F
- i( M$ j0 e0 }$ ^% i* k+ Z# m
编码全部统一。7335 个文件全部为 UTF-8 无 BOM 加 LF 换行,无乱码、无空文件、无零宽字符残留,全量校验 0 错误。
x* l: \8 i! D/ K" D; e; m u, Y8 K) n/ W0 v6 C- ^
代码实测。Rust 侧用 cargo 构建 tikv/raft-rs 通过,并运行其单元测试 48 个全部通过、0 失败;C/C++ 侧用 g++ 11.4 逐文件编译,LevelDB 40 个文件通过、36 个因缺 snappy 中止,LMDB 21 个通过、2 个缺依赖,braft 41 个文件全部因缺 gflags 与 protobuf 中止,三者非依赖类错误均为 0;Java 侧用 JDK 25 的 javac 以纯语法解析模式检查 sofa-jraft、ZooKeeper、Seata、RocketMQ 四个工程共 2955 个 Java 文件,语法错误 0 个;Go 侧用 Go 1.26 实测 bbolt 与 NATS 均可构建通过,bbolt 自带测试中五个子包通过、主包因上游 failpoint 注入需要特殊构建标签且测试超过 180 秒未跑完;Python 侧包内 6 个 Python 文件用 Python 3.14 逐个编译,全部通过。4 B3 Z, v+ ~. ?3 V+ ~2 u
$ o- u( M3 ~. V版权逐个核实。十四个来源项目逐个实读许可证原文后才收录,许可证含非商业条款的、仓库内没有许可证原文的、采用 GPL 或 BSL 等非开源许可的、README 含个人社交账号或付费社群引流的,以及明确声明禁止 AI 工具使用的,一律排除;各来源 README 中的联系与扫码推广段落已删除,全包按联系方式类与交易类关键词逐文件扫描,命中 0 处。5 W; s9 G9 D+ f) r+ S3 c
# n# C- J9 w( O S( d% c八、许可、来源与转载说明4 l" U1 d$ g( v( L0 ]+ T7 J6 G
6 q+ t9 |! G: J2 f( n6 I
十四个来源项目均为 MIT、Apache-2.0、BSD-3-Clause 或 OpenLDAP Public License 许可,允许再分发与改编,但必须保留许可证全文与原作者署名,因此包内附带十四份许可证原文。本手册对原文只做了技术性处理:统一编码与换行、清理零宽字符、移除非自制配图与编译产物、删除联系与推广段落、按实测结果处理外链,并把 tarball 中指向包内其它文件的相对符号链接还原为真实文件,代码与正文的实质内容未作改动。
. Y7 n( K8 u1 Z a( K' p6 Z9 ]1 m
来源项目名称、作者、许可协议与收录提交号,见包内 来源与版权声明.md。若要转载或引用本资料,请一并注明来源项目名称、作者与许可证,并保留随包的许可证全文。本资料内不含任何个人联系渠道、外部引导链接与商业信息,压缩包可直接下载使用。3 U( g: o: M( S9 ~/ m
6 O' C6 s7 `, K% S) }上述内容均来自我整理后的公开发布版本,已按论坛要求写明来源;如版主认为需要补充任何信息,回复本帖即可。! l# A2 d& L' r* ~+ Y9 n3 r
|