零刻 ME Pro 龙芯安装 Docker 教程

Docker 官方仓库未提供 loong64 架构的软件包，执行官方安装脚本会提示找不到软件包。本教程使用 Loongnix 软件源中的 docker.io，安装后得到 Docker 26.1.5、containerd 1.7.24 与 docker compose 2.26.1。
注意：Docker 镜像是分 CPU 架构的。龙芯为 loong64 架构，Docker Hub 上大部分镜像只提供 amd64 和 arm64 版本，直接拉取会提示 no matching manifest for linux/loong64。部署项目前请先确认该项目是否提供 loong64 镜像。

准备工作

龙芯 install-docker.sh

点击上方的附件，跳转下载 install-docker.sh。
脚本默认保存到「下载」目录，完整路径为 /home/用户名/下载。

Screenshot_2026-10-29_15-51-24.png

安装 Docker

执行安装脚本

进入脚本所在目录，执行：
cd ~/下载
sudo bash install-docker.sh
脚本会自动请求 root 权限，随后依次执行以下 8 个步骤：

Screenshot_2026-10-29_15-52-43.png

  1. 检查系统环境
  2. 更新软件源
  3. 安装 docker
  4. 配置守护进程
  5. 启动 docker 并设置开机自启
  6. 添加用户到 docker 组
  7. 注册 compose 插件
  8. 验证安装
期间请勿强制中断。

Screenshot_2026-10-29_15-52-46.png

验证安装

脚本完成后会输出以下结果：
8/8  验证安装
    客户端 26.1.5+dfsg1　服务端 26.1.5+dfsg1
    存储驱动 overlay2　运行时 runc　Cgroup systemd
    拉取测试镜像 lcr.loongnix.cn/library/alpine:3.24
    容器运行正常，输出 loongarch64
出现「容器运行正常，输出 loongarch64」，即表示 Docker 服务、容器运行时与镜像拉取均正常。

Screenshot_2026-10-29_15-53-50.png

注意：如安装时添加了 --skip-test 跳过测试，或当时镜像拉取失败，可在网络恢复后执行 docker run --rm lcr.loongnix.cn/library/alpine:3.24 uname -m 补做验证，输出 loongarch64 即表示容器可正常运行。

使 docker 组权限生效

脚本将当前用户加入 docker 组后，组权限在新的会话中生效。如需立即生效，执行：
newgrp docker
后续重启系统即可永久生效。
执行 docker ps 不会提示 permission denied 即表示成功。

Screenshot_2026-10-29_15-54-21.png

配置文件说明

脚本写入的 /etc/docker/daemon.json 内容如下：
{
  "registry-mirrors": ["https://docker.m.daocloud.io", "https://docker.1ms.run"],
  "log-driver": "json-file",
  "log-opts": { "max-size": "50m", "max-file": "3" },
  "live-restore": true
}
修改配置后执行 sudo systemctl restart docker 生效。

常见问题

提示 no matching manifest for linux/loong64

Docker Hub 上的镜像大多未提供 loong64 版本，换用 lcr.loongnix.cn 提供的镜像即可。

提示 permission denied while trying to connect to the Docker daemon socket

当前用户尚未加入 docker 组，执行 newgrp docker，或注销后重新登录。

脚本停留在「检测到其他 apt 进程正在运行」

系统正在执行自动更新，dpkg 锁被占用。等待其结束后重新执行脚本即可，重复执行不会破坏已安装的环境。

测试镜像拉取失败

不影响 Docker 本身，执行 docker version 确认服务正常，网络恢复后单独执行 docker pull 即可。

镜像来源

Docker 引擎装好之后，命令、compose 文件、数据卷、网络的使用方式与其他系统完全一致，唯一的区别在镜像本身。龙芯为 loong64 架构，请使用龙芯官方仓库 lcr.loongnix.cn 提供的镜像：
拉取时使用完整地址：
docker pull lcr.loongnix.cn/library/nginx:1.28.0
编写 Dockerfile 时，将 FROM 指向上述地址：
FROM lcr.loongnix.cn/library/python:3.11.7
WORKDIR /app
COPY . .
CMD ["python", "main.py"]
如需使用短名称，可先打标签：
docker tag lcr.loongnix.cn/library/nginx:1.28.0 nginx:1.28.0
只发布 amd64 镜像的闭源软件无法在龙芯上运行。部署其他项目前，请先确认其是否提供 loong64 版本，可查看镜像仓库页面标注的支持架构，或查阅项目文档。

卸载 Docker

脚本安装的软件包包含 docker.io、docker-cli、docker-buildx、docker-compose、containerd、runc、tini。仅卸载 docker.io 会残留其余软件包，docker 命令仍然存在，需整组卸载：
sudo systemctl stop docker.socket docker.service containerd
sudo apt-get purge -y 'docker*' 'containerd*' runc tini
sudo apt-get autoremove -y
sudo rm -rf /var/lib/docker /var/lib/containerd /etc/docker /usr/local/lib/docker /run/docker /run/docker.sock
sudo delgroup docker

Screenshot_2026-10-29_16-37-17.png

可选参数

Revision #1
Created 2026-10-29 16:37:58 CST by xiaoshao
Updated 2026-10-29 16:47:15 CST by xiaoshao