rattydave/docker-ubuntu-xrdp-mate-custom

Ubuntu XRDP MATE 自定义虚拟桌面镜像

镜像概述

本镜像提供基于Ubuntu的虚拟桌面环境，集成XRDP和MATE桌面，支持XORG和XVNC协议。具备持久化用户信息管理功能，当Ubuntu发布更新时会自动重建镜像，确保系统组件保持最新。

核心功能与特性

• 系统环境：基于Ubuntu 22.04（latest标签）
• 桌面环境：MATE桌面（Ubuntu官方仓库）
• 远程协议：XRDP、XRPDXORG、tightvncserver
• 基础软件：Epiphany网页浏览器
• 自定义配置：包含自定义xrdp.ini脚本
• 本地化支持：默认UK键盘布局和时区（可修改）
• 时区设置：通过TZ环境变量自定义时区
• 启动脚本：支持容器启动时运行自定义脚本（用于安装额外软件包）
• 本地驱动映射：需--privileged=true参数支持
• 剪贴板共享：需--privileged=true参数支持

使用场景

• 远程虚拟桌面访问
• 持久化用户环境的容器化桌面
• 需要自定义软件环境的开发/测试场景
• 多用户共享的远程桌面服务

使用方法

快速启动

1. 创建用户配置文件：

   bash
   echo "user:pass:N" > CREATEUSERS.TXT
   

2. 启动容器：

   bash
   docker run --name RattyDAVE \
              --privileged=true \
              -p 3389:3389 \
              -e TZ="Europe/London" \
              -v ${PWD}/CREATEUSERS.TXT:/root/createusers.txt \
              -dit --restart unless-stopped \
              rattydave/docker-ubuntu-xrdp-mate-custom
   

3. 连接远程桌面：

   • Windows系统：打开命令提示符，输入mstsc，输入Docker主机IP地址
   • 使用用户名user和密码pass登录

高级配置

完整的docker run命令：

bash
docker run --name RattyDAVE \
           --privileged=true \
           -p 3389:3389 \
           -e TZ="Europe/London" \
           -v %LOCAL_PATH_TO_CREATEUSERS.TXT_FILE%:/root/createusers.txt \
           -v %LOCAL_PATH_TO_STARTUP.SH_FILE%:/root/startup.sh \
           -v %LOCAL_PATH_TO_HOME_DIRECTORY%:/home \
           -dit --restart unless-stopped \
           rattydave/docker-ubuntu-xrdp-mate-custom

参数说明：

• %LOCAL_PATH_TO_CREATEUSERS.TXT_FILE%: 用户配置文件本地路径
• %LOCAL_PATH_TO_STARTUP.SH_FILE%: 启动脚本本地路径（在用户创建后、服务启动前执行）
• %LOCAL_PATH_TO_HOME_DIRECTORY%: /home目录本地挂载路径（用于持久化用户数据）

用户配置文件（CREATEUSERS.TXT）

文件格式：username:password:is_sudo（需以换行符结束）

• username: 登录用户名
• password: 用户密码
• is_sudo: 是否拥有sudo权限（仅Y/y被识别为是）

示例：

mickey:mouse:N
daisy:duke:Y
dog:flash:n
morty:rick:wubba

此示例将创建4个用户，仅daisy拥有sudo权限。容器重启时会检查并添加新用户。

启动脚本（STARTUP.SH）

用于容器启动时执行自定义操作，如安装软件包或配置系统。

示例（更改系统区域设置为德语）：

bash
apt-get update
apt-get -y install language-pack-de language-pack-gnome-de
locale-gen de_DE.UTF-8
update-locale LANG=de_DE.UTF-8

连接方法

Windows客户端

1. 打开命令提示符
2. 输入 mstsc
3. 输入Docker主机IP地址并连接

Linux客户端

使用xfreerdp命令（部分客户端需设置+glyph-cache参数）：

bash
xfreerdp /size:1920x1140 /kbd:0x00000809 /v:%IP_ADDRESS% /gdi:hw /drive:home,$HOME +clipboard /sound:sys:alsa +glyph-cache

自动更新

推荐使用watchtower实现容器自动更新：

bash
docker run -d \
    --name watchtower \
    -v /var/run/docker.sock:/var/run/docker.sock \
    containrrr/watchtower

20.04-tools版本

额外提供包含开发工具的20.04版本（rattydave/docker-ubuntu-xrdp-mate-custom:20.04-tools），包含以下工具：

• x3270、filezilla、netbeans、dia、geany、putty
• mysql-workbench、remmina、openjdk-11-jre
• libreoffice、pasmo、BlueJ
• Rocket2014（RC2014 Z80模拟器，ROMs位于/opt/rocket2014/examples）

屏幕共享功能

1. 主用户使用Xvnc选项连接并正常登录
2. 桌面上的session_info.txt文件包含显示编号和密码
3. 其他客户端使用"Reconnect"选项连接：
   • 端口：5900 + 显示编号（如显示编号为11，端口为5911）
   • 用户名：主用户账号
   • 密码：session_info.txt中的密码（如1a2b3c4d）

20.04-tools版本启动命令

bash
docker run --name RattyDAVE20.04-tools \
           --privileged=true \
           -p 3389:3389 \
           -e TZ="Europe/London" \
           -v %LOCAL_PATH_TO_CREATEUSERS.TXT_FILE%:/root/createusers.txt \
           -v %LOCAL_PATH_TO_STARTUP.SH_FILE%:/root/startup.sh \
           -v %LOCAL_PATH_TO_HOME_DIRECTORY%:/home \
           -dit --restart unless-stopped \
           rattydave/docker-ubuntu-xrdp-mate-custom:20.04-tools

反馈与支持

使用GitHub Issues提交反馈、问题和评论：https://github.com/RattyDAVE/docker-ubuntu-xrdp-mate-custom/issues