# Technical Documentation: yeasy/blockchain_guide

> ℹ️ **Provenance:** Hybrid Fusion: `yeasy/blockchain_guide` (README + 10 In-Tree Chapters) · [CodeWiki Reference](https://codewiki.google/github.com/yeasy/blockchain_guide) · Recency: Active (< 180 days)

## 1. Project Overview & Quickstart (yeasy/blockchain_guide)

---

## 关于本书

区块链是金融科技（Fintech）领域的一项基础性的创新。作为新一代分布式记账（Distributed Ledger Technology，DLT）系统的核心技术，区块链被认为在金融、物联网、商业贸易、征信、资产管理等众多领域都拥有广泛的应用前景。

区块链技术涉及分布式系统、密码学、博弈论、网络协议等诸多学科知识，为学习和实践都带来了不小的挑战。

本书希望能客观探索区块链概念的来龙去脉，剖析关键技术和原理，同时以 Linux 基金会生态中的重要开源分布式账本项目——超级账本为例讲解具体应用。在开发超级账本项目，以及为企业设计方案过程中，笔者积累了一些实践经验，也通过本书分享出来，希望能有助于分布式账本科技的发展和应用。

## 目标读者

- **区块链入门者**：对区块链技术充满好奇，希望系统了解其原理和应用
- **以太坊开发者**：希望掌握智能合约开发与 DeFi 生态
- **企业级应用者**：需要设计和部署超级账本解决方案的技术人员
- **架构师**：需要设计高可用、高性能区块链系统的资深工程师

## 五分钟快速上手

“5 分钟理解区块链”——跟随以下步骤快速掌握核心概念：

1. **区块链基础**（第 1-2 章）：理解区块链的起源、定义、演化与关键挑战
2. **应用场景**（第 3 章）：了解金融、溯源、政务等领域的落地形态与失败案例
3. **核心机制**（第 4-5 章）：探索一致性、共识算法与密码学安全
4. **比特币与以太坊**（第 6-7 章）：掌握主流公链的工作原理、设计与智能合约能力
5. **企业级应用**（第 8-11 章）：了解超级账本 Fabric 的权限、通道、背书机制，并动手开发链码
6. **架构与前沿**（第 12-15 章）：学习 Web3 与 DeFi、Fabric 架构设计、区块链服务平台与前沿趋势

## 学习路线图

```mermaid
graph LR
    Start[区块链学习入口] --> Ch1[第1章：区块链的诞生]

    Ch1 --> Role1["技术入门者第1-3章 → 第6章"]
    Ch1 --> Role2["以太坊开发者第1-2章 → 第7章 → 第12章"]
    Ch1 --> Role3["企业级应用者第1-2章 → 第8-11章 → 第13章"]
    Ch1 --> Role4["架构师第1-5章 → 第13-15章"]

    Role1 --> End1["掌握基础概念"]
    Role2 --> End2["智能合约开发"]
    Role3 --> End3["搭建企业方案"]
    Role4 --> End4["系统设计与创新"]
```

| 读者角色 | 学习重点 | 核心成果 |
|---------|---------|---------|
| **技术入门** | 第1-3章 → 第6章 | 理解区块链基础概念、应用场景与比特币实现 |
| **以太坊开发者** | 第1-2章 → 第7章 → 第12章 | 掌握智能合约开发与 DeFi 生态 |
| **企业级应用** | 第1-2章 → 第8-11章 → 第13章 | 设计与部署超级账本解决方案，并开发链码 |
| **架构师** | 第1-5章 → 第13-15章 | 设计高可用、高性能的区块链系统 |

## 阅读使用

本书适用于对区块链技术感兴趣，且具备一定金融科技基础的读者；无技术背景的读者也可以从中了解到区块链技术的现状。

**在线阅读**：https://yeasy.gitbook.io/blockchain_guide/

**本地阅读**（先安装 [mdPress](https://github.com/yeasy/mdpress)）：

```bash
brew tap yeasy/tap && brew install mdpress
mdpress serve
```

## 下载离线版本

本书提供 PDF 版本供离线阅读，可前往 [GitHub Releases](https://github.com/yeasy/blockchain_guide/releases/latest) 页面下载最新版本。

如需获取默认分支自动更新的预览版，可直接下载 [blockchain_guide.pdf](https://github.com/yeasy/blockchain_guide/releases/download/preview-pdf/blockchain_guide.pdf)。该文件会随主线更新覆盖，不代表正式发布版本。

## 进阶学习



《[区块链原理、设计与应用 第 2 版](https://item.jd.com/12159265.html)》 成书时围绕超级账本 Fabric 2.x 展开，详细介绍了区块链和分布式账本领域的核心技术，以及企业分布式账本方案的设计、架构和应用。截至 2026 年，Fabric 社区同时维护 2.5 LTS 和 3.x 发布线，读者实践时应结合官方文档确认当前版本。欢迎大家阅读并反馈建议。本书已被译为多国语言发行，有意者欢迎与作者联系。

* [京东图书](https://item.jd.com/12935394.html)
* [当当图书](https://product.dangdang.com/28996031.html)

如果发现疏漏，欢迎提交到 [勘误表](https://github.com/yeasy/blockchain_guide/wiki/%E3%80%8A%E5%8C%BA%E5%9D%97%E9%93%BE%E5%8E%9F%E7%90%86%E3%80%81%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BA%94%E7%94%A8%E3%80%8B2%E7%89%88%E5%8B%98%E8%AF%AF%E8%A1%A8)。

## 推荐阅读

本书是技术丛书的一部分。以下书籍与本书形成互补：

| 书名 | 与本书的关系 |
|------|------------|
| [《Docker 从入门到实践》](https://yeasy.gitbook.io/docker_practice) | 区块链节点的容器化部署与运维实践 |
| [《大模型安全权威指南》](https://yeasy.gitbook.io/ai_security_guide) | 密码学、安全攻防与区块链安全共通 |
| [《智能体 AI 权威指南》](https://yeasy.gitbook.io/agentic_ai_guide) | AI 智能体与区块链结合的前沿探索 |
| [《零基础学 AI》](https://yeasy.gitbook.io/ai_beginner_guide) | AI 基础入门，理解 AI + Web3 融合趋势 |

## 参与贡献

欢迎 [参与维护项目](contribute.md)。

* [修订记录](revision.md)
* [贡献者名单](https://github.com/yeasy/blockchain_guide/graphs/contributors)

## 支持鼓励

欢迎鼓励一杯 coffee~



## 在线交流

欢迎大家加入区块链技术讨论群：

* QQ 群  IV：364824846（可加）
* QQ 群 III：414919574（已满）
* QQ 群  II：523889325（已满）
* QQ 群   I：335626996（已满）

## 许可证

本书采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可证。

您可以自由分享和演绎，但需署名、非商业使用、相同方式共享。

## Star History

[查看《区块链技术指南》的 Star History](https://star-history.com/#yeasy/blockchain_guide&Date)。

## 2. In-Tree Documentation Chapters (yeasy/blockchain_guide)

## File: README.md

---

## 关于本书

区块链是金融科技（Fintech）领域的一项基础性的创新。作为新一代分布式记账（Distributed Ledger Technology，DLT）系统的核心技术，区块链被认为在金融、物联网、商业贸易、征信、资产管理等众多领域都拥有广泛的应用前景。

区块链技术涉及分布式系统、密码学、博弈论、网络协议等诸多学科知识，为学习和实践都带来了不小的挑战。

本书希望能客观探索区块链概念的来龙去脉，剖析关键技术和原理，同时以 Linux 基金会生态中的重要开源分布式账本项目——超级账本为例讲解具体应用。在开发超级账本项目，以及为企业设计方案过程中，笔者积累了一些实践经验，也通过本书分享出来，希望能有助于分布式账本科技的发展和应用。

## 目标读者

- **区块链入门者**：对区块链技术充满好奇，希望系统了解其原理和应用
- **以太坊开发者**：希望掌握智能合约开发与 DeFi 生态
- **企业级应用者**：需要设计和部署超级账本解决方案的技术人员
- **架构师**：需要设计高可用、高性能区块链系统的资深工程师

## 五分钟快速上手

“5 分钟理解区块链”——跟随以下步骤快速掌握核心概念：

1. **区块链基础**（第 1-2 章）：理解区块链的起源、定义、演化与关键挑战
2. **应用场景**（第 3 章）：了解金融、溯源、政务等领域的落地形态与失败案例
3. **核心机制**（第 4-5 章）：探索一致性、共识算法与密码学安全
4. **比特币与以太坊**（第 6-7 章）：掌握主流公链的工作原理、设计与智能合约能力
5. **企业级应用**（第 8-11 章）：了解超级账本 Fabric 的权限、通道、背书机制，并动手开发链码
6. **架构与前沿**（第 12-15 章）：学习 Web3 与 DeFi、Fabric 架构设计、区块链服务平台与前沿趋势

## 学习路线图

```mermaid
graph LR
    Start[区块链学习入口] --> Ch1[第1章：区块链的诞生]

    Ch1 --> Role1["技术入门者第1-3章 → 第6章"]
    Ch1 --> Role2["以太坊开发者第1-2章 → 第7章 → 第12章"]
    Ch1 --> Role3["企业级应用者第1-2章 → 第8-11章 → 第13章"]
    Ch1 --> Role4["架构师第1-5章 → 第13-15章"]

    Role1 --> End1["掌握基础概念"]
    Role2 --> End2["智能合约开发"]
    Role3 --> End3["搭建企业方案"]
    Role4 --> End4["系统设计与创新"]
```

| 读者角色 | 学习重点 | 核心成果 |
|---------|---------|---------|
| **技术入门** | 第1-3章 → 第6章 | 理解区块链基础概念、应用场景与比特币实现 |
| **以太坊开发者** | 第1-2章 → 第7章 → 第12章 | 掌握智能合约开发与 DeFi 生态 |
| **企业级应用** | 第1-2章 → 第8-11章 → 第13章 | 设计与部署超级账本解决方案，并开发链码 |
| **架构师** | 第1-5章 → 第13-15章 | 设计高可用、高性能的区块链系统 |

## 阅读使用

本书适用于对区块链技术感兴趣，且具备一定金融科技基础的读者；无技术背景的读者也可以从中了解到区块链技术的现状。

**在线阅读**：https://yeasy.gitbook.io/blockchain_guide/

**本地阅读**（先安装 [mdPress](https://github.com/yeasy/mdpress)）：

```bash
brew tap yeasy/tap && brew install mdpress
mdpress serve
```

## 下载离线版本

本书提供 PDF 版本供离线阅读，可前往 [GitHub Releases](https://github.com/yeasy/blockchain_guide/releases/latest) 页面下载最新版本。

如需获取默认分支自动更新的预览版，可直接下载 [blockchain_guide.pdf](https://github.com/yeasy/blockchain_guide/releases/download/preview-pdf/blockchain_guide.pdf)。该文件会随主线更新覆盖，不代表正式发布版本。

## 进阶学习



《[区块链原理、设计与应用 第 2 版](https://item.jd.com/12159265.html)》 成书时围绕超级账本 Fabric 2.x 展开，详细介绍了区块链和分布式账本领域的核心技术，以及企业分布式账本方案的设计、架构和应用。截至 2026 年，Fabric 社区同时维护 2.5 LTS 和 3.x 发布线，读者实践时应结合官方文档确认当前版本。欢迎大家阅读并反馈建议。本书已被译为多国语言发行，有意者欢迎与作者联系。

* [京东图书](https://item.jd.com/12935394.html)
* [当当图书](https://product.dangdang.com/28996031.html)

如果发现疏漏，欢迎提交到 [勘误表](https://github.com/yeasy/blockchain_guide/wiki/%E3%80%8A%E5%8C%BA%E5%9D%97%E9%93%BE%E5%8E%9F%E7%90%86%E3%80%81%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BA%94%E7%94%A8%E3%80%8B2%E7%89%88%E5%8B%98%E8%AF%AF%E8%A1%A8)。

## 推荐阅读

本书是技术丛书的一部分。以下书籍与本书形成互补：

| 书名 | 与本书的关系 |
|------|------------|
| [《Docker 从入门到实践》](https://yeasy.gitbook.io/docker_practice) | 区块链节点的容器化部署与运维实践 |
| [《大模型安全权威指南》](https://yeasy.gitbook.io/ai_security_guide) | 密码学、安全攻防与区块链安全共通 |
| [《智能体 AI 权威指南》](https://yeasy.gitbook.io/agentic_ai_guide) | AI 智能体与区块链结合的前沿探索 |
| [《零基础学 AI》](https://yeasy.gitbook.io/ai_beginner_guide) | AI 基础入门，理解 AI + Web3 融合趋势 |

## 参与贡献

欢迎 [参与维护项目](contribute.md)。

* [修订记录](revision.md)
* [贡献者名单](https://github.com/yeasy/blockchain_guide/graphs/contributors)

## 支持鼓励

欢迎鼓励一杯 coffee~



## 在线交流

欢迎大家加入区块链技术讨论群：

* QQ 群  IV：364824846（可加）
* QQ 群 III：414919574（已满）
* QQ 群  II：523889325（已满）
* QQ 群   I：335626996（已满）

## 许可证

本书采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可证。

您可以自由分享和演绎，但需署名、非商业使用、相同方式共享。

## Star History

[查看《区块链技术指南》的 Star History](https://star-history.com/#yeasy/blockchain_guide&Date)。

---

## File: 01_history/README.md

# 区块链的诞生

**大道无形，链生其中。**

认识新事物，首先要弄清楚它的来龙去脉。知其出身，方能知其所以然。

区块链（Blockchain）结构首次为人关注，源于 2009 年初上线的比特币（Bitcoin）开源项目。从记账科技数千年的演化角度来看，区块链实际上是记账问题发展到分布式场景下的天然结果。

本章将从记账问题的历史讲起，剖析区块链和分布式账本技术的来龙去脉。通过介绍比特币项目探讨区块链的诞生过程，并初步剖析区块链技术潜在的商业价值。

通过阅读本章内容，读者可以了解到区块链思想和技术的起源和背景，以及在商业应用中的巨大潜力。

---

## File: 02_overview/README.md

# 核心技术概览

**设计之妙夺造化，存乎一心胜天工。**

跨境商贸中签订的合同，怎么确保对方能严格遵守和及时执行？

酒店宣称刚打捞上来的三文鱼，怎么追踪捕捞和运输过程中的时间和卫生情况？

数字世界里，怎么证明你是谁？怎么证明某个资产属于你？

囚徒困境中的两个人，怎样才能达成利益的最大化？

宇宙不同文明之间的“黑暗森林”猜疑链，有没有可能被彻底打破？

这些看似很难解决的问题，在区块链的世界里已经有了初步的答案。

本章将带领大家探索区块链的核心技术，包括其定义与原理、关键的问题等，还将探讨区块链技术的演化，并对未来发展的趋势进行展望。最后，对一些常见的认识误区进行了澄清。

---

## File: 03_scenario/README.md

# 典型应用场景

**创新落地，应用为王。**

新的技术能否最终落地得以普及，受很多因素影响，其中最关键一点便是合适的应用场景。

比特币网络支撑了全球范围内的支付交易，成功论证了去中心化系统长时间自治运转的可行性。这引发了对区块链应用潜力的遐想：如果基于区块链技术构造自动运行的商业价值网络，其中的交易自动完成且无法伪造；所有签署的合同都能按照约定严格执行，这将大大提高商业系统协作的效率。从这个意义上讲，人们相信，基于区块链技术构建的未来商业网络，将是继互联网之后又一次巨大的产业变革。

目前，除了金融领域外，在权属追溯、资源共享、物流供应链、征信管理和物联网等诸多领域，也涌现出大量的应用案例。本章将通过剖析这些典型的应用场景，展现区块链技术为不同行业带来的创新潜力。

---

## File: 04_distributed_system/README.md

# 分布式系统核心技术

**万法皆空，因果不空。**

随着摩尔定律碰到瓶颈，分布式架构逐渐流行起来。

从单点演变到分布式结构，重要问题之一就是数据一致性。很显然，如果分布式集群中多个节点处理结果无法保证一致，那么在其上的业务系统将无法正常工作。

区块链系统是一个典型的分布式系统，必然也会碰到这些经典问题。

本章将介绍分布式系统领域的核心技术，包括一致性、共识，介绍这些概念的定义、基本原理和常见算法，最后还介绍了评估分布式系统可靠性的指标。

---

## File: 05_crypto/README.md

# 密码学与区块链安全

**工程领域从来没有黑科技；密码学不仅是工程。**

密码学作为核心的安全技术在信息科技领域的重要性无需多言。离开现代密码学和信息安全技术，人类社会将无法全面步入信息时代。区块链和分布式账本中大量使用了密码学和安全技术的最新成果，特别是身份认证和隐私保护相关技术。

从数学定理到工程实践，密码学和信息安全所涉及的知识体系十分繁杂。本章将介绍与区块链密切相关的安全知识，分为两部分：一是密码学基础，包括 Hash 算法与摘要、加密算法、数字签名和证书、PKI 体系、Merkle 树、布隆过滤器、同态加密、零知识证明等；二是区块链自身的安全实践，包括安全概览、智能合约漏洞与安全开发最佳实践、常见攻击向量、安全审计流程与审计工具。通过本章，读者可以了解常见安全技术体系，以及如何实现信息安全的核心要素：机密性、完整性、可认证性和不可抵赖性，为后续理解区块链的设计奠定基础。

---

## File: 06_bitcoin/README.md

# 比特币 —— 初露锋芒的区块链

**之所以看得更远，是因为站在了巨人的肩膀上。**

作为区块链思想的源头，比特币项目值得区块链技术爱好者们仔细学习和研究。

比特币网络是首个得到大规模部署的区块链平台，也是首个得到长时间实践检验的加密货币实现，无论在科技史还是金融史上都将具有十分重要的意义。比特币项目在诞生和发展过程中，借鉴了加密货币、密码学、博弈论、分布式系统、控制论等多个领域的技术成果，可谓博采众家之长于一身，是集大成者。

后来的区块链技术应用已经超越了加密货币的范畴，但探索比特币项目的发展历程和设计思路，对于深刻理解区块链技术的来龙去脉有着重要的价值。

本章将介绍比特币项目的来源、核心原理设计、相关的工具，以及关键的技术话题。

---

## File: 07_ethereum/README.md

# 以太坊 —— 挣脱加密货币的枷锁

**君子和而不同。**

在区块链领域，以太坊项目同样是十分出名的开源项目。作为公有区块链平台，以太坊将比特币针对数字货币交易的功能进一步进行拓展，面向更为复杂和灵活的应用场景，支持了智能合约（Smart Contract）这一重要特性。

从此，区块链技术的应用场景，从单一基于 UTXO 的数字货币交易，延伸到图灵完备的通用计算领域。用户不再受限于仅能使用比特币脚本所支持的简单逻辑，而是可以自行设计任意复杂的合约逻辑。这就为构建各种多样化的上层应用开启了大门，可谓意义重大。

本章将参照比特币项目来介绍以太坊项目的核心概念和改进设计，以及如何安装客户端和使用智能合约等内容。

---

## File: 08_hyperledger/README.md

# 超级账本 —— 面向企业的分布式账本

**欲戴王冠，必承其重（Uneasy lies the head that wears a crown）。**

超级账本（Hyperledger）项目是全球最大的开源企业级分布式账本平台。

超级账本起源于 Linux 基金会 2015 年启动的开源协作项目；2024 年 9 月，Linux Foundation Decentralized Trust（LF Decentralized Trust，LFDT）正式启动，Hyperledger Foundation 下的区块链、分布式账本和相关技术转为 LFDT 项目。Hyperledger 品牌仍用于 Fabric 等多个项目，但项目治理、生命周期和项目目录应以 LFDT 官方页面为准。

本章将介绍超级账本项目的发展历史和社区组织，以及旗下的多个顶级开源项目的情况，还将展示开源社区提供的多个高效开发工具。最后介绍如何参与到超级账本项目中，进行代码贡献。

---

## File: 09_fabric_deploy/README.md

# Fabric 安装与部署

**纸上得来终觉浅，绝知此事要躬行。**

作为被广泛应用的联盟链项目，Fabric 吸取了来自科技界和金融界的最新成果，提供面向企业场景的开放分布式账本平台实现。

本章将带领读者动手实践，学习如何从源码进行编译、安装 Fabric ，如何使用官方容器镜像，以及在多服务器环境下部署一个典型的 Fabric 网络，同时，还将介绍通道的相关实践操作。

## 版本选择与迁移边界

Hyperledger 项目当前同时提供经典 Fabric 与 Fabric-X 两种不同实现。经典 Fabric 的 2.5.x 是长期支持（LTS）分支，3.x 是引入 `V3_0` 通道能力和 SmartBFT 等特性的后续主版本；Fabric-X 则面向高吞吐数字资产场景，采用 ARMA 排序和解耦的提交架构。它们不是同一条版本号序列。

现状或目标 | 官方定位 | 推荐路径 | 进入下一阶段前的关键检查
--- | --- | --- | ---
经典 Fabric 1.x | 已停止维护的历史分支；仅 v1.4.x 有官方直达 2.5.x 的滚动升级说明 | 先备份；v1.4.x 可按 2.5 文档升级，早于 v1.4 的网络应先按对应历史文档到 v1.4.x，或评估重建网络 | 更新旧链码依赖，执行 Peer 数据库升级，准备 `V2_0` 链码生命周期
经典 Fabric 2.5 LTS | 经典 Fabric 的生产 LTS 分支 | 新部署优先选择最新 2.5.x 补丁；现有 2.x 可滚动升级到 2.5.x | 先升级二进制，再按需启用 `V2_5` 应用能力
经典 Fabric 3.x | 经典 Fabric 的当前功能分支 | 从 2.x 滚动升级；先在 2.x 阶段清除已移除功能 | Kafka/Solo 改为 Raft、旧链码生命周期改为 v2 生命周期、移除系统通道并使用 Channel Participation API、配置组织级 `OrdererEndpoints`
Fabric-X 1.x | 与经典 Fabric 并列的、面向高吞吐数字资产的独立实现 | 作为新平台单独部署和验收，规划应用、身份、治理与数据迁移 | **不是**从经典 Fabric 2.5/3.x 直接替换二进制即可完成的升级；API 或区块格式兼容性不等于受支持的原地升级路径

判断依据以官方资料为准：[Fabric 2.5 LTS 说明](https://hyperledger-fabric.readthedocs.io/en/release-2.5/whatsnew.html)、[从 1.4/2.x 升级到 2.5 的注意事项](https://hyperledger-fabric.readthedocs.io/en/release-2.5/upgrade_to_newest_version.html)、[进入 Fabric 3.x 的前置条件](https://hyperledger-fabric.readthedocs.io/en/latest/upgrade_to_newest_version.html)、[Fabric 与 Fabric-X 的双实现定位](https://www.lfdecentralizedtrust.org/projects/fabric)及 [Fabric-X 路线图](https://www.lfdecentralizedtrust.org/blog/the-hyperledger-fabric-x-roadmap)。具体升级步骤见[运维章节的升级矩阵](../10_fabric_op/upgrade.md)。

--- METRICS ---
- Files Extracted: 11
- Estimated Token Budget: ~2896 tokens
- Recency Window: Active (< 180 days)
- Canonical Reference: https://codewiki.google/github.com/yeasy/blockchain_guide