xjogger/webtop

xjogger/webtop 镜像文档

镜像概述

xjogger/webtop 是一个基于 linuxserver/webtop 的 Docker 镜像，在其基础上新增了 Nginx 服务，该服务监听 8080 端口并转发请求至 3000 端口，使用户可通过 Web 浏览器便捷访问桌面环境。

核心功能与特性

• 继承 linuxserver/webtop 的全部功能，提供完整的桌面环境
• 内置 Nginx 服务，通过 8080 端口访问 3000 端口的桌面服务
• 支持用户身份配置（PUID/PGID）、时区设置及自定义登录凭证
• 持久化配置存储，支持数据卷挂载

使用场景

• 远程桌面访问需求，如在家办公、异地操作
• 轻量级桌面环境测试与演示
• 需要通过 Web 浏览器快速访问桌面应用的场景

使用方法与配置说明

基本部署命令

bash
docker run -d \
  --name=firefox \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e USER=your_user_name \
  -e PASSWD=your_password \
  -p 8080:8080 \
  -v /path/to/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  xjogger/webtop

参数说明

环境变量

• PUID: 用户ID，用于设置容器内进程的用户权限，默认建议设为 1000
• PGID: 用户组ID，与 PUID 配合使用，默认建议设为 1000
• TZ: 时区设置，如 Asia/Shanghai 表示中国上海时区
• USER: 登录桌面环境的用户名
• PASSWD: 登录桌面环境的密码

端口映射

• -p 8080:8080: 将容器内 Nginx 服务的 8080 端口映射到宿主机的 8080 端口，通过宿主机 IP:8080 访问桌面环境

数据卷

• -v /path/to/config:/config: 将宿主机目录挂载到容器内的 /config 目录，用于持久化存储桌面环境配置

其他设置

• --shm-size="1gb": 设置共享内存大小，建议至少 1GB 以保证桌面环境流畅运行
• --restart unless-stopped: 设置容器重启策略，除非手动停止，否则自动重启

访问方式

部署完成后，通过浏览器访问 http://宿主机IP:8080，输入配置的 USER 和 PASSWD 即可登录桌面环境。