Webtop - 基于 Alpine、Ubuntu、Fedora 和 Arch 的容器，包含官方支持的完整桌面环境，可通过任何现代 Web 浏览器访问。

项目地址：https://github.com/linuxserver/docker-webtop

支持的架构

支持系统标签

安装Docker🐳

现代 GUI 桌面应用程序（包括某些风格的终端）与最新的 Docker 和系统调用兼容性存在问题，您可以使用 Docker 并设置 --security-opt seccomp=unconfined允许这些系统调用

直接运行

docker run -d \\
--name=webtop \\
--security-opt seccomp=unconfined \\
-e PUID=1000 \\
-e PGID=1000 \\
-e TZ=Etc/UTC \\
-e SUBFOLDER=/ \\
-e TITLE=Webtop \\
-e LC\_ALL=zh\_CN.UTF-8 \\
-e DOCKER\_MODS=linuxserver/mods:universal-package-install \\
-e INSTALL\_PACKAGES=font-noto-cjk \\
-p 3080:3000 \\
-p 3443:3001 \\
-v /home/docker/webtop/data:/config \\
-v /var/run/docker.sock:/var/run/docker.sock \\
--device /dev/dri:/dev/dri \\
--shm-size="1gb" \\
--restart unless-stopped \\
lscr.io/linuxserver/webtop:latest

更多镜像系统（可选）

lscr.io/linuxserver/webtop:latest

lscr.io/linuxserver/webtop:ubuntu-xfce

lscr.io/linuxserver/webtop:fedora-xfce

lscr.io/linuxserver/webtop:arch-xfce

lscr.io/linuxserver/webtop:debian-xfce

我们现在可以输入 http://ip:3000/访问了。如果你要是用https方案，使用 https://ip:3001/这个地址即可

利用Docker-compose搭建，易于更新

先建立一个文件夹

mkdir -p ~/webtop &&cd $_

vim docker-compose.yml

docker-compose填入以下内容：

services:
  webtop:
    image: lscr.io/linuxserver/webtop:latest
    container_name: webtop
    security_opt:
      - seccomp:unconfined #optional
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - SUBFOLDER=/ #optional
      - TITLE=Webtop #optional
    volumes:
      - /path/to/data:/config
      - /var/run/docker.sock:/var/run/docker.sock #optional
    ports:
      - 3000:3000
      - 3001:3001
    devices:
      - /dev/dri:/dev/dri #optional
    shm_size: "1gb" #optional
    restart: unless-stopped

修改好之后，注意切换成英文输入法，然后按一下 esc，然后 :wq 保存退出。

运行

docker-compose up -d

同样的，我们可以输入 http://ip:3000/访问了。如果你要是用https方案，使用 https://ip:3001/这个地址。

反向代理

参考教程：安装及使用

⚠️Nginx Proxy Manager（以下简称NPM）会用到80、443端口，所以本机不能占用（比如原来就有Nginx）

互联网使用请确保完成了域名解析

使用配置

无损模式

通过将流质量预设更改为“无损”，此容器能够以高帧速率向您的 Web 浏览器提供真正的无损图像，更多信息请见此处⁠。为了从非本地主机端点使用此模式，需要使用 3001 上的 HTTPS 端口。如果使用反向代理端口 3000，则需要按照此处所述设置特定标头⁠。

nginx配置增加

add_header 'Cross-Origin-Embedder-Policy' 'require-corp';
add_header 'Cross-Origin-Opener-Policy' 'same-origin';
add_header 'Cross-Origin-Resource-Policy' 'same-site';

容器参数（可选）

容器使用运行时传递的参数进行配置。这些参数用冒号分隔，<external>:<internal>分别表示。例如，-p 8080:80将从容器内部公开端口，以便从容器外部的 80端口上的主机 IP 进行访问。8080

可选环境变量

可选运行配置

来自文件的环境变量（Docker secrets）

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

举个例子：

-e FILE__MYVAR=/run/secrets/mysecretvariable

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

语言支持 - 国际化

环境变量 LC_ALL可用于以英语以外的其他语言启动 Webtop，例如，只需传递以法语启动桌面会话即可 LC_ALL=fr_FR.UTF-8。某些语言（如中文、日语或韩语）缺少正确呈现所需的字体（称为 cjk 字体），但其他语言可能存在但未安装在 Webtop 中，具体取决于您正在运行的底层发行版。我们仅确保存在拉丁字符的字体。字体可以在启动时使用 mod 安装。

以启动时安装 cjk 字体为例，传递环境变量（Alpine 为例）：

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

Web 界面在“设置”中有一个“IME 输入模式”选项，允许在客户端的非 en_US 键盘上使用非英文字符。启用后，其执行效果与设置为您所在地区的本地 Linux 安装相同。

DRI3 GPU 加速

对于加速应用或游戏，可以将渲染设备安装到容器中，并由应用程序使用以下方式利用：

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

此功能仅支持开源GPU 驱动程序：

环境 DRINODE变量可用于指向特定 GPU。最新信息可在此处找到⁠

显示合成（桌面效果）

当将此图像与受支持的视频卡结合使用时，合成将正常运行，但在为使用它的应用程序同步帧与像素图时，性能会受到影响。如果相关应用程序需要合成，但需要在容器中安装真正的 GPU，这可以大大提高应用程序兼容性。默认情况下，我们会出于下游图像的性能原因在 DE 级别禁用合成，但用户可以启用它，并且使用合成的程序仍将正常运行，即使 DE 在其设置中禁用了它。在构建桌面图像时，请务必了解，默认情况下启用它后，只有安装了兼容 GPU 的用户才能使用您的图像。

Nvidia GPU 支持

Nvidia 与基于 Alpine 的图像不兼容

利用 Zink 获得 OpenGL 支持即可获得 Nvidia 支持。可以使用以下运行标志启用此功能：

由于您需要将 nvidia 设置为默认运行时，因此撰写语法略有不同：

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

并在组合中分配 GPU：

services:
  webtop:
    image: linuxserver/webtop:debian-kde
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [compute,video,graphics,utility]