tibynx/webtop

🖥️ Webtop

基于KasmVNC技术的Linux容器，提供完整的桌面环境，可通过任何现代Web浏览器访问。

桌面环境

要使用特定桌面环境，只需更改Docker镜像标签。

安装配置

可通过docker-compose或docker命令行工具设置容器。除非参数标记为“可选”，否则均为必填项，必须提供值。该容器基于linuxserver.io基础镜像，因此可以使用其https://github.com/linuxserver/docker-mods和配置来启用容器内的额外功能。

https://docs.linuxserver.io/general/docker-compose（推荐）

yaml
---
services:
  webtop:
    image: docker.xuanyuan.run/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

https://docs.docker.com/engine/reference/commandline/cli/

bash
docker 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认证。这仅应用于本地网络中保护容器。如果要将容器暴露到互联网，建议使用反向代理或***，如https://github.com/linuxserver/docker-swag或Tailscale。

配置参数

容器通过运行时传递的参数进行配置（如上所示）。这些参数用冒号分隔，表示<外部>:<内部>。例如，-p 8080:80会将容器内的80端口暴露到主机IP的8080端口。更多选项可在https://github.com/linuxserver/docker-baseimage-kasmvnc#options仓库中找到。

更新说明

此镜像并非始终保持最新。要更新或安装软件包，请使用桌面的包管理器。下文将介绍持久化应用的相关内容。建议定期拉取最新镜像并重新部署容器以更新已配置的mod。

应用安装

有两种在容器内安装应用的方法：PRoot Apps（推荐用于持久化）和原生应用。

PRoot Apps

通过apt-get install等方式原生安装的软件包在容器重建后不会保留。要在容器更新时保留应用及其设置，请使用https://github.com/linuxserver/proot-apps。这些是安装在用户持久化`$HOME`目录中的便携应用。

要安装应用，在容器内使用命令行。支持的应用列表可在https://github.com/linuxserver/proot-apps?tab=readme-ov-file#supported-apps查看。

proot-apps install filezilla

原生应用

可使用https://github.com/linuxserver/docker-mods/tree/universal-package-install mod从系统原生仓库安装软件包。此方法会增加容器启动时间且不持久。在compose.yaml中添加以下内容：

yaml
  environment:
    - DOCKER_MODS=linuxserver/mods:universal-package-install
    - INSTALL_PACKAGES=libfuse2|git|gdb

使用方法

要访问容器，请导航至您机器的IP地址并使用设置时提供的端口。

• [***]
• [***]