
tibynx/webtop基于KasmVNC技术的Linux容器,提供完整的桌面环境,可通过任何现代Web浏览器访问。
!webtop
要使用特定桌面环境,只需更改Docker镜像标签。
| 基础发行版 | 桌面环境 | Docker镜像标签 |
|---|---|---|
| Debian 12 | KDE Plasma | latest |
| Ubuntu 24.04 | Ubuntu Desktop | ubuntu |
| Ubuntu 24.04 | KDE Plasma | kubuntu |
| Ubuntu 24.04 | Zorin OS Desktop | zorinos-core |
可通过docker-compose或docker命令行工具设置容器。除非参数标记为“可选”,否则均为必填项,必须提供值。该容器基于linuxserver.io基础镜像,因此可以使用其mods和配置来启用容器内的额外功能。
yaml--- services: webtop: image: tibynx/webtop:latest container_name: webtop security_opt: - seccomp:unconfined #可选 environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - SUBFOLDER=/ #可选 - TITLE=Webtop #可选 volumes: - /path/to/data:/config - /var/run/docker.sock:/var/run/docker.sock #可选 ports: - 3000:3000 - 3001:3001 devices: - /dev/dri:/dev/dri #可选 shm_size: "1gb" #可选 restart: unless-stopped
bashdocker run -d \ --name=webtop \ --security-opt seccomp=unconfined `#可选` \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -e SUBFOLDER=/ `#可选` \ -e TITLE=Webtop `#可选` \ -p 3000:3000 \ -p 3001:3001 \ -v /path/to/data:/config \ -v /var/run/docker.sock:/var/run/docker.sock `#可选` \ --device /dev/dri:/dev/dri `#可选` \ --shm-size="1gb" `#可选` \ --restart unless-stopped \ tibynx/webtop:latest
默认情况下,此容器无身份验证。配置可选环境变量CUSTOM_USER和PASSWORD可启用基本HTTP认证。这仅应用于本地网络中保护容器。如果要将容器暴露到互联网,建议使用反向代理或***,如SWAG或Tailscale。
容器通过运行时传递的参数进行配置(如上所示)。这些参数用冒号分隔,表示<外部>:<内部>。例如,-p 8080:80会将容器内的80端口暴露到主机IP的8080端口。更多选项可在KasmVNC基础镜像仓库中找到。
| 参数 | 功能 |
|---|---|
-p 3000:3000 | Web桌面GUI HTTP端口,需代理 |
-p 3001:3001 | Web桌面GUI HTTPS端口 |
-e PUID=1000 | 用户ID |
-e PGID=1000 | 组ID |
-e TZ=Etc/UTC | 指定时区,详见此列表 |
-e SUBFOLDER=/ | 指定反向代理使用的子文件夹,如/subfolder/ |
-e TITLE=Webtop | 浏览器页面/标签标题 |
-v /config | abc用户的主目录,存储本地文件和设置 |
-v /var/run/docker.sock | 系统Docker套接字,如需在容器内使用Docker |
--device /dev/dri | 添加以支持GL(仅Linux主机) |
--shm-size= | 设置为1GB以防止现代Web浏览器崩溃 |
--security-opt seccomp=unconfined | 仅Docker引擎需要,许多现代GUI应用在旧主机上运行时需要此选项,因为Docker可能不识别某些系统调用 |
此镜像并非始终保持最新。要更新或安装软件包,请使用桌面的包管理器。下文将介绍持久化应用的相关内容。建议定期拉取最新镜像并重新部署容器以更新已配置的mod。
有两种在容器内安装应用的方法:PRoot Apps(推荐用于持久化)和原生应用。
通过apt-get install等方式原生安装的软件包在容器重建后不会保留。要在容器更新时保留应用及其设置,请使用proot-apps。这些是安装在用户持久化$HOME目录中的便携应用。
要安装应用,在容器内使用命令行。支持的应用列表可在此处查看。
proot-apps install filezilla
可使用universal-package-install mod从系统原生仓库安装软件包。此方法会增加容器启动时间且不持久。在compose.yaml中添加以下内容:
yamlenvironment: - DOCKER_MODS=linuxserver/mods:universal-package-install - INSTALL_PACKAGES=libfuse2|git|gdb
要访问容器,请导航至您机器的IP地址并使用设置时提供的端口。



manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务