tibynx/webtop

🖥️ Webtop

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

!https://github.com/tibynx/webtop/raw/main/.github/preview.png

桌面环境

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

安装配置

可通过docker-compose或docker命令行工具设置容器。除非参数标记为“可选”，否则均为必填项，必须提供值。该容器基于linuxserver.io基础镜像，因此可以使用其https://github.com/linuxserver/docker-mods%E5%92%8C%E9%85%8D%E7%BD%AE%E6%9D%A5%E5%90%AF%E7%94%A8%E5%AE%B9%E5%99%A8%E5%86%85%E7%9A%84%E9%A2%9D%E5%A4%96%E5%8A%9F%E8%83%BD%E3%80%82

docker-compose（推荐）

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

docker-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%E6%88%96Tailscale%E3%80%82

配置参数

容器通过运行时传递的参数进行配置（如上所示）。这些参数用冒号分隔，表示<外部>:<内部>。例如，-p 8080:80会将容器内的80端口暴露到主机IP的8080端口。更多选项可在https://github.com/linuxserver/docker-baseimage-kasmvnc#options%E4%BB%93%E5%BA%93%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

更新说明

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

应用安装

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

PRoot Apps

通过apt-get install等方式原生安装的软件包在容器重建后不会保留。要在容器更新时保留应用及其设置，请使用https://github.com/linuxserver/proot-apps%E3%80%82%E8%BF%99%E4%BA%9B%E6%98%AF%E5%AE%89%E8%A3%85%E5%9C%A8%E7%94%A8%E6%88%B7%E6%8C%81%E4%B9%85%E5%8C%96%60$HOME%60%E7%9B%AE%E5%BD%95%E4%B8%AD%E7%9A%84%E4%BE%BF%E6%90%BA%E5%BA%94%E7%94%A8%E3%80%82

要安装应用，在容器内使用命令行。支持的应用列表可在https://github.com/linuxserver/proot-apps?tab=readme-ov-file#supported-apps%E6%9F%A5%E7%9C%8B%E3%80%82

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地址并使用设置时提供的端口。

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