最近在龙芯 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 仓库，至少做了两件关键事：

1. 架构适配：仓库中的所有软件包，包括 Docker 及其所有依赖（如containerd、runc、docker-compose-plugin等），都是专门为 LoongArch 架构编译的。这确保了二进制文件能在你的龙芯 3B6000 上正确执行。
2. 依赖管理：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] name=Docker CE LoongArch - $basearch # 示例地址，请替换为真实可用的仓库地址 # 可能是社区镜像站，如：https://mirrors.loongnix.cn/docker-ce/linux/loongarch64 # 或发行版特定源，如：https://pkg.loongnix.cn/loongnix/docker/... baseurl=https://your-actual-loongarch-docker-repo.mirror/linux/loongarch64 enabled=1 gpgcheck=1 gpgkey=https://your-actual-loongarch-docker-repo.mirror/gpg

关键点解析：

• baseurl：这是最重要的部分。你需要找到为 LoongArch 提供 Docker CE 的仓库地址。可以搜索“Loongnix 软件源”、“龙芯开源社区镜像站”等关键词来获取最新地址。
• gpgcheck=1和gpgkey：启用 GPG 检查可以确保安装的软件包来自可信源，未被篡改。你需要同时配置正确的 GPG 密钥地址。
• 如果你不确定确切的地址，可以查阅你所使用的龙芯系统发行版的官方文档或社区论坛。

保存文件后，更新包管理器缓存，让系统识别新仓库：

sudo yum makecache

如果缓存更新成功，没有报错，说明仓库配置基本正确。你可以用以下命令查看该仓库里有哪些可用的 Docker 包：

sudo yum list available --showduplicates docker-ce --disablerepo='*' --enablerepo='docker-loongarch'

这条命令会只从我们刚配置的docker-loongarch仓库中列出所有docker-ce的版本。你应该能看到类似29.5.1-1.el8.loongarch64这样的版本信息。

3. 执行安装与关键参数解析

配置好仓库后，安装过程本身非常简单，但理解命令背后的选择很重要。

3.1 执行安装命令

运行以下命令来安装 Docker 引擎、命令行工具和 containerd：

sudo 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.cgroupdriver=systemd"], "log-driver": "json-file", "log-opts": { "max-size": "100m", "max-file": "3" }, "data-root": "/var/lib/docker", "storage-driver": "overlay2" }

• native.cgroupdriver=systemd：对于使用 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

    在更新前，建议：

    1. 停止重要的容器服务。
    2. 备份重要的容器数据或使用数据卷（volume）。
    3. 在测试环境先行验证。

    5.4 故障排查思路

    如果安装或运行过程中出现问题，可以按以下顺序排查：

    1. 服务状态：sudo systemctl status docker查看是否有启动失败的错误信息。
    2. 日志分析：使用sudo journalctl -u docker.service -f实时查看 Docker 服务日志，或者sudo journalctl -u docker.service --since "1 hour ago"查看近期日志，寻找错误线索。
    3. 依赖检查：确认containerd服务是否正常运行 (systemctl status containerd)。
    4. 存储驱动：检查daemon.json配置是否正确，特别是storage-driver。可以尝试暂时注释掉daemon.json，用默认配置启动测试。
    5. 内核模块：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 架构上部署软件时，首先思考“这个生态的官方仓库在哪里”，这或许就是本次实践带来的最大价值。