在龙芯 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 包。这通常有三种途径：从操作系统发行版的官方或第三方软件仓库中直接安装。下载针对龙芯架构预编译的二进制包，手动安装并配置服务。从源码编译 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 = 12.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 \