# 零刻 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](https://dl.bee-link.cn/download/dXBsb2Fkcy8lRTYlOEMlODclRTUlOEQlOTcvTUUtUHJvL01FJTIwUHJvJTIwJUU5JUJFJTk5JUU4JThBJUFGLyVFOSVCRSU5OSVFOCU4QSVBRiVFNSVBRSU4OSVFOCVBMyU4NURvY2tlci9pbnN0YWxsLWRvY2tlci5zaA==/h/c9eed95e2fae22f28c076e70b6f29618)
##### 点击上方的附件，跳转下载 `install-docker.sh`。
##### 脚本默认保存到「下载」目录，完整路径为 `/home/用户名/下载`。
[](https://doc.bee-link.com.cn/uploads/images/gallery/2026-10/MZ2l7yrqmcnhogAr-screenshot-2026-10-29-15-51-24.png)
---
## 安装 Docker
### 执行安装脚本
##### 进入脚本所在目录，执行：
```
cd ~/下载
sudo bash install-docker.sh
```
##### 脚本会自动请求 root 权限，随后依次执行以下 8 个步骤：
[](https://doc.bee-link.com.cn/uploads/images/gallery/2026-10/pJxDdh3NH8ExzfA2-screenshot-2026-10-29-15-52-43.png)
1. ##### 检查系统环境
2. ##### 更新软件源
3. ##### 安装 docker
4. ##### 配置守护进程
5. ##### 启动 docker 并设置开机自启
6. ##### 添加用户到 docker 组
7. ##### 注册 compose 插件
8. ##### 验证安装
##### 期间请勿强制中断。
[](https://doc.bee-link.com.cn/uploads/images/gallery/2026-10/e7zG8cJPYSwGmUg6-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 服务、容器运行时与镜像拉取均正常。
[](https://doc.bee-link.com.cn/uploads/images/gallery/2026-10/JVT6FgmAb2w20NkJ-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` 即表示成功。
[](https://doc.bee-link.com.cn/uploads/images/gallery/2026-10/73ILmZJaf9Bw7Q6U-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
}
```
- ##### **registry-mirrors**：docker.io 的镜像加速地址，拉取镜像时优先走这两个站点
- ##### **log-opts**：单个容器日志上限 50MB，最多保留 3 份，避免写满 eMMC
- ##### **live-restore**：重启 docker 服务时容器不中断，升级 docker 时不必先停容器
##### 修改配置后执行 `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` 提供的镜像：
- ##### `lcr.loongnix.cn/library/alpine:3.24`
- ##### `lcr.loongnix.cn/library/debian:sid-slim`
- ##### `lcr.loongnix.cn/library/busybox:latest`
- ##### `lcr.loongnix.cn/library/nginx:1.28.0`
- ##### `lcr.loongnix.cn/library/redis:7.4.1`
- ##### `lcr.loongnix.cn/library/mysql:8.4.6-lns23.1`
- ##### `lcr.loongnix.cn/library/postgres:17-sid`
- ##### `lcr.loongnix.cn/library/python:3.11.7`
- ##### `lcr.loongnix.cn/library/node:22.15-alpine3.21`
##### 拉取时使用完整地址：
```
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
```
[](https://doc.bee-link.com.cn/uploads/images/gallery/2026-10/l9Tk9PZqrCTkK2Ed-screenshot-2026-10-29-16-37-17.png)
## 可选参数
- ##### `--no-mirror`：不配置镜像加速，`daemon.json` 中仅保留日志与 live-restore 设置
- ##### `--skip-test`：跳过测试容器，适用于网络较慢的环境
- ##### `--user 用户名`：指定加入 docker 组的用户，使用 sudo 执行时自动识别
- ##### `--force`：跳过架构校验，不建议添加该参数。
- ##### `-h`：查看用法