garfieldtux/webtop

garfieldtux/webtop 镜像文档

镜像概述

garfieldtux/webtop是一个基于Arch Linux的Docker镜像，集成了Mate桌面环境，允许用户通过Web浏览器访问完整的图形化桌面界面。该镜像适用于需要远程图形化环境的场景，提供便捷的桌面体验和灵活的配置选项。

核心功能与特性

• Arch Linux基础：基于轻量高效的Arch Linux系统，提供丰富的软件生态
• Mate桌面环境：包含完整的Mate桌面组件，提供直观的图形化操作界面
• Web访问支持：通过Web浏览器即可访问桌面环境，无需额外客户端
• 权限控制：支持自定义用户ID(PUID)和组ID(PGID)，确保文件权限兼容
• 时区配置：可通过环境变量设置时区，适应不同地区需求
• 持久化存储：支持数据卷挂载，保存用户配置和数据

使用场景

• 远程桌面访问：无需本地安装桌面环境，通过浏览器访问图形化界面
• 轻量级开发环境：快速部署包含图形化工具的开发环境
• 测试环境：在隔离环境中测试图形化应用程序
• 家庭服务器图形界面：为家庭服务器提供便捷的图形化管理界面

使用方法

基本部署 (docker run)

以下命令可快速启动webtop容器：

bash
docker run -d \
  --name=webtop \
  --privileged \
  --security-opt seccomp=unconfined \
  -e PUID=501 \
  -e PGID=20 \
  -e TZ=Europe/Paris \
  -p 3000:3000 \
  -v /path/to/local/data:/config \
  --shm-size="3gb" \
  --restart unless-stopped \
  garfieldtux/webtop:latest

参数说明

访问方法

容器启动后，通过浏览器访问http://<宿主机IP>:3000即可进入Mate桌面环境。

Synology NAS部署示例

针对Synology NAS用户，可使用以下命令：

bash
sudo docker run -d \
  --name=webtop \
  --privileged \
  --security-opt seccomp=unconfined \
  -e PUID=1035 \
  -e PGID=100 \
  -e TZ=Europe/Paris \
  -p 3000:3000 \
  -v /volume1/docker/webtop/data:/config \
  --shm-size="3gb" \
  --restart unless-stopped \
  garfieldtux/webtop:latest

（注：将PUID和PGID替换为Synology NAS中实际的用户ID和组ID，/volume1/docker/webtop/data替换为实际存储路径）