LinuxServer rdesktop 基础镜像

镜像概述和主要用途

本系列镜像旨在为任何Linux应用或桌面环境提供全功能的rdesktop Linux桌面体验。它们包含无密码sudo，以便轻松进行包安装、测试和定制。默认情况下，除用户主目录外，镜像不挂载其他内容，这意味着镜像更新时，/config 目录外的任何内容都将丢失。

• 基于合理努力原则为在您自己的项目中使用这些基础镜像提供支持，详情请参见我们的支持政策。
• 我们的所有基础镜像均无 latest 标签，这是有意为之。我们经常在版本间进行破坏性变更，且不像下游镜像那样发布发行说明。
• 如果您打算分发使用我们基础镜像构建的镜像，请先阅读我们的容器品牌文档。
• 镜像的支持期限与它们所基于的上游版本相同，之后我们将停止为该版本构建新的基础镜像。

核心功能和特性

• 全功能rdesktop Linux桌面体验，支持运行各类Linux应用或桌面环境
• 无密码sudo权限，便于包安装、测试和定制
• 仅持久化 /config 目录，确保升级时用户数据不丢失
• 支持通过环境变量配置应用设置（如语言、窗口边框、全屏等）
• 集成proot-apps，可安装便携应用到持久存储，跨容器版本保留应用和设置
• 支持构建单应用容器或完整桌面环境
• 提供开源GPU驱动加速和Nvidia GPU支持（通过Zink）

使用场景和适用范围

• 作为构建运行Linux应用的容器基础镜像（如Firefox、办公软件等）
• 构建完整的Linux桌面环境容器
• 需要跨容器版本保留应用和设置的场景
• 开发和测试Linux应用的桌面环境
• 需要国际化语言支持的Linux桌面应用场景

使用方法和配置说明

环境变量配置

所有应用设置通过环境变量传递：

语言支持 - 国际化

通过环境变量 LC_ALL 可将镜像启动为不同语言，例如启动法语桌面会话：LC_ALL=fr_FR.UTF-8。部分语言（如中文、日文、韩文）可能缺少必要的CJK字体，可通过启动时安装：

Debian系统安装CJK字体示例：

bash
-e DOCKER_MODS=linuxserver/mods:universal-package-install \
-e INSTALL_PACKAGES=fonts-noto-cjk \
-e LC_ALL=zh_CN.UTF-8

可用发行版

所有基础镜像均为x86_64和aarch64平台构建：

PRoot Apps

所有镜像包含proot-apps，允许将便携应用安装到用户 $HOME 目录的持久存储中。这些应用及其设置在基础容器升级后仍保留，且可挂载到不同rdesktop容器中使用（例如Alpine容器的 /config 目录可挂载到Ubuntu容器，保留通过 proot-apps install 安装的应用和设置）。

LinuxServer支持的应用列表见此处。

构建镜像

应用容器

基础镜像包含简单的Openbox桌面环境及启动单个应用所需的逻辑。构建应用容器的最低要求如下：

Dockerfile示例：

dockerfile
FROM ghcr.io/linuxserver/baseimage-rdesktop:alpine320
RUN apk add --no-cache firefox
COPY /root /

定义启动应用：

bash
mkdir -p root/defaults
echo "firefox" > root/defaults/autostart

目录结构：

├── Dockerfile
└── root
  └── defaults
    └── autostart

构建和测试：

bash
docker build -t firefox .
docker run --rm -it -p 3389:3389 firefox bash

启动后，通过RDP端口3389连接将看到全屏Firefox窗口。

注意：构建镜像时，许多应用需要 --security-opt seccomp=unconfined 才能在Docker中运行，部分应用（如Chromium系列）可能需要启动标志（如 --no-sandbox）规避Docker的系统调用限制，并非所有应用都能像原生Linux安装一样直接运行。

容器内应用启动器配置

可通过菜单定义文件允许用户右键桌面启动应用。示例Firefox菜单配置：

menu.xml文件内容：

xml
<?xml version="1.0" encoding="utf-8"?>
<openbox_menu xmlns="[***]">
<menu id="root-menu" label="MENU">
<item label="xterm" icon="/usr/share/pixmaps/xterm-color_48x48.xpm"><action name="Execute"><command>/usr/bin/xterm</command></action></item>
<item label="FireFox" icon="/usr/share/icons/hicolor/48x48/apps/firefox.png"><action name="Execute"><command>/usr/bin/firefox</command></action></item>
</menu>
</openbox_menu>

添加到目录结构：

├── Dockerfile
└── root
  └── defaults
    ├── autostart
    └── menu.xml

完整桌面环境

构建应用容器时使用Openbox作为窗口管理器，也可通过 startwm.sh 脚本完全替换启动的桌面环境，该脚本位于 defaults 目录：

目录结构：

├── Dockerfile
└── root
  └── defaults
    └── startwm.sh

包含 startwm.sh 后，容器启动时将运行该脚本而非Openbox。配置示例可参考linuxserver/docker-rdesktop。

开源GPU加速

对于需要加速的应用或游戏，可将渲染设备挂载到容器中：

bash
--device /dev/dri:/dev/dri

仅支持开源GPU驱动：

Nvidia GPU支持

注意：Nvidia不兼容Alpine基础镜像

Nvidia支持通过Zink提供OpenGL加速，需以下运行标志：

Compose配置：

需先将Nvidia设为默认运行时：

bash
sudo nvidia-ctk runtime configure --runtime=docker --set-as-default
sudo service docker restart

Compose文件示例：

yaml
services:
  myimage:
    image: myname/myimage:mytag
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [compute,video,graphics,utility]