linuxserver/winegui

linuxserver/winegui 镜像文档

镜像概述和主要用途

WineGUI是一款用户友好的Wine管理器，提供图形化前端用于创建和管理Wine bottles（独立的Wine环境）。本Docker镜像由LinuxServer.io提供，将WineGUI容器化，便于用户在各种环境中轻松部署和使用，无需直接在主机系统配置Wine。

核心功能和特性

• 图形化界面：提供直观的用户界面，简化Wine环境的创建和管理
• Wine bottles管理：支持创建、配置和维护多个独立的Wine环境（bottles）
• 容器化部署：通过Docker容器运行，隔离主机系统，简化安装和升级流程
• 跨平台兼容：可在支持Docker的任何系统上运行，包括Linux、macOS和Windows（通过WSL2）

使用场景和适用范围

• 需要在Linux系统中运行Windows应用程序的用户
• 希望隔离不同Windows应用程序运行环境的场景
• 开发或测试环境中需要快速部署和切换Wine配置的需求
• 对命令行操作不熟悉，偏好图形界面管理Wine的用户

使用方法和配置说明

基本部署命令

使用以下docker run命令部署WineGUI容器：

bash
docker run -d \
  --name=winegui \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/winegui/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/winegui:latest

参数说明

• 容器名称：--name=winegui - 指定容器名称为winegui
• 环境变量：
  • PUID=1000 - 运行容器的用户ID，确保容器内权限与主机一致
  • PGID=1000 - 运行容器的用户组ID，同上
  • TZ=Etc/UTC - 设置容器时区，例如Asia/Shanghai表示中国标准时间
• 端口映射：
  • -p 3000:3000 - Web界面端口映射
  • -p 3001:3001 - 应用访问端口映射
• 卷挂载：-v /path/to/winegui/config:/config - 将主机目录挂载到容器内的配置目录，用于持久化存储WineGUI配置和Wine bottles数据
• 共享内存：--shm-size="1gb" - 设置共享内存大小，确保图形界面流畅运行
• 自动重启：--restart unless-stopped - 除非手动停止，否则容器自动重启

访问应用

容器部署完成后，通过以下地址访问WineGUI应用：

• [***]