ghcr.io/linuxserver/webtop:arm64v8-dev-version-155182a7

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

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

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

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

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 和我们的公告 https://blog.linuxserver.io/2019/02/21/the-lsio-pipeline-project/ 获取。

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

此镜像支持的架构如下：

版本标签

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

应用设置

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

• [***]

严格反向代理

此镜像默认使用自签名证书。这自然意味着协议为 https。 如果您使用的反向代理会验证证书，则需要https://docs.linuxserver.io/faq#strict-proxy。

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

安全性

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

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

默认情况下，此容器没有身份验证。可选的 CUSTOM_USER 和 PASSWORD 环境变量可启用基本 HTTP 身份验证，这仅适用于在受信任的本地网络上保护容器。对于互联网暴露，我们强烈建议将容器置于反向代理（如 https://github.com/linuxserver/docker-swag）之后，并使用强大的身份验证机制。

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

虽然通常不推荐，但某些 legacy 环境（特别是那些使用较旧硬件或过时 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] Nvidia 支持不适用于基于 Alpine 的镜像。

前提条件：

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
• 浏览器扩展： https://chromewebstore.google.com/detail/sealskin-isolation/lclgfmnljgacfdpmmmjmfpdelndbbfhk 和 https://addons.mozilla.org/en-US/firefox/addon/sealskin-isolation/。
• 移动应用： https://apps.apple.com/us/app/sealskin/id6758210210 和 https://play.google.com/store/apps/details?id=io.linuxserver.sealskin

所有基于 Selkies 的 GUI 容器选项

此容器基于 https://github.com/linuxserver/docker-baseimage-selkies。

点击展开：可选环境变量

WATERMARK_LOCATION 选项：

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

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

语言支持 - 国际化

要以其他语言启动桌面会话，请设置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 - 意大利语

参数

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

版本历史

• 10.06.26: - 将Alpine镜像重新基于3.24版本构建。
• 07.05.26: - 弃用Enterprise 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 Apps的文档。
• 14.04.24: - 将Fedora重新基于40版本构建。
• 11.02.24: - 正确添加PWA图标和标题变体。
• 06.02.24: - 更新自述文件中关于原生语言支持的内容。
• 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镜像，在自述文件中显示seccomp设置。
• 26.09.21: - 将Alpine版本重新基于3.14构建。
• 20.04.21: - 初始发布。