详解Docker容器运行GUI程序的方法

Posted 2023-03-09 华为云开发者联盟

摘要：本文为大家详解如何直接进入Docker容器运行或通过SSH连接Docker容器运行GUI程序的方法。

本文分享自华为云社区《Docker容器运行GUI程序的方法（直接进入Docker容器运行或通过SSH连接Docker容器运行）》，作者：MAVER1CK 。

以下两种方法都需要先在主机执行 xhost + 命令，若无该命令，先apt安装 x11-xserver-utils 后再执行，否则会报 No protocol specified 这个错

sudo apt install x11-xserver-utils

xhost +

直接进入Docker容器运行

针对远程容器

docker-compose.yml中需要绑定挂载 /tmp/.X11-unix

    volumes:
      - "/tmp/.X11-unix:/tmp/.X11-unix:rw"
    environment:
      - DISPLAY=$DISPLAY
      - QT_X11_NO_MITSHM=1

若出现 X11 connection rejected because of wrong authentication. 这个错，则需要再挂载 ~/.Xauthority

    volumes:
      - "/tmp/.X11-unix:/tmp/.X11-unix:rw"
      - "~/.Xauthority：/root/.Xauthority:rw"
    environment:
      - DISPLAY=$DISPLAY
      - QT_X11_NO_MITSHM=1

这种方法有个问题：虽然将主机中的Xauthority文件使用绑定挂载共享到容器中，但容器中的该文件数据更新不及时（可以在主机和容器中分别使用 xauth list 命令查看详情，对比这两个文件的内容），导致即使挂载Xauthority，也会报 X11 connection rejected because of wrong authentication. 这个错，必须重启容器才可以继续显示图像。而通过SSH连接容器则不会出现这个问题。
举个例子：

1. 一台NUC上运行了一个容器，已经使用docker compose up -d 部署了容器，在开机脚本里写了自启容器的命令，每次NUC开机都会自动启动容器
2. 使用笔记本电脑ssh连接到了NUC，再在这个ssh连接中进入容器
3. 在容器中运行GUI程序，成功显示了窗口
4. 退出容器，并断开了与NUC的ssh连接
5. 再次ssh连接NUC，重复步骤2. 3.，但未能显示图形，报错：X11 connection rejected because of wrong authentication.
6. 在容器中执行 xauth list 命令，再在NUC中执行相同命令，可以看到设备名相同，但cookie值不同，导致认证失败
7. 不断开ssh连接，重启容器并再次运行GUI程序，成功显示图形

针对本地容器

直接使用docker exec命令或通过下文ssh的方法进入容器

例如容器中使用的是bash

docker exec -it [容器名称] bash

然后在当前终端中输入命令执行GUI程序即可

通过SSH连接Docker容器运行

根据官方文档说明，在 host 网络模式下无法使用端口映射，为了使容器的ssh端口和主机的ssh端口不冲突（做到既可以连接主机，又可以连接容器），需要修改容器中默认的ssh端口，又因为容器中默认为root用户，且为随机生成密码，所以还要修改容器的ssh配置文件，允许以root身份ssh登陆，并修改容器root用户的密码，最后还要让容器每次启动的时候自动启动ssh服务（因为容器没有systemd，不会自启ssh服务）。注意不能挂载主机的Xauthority文件，但要挂载 /tmp/.X11-unix

volumes:
      - "/tmp/.X11-unix:/tmp/.X11-unix:rw"
environment:
      - DISPLAY=$DISPLAY
      - QT_X11_NO_MITSHM=1

1、修改容器ssh端口并允许root用户登陆

vim /etc/ssh/sshd_config

• 将 Port 解注释，并把值从22改为其他值（不能使用主机正在使用的端口，因为容器在 host 模式下与主机共用端口），比如2222
• 然后找到 PermitRootLogin ，解注释并把值改为 yes

2、修改docker-compose.yml,使容器启动时自启ssh服务：在 command 处增加命令

service ssh start

因为我的容器已经在启动时执行了 tail -f /dev/null 命令，因此需要下面这种写法以使容器执行多条命令

    command: bash -c "service ssh start && tail -f /dev/null"

3、最后通过ssh命令连接

ssh -p 2222 root@localhost -Y

点击关注，第一时间了解华为云新鲜技术~