Post

Docker Configuration

记录 Docker 的免 sudo 权限、守护进程与容器的代理配置、容器内使用 NVIDIA 显卡,以及显示 ROS 图形界面的方法

Docker Configuration
Linux系列:第 4 篇,共 4 篇

Ubuntu 的系统配置、常用命令行工具、文件系统挂载和 Docker

系统
  1. Ubuntu Optimization
  2. Linux Tools
  3. Linux Mounting
容器
  1. 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" \
This post is licensed under CC BY 4.0 by the author.