LinuxServer.io 团队为您带来另一款容器发布，其特点包括：

• 定期且及时的应用更新
• 简单的用户映射（PGID、PUID）
• 带有 s6 overlay 的自定义基础镜像
• 每周基础操作系统更新，在整个 LinuxServer.io 生态系统中共享通用层，以最小化空间占用、停机时间和带宽
• 定期安全更新

您可以通过以下渠道找到我们：

• 博客 - 关于如何使用我们的容器的所有内容，包括操作指南、观点等更多信息！
• *** - 与社区和团队进行实时支持/聊天。
• Discourse - 在我们的社区论坛上发帖。
• https://github.com/linuxserver - 查看我们所有仓库的源代码。
• Open Collective - 请考虑通过***或为我们的预算做出贡献来支持我们

https://github.com/linuxserver/docker-webtop

https://github.com/linuxserver/docker-webtop - 基于 Alpine、Ubuntu、Fedora 和 Arch 的容器，包含官方支持的完整桌面环境，可通过任何现代 Web 浏览器访问。

支持的架构

我们利用 docker manifest 实现多平台支持。更多信息可从 docker https://distribution.github.io/distribution/spec/manifest-v2-2/#manifest-list 和我们的公告 此处 获取。

只需拉取 lscr.io/linuxserver/webtop:latest 即可获取适合您架构的正确镜像，但您也可以通过标签拉取特定架构的镜像。

此镜像支持的架构如下：

版本标签

此镜像提供多种可通过标签获取的版本。请仔细阅读描述，并在使用不稳定或开发标签时谨慎操作。

应用设置

可通过以下地址访问应用：

• [***]

严格反向代理

此镜像默认使用自签名证书。这自然意味着协议为 https。如果您使用的反向代理会验证证书，则需要为容器禁用此检查。

现代 GUI 桌面应用可能与最新的 Docker 系统调用限制存在兼容性问题。在具有较旧内核或 libseccomp 版本的主机上，您可以使用带有 --security-opt seccomp=unconfined 设置的 Docker 来允许这些系统调用。

安全性

[!WARNING] 此容器提供对主机系统的特权访问。除非已正确配置安全措施，否则不要将其暴露在互联网上。

完整功能需要 HTTPS。 现代浏览器功能（如用于视频和音频的 WebCodecs）在不安全的 HTTP 连接上无法运行。

默认情况下，此容器没有身份验证。可选的 CUSTOM_USER 和 PASSWORD 环境变量可启用基本 HTTP 身份验证，这仅适用于在受信任的本地网络上保护容器。对于互联网暴露，我们强烈建议将容器放在反向代理（如 https://github.com/linuxserver/docker-swag%EF%BC%89%E4%B9%8B%E5%90%8E%EF%BC%8C%E5%B9%B6%E4%BD%BF%E7%94%A8%E5%BC%BA%E5%A4%A7%E7%9A%84%E8%BA%AB%E4%BB%BD%E9%AA%8C%E8%AF%81%E6%9C%BA%E5%88%B6%E3%80%82

Web 界面包含一个具有无密码 sudo 访问权限的终端。任何有权访问 GUI 的用户都可以在容器内获得 root 控制权，安装任意软件，并探测您的本地网络。

虽然通常不推荐，但某些旧环境（特别是那些使用较旧硬件或过时 Linux 发行版的环境）可能需要停用标准 seccomp 配置文件才能运行容器化桌面软件。这可以通过使用 --security-opt seccomp=unconfined 参数实现。仅在绝对必要时使用此选项，因为它会禁用 Docker 的关键安全层，增加容器逃逸漏洞的可能性，这一点至关重要。

FullColor 4:4:4 编码

如果您注意到文本模糊，特别是黑色背景上的浅色文本，可以通过在侧边栏中启用 FullColor 4:4:4 编码或使用 jpeg 编码模式向浏览器发送真正的 8 位颜色。

硬件加速注意事项： 目前，只有 Nvidia GPU 支持在 Zero Copy 模式下编码此颜色配置文件。如果在 Intel 或 AMD GPU 上启用 FullColor 4:4:4，系统将回退到 CPU 编码。这会迫使 CPU 从 GPU 读取像素，导致性能显著下降。

硬件加速与 Wayland

我们已将桌面容器从 X11 过渡到现代 Wayland 栈，现在 Wayland 是默认选项。

硬件回退注意事项： 在 x86_64 架构上，Wayland 栈需要支持 AVX2 的处理器（Intel Haswell 代或更新版本）。如果您的处理器缺少 AVX2（例如较旧的 CPU 或某些低端赛扬处理器），容器将自动回退到 X11。

重要： X11 的 GPU 加速支持已弃用。未来硬件加速的开发将完全集中在 Wayland 栈上。

如果您遇到兼容性问题并需要手动禁用 Wayland（强制回退到 X11），可以通过设置以下环境变量来实现：

• -e PIXELFLUX_WAYLAND=false

为什么选择 Wayland？

• 零复制编码： 当与 GPU 正确配置时，帧在显卡上渲染和编码，无需复制到系统 RAM。这大大降低了 CPU 使用率和延迟。
• 现代栈： 单应用容器使用 Labwc（替代 Openbox），完整桌面容器使用 KDE Plasma Wayland，在保持相同用户体验的同时，提供更现代、高性能和安全的合成环境。

GPU 配置

要在 Wayland 模式下使用硬件加速，我们区分用于渲染（3D 应用/桌面）和编码（视频流）的显卡。

配置变量：

• DRINODE：用于渲染（EGL）的 GPU 路径。
• DRI_NODE：用于编码（VAAPI/NVENC）的 GPU 路径。

如果两个变量指向同一设备，容器将自动启用零拷贝（Zero Copy）编码，显著降低 CPU 使用率和延迟。如果设置为不同设备，则一个用于渲染，一个用于编码，并进行 CPU 回读。

也可使用环境变量 AUTO_GPU=true，设置后容器中检测到的第一张显卡（例如 /dev/dri/renderD128）将被使用并配置为零拷贝模式。

Intel 和 AMD（开源驱动）

适用于 Intel 和 AMD GPU。

devices:
- /dev/dri:/dev/dri
environment:
- PIXELFLUX_WAYLAND=true
# 可选：如果存在多个设备，指定设备（例如：/dev/dri/renderD129）
- DRINODE=/dev/dri/renderD128
- DRI_NODE=/dev/dri/renderD128

Nvidia（专有驱动）

[!NOTE] Alpine 基础镜像不支持 Nvidia。

前提条件：

1. 驱动： 需要580 或更高版本的专有驱动。重要的是，应使用直接从 Nvidia 官网下载的 .run 文件安装驱动。

• Unraid： 使用 Nvidia Driver 插件的生产分支。

2. 内核参数： 必须在主机引导加载程序中设置 nvidia-drm.modeset=1 nvidia_drm.fbdev=1。

• 标准 Linux（GRUB）： 编辑 /etc/default/grub 并将参数添加到现有的 GRUB_CMDLINE_LINUX_DEFAULT 行：

GRUB_CMDLINE_LINUX_DEFAULT=" nvidia-drm.modeset=1 nvidia_drm.fbdev=1"

然后通过运行以下命令应用更改：

sudo update-grub

• Unraid（Syslinux）： 编辑文件 /boot/syslinux/syslinux.cfg 并将 nvidia-drm.modeset=1 nvidia_drm.fbdev=1 添加到 Unraid OS 启动项的 append 行末尾。

3. 硬件初始化： 在无头系统上，Nvidia 显卡需要在 GPU 上插入物理虚拟插头，以便 DRM 正确初始化。

4. Docker 运行时： 配置主机 Docker 守护进程以使用 Nvidia 运行时：

sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Compose 配置：

---
services:
webtop:
image: lscr.io/linuxserver/webtop:latest
environment:
- PIXELFLUX_WAYLAND=true
# 确保这些指向运行时注入的渲染节点（通常是 renderD128）
- DRINODE=/dev/dri/renderD128
- DRI_NODE=/dev/dri/renderD128
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: 1
capabilities: [compute,video,graphics,utility]

• Unraid： 确保正确设置 DRINODE/DRI_NODE 并将 --gpus all --runtime nvidia 添加到额外参数中。

SealSkin 兼容性

此容器与 SealSkin 兼容。

SealSkin 是一个自托管的客户端-服务器平台，提供安全认证和协作功能，同时使用浏览器扩展拦截用户操作（如点击链接或下载文件）并将其重定向到运行在远程服务器上的安全、隔离的应用环境。

• SealSkin 服务器： https://github.com/linuxserver/docker-sealskin
• 浏览器扩展： Chrome 和 Firefox。
• 移动应用： iOS 和 Android

所有基于 Selkies 的 GUI 容器选项

此容器基于 https://github.com/linuxserver/docker-baseimage-selkies%E3%80%82

点击展开：可选环境变量

WATERMARK_LOCATION 选项：

• 1：左上角
• 2：右上角
• 3：左下角
• 4：右下角
• 5：居中
• 6：动画

点击展开：可选运行配置（DinD 和 GPU 挂载）

点击展开：传统X11分辨率与加速

[!NOTE] 本部分仅适用于未使用 PIXELFLUX_WAYLAND=true 的情况。

在X11模式下通过Nvidia DRM或DRI3使用3D加速时，将虚拟显示限制在合理的最大分辨率至关重要，以避免内存耗尽或性能下降。

• -e MAX_RES=3840x2160

这会将总虚拟帧缓冲区设置为4K。默认情况下，虚拟显示器为16K。如果在加速X11会话中遇到性能问题，请尝试将分辨率限制为1080p，然后逐步提高：

-e SELKIES_MANUAL_WIDTH=1920
-e SELKIES_MANUAL_HEIGHT=1080
-e MAX_RES=1920x1080

语言支持 - 国际化

要以其他语言启动桌面会话，请设置 LC_ALL 环境变量。例如：

• -e LC_ALL=zh_CN.UTF-8 - 中文
• -e LC_ALL=ja_JP.UTF-8 - 日语
• -e LC_ALL=ko_KR.UTF-8 - 韩语
• -e LC_ALL=ar_AE.UTF-8 - 阿拉伯语
• -e LC_ALL=ru_RU.UTF-8 - 俄语
• -e LC_ALL=es_MX.UTF-8 - 西班牙语（拉丁美洲）
• -e LC_ALL=de_DE.UTF-8 - 德语
• -e LC_ALL=fr_FR.UTF-8 - 法语
• -e LC_ALL=nl_NL.UTF-8 - 荷兰语
• -e LC_ALL=it_IT.UTF-8 - 意大利语

应用管理

在容器内安装应用有两种方法：PRoot Apps（推荐用于持久化）和原生应用（Native Apps）。

PRoot Apps（持久化）

如果容器被重新创建，原生安装的软件包（例如通过 apt-get install）将不会持久保存。为了在容器更新后保留应用及其设置，建议使用 https://github.com/linuxserver/proot-apps%E3%80%82%E8%BF%99%E4%BA%9B%E6%98%AF%E5%AE%89%E8%A3%85%E5%88%B0%E7%94%A8%E6%88%B7%E6%8C%81%E4%B9%85%E5%8C%96 $HOME 目录的可移植应用。

要安装应用，请在容器内使用命令行：

proot-apps install filezilla

支持的应用列表可在 https://github.com/linuxserver/proot-apps?tab=readme-ov-file#supported-apps 查看。

原生应用（非持久化）

您可以使用 https://github.com/linuxserver/docker-mods/tree/universal-package-install 模块从系统原生仓库安装软件包。此方法会增加容器启动时间，且不具备持久性。在您的 compose.yaml 中添加以下内容：

environment:
- DOCKER_MODS=linuxserver/mods:universal-package-install
- INSTALL_PACKAGES=libfuse2|git|gdb

高级配置

点击展开：强化选项

这些变量可用于为单应用场景锁定桌面环境或限制用户功能。

单独的强化变量：

点击展开：Selkies应用设置

使用环境变量可以配置应用的各个方面。

布尔值与锁定：
布尔值设置接受 true 或 false。您还可以通过追加 |locked 防止用户在UI中更改布尔值设置。

• 示例：-e SELKIES_USE_CPU="true|locked"

枚举与列表：
这些设置接受逗号分隔的值列表。第一项为默认值。如果仅提供一项，UI下拉菜单将隐藏。

• 示例：-e SELKIES_ENCODER="jpeg"

范围：
使用连字符分隔的 min-max 格式表示滑块，或使用单个数字锁定值。

• 示例：-e SELKIES_FRAMERATE="60"

手动分辨率模式：
如果设置了 SELKIES_MANUAL_WIDTH 或 SELKIES_MANUAL_HEIGHT，分辨率将锁定为这些值。

参数

容器通过运行时传递的参数（如上文所述）进行配置。这些参数用冒号分隔，分别表示 :。例如，-p 8080:80 会将容器内部的 80 端口暴露出来，使其可通过主机 IP 在容器外部的 8080 端口访问。

从文件设置环境变量（Docker secrets）

您可以通过使用特殊前缀 FILE__ 从文件中设置任何环境变量。

例如：

-e FILE__MYVAR=/run/secrets/mysecretvariable

这会根据 /run/secrets/mysecretvariable 文件的内容设置环境变量 MYVAR。

运行应用程序的Umask设置

对于我们所有的镜像，您可以通过可选的 -e UMASK=022 设置来覆盖容器内启动服务的默认umask设置。
请记住，umask 不是 chmod，它根据其值从权限中减去，而不是添加。在请求支持前，请先阅读此处。

用户/组标识符

使用卷（-v 标志）时，主机操作系统和容器之间可能会出现权限问题，我们通过允许您指定用户 PUID 和组 PGID 来避免此问题。

确保主机上的任何卷目录都归您指定的同一用户所有，这样任何权限问题都会像魔法一样消失。

在此示例中 PUID=1000 和 PGID=1000，要查找您的ID，请使用 id your_user，如下所示：

id your_user

示例输出：

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

我们发布了各种 https://github.com/linuxserver/docker-mods%EF%BC%8C%E4%BB%A5%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%E5%90%AF%E7%94%A8%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%E3%80%82%E5%8F%AF%E7%94%A8%E4%BA%8E%E6%AD%A4%E9%95%9C%E5%83%8F%E7%9A%84Mods%E5%88%97%E8%A1%A8%EF%BC%88%E5%A6%82%E6%9C%89%EF%BC%89%E4%BB%A5%E5%8F%8A%E5%8F%AF%E5%BA%94%E7%94%A8%E4%BA%8E%E6%88%91%E4%BB%AC%E4%BB%BB%E4%BD%95%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8Mods%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E4%B8%8A%E6%96%B9%E7%9A%84%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E8%AE%BF%E9%97%AE%E3%80%82

支持信息

• 容器运行时的Shell访问：

docker exec -it webtop /bin/bash

• 实时监控容器日志：

docker logs -f webtop

• 容器版本号：

docker inspect -f '{{ index .Config.Labels "build_version" }}' webtop

• 镜像版本号：

docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/webtop:latest

更新信息

我们的大多数镜像是静态的、版本化的，需要更新镜像并重新创建容器才能更新内部的应用程序。除某些例外情况（在相关readme.md中注明），我们不推荐或支持在容器内更新应用程序。请参考上方的应用程序设置部分，了解是否推荐对此镜像进行应用内更新。

以下是更新容器的说明：

通过Docker Compose

• 更新镜像：
• 所有镜像：

docker-compose pull

• 单个镜像：

docker-compose pull webtop

• 更新容器：
• 所有容器：

docker-compose up -d

• 单个容器：

docker-compose up -d webtop

• 您还可以删除旧的悬空镜像：

docker image prune

通过Docker Run

• 更新镜像：

docker pull lscr.io/linuxserver/webtop:latest

• 停止运行中的容器：

docker stop webtop

• 删除容器：

docker rm webtop

• 使用上述相同的docker run参数重新创建新容器（如果正确映射到主机文件夹，您的 /config 文件夹和设置将被保留）
• 您还可以删除旧的悬空镜像：

docker image prune

镜像更新通知 - Diun（Docker 镜像更新通知器）

[!TIP] 我们推荐使用 Diun 进行更新通知。不推荐或支持其他自动无人值守更新容器的工具。

本地构建

如果您出于开发目的或自定义逻辑需要对这些镜像进行本地修改：

git clone https://github.com/linuxserver/docker-webtop.git
cd docker-webtop
docker build \
--no-cache \
--pull \
-t lscr.io/linuxserver/webtop:latest .

可以使用 lscr.io/linuxserver/qemu-static 在x86_64硬件上构建ARM变体，反之亦然：

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

注册后，您可以使用 -f Dockerfile.aarch64 指定要使用的Dockerfile。

版本历史

• 07.05.26: - 弃用企业级Linux标签。
• 07.04.26: - 将Ubuntu镜像重新基于Resolute。
• 26.03.26: - 将Fedora镜像重新基于44。
• 24.03.26: - 更新支持Wayland的标签，为chromium传递ozone平台参数。
• 27.12.25: - 将Alpine镜像重新基于3.23。
• 17.11.25: - 将Fedora镜像重新基于43。
• 24.07.25: - 将Debian镜像重新基于Trixie。
• 17.06.25: - 将所有镜像重新基于Selkies，移除openbox和icewm，将Alpine升级到3.22，将Fedora升级到42。
• 10.01.25: - 将Fedora重新基于41。
• 06.12.24: - 将Alpine重新基于3.21。
• 26.09.24: - Alpine镜像从firefox切换到chromium。
• 23.05.24: - 将Alpine重新基于3.20，记录Nvidia支持。
• 22.04.24: - 将Ubuntu重新基于Noble。
• 16.04.24: - 添加PRoot应用的文档。
• 14.04.24: - 将Fedora重新基于40。
• 11.02.24: - 正确添加PWA图标和标题变体。
• 06.02.24: - 更新关于原生语言支持的Readme。
• 29.12.23: - 将Alpine重新基于3.19并换回Firefox。
• 07.11.23: - 将Fedora重新基于39。
• 14.06.23: - 重新基于Debian Bookworm。
• 13.05.23: - 重新基于Alpine 3.18和Fedora 38。
• 23.03.23: - 将所有Webtop重新基于KasmVNC基础镜像。
• 21.10.22: - 将xfce重新基于Alpine 3.16，迁移到s6v3。
• 12.03.22: - 添加挂载GPU的文档。
• 05.02.22: - 将KDE Ubuntu重新基于Jammy，添加更新后的gclient文档，停止推荐priv模式。
• 21.09.21: - 添加Fedora和Arch镜像，在readme中显示seccomp设置。
• 26.09.21: - 将Alpine版本重新基于3.14。
• 20.04.21: - 初始发布。