soff/ubuntu-xfce-vnc

Docker容器镜像：无头VNC与RDP会话环境

本镜像基于https://github.com/ConSol/docker-headless-vnc-container%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E6%97%A0%E5%A4%B4%EF%BC%88headless%EF%BC%89VNC%E5%92%8CRDP%E8%BF%9C%E7%A8%8B%E6%A1%8C%E9%9D%A2%E7%8E%AF%E5%A2%83%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E5%AE%B9%E5%99%A8%E5%8C%96%E6%A1%8C%E9%9D%A2%E6%93%8D%E4%BD%9C%E7%9A%84%E5%9C%BA%E6%99%AF%E3%80%82

核心功能

• 桌面环境：Xfce4轻量级桌面
• 远程访问协议：VNC（默认端口5901）、RDP（默认端口3389）
• 网页端访问：noVNC HTML5客户端（默认端口6901）
• 内置工具：Chromium浏览器

使用场景

1. 远程桌面测试与调试
2. 容器化环境下运行桌面应用
3. 无需本地桌面的远程操作需求
4. 自动化测试中的图形界面交互场景

部署与使用示例

查看帮助

bash
docker run soff/ubuntu-xfce-vnc --help

启动容器（映射VNC和noVNC端口）

bash
docker run -d -p 5901:5901 -p 6901:6901 soff/ubuntu-xfce-vnc

启动容器（映射RDP端口）

bash
docker run -d -p 3389:3389 soff/ubuntu-xfce-vnc
# RDP登录默认用户名：user，密码：password

自定义RDP密码

bash
docker run -d -p 3389:3389 -e USER_PASSWORD=1234 soff/ubuntu-xfce-vnc

切换为宿主机用户运行

bash
docker run -d -p 5901:5901 -p 6901:6901 --user $(id -u):$(id -g) soff/ubuntu-xfce-vnc

进入容器交互模式

bash
docker run -it -p 5901:5901 -p 6901:6901 soff/ubuntu-xfce-vnc bash

连接与控制

容器启动后，可通过以下方式连接：

1. VNC Viewer：localhost:5901，默认密码：vncpassword
2. noVNC HTML5全客户端：http://localhost:6901/vnc.html，默认密码：vncpassword
3. noVNC HTML5轻量客户端：http://localhost:6901/?password=vncpassword
4. RDP客户端：localhost:3389，默认用户名/密码：user/password（或自定义密码）

配置说明

1. 扩展镜像（安装自定义软件）

默认以非root用户运行，若需安装软件需切换至root：

dockerfile
FROM soff/ubuntu-xfce-vnc
ENV REFRESHED_AT 2020-01-02

# 切换至root用户
USER 0

# 安装gedit示例
RUN apt-get update && apt-get install -y gedit && apt-get clean

# 切换回默认用户
USER 1000

2. 覆盖VNC环境变量

可通过环境变量自定义桌面设置：

• VNC_COL_DEPTH：颜色深度（默认24）
• VNC_RESOLUTION：分辨率（默认1280x1024）
• VNC_PW：VNC密码（默认my-pw）
• VNC_VIEW_ONLY：仅查看模式（默认false，设为true时仅允许查看不允许控制）

示例：自定义VNC分辨率和密码

bash
docker run -d -p 5901:5901 -p 6901:6901 -e VNC_RESOLUTION=800x600 -e VNC_PW=my-custom-pw soff/ubuntu-xfce-vnc

3. 已知问题

• Chromium高分辨率崩溃：当分辨率较高（如1920x1080）时，Chromium可能因/dev/shm空间不足崩溃，需添加--shm-size参数：

  bash
  docker run --shm-size=256m -d -p 6901:6901 -e VNC_RESOLUTION=1920x1080 soff/ubuntu-xfce-vnc chromium-browser