这次我们来看一个在龙芯 3B6000 平台上安装 Docker 29.5.1 的实战过程。对于使用国产龙芯架构LoongArch的开发者来说直接使用官方仓库的 Docker 版本往往较低而高版本 Docker 带来的新特性和性能优化又是开发部署中迫切需要的。本文将详细拆解如何通过 RPM 包在龙芯 3B6000 上成功部署 Docker 29.5.1并验证其核心功能。整个过程的核心挑战在于解决高版本 Docker 在龙芯平台上的依赖和兼容性问题。我们将从环境准备、依赖包手动编译安装、Docker RPM 包获取与安装到最后的服务验证与基础使用提供一套完整的、可复现的操作指南。如果你正在龙芯平台上构建容器化环境或者对国产化软件生态的适配感兴趣这篇文章将为你提供直接的参考。1. 核心能力速览在开始具体操作前我们先快速了解本次部署的目标和关键信息。能力项说明目标平台龙芯 3B6000 处理器LoongArch 架构目标软件Docker Engine 29.5.1安装方式RPM 包离线安装核心价值在龙芯平台获取较新的 Docker 版本支持更多现代容器特性主要挑战解决高版本依赖如containerd.io,runc的架构适配问题前置要求系统需具备基本的编译环境gcc, make等和网络访问用于下载源码适合场景龙芯平台下的软件开发、测试、CI/CD 流水线搭建等容器化需求2. 适用场景与使用边界在龙芯 3B6000 上安装高版本 Docker主要服务于特定的技术场景和用户群体。适合谁龙芯平台开发者需要在本地进行容器化应用开发、测试和调试。系统运维工程师负责维护基于龙芯服务器的生产或测试环境需要部署和管理容器服务。国产化项目团队项目技术栈要求使用国产芯片并且应用架构基于容器技术。技术爱好者希望深入探索龙芯生态软件适配的细节和过程。能解决什么问题版本滞后解决龙芯官方源 Docker 版本老旧无法使用新功能的问题。环境一致性通过容器确保应用在龙芯开发机与服务器环境的一致性。依赖隔离简化复杂应用的依赖管理避免污染主机系统。现代化部署为在龙芯平台上实践 Kubernetes、微服务等现代架构奠定基础。不适合什么场景对 Docker 版本无要求如果系统自带的 Docker 20.10 等旧版本已满足所有需求则无需折腾。生产环境直接使用本文演示的编译安装方式更适合测试和开发环境。生产环境部署前需进行更充分的稳定性测试。完全离线且无编译能力的环境此过程需要从网络下载源码进行编译纯离线环境需提前准备好所有源码包。安全与合规边界Docker 本身需要特权操作务必在可信的环境中使用。从网络下载源码包时请尽量使用官方仓库或可信源验证文件完整性。在龙芯平台上运行容器同样需遵循镜像安全最佳实践仅使用来自可信仓库的基础镜像。3. 环境准备与前置条件开始安装前请确保你的龙芯 3B6000 系统满足以下条件。操作系统通常为基于 LoongArch 架构的 Linux 发行版如 LoongnixFedora 衍生版、UOS、麒麟等。本文以类 Fedora 系统为例包管理工具为dnf(或yum)。系统更新首先更新系统确保所有已安装的软件包为最新版本并安装必要的开发工具。sudo dnf update -y sudo dnf groupinstall “Development Tools” -y sudo dnf install wget git cmake golang libseccomp-devel -y依赖检查高版本 Docker 依赖较新版本的containerd和runc系统自带版本往往过低我们需要手动编译安装。请先检查现有版本# 检查是否已有旧版 Docker如有可先卸载谨慎操作 sudo dnf remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 检查 containerd 和 runc containerd --version runc --version网络与存储网络需要能够访问 GitHub、官方源码仓库等以下载源码包。磁盘空间确保有足够的空间建议至少 2GB 剩余用于下载源码、编译和安装。4. 安装部署与启动方式由于 Docker 29.5.1 的 RPM 包可能不直接提供 LoongArch 架构版本我们的核心思路是先手动解决关键依赖再安装适配好的 Docker RPM 包。关键在于containerd.io这个包。4.1 编译安装高版本 runcrunc是容器运行时的基础。我们需要从源码编译一个较新的版本。安装 Go 语言环境确保已安装 Go上一步已安装。检查版本go version建议使用 Go 1.20。下载 runc 源码git clone https://github.com/opencontainers/runc.git cd runc # 切换到稳定版本标签例如 v1.1.12 git checkout v1.1.12编译 runcmake编译成功后会在当前目录生成runc二进制文件。安装 runcsudo cp runc /usr/local/bin/ sudo chmod x /usr/local/bin/runc runc --version确认输出版本为1.1.12。4.2 编译安装高版本 containerdcontainerd是 Docker 的核心依赖。下载 containerd 源码git clone https://github.com/containerd/containerd.git cd containerd # 切换到与 Docker 29.5.1 兼容的版本例如 v1.7.16 git checkout v1.7.16编译 containerdmake这个过程可能需要一些时间。安装 containerdsudo make install这会将containerd、ctr等二进制文件安装到/usr/local/bin/。验证安装containerd --version应显示containerd github.com/containerd/containerd v1.7.16 ...。4.3 获取并安装 Docker 29.5.1 RPM 包现在来处理 Docker 本体。我们需要找到或构建一个 LoongArch 架构的 Docker RPM 包。一种可行的方法是从其他已适配的龙芯发行版仓库中查找。寻找 RPM 包 可以尝试在龙芯社区或相关发行版的镜像站搜索。例如有时可以在https://mirrors.loongnix.cn或相关企业的软件仓库中找到较新的 Docker 包。假设我们找到了名为docker-ce-29.5.1-1.lns.loongarch64.rpm的包。下载 RPM 包wget https://镜像站地址/path/to/docker-ce-29.5.1-1.lns.loongarch64.rpm安装 Docker RPM 由于我们已经手动安装了containerd和runc安装 RPM 时应跳过这些依赖否则包管理器会因找不到对应版本的 RPM 包而报错。sudo rpm -ivh --nodeps docker-ce-29.5.1-1.lns.loongarch64.rpm--nodeps参数表示忽略依赖检查。使用此参数需要你非常确定依赖已手动满足。4.4 配置与启动 Docker 服务启动 containerd 服务 Docker 依赖于 containerd。sudo systemctl daemon-reload sudo systemctl enable --now containerd sudo systemctl status containerd启动 Docker 服务sudo systemctl enable --now docker sudo systemctl status docker如果状态显示为active (running)则 Docker 服务已成功启动。验证 Docker 安装sudo docker version查看输出确认Client和Server的版本都是29.5.1。同时运行一个简单的测试容器sudo docker run hello-world如果能看到 “Hello from Docker!” 等欢迎信息说明 Docker 引擎工作正常。5. 功能测试与效果验证安装成功只是第一步我们需要验证 Docker 的核心功能是否完整可用。5.1 基础容器操作测试测试拉取镜像、运行容器、查看容器状态等基本操作。# 1. 拉取一个轻量级镜像 (例如 Alpine Linux) sudo docker pull alpine:latest # 2. 运行一个交互式容器 sudo docker run -it --rm alpine:latest /bin/sh # 在容器内执行命令例如 ls /然后输入 exit 退出 # 3. 以后台方式运行容器 sudo docker run -d --name my-nginx -p 8080:80 nginx:alpine # 4. 检查容器运行状态和日志 sudo docker ps sudo docker logs my-nginx # 5. 访问服务 (在另一终端或使用curl) curl http://localhost:8080 # 6. 停止并删除测试容器 sudo docker stop my-nginx sudo docker rm my-nginx5.2 网络与存储功能测试验证 Docker 网络和卷挂载功能。# 1. 创建自定义网络 sudo docker network create my-net # 2. 运行两个容器加入同一网络并测试互通 sudo docker run -d --name container1 --network my-net alpine:latest tail -f /dev/null sudo docker run -it --rm --name container2 --network my-net alpine:latest ping -c 4 container1 # 3. 测试卷挂载 mkdir ~/docker-test echo “Hello from Host” ~/docker-test/test.txt sudo docker run -it --rm -v ~/docker-test:/data alpine:latest cat /data/test.txt # 应输出 “Hello from Host” # 4. 清理 sudo docker stop container1 sudo docker rm container1 sudo docker network rm my-net5.3 构建镜像测试 (Dockerfile)测试 Docker 的镜像构建能力这是核心开发功能。创建简单的 Dockerfilecat ~/Dockerfile EOF FROM alpine:latest RUN apk add --no-cache curl CMD [“curl”, “--version”] EOF构建镜像cd ~ sudo docker build -t my-curl-test .运行构建的镜像sudo docker run --rm my-curl-test如果成功输出 curl 的版本信息说明 Docker 的构建功能完全正常。6. 资源占用与性能观察在龙芯平台上运行 Docker关注其资源使用情况至关重要。观察服务启动资源占用# 查看 Docker 相关进程 ps aux | grep -E “(dockerd|containerd)” # 使用 top 或 htop 观察内存和 CPU 占用 top -p $(pgrep -d’,’ dockerd containerd)启动后dockerd和containerd进程会常驻占用一定的内存通常几十到上百 MB。观察容器运行时资源占用运行一个容器后可以使用docker stats命令实时查看资源使用情况。sudo docker run -d --name stress-test --memory200m alpine:latest sh -c “while true; do echo ‘test’; sleep 1; done” sudo docker stats stress-test此命令会动态显示容器的 CPU、内存、网络 I/O、块 I/O 使用率。按CtrlC退出。性能考量CPU龙芯 3B6000 为多核处理器Docker 能很好地利用多核进行容器调度和任务处理。内存容器本身内存开销小但运行业务应用时需根据应用需求分配足够内存。I/O容器内文件操作尤其是使用overlay2存储驱动时的 I/O 性能与宿主机直接操作有细微差别对于 I/O 密集型应用需注意。网络Docker 的桥接网络会引入少量性能开销但对大多数应用影响不大。如需高性能网络可考虑使用host网络模式。7. 常见问题与排查方法在龙芯架构上安装高版本 Docker可能会遇到一些特殊问题。问题现象可能原因排查方式解决方案rpm -ivh安装时依赖报错缺少containerd.io等特定版本 RPM 包rpm -qpR docker-ce-*.rpm查看具体依赖使用--nodeps强制安装并确保已手动编译安装对应软件。docker version显示 Server 版本为旧版或报错Docker 服务未成功启动或与手动安装的 containerd 版本不兼容sudo systemctl status docker查看服务状态和日志sudo journalctl -u docker -f检查 containerd 服务是否运行。确认手动安装的 containerd、runc 版本与 Docker 29.5.1 兼容。docker run hello-world失败提示exec format error拉取的hello-world镜像架构不正确可能是 amd64docker image inspect hello-worldgrep Architecturedocker pull速度慢或失败默认镜像仓库docker.io网络连接问题ping registry-1.docker.io配置国内镜像加速器。编辑/etc/docker/daemon.json(不存在则创建)。启动容器提示cgroup相关错误系统未启用或未正确配置 cgroup v2cat /proc/filesystemsgrep cgroup mount端口绑定失败端口已被其他进程占用sudo ss -tulnpgrep :端口号存储驱动问题Docker 使用的存储驱动如overlay2不支持当前文件系统docker infogrep Storage配置镜像加速器示例 (/etc/docker/daemon.json){ “registry-mirrors”: [ “https://docker.mirrors.ustc.edu.cn“, “https://hub-mirror.c.163.com“ ] }修改后需重启 Docker 服务sudo systemctl restart docker。8. 最佳实践与使用建议为了让 Docker 在龙芯 3B6000 上更稳定、高效地运行遵循以下建议系统层面优化内核参数根据实际容器运行需求可能需要调整内核参数如net.ipv4.ip_forward,vm.max_map_count等。可通过sysctl.conf持久化修改。存储路径默认 Docker 数据目录 (/var/lib/docker) 如果位于根分区可能导致磁盘空间不足。可以考虑通过daemon.json中的“data-root”选项将其迁移到大容量分区。Docker 守护进程配置建议创建/etc/docker/daemon.json文件进行集中配置如设置镜像加速器、日志驱动、存储驱动、默认运行时等。对于开发环境可以设置“log-level”: “debug”以便排查问题生产环境建议设为“info”或“warn”。镜像使用策略架构标签龙芯平台是loong64架构。拉取镜像时尽量使用明确支持linux/loong64的镜像。如果镜像支持多架构Docker 会自动选择匹配的版本。镜像源优先使用提供loong64镜像的国内仓库如一些高校和云厂商的镜像站。镜像构建在龙芯平台上构建的镜像天然是loong64架构。如果需要为其他架构构建需要使用buildx等跨平台构建工具。开发与运维习惯非 root 用户运行将需要使用 Docker 的用户加入docker用户组 (sudo usermod -aG docker $USER)之后可以不用sudo执行 docker 命令。注意这会带来安全风险仅限可信用户。资源限制在docker run时使用--memory,--cpus等参数为容器设置资源上限避免单个容器耗尽主机资源。数据持久化对于需要保存的数据务必使用-v参数挂载宿主机目录或使用 Docker Volume避免数据丢失。安全提醒定期更新通过此方式安装的 Docker、containerd、runc 等组件修复安全漏洞。避免在容器内以 root 身份运行不必要的服务。谨慎使用--privileged标志运行容器。在龙芯 3B6000 上成功部署 Docker 29.5.1标志着你能在这个国产平台上使用更现代的容器技术栈。整个过程的关键在于解决核心依赖的编译和兼容性问题。虽然步骤比在 x86 架构上直接yum install繁琐但一旦打通后续的使用体验与主流平台基本无异。建议将编译好的关键二进制文件如特定版本的runc、containerd和 Docker RPM 包进行归档备份便于在同类环境中快速部署。接下来你可以尝试部署 Docker Compose 来管理多容器应用或者探索在龙芯平台上运行 Kubernetes 节点进一步深入国产化容器生态。
原理、排查与预防全指南)
