如何在Kubernetes Pod中运行并连接X Windows？（含Rancher Desktop实操问题）

一、先搞定WSL本地的X Server配置（关键前提） #

你之前xeyes启动失败，大概率是本地X Server的配置问题，先把这一步弄对：

• 安装X Server工具：用VcXsrv或者X410都行。启动VcXsrv时，选「One large window」，到「Extra settings」步骤一定要勾选Disable access control（关闭访问控制，允许Pod连接），再完成启动。
• 配置WSL的DISPLAY变量：在WSL终端执行这条命令，让Pod能找到X Server：

  export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0
  

  要是想永久生效，把这条命令加到~/.bashrc或~/.zshrc文件末尾，下次启动终端自动加载。
• 验证本地X Server：直接在WSL终端输入xeyes，能弹出眼睛窗口就说明本地没问题。

二、配置Kubernetes Pod的权限与环境变量 #

不管是新建Pod还是改已有Pod，得确保Pod能访问主机的X套接字和正确的DISPLAY变量：

方式1：新建带X支持的Pod #

创建x-test-pod.yaml文件，内容如下：

apiVersion: v1
kind: Pod
metadata:
  name: x-test-pod
spec:
  containers:
  - name: x-test-container
    image: ubuntu:latest
    command: ["sleep", "3600"] # 让Pod保持运行状态
    env:
    - name: DISPLAY
      valueFrom:
        configMapKeyRef:
          name: x-display-config
          key: display-value
    volumeMounts:
    - name: x-unix
      mountPath: /tmp/.X11-unix
  volumes:
  - name: x-unix
    hostPath:
      path: /tmp/.X11-unix # 挂载主机的X Unix套接字

然后在WSL终端创建存储DISPLAY值的ConfigMap：

kubectl create configmap x-display-config --from-literal=display-value=$(echo $DISPLAY)

最后部署Pod：

kubectl apply -f x-test-pod.yaml

方式2：修改已有Pod #

如果是已经在运行的Pod，直接编辑配置：

kubectl edit pod <你的Pod名称>

添加以下内容：

• 在spec.containers[*].env下加DISPLAY变量，值和WSL终端里echo $DISPLAY的结果一致
• 在spec.containers[*].volumeMounts下添加挂载项：

  - name: x-unix
    mountPath: /tmp/.X11-unix
  

• 在spec.volumes下添加hostPath卷：

  - name: x-unix
    hostPath:
      path: /tmp/.X11-unix
  

三、进入Pod并运行X应用 #

Pod启动后，进入Pod终端：

kubectl exec -it x-test-pod -- /bin/bash

在Pod内部做这两步：

1. 安装测试用的X应用，比如xeyes：

   apt update && apt install -y x11-apps
   

2. 运行xeyes，能弹出窗口就成功了。

四、常见问题排查 #

要是还是启动失败，检查这几个点：

• 确认Pod里的DISPLAY和WSL里的一致：在Pod终端执行echo $DISPLAY，和WSL终端的结果对比。
• 检查X Server的访问控制：VcXsrv必须开了「Disable access control」，或者临时在WSL里执行xhost +（注意：这会放宽权限，测试完可以用xhost -恢复）。
• 检查挂载是否正常：在Pod里执行ls /tmp/.X11-unix，能看到X0这类套接字文件才算挂载成功。
• 用host.docker.internal的话，先在WSL里执行telnet host.docker.internal 6000，看能不能连通（6000是X Server默认端口，对应DISPLAY的:0）。

内容的提问来源于stack exchange，提问作者Chameleon