jjm2473/webtop Docker 镜像

jjm2473/webtop 镜像文档

镜像概述

jjm2473/webtop 是基于 linuxserver/webtop 的分支镜像，主要修改包括将默认浏览器替换为 Firefox，并添加中文支持，提供可通过 Web 访问的桌面环境。

核心功能与特性

• 浏览器替换：将默认浏览器从 Chrome 更改为 Firefox
• 中文支持：内置中文语言包和编码支持（LC_ALL=zh_CN.UTF-8）
• Web 访问：通过浏览器即可访问完整的桌面环境
• 兼容性：继承 linuxserver/webtop 的核心功能，支持图形加速和音频输出

使用场景

• 需要通过 Web 远程访问桌面环境的用户
• 偏好 Firefox 浏览器的用户
• 对中文显示和输入有需求的用户
• 开发或测试环境中需要临时桌面环境的场景

使用方法

Docker Compose 部署示例

yaml
---
version: "2.1"
services:
  webtop:
    image: docker.xuanyuan.run/jjm2473/webtop:latest
    container_name: webtop
    security_opt:
      - seccomp:unconfined
    network_mode: bridge
    dns: 172.17.0.1
    environment:
      - TITLE=Webtop  # 桌面标题
      - PUID=1000     # 用户ID，用于权限控制
      - PGID=1000     # 用户组ID，用于权限控制
      - TZ=Asia/Shanghai  # 时区设置
      - START_DOCKER=false  # 是否启动Docker服务
      - PULSE_RUNTIME_PATH=/tmp/pulse/default  # 音频运行时路径
      - LC_ALL=zh_CN.UTF-8  # 中文编码设置
    volumes:
      - xorg:/tmp/.X11-unix  # X11套接字卷
      - pulse:/tmp/pulse      # 音频卷
      - /mnt/data/Configs/Webtop:/config  # 配置文件持久化路径
    devices:
      - /dev/dri:/dev/dri  # 图形加速设备
    ports:
      - 3000:3000  # Web访问端口
      - 3001:3001  # 备用端口
    shm_size: "2gb"  # 共享内存大小
    ipc: shareable   # IPC共享设置
    restart: unless-stopped  # 重启策略

volumes:
  xorg:
  pulse:

Docker Run 命令示例

bash
docker run -d \
  --name=webtop \
  --security-opt seccomp=unconfined \
  --network=bridge \
  --dns=172.17.0.1 \
  -e TITLE=Webtop \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e START_DOCKER=false \
  -e PULSE_RUNTIME_PATH=/tmp/pulse/default \
  -e LC_ALL=zh_CN.UTF-8 \
  -v xorg:/tmp/.X11-unix \
  -v pulse:/tmp/pulse \
  -v /mnt/data/Configs/Webtop:/config \
  --device /dev/dri:/dev/dri \
  -p 3000:3000 \
  -p 3001:3001 \
  --shm-size=2gb \
  --ipc=shareable \
  --restart unless-stopped \
  docker.xuanyuan.run/jjm2473/webtop:latest

配置参数说明

环境变量

卷挂载

端口映射

设备映射

• /dev/dri:/dev/dri：用于图形硬件加速

其他设置

• shm_size: "2gb"：设置共享内存大小，提升图形性能
• ipc: shareable：启用IPC共享，增强进程间通信
• restart: unless-stopped：除非手动停止，否则容器自动重启