container-xrdp Docker镜像文档

镜像概述和主要用途

container-xrdp是一个用于运行xrdp远程桌面服务的Docker容器，支持Xorg和Xvnc协议，基于Fedora和Ubuntu系统，提供完整的Xfce桌面环境。该容器适用于amd64和arm64硬件架构，无需主机系统的特权或系统能力，具有轻量级特性，非常适合快速开发和测试场景。注意容器状态在运行之间不持久化，如需持久化容器状态，请参考相关指南。

核心功能和特性

• 支持xrdp远程桌面服务，兼容Xorg和Xvnc协议
• 提供Xfce桌面环境，支持amd64和arm64硬件架构
• 基于Fedora和Ubuntu系统构建，确保系统稳定性
• 无需主机系统特权或特殊系统能力，安全性更高
• 轻量级设计，资源占用低，启动速度快
• 支持多用户配置，可指定用户sudo权限

使用场景和适用范围

• 快速搭建远程桌面环境进行开发和测试
• 需要临时远程访问Linux桌面环境的场景
• 跨平台（amd64/arm64）远程桌面需求
• 教学或演示环境的快速部署
• 无需在主机安装完整桌面环境的轻量级远程访问需求

详细的使用方法和配置说明

镜像拉取

首先拉取带有适当标签的容器镜像，以下是可用的标签组合：

• danchitnis/xrdp:ubuntu-xfce
• danchitnis/xrdp:fedora-xfce
• danchitnis/xrdp:amazon-mate（不再支持）
• danchitnis/xrdp:amazon-xfce（不再支持）
• danchitnis/xrdp:centos7-mate（不再支持）
• danchitnis/xrdp:centos7-xfce（不再支持）
• danchitnis/xrdp:centos8-xfce（不再支持）

拉取示例：

bash
docker pull danchitnis/xrdp:ubuntu-xfce

运行容器

运行容器时需要提供用户名、密码和sudo权限作为输入参数，每个用户需指定这三个参数。如果输入参数不正确，进程将退出。建议首次运行时使用交互模式。

交互模式示例（用户名为foo，密码为bar，sudo权限为no）：

bash
docker run -it -p 33890:3389 danchitnis/xrdp:ubuntu-xfce foo bar no

Detached模式示例：

bash
docker run -d -p 33890:3389 danchitnis/xrdp:ubuntu-xfce foo bar no

连接远程桌面

容器运行后，打开远程桌面连接工具，输入地址"localhost:33890"，使用指定的用户名（foo）和密码（bar）登录。

Nightly构建版本

Nightly构建版本适用于以下标签：

• danchitnis/xrdp:ubuntu-xfce-next
• danchitnis/xrdp:fedora-xfce-next

只需将标签替换为nightly标签即可拉取和运行nightly构建版本：

示例：

bash
docker run -it -p 33890:3389 danchitnis/xrdp:ubuntu-xfce-next foo bar no

注意：这些nightly构建版本是自动构建的，未经过测试，可能无法按预期工作。如果登录失败，请尝试使用主版本标签。

添加更多用户

可以添加多个用户，每个用户需提供三个参数（用户名、密码、sudo权限）。

示例用户列表：

运行命令：

bash
docker run -it -p 33890:3389 danchitnis/xrdp:ubuntu-xfce foo bar yes baz qux no

Sudo用户

添加sudo用户将赋予该用户在容器内运行特权命令的能力。

示例（创建sudo用户foo）：

bash
docker run -d -p 33890:3389 danchitnis/xrdp:ubuntu-xfce foo bar yes

容器内使用sudo示例：

bash
sudo yum update

注意：要授予sudo能力，每个用户的第三个输入参数必须显式设置为"yes"，其他任何输入都将被忽略。

构建自定义容器

有关构建自己的容器的详细指南，请查看此文档。

贡献致谢

• 受frxyt/docker-xrdp启发
• Ubuntu命令参考自danielguerra69/ubuntu-xrdp
• xrdp服务重启功能由timwa0669贡献