深入解析 docker-archive/docker-ce:Golang 视角下的 Docker CE 源码剖析
项目地址:https://github.com/docker-archive/docker-ce
这是一个 Go 开发者阅读容器引擎源码的绝佳入口,也是理解”一个工业级 Go 项目如何组织”的活教材。
一、这是什么项目?
docker-archive/docker-ce 是 Docker Community Edition(Docker CE)的官方源码归档仓库。在 2017 年,Docker 公司将 Docker 引擎的代码从原来的 docker/docker 仓库迁移到这里,用于组织 Docker CE 的打包、构建与发布流程,后来在 2019 年前后,Docker 的组件进一步拆分到 moby/moby 等独立仓库中,这个仓库便被归档(archive),进入了只读状态。
需要先厘清一个常见的误解:
| 仓库 | 角色 |
|---|---|
docker-archive/docker-ce(本项目) |
Docker CE 的构建、打包、发布工程的仓库,包含大量组件 Git 子模块(submodules)与构建脚本 |
moby/moby |
Docker 引擎核心(daemon + client)的真正源码 |
opencontainers/runc |
容器运行时(OCI runtime) |
containerd/containerd |
容器生命周期管理 |
换句话说,docker-ce 本身不是引擎核心的一行行 Go 代码,而是一个“组装工厂”:它把 containerd、runc、libnetwork、docker/cli、moby 等真正用 Go 写就的组件作为子模块聚合进来,然后拉取、编译、打包成你在 apt/yum 里安装的 docker-ce。
所以阅读这个仓库,你能学到的不是 daemon 的网络栈实现细节,而是 一个大型 Go 项目族群如何做发布工程。但正因为它引用了大量 Go 子模块,它依然非常适合作为你研究 Docker 源码栈的”导航地图”。
二、仓库结构总览
克隆下来之后,你会看到类似这样的目录布局:
docker-ce/ ├── components/ # 各个子组件的 build 工程(含打包、测试脚本) │ ├── engine/ # moby 引擎组件 │ ├── cli/ # docker CLI (docker/cli) │ ├── containerd/ # containerd │ ├── runc/ # runc │ ├── packaging/ # deb/rpm 打包定义 │ └── ... ├── deb/ # Debian/Ubuntu 包构建入口 ├── rpm/ # RHEL/CentOS/Fedora 包构建入口 ├── hack/ # 各种辅助脚本(下载、校验、release 等) ├── MANIFEST # 组件版本清单,核心文件! ├── VERSION # Docker CE 版本号 ├── Makefile # 顶层构建入口 └── .gitmodules # 关键:所有 Go 组件子模块的地址与版本
对你(Golang 开发者)来说,两个文件至关重要:
MANIFEST—— 声明了每个组件(engine、cli、containerd……)在该次发布中对应的 提交 SHA / 分支。.gitmodules—— 定义每个组件从哪里拉取。
它们一起构成了”可复现构建“的基础:只要签出某个 tag,MANIFEST 就能锁定所有组件的精确版本。
三、构建流程:从 MANIFEST 到 deb 包
以一个 make deb 场景为例,顶层 Makefile 会驱动 hack/ 下的脚本完成:
- 读取
VERSION+MANIFEST,决定各组件版本; - 下载源码 tarball(
hack/download.tgz之类),或直接 clone 子模块; - 进入各组件目录执行 Go 构建(通过
components/engine、components/cli等Makefile调用go build); - 打 deb/rpm 包:
deb/与rpm/下的模板把编译好的二进制(dockerd、docker、containerd、runc、docker-proxy…)塞进包结构; - 签名 / 生成 repo 元数据。
对 Go 开发者有几点非常有参考价值:
- 多组件版本协调:一次发布涉及十几个 Go 仓库(moby、cli、libnetwork、swarmkit、containerd、runc、tini、docker-proxy……)。
MANIFEST用一个”中央清单”锁定它们的 SHA,避免”组件漂移”。这是大型 monorepo / multi-repo 管理的经典范式。 - 构建与源码彻底解耦:本仓库几乎不含业务 Go 代码,全部依赖外部组件。这种做法让”打包工程”可以独立演进而不至于污染引擎源码。
- 可复现性(reproducible build):固定 SHA + 固定构建工具链 + 固定基础镜像,才能让”某版本 docker-ce”在任何机器上产出一致二进制。
给你一个简化示意(实际脚本更复杂,但思路一致):
# 顶层 Makefile 的简化示意 VERSION := $(shell cat VERSION) .PHONY: checkout checkout: @# 依据 .gitmodules 与 MANIFEST 拉取各组件 git submodule update --init --recursive @# 若有 MANIFEST 中指定 SHA,则同步对齐 ./hack/sync-from-manifest.sh .PHONY: build-engine build-engine: $(MAKE) -C components/engine build VERSION=$(VERSION) .PHONY: deb deb: checkout build-engine @# 将二进制与配置塞入 deb 结构 ./hack/make.sh deb
四、Go 组件在这里扮演什么角色?
虽然本仓库以打包为主,但它牵动的核心组件几乎都是 Go 写的。理清它们的职责,对你深入 Go 云原生栈很有帮助:
| 组件 | 语言 | 职责 |
|---|---|---|
moby/moby (dockerd) |
Go | Docker 守护进程,提供 Engine API |
docker/cli (docker) |
Go | 命令行客户端 |
| containerd | Go | 容器运行时管理(镜像、容器生命周期) |
| runc | Go | OCI 运行时,真正调用 clone/pivot_root 等系统调用 |
| libnetwork | Go | CNM 网络模型实现 |
| swarmkit | Go | Swarm 编排 |
| docker-proxy | Go | 端口转发用户态实现 |
| tini | C | PID 1 init 进程 |
如果你曾在 dockerd 里读过 daemon/ 目录,或在 containerd 里追过 runtime/v2/task,你就能明白:docker-ce 仓库的价值,就是把这条从 CLI → daemon → containerd → runc → 内核的调用链完整地”封装成可发布的制品”。当你能顺着一个 docker run 请求把这条链上的每一跳都讲清楚,你对 Go 容器生态的理解就已经上了一个台阶。
五、为什么现在被归档?迁移路径
2017~2019 期间,Docker 逐步把引擎核心迁往 Moby 项目:
- 引擎核心 →
moby/moby - CLI →
docker/cli - 打包定义 → 也在
moby/moby的packaging目录及厂商侧维护
docker-ce 作为”某一段时期官方打包工程”的历史产物被保留下来,只读归档。如果你现在要做现代容器开发,应关注:
moby/mobymoby/buildkit(现代构建后端,强烈建议 Go 开发者研读)containerd/containerdopencontainers/runc
不过,归档 ≠ 无价值。这个仓库仍然是你理解 “Docker 发行体系” 的最佳考古材料。
六、给 Go 开发者的阅读建议
如果你真想从这套仓库里学到东西,我建议按这个顺序走:
- 先读
MANIFEST与.gitmodules:搞清一次发布涉及多少个 Go 仓库、它们的版本如何锁定。 - 追踪一个
docker二进制的诞生:从Makefile→components/cli→ 找到main.go,理解 CLI 如何用 cobra 组织命令。 - 追踪
dockerd:进入moby/moby/cmd/dockerd,看它如何启动 API server、加载 containerd 客户端。 - 追一次容器启动请求:
docker run→ CLI 组 HTTP 请求 → daemon → containerdruntime/v2→ runc。这是理解 Go 云原生编排最核心的一条线。 - 对比打包脚本:看
deb/与rpm/下的规则,理解 Go 二进制如何被分装进系统包、如何写 systemd unit。
七、小结
docker-archive/docker-ce 是一个“被归档但极具教学价值”的仓库。它本身不写业务 Go 代码,却是整个 Docker 生态的发布中枢与版本契约:通过 MANIFEST 锁定十几个 Go 组件的精确版本,通过 components/ 下的构建脚本把它们编译、打包成用户可安装的 docker-ce。
对于 Golang 开发者,它能给你三点关键启发:
- 多仓库版本治理:如何用一份清单协调十几个 Go 仓库的发布;
- 可复现构建:固定 SHA、固定工具链的工程实践;
- 容器技术栈全链路:把 CLI / daemon / containerd / runc 串成一条可追溯的调用链。
读懂它,你不仅读懂了”一个 Go 项目如何被发布”,更读懂了”Docker 这套 Go 生态是如何被组装出来的”。
参考链接
- 仓库主页:https://github.com/docker-archive/docker-ce
- Moby 项目:https://github.com/moby/moby
- containerd:https://github.com/containerd/containerd
- runc:https://github.com/opencontainers/runc
- docker/cli:https://github.com/docker/cli




还没有评论,来说两句吧...