Docker 基础命令介绍和常见报错解决

介绍一些 docker 可能用到的基础命令，并解决三个常见报错：

• 权限被拒绝（Permission Denied）
• 无法连接到 Docker 仓库（Timeout Exceeded）
• 磁盘空间不足（No Space Left on Device）

命令以适用于深度学习的 dl 镜像为例进行演示。

Docker 安装见《用两行命令快速搭建深度学习环境（Docker/torch2.5.1+cu118/命令行美化+插件），包含完整的 Docker 安装步骤》

镜像管理

写在前面

如果不想每次运行都使用 sudo 开头，使用以下命令：

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

查看本地镜像

docker images

列出本地所有的 Docker 镜像，包括仓库名、标签、镜像 ID、创建时间和大小。

拉取镜像

docker pull <image_name>:<tag>

例如：

docker pull hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel

docker pull 可以更新镜像，此时下载数据量较小，不严谨地类比为 git pull 进行理解。

删除镜像

docker rmi <image_id_or_name>

注意： 删除镜像前，确保没有容器正在使用它。

创建容器

以当前使用的命令为例：

docker run --gpus all -it hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel

先来解释一下 --gpus all 和 -it 的作用：

• --gpus all：允许容器使用主机的所有 GPU 资源。
• -it：这是两个参数的组合，-i 表示“交互式”（interactive），-t 表示为容器分配一个伪终端（pseudo-TTY）。-it 组合使用可以获得完整的交互式终端体验。

使用 docker run --help 可以查看更多参数的用法。

如果在执行 Docker 命令时遇到权限问题，可以在命令前加上 sudo。

挂载

如果需要在容器内访问主机的文件，可以使用 -v 参数。

1. 卷挂载

   docker run --gpus all -it -v my_volume:container_path hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel
   

   • my_volume：Docker 卷的名称。
   • container_path：容器中的路径。

   这样，保存在该路径的数据在容器删除后仍会保存在 my_volume 中。

2. 绑定主机目录到容器中

   docker run --gpus all -it -v /home/your_username/data:/workspace/data hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel
   

   • /home/your_username/data：主机上的目录路径。
   • /workspace/data：容器内的挂载点。

在容器中启动 Jupyter Lab

如果需要在容器内启动 Jupyter Lab，并通过主机的浏览器进行访问，可以使用 -p 参数映射端口。Jupyter Lab 默认使用 8888 端口，使用以下命令：

docker run --gpus all -it -p 8888:8888 hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel

• -p 8888:8888 将容器内的 8888 端口映射到主机的 8888 端口。

然后在容器内运行：

jupyter lab --ip=0.0.0.0 --port=8888 --no-browser --allow-root

现在可以在主机浏览器中访问 http://localhost:8888。

停止容器

在容器终端内

• 使用 Ctrl+D 或输入 exit：退出并停止容器（适用于通过 docker run 启动的情况）。
• 使用 Ctrl+P 然后 Ctrl+Q：仅退出容器的终端（detach），让容器继续在后台运行。

以上的“停止”行为适用于通过 docker run 启动的容器。如果容器是通过 docker start 启动的，Ctrl+D 或 exit 只会退出终端，而不会停止容器。通过 docker ps 可以察觉到这一点。

从主机停止容器

如果你想从主机停止正在运行的容器，可以使用：

docker stop <container_id_or_name>

替换 <container_id_or_name> 为容器的 ID 或名称。

重新连接到已存在的容器

在使用一段时间后，你可能会发现每次使用 docker run 去“运行”容器时，之前所做的改变都“没有”保存。

这是因为每次运行 docker run 创建了新的容器。

要找回在容器中的更改，需要重新连接到之前创建的容器。

查看所有容器

docker ps -a

• docker ps：默认只显示正在运行的容器。
• -a：显示所有容器，包括已停止的。

启动已停止的容器

如果目标容器已停止，可以使用以下命令将其重新启动：

docker start <container_id_or_name>

替换 <container_id_or_name> 为容器的 ID 或名称。

重新连接到运行中的容器

使用 docker exec：

docker exec -it <container_id_or_name> /bin/bash

• /bin/bash：在容器内启动一个 Bash Shell。
• 在 docker run 命令末尾也可添加 /bin/bash。

在之前的命令中，我们使用了 /bin/zsh，这是因为该容器中已安装了 zsh。而在大多数容器中，默认的行为通常是 /bin/bash 或 /bin/sh。

命名容器

有没有什么方法可以指定名称呢？每次通过 docker ps -a 复制 id 太不优雅了。

使用 --name 参数

在创建容器时，可以使用 --name 参数为容器指定一个名称。例如：

docker run --gpus all -it --name ai hoperj/quickstart:dl-torch2.5.1-cuda11.8-cudnn9-devel

容器被命名为 ai，以后可通过该名称管理容器，不需要记住容器的 ID。

运行 docker ps -a：

使用容器名称的命令示例

• 启动容器：

  docker start ai
  

• 停止容器：

  docker stop ai
  

• 重新连接到容器：

  docker exec -it ai /bin/bash
  

复制文件

从主机复制文件到容器

docker cp /path/on/host <container_id_or_name>:/path/in/container

从容器复制文件到主机

docker cp <container_id_or_name>:/path/in/container /path/on/host

删除容器

删除指定的容器

如果想删除一个容器，可以使用 docker rm 命令：

docker rm <container_id_or_name>

例如，删除名为 ai 的容器：

docker rm ai

注意： 需要先停止容器才能删除。

删除所有未使用的容器

我们可以使用以下命令来删除所有处于“已退出”状态的容器：

docker container prune

这将删除所有已停止的容器（请谨慎使用，因为删除后无法恢复，适用于刚安装 Docker “不小心”创建了一堆容器）。

解决常见报错

介绍在新环境中使用 Docker 时，可能会遇到的报错。

推荐阅读，特别是报错 2。

报错 1：权限被拒绝（Permission Denied）

当运行命令：

docker ps

可能会遇到以下报错：

permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get “http://%2Fvar%2Frun%2Fdocker.sock/v1.45/containers/json”: dial unix /var/run/docker.sock: connect: permission denied

解决方法：

方法 1：使用 sudo

在 Docker 命令前加上 sudo：

sudo docker ps

方法 2：将用户添加到 docker 用户组

1. 创建 docker 用户组

   sudo groupadd docker
   

2. 将当前用户添加到 docker 组

   sudo usermod -aG docker $USER
   

3. 重新加载用户组设置

   newgrp docker
   

4. 验证

   运行 Docker 命令，如果不提示权限错误（permission denied），说明配置成功。

   docker ps	
   

报错 2：无法连接到 Docker 仓库（Timeout Exceeded）

Error response from daemon: Get “https://registry-1.docker.io/v2/”: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

原因： 由于国内网络限制，无法直接连接到 Docker Hub。

解决方法：

方法一：配置镜像

镜像参考：目前国内可用Docker镜像源汇总（截至2024年11月）

临时使用：

直接在原 <image_name>:<tag> 前增加网址，比如：

docker pull dockerpull.org/<image_name>:<tag>

快速测试可用性：

docker pull dockerpull.org/hello-world

永久使用：

运行以下命令配置文件，如果有一天突然拉（pull）不动了，说明链接挂了需要更新。

# 创建目录
sudo mkdir -p /etc/docker

# 写入配置文件
sudo tee /etc/docker/daemon.json > /dev/null <<-'EOF'
{
    "registry-mirrors": [
        "https://docker.unsee.tech",
        "https://dockerpull.org",
        "https://docker.1panel.live",
        "https://dockerhub.icu"
    ]
}
EOF

# 重启 Docker 服务
sudo systemctl daemon-reload
sudo systemctl restart docker

方法二：设置 HTTP/HTTPS 代理

这一项提供给🪜科学上网的同学进行配置。对于本项目来说，所有文件都会提供网盘链接和对应的国内镜像命令。

1. 创建并编辑 Docker 的系统服务配置文件

   sudo mkdir -p /etc/systemd/system/docker.service.d
   sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf
   

2. 添加代理配置

   在 http-proxy.conf 文件中添加以下内容（将 http://localhost:7890/ 替换为你自己的代理地址）：

   [Service]
   Environment="HTTP_PROXY=http://localhost:7890/"
   Environment="HTTPS_PROXY=http://localhost:7890/"
   

   使用 ESC + :wq 回车保存配置。

   如果不熟悉 vim 的操作，也可以使用直接运行（将 http://localhost:7890/ 替换为你自己的代理地址）：

   sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf > /dev/null <<EOF
   [Service]
   Environment="HTTP_PROXY=http://localhost:7890/"
   Environment="HTTPS_PROXY=http://localhost:7890/"
   EOF
   

3. 重新加载配置并重启 Docker 服务

   sudo systemctl daemon-reload
   sudo systemctl restart docker
   

报错 3: 磁盘空间不足（No Space Left on Device）

write /var/lib/docker/tmp/…: no space left on device

原因： Docker 默认使用 /var/lib/docker 作为数据存储目录，如果该分区空间不足，就会出现此错误。

解决方法：

更改 Docker 的数据目录

1. 查看当前的磁盘空间

   检查 /var/lib/docker 所在分区的剩余空间：

   sudo df -h /var/lib/docker
   

   

   2.3G 显然不够。

2. 选择具有足够空间的目录

   假设将 Docker 的数据目录移动到 ~/Downloads 下，先看看剩余空间：

   

   显示还有 53G，绰绰有余，接着创建文件夹：

   mkdir -p ~/Downloads/Docker && cd ~/Downloads/Docker && pwd
   

   

   复制输出。

3. 修改 Docker 的配置文件

   编辑 /etc/docker/daemon.json 文件（如果不存在会自动创建）：

   sudo vim /etc/docker/daemon.json
   

   添加或修改以下内容（将 Path/to/Docker 替换为你的新数据目录的绝对路径，也就是刚刚复制的输出）：

   { 
      "data-root": "Path/to/Docker"
   }
   

   ESC + :wq保存并退出。

   

4. 重启 Docker 服务并验证

   sudo systemctl restart docker
   docker info -f '{{ .DockerRootDir}}'
   

   输出：

参考链接

How to Fix Docker’s No Space Left on Device Error