龙芯3B6000平台部署Docker 29.5.1：从环境准备到生产实践

在龙芯 3B6000 这样的国产自主 CPU 架构上部署 Docker，尤其是安装较新的 29.5.1 版本，会遇到与 x86_64 或 ARM64 平台截然不同的依赖、包管理和兼容性问题。龙芯平台基于 MIPS64 架构，其软件生态主要依赖 Loongnix、UOS、Kylin 等国产操作系统，这些系统通常使用 RPM 包管理。直接从 Docker 官方仓库下载的二进制包或通用 RPM 包往往无法直接运行，需要寻找或编译适配龙芯架构的版本。本文将详细讲解在龙芯 3B6000 平台上，如何从零开始准备环境、获取适配的 RPM 包、完成 Docker 29.5.1 的安装、配置、验证，并解决安装过程中可能遇到的核心问题。

1. 理解龙芯平台 Docker 安装的特殊性

在 x86_64 或 ARM64 平台上，安装 Docker 通常只需几条命令，通过官方仓库即可完成。但在龙芯 3B6000 上，情况要复杂得多。首先，Docker 官方并未为龙芯（LoongArch）架构提供预编译的二进制包或 RPM 包。其次，龙芯平台的软件生态主要围绕国产操作系统构建，其内核版本、Glibc 版本、系统服务管理方式可能与主流的 CentOS、Ubuntu 有差异。最后，Docker 29.x 版本引入了一些新特性（如默认使用 containerd 镜像存储），对内核和系统组件有新的要求。

因此，在龙芯 3B6000 上安装 Docker 29.5.1 的核心思路是：寻找或构建针对龙芯架构（LoongArch64）的 Docker RPM 包。这通常有三种途径：

1. 从操作系统发行版的官方或第三方软件仓库中直接安装。
2. 下载针对龙芯架构预编译的二进制包，手动安装并配置服务。
3. 从源码编译 Docker 及其依赖，并打包成 RPM。

对于大多数用户，第一种方式是最直接、最稳定的。本文将重点介绍在基于 RPM 包管理的国产操作系统（如 Loongnix Server、统信 UOS Server、麒麟 V10）上，如何完成安装。

2. 安装前的环境检查与准备

在开始安装之前，必须对系统环境进行彻底检查，确保满足 Docker 29.5.1 的基本运行要求。不满足这些前置条件，后续安装步骤大概率会失败。

2.1 确认系统与架构信息

首先，通过命令行确认你的系统确实是运行在龙芯 3B6000 上，并且操作系统是基于 RPM 的。

# 查看 CPU 架构信息 uname -m # 预期输出应为：loongarch64 # 查看内核版本 uname -r # 记录下内核版本，例如：4.19.190-6.4.lns8.loongarch64 # Docker 29.x 通常需要内核版本 >= 3.10（建议 4.x 以上） # 查看操作系统发行版信息 cat /etc/os-release # 或 cat /etc/system-release # 预期会看到类似 `Loongnix Server 8`、`UnionTech OS Server 20`、`Kylin Linux Advanced Server release V10` 的信息

2.2 检查关键系统依赖

Docker 依赖一些特定的内核模块和用户空间工具。使用以下命令检查它们是否可用：

# 1. 检查 cgroup 支持 # Docker 需要 cgroup 来管理容器资源。cgroup v1 已废弃，v2 是未来方向。 # 检查当前 cgroup 版本 grep cgroup /proc/filesystems # 如果输出包含 `cgroup2`，则系统使用 cgroup v2，这是 Docker 29.x 推荐的。 # 如果只有 `cgroup`，则是 cgroup v1，Docker 29.x 仍支持但已废弃。 # 检查 cgroup 挂载点 mount | grep cgroup # 确保有类似 `cgroup2 on /sys/fs/cgroup type cgroup2 (rw,nosuid,nodev,noexec,relatime)` 的输出。 # 2. 检查 OverlayFS 支持 # OverlayFS 是 Docker 默认的存储驱动，需要内核模块支持。 lsmod | grep overlay # 如果没有任何输出，尝试加载模块 sudo modprobe overlay # 再次检查。如果加载失败，说明内核编译时未包含 OverlayFS 支持，这是一个严重问题。 # 3. 检查网络过滤器和桥接支持 # Docker 需要 iptables 或 nftables 进行网络管理。 lsmod | grep -E '(br_netfilter|bridge|nf_conntrack)' sudo modprobe br_netfilter sudo modprobe bridge # 4. 检查必要的用户空间工具 # `device-mapper-persistent-data` 和 `lvm2` 是 devicemapper 存储驱动（旧版）的依赖，虽然现在默认是 overlay2，但最好安装。 # `yum-utils` 提供了 `yum-config-manager` 工具，用于管理仓库。 # 检查它们是否已安装 rpm -qa | grep -E '(device-mapper-persistent-data|lvm2|yum-utils)'

2.3 配置系统参数

为了让 Docker 正常工作，需要修改一些内核参数并确保它们在重启后依然生效。

# 编辑 sysctl 配置文件 sudo vi /etc/sysctl.d/99-docker.conf

将以下内容添加到文件中：

# 启用 IP 转发，这是容器网络通信的基础 net.ipv4.ip_forward = 1 net.ipv6.conf.all.forwarding = 1 # 启用桥接网络的数据包过滤和传递 net.bridge.bridge-nf-call-iptables = 1 net.bridge.bridge-nf-call-ip6tables = 1 # 如果使用 cgroup v2，可能需要设置内存限制相关参数（非必须，但建议） vm.overcommit_memory = 1 kernel.panic_on_oops = 1

保存并退出编辑器，然后应用配置：

# 重新加载 sysctl 配置 sudo sysctl --system # 或 sudo sysctl -p /etc/sysctl.d/99-docker.conf # 验证关键参数是否生效 sysctl net.ipv4.ip_forward net.bridge.bridge-nf-call-iptables # 预期输出应为： # net.ipv4.ip_forward = 1 # net.bridge.bridge-nf-call-iptables = 1

2.4 清理旧版本 Docker

如果你的系统上曾经安装过旧版本的 Docker（可能叫docker、docker-engine或docker-ce），必须先彻底清理，避免冲突。

# 停止 Docker 服务 sudo systemctl stop docker sudo systemctl stop docker.socket sudo systemctl stop containerd # 卸载旧版本 Docker 及相关包 sudo yum remove -y docker \ docker-client \ docker-client-latest \ docker-common \ docker-latest \ docker-latest-logrotate \ docker-logrotate \