Docker Configuration
记录 Docker 的免 sudo 权限、守护进程与容器的代理配置、容器内使用 NVIDIA 显卡,以及显示 ROS 图形界面的方法
Linux系列:第 4 篇,共 4 篇
Ubuntu 的系统配置、常用命令行工具、文件系统挂载和 Docker
- Docker Configuration
权限设置
Docker 进程默认是以 root 用户运行的,免 sudo 运行需要将用户添加到docker组中
1
2
3
4
5
# 创建docker组
sudo groupadd docker
# 将用户添加到docker组
sudo usermod -aG docker $USER
重新登录(或执行newgrp docker)后即可免 sudo 运行 Docker。注意:docker组成员等同于拥有 root 权限,只应添加可信用户
代理配置
守护进程代理
Docker 的守护进程(dockerd)默认不会走代理,需要在进程服务文件夹配置代理设置。该配置只影响 dockerd 本身(如拉取/推送镜像),不会作用于容器内网络和docker build中的RUN步骤
1
sudo mkdir -p /etc/systemd/system/docker.service.d
1
sudo vim /etc/systemd/system/docker.service.d/proxy.conf
在代理文件中,添加代理信息,以 clash-verge 为例
1
2
3
4
[Service]
Environment="HTTP_PROXY=http://127.0.0.1:7897"
Environment="HTTPS_PROXY=http://127.0.0.1:7897"
Environment="NO_PROXY=localhost,127.0.0.1"
最后重新加载 systemd 配置,并重启 Docker
1
2
sudo systemctl daemon-reload
sudo systemctl restart docker
1
docker info
如果输出了代理信息即配置成功
容器代理
容器内的程序和docker build中的RUN步骤使用的代理,在~/.docker/config.json中配置,之后新建的容器和构建过程会自动带上对应的环境变量
1
2
3
4
5
6
7
8
9
{
"proxies": {
"default": {
"httpProxy": "http://172.17.0.1:7897",
"httpsProxy": "http://172.17.0.1:7897",
"noProxy": "localhost,127.0.0.1"
}
}
}
容器内的127.0.0.1指向容器自身,访问宿主机上的代理要使用宿主机在docker0网桥上的地址(默认为172.17.0.1),同时代理软件需要允许来自局域网的连接。使用--net=host的容器与宿主机共享网络,可以直接使用127.0.0.1
只想对单个容器生效时,可以在启动时通过-e传入
1
docker run -it -e HTTP_PROXY=http://172.17.0.1:7897 -e HTTPS_PROXY=http://172.17.0.1:7897 ubuntu:24.04
GPU 支持
容器内使用 NVIDIA 显卡需要安装nvidia-container-toolkit。宿主机上要先装好显卡驱动,容器内不需要再安装驱动,CUDA 等运行库由镜像提供
1
2
3
4
5
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | \
sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
1
2
sudo apt update
sudo apt install -y nvidia-container-toolkit
1
2
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker
1
docker run --rm --gpus all ubuntu:24.04 nvidia-smi
能输出与宿主机相同的显卡信息即配置成功
1
docker run --rm --gpus '"device=0,1"' ubuntu:24.04 nvidia-smi
使用docker compose时,在服务中声明所需的设备
1
2
3
4
5
6
7
8
9
10
11
services:
app:
image: ubuntu:24.04
command: nvidia-smi
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: all
capabilities: [gpu]
Docker ROS 可视化
需要配置 Docker 以便支持 X11 显示系统,用于图形界面显示。以osrf中的ros:humble-desktop为例。 在容器外的终端执行如下命令,允许本机的本地连接访问 X server
1
xhost +local:
不要使用xhost +,它会关闭 X server 的访问控制,网络上任何主机都可连接并截屏、记录键盘输入。使用完毕后执行xhost -local:恢复
随后启动容器
1
2
3
4
5
6
7
docker run -it \
--net=host \
--env="DISPLAY" \
--env="QT_X11_NO_MITSHM=1" \
--volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" \
--name ros_rviz_container \
osrf/ros:humble-desktop
即可使用rviz2等进行可视化显示
参数说明:
| 参数 | 说明 |
|---|---|
--net=host | 使 Docker 容器共享主机的网络环境,这样 ROS 可以正常通信 |
--env="DISPLAY" | 将主机的 DISPLAY 环境变量传递给容器,允许容器中的 GUI 程序使用主机的显示 |
--env="QT_X11_NO_MITSHM=1" | 防止共享内存导致的图形渲染问题 |
--volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" | 允许容器访问主机的 X11 unix socket |
需要在容器内使用显卡渲染(如gazebo、rviz2)时,在安装nvidia-container-toolkit后加上以下参数
1
2
--gpus all \
--env="NVIDIA_DRIVER_CAPABILITIES=all" \