Repolode
linuxserver

linuxserver/docker-webtop

基于 Docker 的 Linux 桌面镜像,可在任意现代浏览器中直接使用完整桌面环境。

Star
4,458
Fork
378
未关闭 Issue
0
最近提交
前天

这是什么?

Webtop 是 LinuxServer.io 提供的一组 Docker 镜像,将完整的 Linux 桌面环境封装在容器中,并通过网页浏览器远程访问。镜像基于 Alpine、Ubuntu、Debian、Fedora 或 Arch 构建,提供 XFCE、KDE、MATE、i3、LXQt 等多种桌面版本,每种组合都有对应标签。

镜像基于 Selkies 串流平台实现,通过 HTTPS 的 3001 端口访问桌面。支持 Intel、AMD 和 Nvidia 显卡的硬件加速,并提供文件传输、剪贴板同步、音频和手柄支持。配置通过 PUID、PGID、TZ 等环境变量完成,挂载 /config 目录即可持久保存用户数据。

由于容器内的网页桌面默认提供免密 sudo,建议仅在可信网络中运行,或放在具备强认证的反向代理之后。

核心功能

  • 01提供 XFCE、KDE、MATE、i3、LXQt 等多种桌面版本。
  • 02基础系统可选 Alpine、Ubuntu、Debian、Fedora 或 Arch。
  • 03通过任意现代浏览器经 HTTPS 访问桌面。
  • 04支持 Intel、AMD 和 Nvidia 显卡的可选硬件加速。
  • 05网页端支持剪贴板同步、文件传输、音频和手柄。
  • 06可通过环境变量配置用户 ID、时区,并持久保存配置目录。

适用场景

  • 在浏览器中快速启动一次性的 Linux 桌面,用于测试或培训。
  • 在没有安装 Linux 的设备上访问完整的 Linux 环境。
  • 在家庭或实验室服务器上搭建共享的桌面环境。
  • 无需在宿主机安装,即可体验不同的桌面环境。

快速上手

  1. 1

    使用 docker run 命令启动最小测试容器

    docker run --rm -it --shm-size=1gb -p 3001:3001 lscr.io/linuxserver/webtop:latest bash
  2. 2

    在浏览器中打开 https://localhost:3001 并接受自签名证书警告

使用前须知

  • 默认情况下具有特权访问主机的能力且无身份验证,未加保护不应暴露到互联网。
  • 网页界面提供免密码 sudo,任何能访问它的人都可以在容器内获得 root 权限。
  • Nvidia GPU 加速需要专有驱动,且 Alpine 系列镜像不支持。

收录于专题

标签

常见问题

docker-webtop 是什么?
基于 Docker 的 Linux 桌面镜像,可在任意现代浏览器中直接使用完整桌面环境。 Webtop 是 LinuxServer.io 提供的一组 Docker 镜像,将完整的 Linux 桌面环境封装在容器中,并通过网页浏览器远程访问。镜像基于 Alpine、Ubuntu、Debian、Fedora 或 Arch 构建,提供 XFCE、KDE、MATE、i3、LXQt 等多种桌面版本,每种组合都有对应标签。
docker-webtop 可以免费使用吗?用的什么许可证?
docker-webtop 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
docker-webtop 还在维护吗?
活跃维护中。docker-webtop 最近一次提交是在 2026年10月22日。
docker-webtop 适合用来做什么?
在浏览器中快速启动一次性的 Linux 桌面,用于测试或培训。 在没有安装 Linux 的设备上访问完整的 Linux 环境。 在家庭或实验室服务器上搭建共享的桌面环境。 无需在宿主机安装,即可体验不同的桌面环境。
docker-webtop 怎么安装和运行?
使用 docker run 命令启动最小测试容器: docker run --rm -it --shm-size=1gb -p 3001:3001 lscr.io/linuxserver/webtop:latest bash 在浏览器中打开 https://localhost:3001 并接受自签名证书警告
在哪里获取 docker-webtop?
源代码和安装说明在 GitHub 上:https://github.com/linuxserver/docker-webtop

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目