介绍一些 docker 可能用到的基础命令,并解决三个常见报错:
- 权限被拒绝(Permission Denied)
- 无法连接到 Docker 仓库(Timeout Exceeded)
- 磁盘空间不足(No Space Left on Device)
命令以适用于深度学习的 dl 镜像为例进行演示。
Docker 安装见《用两行命令快速搭建深度学习环境(Docker/torch2.5.1+cu118/命令行美化+插件),包含完整的 Docker 安装步骤》
文章目录
- 镜像管理
- 查看本地镜像
- 拉取镜像
- 删除镜像
- 创建容器
- 挂载
- 在容器中启动 Jupyter Lab
- 停止容器
- 在容器终端内
- 从主机停止容器
- 重新连接到已存在的容器
- 查看所有容器
- 启动已停止的容器
- 重新连接到运行中的容器
- 命名容器
- 使用 `--name` 参数
- 使用容器名称的命令示例
- 复制文件
- 从主机复制文件到容器
- 从容器复制文件到主机
- 删除容器
- 删除指定的容器
- 删除所有未使用的容器
- 解决常见报错
- 报错 1:权限被拒绝(Permission Denied)
- 方法 1:使用 `sudo`
- 方法 2:将用户添加到 `docker` 用户组
- 报错 2:无法连接到 Docker 仓库(Timeout Exceeded)
- 方法一:配置镜像
- 方法二:设置 HTTP/HTTPS 代理
- 报错 3: 磁盘空间不足(No Space Left on Device)
- 更改 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
参数。
-
卷挂载
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
中。 -
绑定主机目录到容器中
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
用户组
-
创建
docker
用户组sudo groupadd docker
-
将当前用户添加到
docker
组sudo usermod -aG docker $USER
-
重新加载用户组设置
newgrp docker
-
验证
运行 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 代理
这一项提供给🪜科学上网的同学进行配置。对于本项目来说,所有文件都会提供网盘链接和对应的国内镜像命令。
-
创建并编辑 Docker 的系统服务配置文件
sudo mkdir -p /etc/systemd/system/docker.service.d sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf
-
添加代理配置
在
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
-
重新加载配置并重启 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 的数据目录
-
查看当前的磁盘空间
检查
/var/lib/docker
所在分区的剩余空间:sudo df -h /var/lib/docker
2.3G 显然不够。
-
选择具有足够空间的目录
假设将 Docker 的数据目录移动到
~/Downloads
下,先看看剩余空间:显示还有 53G,绰绰有余,接着创建文件夹:
mkdir -p ~/Downloads/Docker && cd ~/Downloads/Docker && pwd
复制输出。
-
修改 Docker 的配置文件
编辑
/etc/docker/daemon.json
文件(如果不存在会自动创建):sudo vim /etc/docker/daemon.json
添加或修改以下内容(将
Path/to/Docker
替换为你的新数据目录的绝对路径,也就是刚刚复制的输出):{ "data-root": "Path/to/Docker" }
ESC
+:wq
保存并退出。 -
重启 Docker 服务并验证
sudo systemctl restart docker docker info -f '{{ .DockerRootDir}}'
输出:
参考链接
How to Fix Docker’s No Space Left on Device Error