tobix/wine

Docker化 Wine 与 Wine-Staging 镜像文档

镜像概述和主要用途

本镜像为包含 Wine 或 Wine-Staging 的 Docker 容器，旨在提供隔离环境以运行 Windows 应用程序。基于 Wine 项目（[] Wine-Staging 项目（[] Windows 环境（如 Linux）中通过 Docker 容器化运行 Windows 可执行文件。

核心功能和特性

• 多版本支持：提供稳定版、开发版和测试版 Wine，满足不同场景需求。
• GUI 应用支持：集成 Xvfb（虚拟帧缓冲），可运行带图形界面的 Windows 应用程序。
• 进程管理优化：使用 tini 作为入口点，解决 xvfb-run 因进程分叉导致的挂起问题。

使用场景和适用范围

• 跨平台运行 Windows 应用：在 Linux 服务器或容器化环境中运行无原生 Linux 版本的 Windows 软件。
• GUI 应用容器化：需图形界面的 Windows 应用（如旧版客户端工具、特定行业软件）的隔离部署。
• 自动化测试环境：为 Windows 应用的自动化测试提供标准化容器环境。
• 旧版软件兼容：通过指定 Wine 版本，兼容依赖特定 Windows 环境的旧版应用。

标签说明

镜像提供以下标签，对应不同版本的 Wine：

详细使用方法和配置说明

1. 选择镜像标签

根据需求选择对应标签的镜像，例如使用稳定版：

bash
docker pull tobix/wine:stable

2. 运行基础 Windows 应用（无 GUI）

对于无图形界面的 Windows 可执行文件（如命令行工具），直接使用 wine 命令运行：

bash
# 示例：运行当前目录下的 app.exe（需挂载本地目录到容器）
docker run --rm -v $(pwd):/app tobix/wine:stable wine /app/app.exe

3. 运行 GUI 应用（通过 Xvfb）

如需运行带图形界面的应用，需使用 xvfb-run 前缀命令（Xvfb 提供虚拟显示服务）：

bash
# 示例：运行带 GUI 的 gui_app.exe
docker run --rm -v $(pwd):/app tobix/wine:stable xvfb-run wine /app/gui_app.exe

4. 多进程运行优化

同时运行多个 Wine 进程时，建议在单个 Xvfb 调用中包裹所有进程，避免重复创建 Xvfb 实例：

bash
# 示例：依次运行 app1.exe、app2.exe，并等待所有进程完成
docker run --rm -v $(pwd):/app tobix/wine:stable xvfb-run sh -c "\
  wine /app/app1.exe && \
  wine /app/app2.exe && \
  wineserver -w  # 等待所有 Wine 进程结束
"

关键工具说明

• Xvfb：虚拟 X 服务器，为无物理显示设备的环境提供图形渲染支持。
• tini：轻量级进程管理器，作为容器入口点处理进程信号和子进程回收，避免 xvfb-run 因进程分叉导致的挂起问题。

Docker 部署示例

示例 1：运行单个 GUI 应用

bash
# 挂载本地目录到容器的 /workspace，运行带 GUI 的 setup.exe
docker run --rm -v $(pwd):/workspace tobix/wine:staging xvfb-run wine /workspace/setup.exe

示例 2：多进程批量处理

bash
# 在容器内批量运行多个 Windows 工具，并等待全部完成
docker run --rm -v $(pwd):/data tobix/wine:devel xvfb-run sh -c "\
  wine /data/tool1.exe process /data/input1.txt && \
  wine /data/tool2.exe convert /data/input2.csv -o /data/output.csv && \
  wineserver -w
"