最近在龙芯 3B6000 平台上部署 AnolisOS 23.4 时，遇到了一个典型问题：通过系统默认仓库安装 Docker 后，容器无法正常创建。这不仅是国产化平台迁移中常见的“水土不服”案例，也涉及到底层架构、内核模块、软件源适配等多个技术环节。本文将系统性地复盘整个问题的排查与解决过程，从环境准备、安装步骤、问题现象、根因分析到最终解决方案，提供一份完整的实战指南。无论你是正在将业务迁移至龙芯平台，还是单纯对 LoongArch 架构下的容器技术感兴趣，都能从中获得可直接复用的经验。1. 背景与核心概念：为什么在龙芯上部署 Docker 是个挑战？在 x86/ARM 架构上，Docker 的安装和使用已经高度标准化，但在龙芯（LoongArch）架构上，情况则复杂得多。这主要源于几个核心差异：1.1 架构差异与软件生态龙芯 3B6000 处理器采用自主的 LoongArch 指令集架构。这意味着所有软件，包括操作系统内核、系统工具链（如 glibc、gcc）以及上层应用（如 Docker），都需要针对该架构进行编译和适配。虽然 AnolisOS（龙蜥操作系统）作为一款优秀的国产 Linux 发行版，已经为 LoongArch 提供了良好的基础支持，但其官方仓库中的软件包版本和兼容性，可能与我们在 x86 上熟悉的 CentOS/Ubuntu 仓库存在差异。1.2 Docker 的架构依赖Docker 并非一个简单的应用程序，它是一套包含客户端、服务端、容器运行时、镜像管理等多个组件的系统。其核心dockerd守护进程深度依赖 Linux 内核的特定功能，如：命名空间（Namespaces）：用于隔离进程、网络、文件系统等。控制组（Cgroups）：用于限制和隔离进程组资源（CPU、内存等）。OverlayFS 等联合文件系统：用于构建高效的容器镜像层。 这些内核功能需要相应的内核模块支持。在龙芯平台上，内核是专门为 LoongArch 编译的，其内置模块和功能开关可能与通用内核不同。1.3 “默认仓库安装”的陷阱“默认仓库安装”通常意味着使用yum install docker或dnf install docker。在 AnolisOS 23.4 中，默认仓库提供的 Docker 包，可能是社区维护的版本，其依赖关系、编译选项、甚至包含的二进制文件，都可能未经过在特定龙芯硬件上的充分测试，尤其是与最新内核版本的匹配度问题，极易引发容器运行时故障。因此，在龙芯平台上部署 Docker，不仅仅是一个安装命令，更是一个涉及系统环境确认、软件源选择、内核兼容性验证和后期调优的系统工程。2. 环境准备与版本说明在开始操作前，请务必确认你的环境与本文一致，这是后续所有排查的基础。2.1 硬件与操作系统环境CPU: 龙芯 3B6000 (LoongArch 架构)操作系统: AnolisOS 23.4内核版本: 通过uname -r命令查看。本文案例基于5.10.xxx-anolis-loongarch64版本内核，这是一个关键信息。权限: 所有操作需要root权限或sudo权限。2.2 基础系统状态检查在安装任何软件前，先对系统做一个健康检查：# 1. 确认系统架构和内核 uname -m # 预期输出：loongarch64 uname -r # 记录下完整的内核版本号，例如：5.10.134-11.2.an8.loongarch64 # 2. 更新系统，确保所有基础包为最新 dnf update -y # 3. 检查关键内核模块是否可用 lsmod | grep -E “overlay|br_netfilter|ip_tables” # 这些模块对于 Docker 运行至关重要。如果未加载，可能是内核未编译进或需要手动加载。3. 通过默认仓库安装 Docker 及问题复现首先，我们按照在 x86 系统上常见的“标准流程”进行安装，并记录下问题现象。3.1 标准安装步骤# 步骤1：安装必要的依赖包 dnf install -y yum-utils device-mapper-persistent-data lvm2 # 步骤2：添加 Docker 官方仓库（这里通常是在x86/ARM上的做法，但在龙芯上可能不适用） # dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # 注意：Docker 官方并未提供 LoongArch 的仓库，此步骤在龙芯上通常会失败或安装错误的架构包。 # 步骤3：从 AnolisOS 默认仓库安装 Docker # 这是本文的核心场景：使用系统自带的仓库 dnf install -y docker docker-client docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 步骤4：启动 Docker 服务并设置开机自启 systemctl start docker systemctl enable docker # 步骤5：验证 Docker 引擎是否安装成功 docker version /
