最近在龙芯 3B6000 上折腾 Docker发现一个挺有意思的现象很多人拿到新机器第一反应就是去官网找最新版本的二进制包或者照着通用教程用curl或yum直接安装。结果往往是依赖报错、版本冲突或者装上了但跑不起来。其实对于龙芯这类采用 LoongArch 架构的平台最稳妥、最高效的方式恰恰是使用系统原生的包管理器从配置好的 RPM 仓库里安装。这不仅能自动解决依赖还能确保安装的是经过适配的最高可用版本比如 Docker 29.5.1。这背后反映了一个更普遍的问题我们习惯了在 x86 生态下“一键安装”的便利却忽略了在不同指令集架构下软件分发的逻辑已经发生了变化。在龙芯平台上盲目追求“最新”不一定是最优解通过官方或社区维护的 RPM 仓库获取“最适合”的版本才是把环境快速搭建起来的关键。今天我们就来完整走一遍在龙芯 3B6000 上通过配置 RPM 仓库自动安装并验证 Docker 29.5.1 的流程并聊聊其中几个容易踩坑的关键点。1. 为什么在龙芯上从 RPM 仓库安装是更优选择在 x86 环境下我们有很多安装 Docker 的途径Docker 官方提供的get.docker.com脚本、各 Linux 发行版的软件源、或者直接下载静态二进制包。这些方法之所以流行是因为背后的生态已经将复杂的依赖关系和架构适配工作做好了。但当环境切换到龙芯的 LoongArch 架构时情况就不同了。直接使用为 x86_64 或 aarch64 编译的脚本和二进制包是行不通的。此时RPM 仓库的价值就凸显出来了。1.1 RPM 仓库解决了架构适配和依赖管理两大核心问题一个为 LoongArch 架构配置好的 RPM 仓库至少做了两件关键事架构适配仓库中的所有软件包包括 Docker 及其所有依赖如containerd、runc、docker-compose-plugin等都是专门为 LoongArch 架构编译的。这确保了二进制文件能在你的龙芯 3B6000 上正确执行。依赖管理Docker 并非一个独立的软件它依赖于一系列底层组件。RPM 仓库通过定义包与包之间的依赖关系让包管理器如yum或dnf能够自动计算并安装所有必需的软件包避免了手动寻找、下载、安装依赖的繁琐和出错风险。相比之下如果你尝试手动编译或使用通用安装脚本很可能在某个依赖库上卡住需要自己解决跨架构的编译问题耗时耗力。1.2 “最高版本”的含义稳定与可用的平衡项目标题里提到的“最高版本 Docker 29.5.1”这里的“最高版本”需要正确理解。它通常不是指 Docker 官方发布的最新绝对版本比如 30.x而是指该 RPM 仓库为 LoongArch 架构所构建、测试并提供的最新稳定版本。这个版本是仓库维护者根据上游源码、LoongArch 架构的补丁、以及与其他系统组件的兼容性综合考量后选定的。因此通过仓库安装 29.5.1你得到的是一个在龙芯平台上经过验证、能稳定工作的版本这远比盲目追求一个未经适配的“绝对最新版”要可靠。2. 前期准备系统环境确认与仓库配置在开始安装之前我们必须先确保基础环境是正确和干净的。这一步做得好能避免至少 80% 的后续问题。2.1 确认系统版本与架构首先登录你的龙芯 3B6000 服务器通过以下命令确认系统信息# 查看操作系统版本这里以麒麟V10或Loongnix为例它们是龙芯平台上常见的发行版 cat /etc/os-release # 明确确认系统架构是否为 LoongArch uname -m输出结果中uname -m应该显示loongarch64。这是后续所有操作的前提。如果你的系统是x86_64或aarch64那么本文的步骤不适用。2.2 清理可能的旧版本 Docker如果你的系统之前通过其他方式安装过 Docker 或类似容器引擎如 podman但默认可能不冲突为了确保纯净安装建议进行清理# 停止可能的 Docker 服务 sudo systemctl stop docker docker.socket containerd # 卸载旧版本 Docker 及相关包 # 注意下面的包名是常见的请根据你系统上实际安装的包名调整 sudo yum remove -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # 删除 Docker 相关数据和配置谨慎操作这会清除所有镜像、容器和网络配置 sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd注意删除/var/lib/docker和/var/lib/containerd会丢失所有本地镜像和容器数据。如果这是生产环境或有重要数据请务必先备份。2.3 配置 LoongArch 架构的 Docker RPM 仓库这是核心步骤。我们需要将包含 Docker 29.5.1 的仓库源添加到系统的包管理器配置中。通常这些仓库由龙芯社区或操作系统发行版维护。以常见的配置为例我们需要创建一个.repo文件# 进入 yum 仓库配置目录 cd /etc/yum.repos.d/ # 创建一个新的仓库配置文件例如 docker-loongarch.repo # 使用你喜欢的编辑器如 vi 或 nano sudo vi docker-loongarch.repo在文件中填入以下内容请注意仓库地址需要根据你实际使用的龙芯系统发行版和版本进行查找和替换以下为示例格式[docker-loongarch] nameDocker CE LoongArch - $basearch # 示例地址请替换为真实可用的仓库地址 # 可能是社区镜像站如https://mirrors.loongnix.cn/docker-ce/linux/loongarch64 # 或发行版特定源如https://pkg.loongnix.cn/loongnix/docker/... baseurlhttps://your-actual-loongarch-docker-repo.mirror/linux/loongarch64 enabled1 gpgcheck1 gpgkeyhttps://your-actual-loongarch-docker-repo.mirror/gpg关键点解析baseurl这是最重要的部分。你需要找到为 LoongArch 提供 Docker CE 的仓库地址。可以搜索“Loongnix 软件源”、“龙芯开源社区镜像站”等关键词来获取最新地址。gpgcheck1和gpgkey启用 GPG 检查可以确保安装的软件包来自可信源未被篡改。你需要同时配置正确的 GPG 密钥地址。如果你不确定确切的地址可以查阅你所使用的龙芯系统发行版的官方文档或社区论坛。保存文件后更新包管理器缓存让系统识别新仓库sudo yum makecache如果缓存更新成功没有报错说明仓库配置基本正确。你可以用以下命令查看该仓库里有哪些可用的 Docker 包sudo yum list available --showduplicates docker-ce --disablerepo* --enablerepodocker-loongarch这条命令会只从我们刚配置的docker-loongarch仓库中列出所有docker-ce的版本。你应该能看到类似29.5.1-1.el8.loongarch64这样的版本信息。3. 执行安装与关键参数解析配置好仓库后安装过程本身非常简单但理解命令背后的选择很重要。3.1 执行安装命令运行以下命令来安装 Docker 引擎、命令行工具和 containerdsudo yum install -y docker-ce docker-ce-cli containerd.io如果你还需要 Docker Compose作为插件形式提供可以一并安装sudo yum install -y docker-compose-plugin发生了什么yum install命令会从我们配置的docker-loongarch仓库中解析docker-ce、docker-ce-cli、containerd.io这些包的依赖关系。由于仓库是为 LoongArch 定制的它会自动选择彼此兼容的版本进行安装其中docker-ce很可能就是仓库中最高的稳定版本 29.5.1。3.2 安装后的基础配置安装完成后不要立即启动。先进行几项关键配置这能让 Docker 用起来更顺手。配置 Docker 守护进程daemon.json创建或编辑/etc/docker/daemon.json文件用于配置 Docker 引擎。一个基础的配置示例如下{ exec-opts: [native.cgroupdriversystemd], log-driver: json-file, log-opts: { max-size: 100m, max-file: 3 }, data-root: /var/lib/docker, storage-driver: overlay2 }native.cgroupdriversystemd对于使用 systemd 的现代 Linux 发行版建议设置为systemd以获得更稳定的资源管理。log-driver和log-opts限制日志文件大小防止磁盘被日志占满。>sudo usermod -aG docker $USER注意执行此操作后你需要退出当前终端会话并重新登录或者开启一个新的终端用户组变更才会生效。4. 启动服务与验证安装配置完成后就可以启动 Docker 并验证其是否正常工作。4.1 启动并设置开机自启# 启动 Docker 服务 sudo systemctl start docker # 设置 Docker 服务开机自启 sudo systemctl enable docker # 查看 Docker 服务状态确认处于 active (running) sudo systemctl status docker如果状态显示为active (running)说明 Docker 守护进程已经成功启动。4.2 运行经典验证命令运行一个最简单的测试容器验证 Docker 引擎、镜像拉取和容器运行功能是否全部正常docker run --rm hello-world这条命令会尝试从 Docker Hub 拉取hello-world镜像如果本地没有然后运行一个容器。如果一切正常你会在终端看到一段 “Hello from Docker!” 的欢迎信息并且容器在输出后自动删除--rm参数作用。4.3 验证安装版本最后确认我们安装的正是期望的版本docker --version # 预期输出Docker version 29.5.1, build xxxxxxx docker-compose version # 如果安装了插件这里会显示版本看到Docker version 29.5.1或更高版本就说明我们通过 RPM 仓库成功安装并运行了龙芯平台上的最高可用稳定版本。5. 进阶考量与长期维护建议成功安装并运行hello-world只是第一步。要让 Docker 在龙芯平台上稳定服务于实际应用还需要考虑以下几个进阶问题。5.1 镜像源加速与架构标签由于网络原因从 Docker Hub 拉取镜像可能较慢。对于 LoongArch 架构还需要注意镜像是否提供了该架构的版本。配置镜像加速器 修改/etc/docker/daemon.json添加registry-mirrors配置。国内用户可以使用一些国内镜像服务{ ... // 之前的配置 registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com ] }修改后需要重启 Docker 服务sudo systemctl restart docker。注意架构标签 并非所有镜像都提供loongarch64版本。在拉取镜像时可以指定标签或者使用--platform参数如果镜像支持多架构。更常见的做法是寻找明确支持 LoongArch 的镜像或者基于已有的基础镜像自行构建。# 尝试拉取指定架构的镜像如果该镜像仓库支持 docker pull --platform linux/loongarch64 nginx:alpine # 查看镜像的架构 docker image inspect nginx:alpine --format{{.Architecture}}5.2 存储与日志管理对于长期运行的生产环境存储和日志管理至关重要。数据存储默认的/var/lib/docker可能位于系统根分区。如果容器或镜像数据量很大建议在安装前就规划好通过daemon.json中的># 检查可用更新 sudo yum check-update docker-ce # 执行更新会同时更新依赖 sudo yum update docker-ce在更新前建议停止重要的容器服务。备份重要的容器数据或使用数据卷volume。在测试环境先行验证。5.4 故障排查思路如果安装或运行过程中出现问题可以按以下顺序排查服务状态sudo systemctl status docker查看是否有启动失败的错误信息。日志分析使用sudo journalctl -u docker.service -f实时查看 Docker 服务日志或者sudo journalctl -u docker.service --since 1 hour ago查看近期日志寻找错误线索。依赖检查确认containerd服务是否正常运行 (systemctl status containerd)。存储驱动检查daemon.json配置是否正确特别是storage-driver。可以尝试暂时注释掉daemon.json用默认配置启动测试。内核模块Docker 需要一些内核模块支持如overlay、br_netfilter。使用lsmod | grep overlay和lsmod | grep br_netfilter检查。通常现代内核已包含但某些精简版系统可能需要手动加载。6. 总结从“能用”到“好用”的思维转变在龙芯 3B6000 上通过 RPM 仓库安装 Docker 29.5.1整个过程看似只是几条命令但其背后体现的是一种适应新架构的软件管理思维。对于 x86 平台我们拥有近乎无限的、即时可用的二进制资源。而在 LoongArch 这样的新兴生态中信任并利用好由社区或发行版维护的官方仓库是最高效、最稳定的路径。它省去了我们手动解决依赖、交叉编译、版本适配的麻烦将我们的精力从“如何装上”解放出来投入到更重要的“如何使用好”上面。这次安装的终点不应只是docker run hello-world的成功输出。真正的起点在于理解这个生态下的软件供给逻辑配置好可持续更新的仓库源规划好存储、网络和日志等生产要素并建立起从安装、验证到更新、排查的完整操作习惯。当你下次需要在龙芯或其他非 x86 架构上部署软件时首先思考“这个生态的官方仓库在哪里”这或许就是本次实践带来的最大价值。
