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

发布时间:2026/7/25 6:43:57
龙芯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 包。这通常有三种途径:从操作系统发行版的官方或第三方软件仓库中直接安装。下载针对龙芯架构预编译的二进制包,手动安装并配置服务。从源码编译 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 \