amake/wine

suchja/wine Docker镜像文档

镜像概述和主要用途

该镜像允许在Docker容器中运行为Microsoft Windows开发的应用程序。最初设计用于创建Windows安装包（MSI），作为https://registry.hub.docker.com/u/suchja/wix/%E7%9A%84%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E5%90%8C%E6%97%B6%E4%B9%9F%E6%94%AF%E6%8C%81%E5%85%B6%E4%BB%96%E5%A4%9A%E7%A7%8D%E4%BD%BF%E7%94%A8%E5%9C%BA%E6%99%AF%E3%80%82

核心功能和特性

标签说明

提示：Wine 1.8版本已发布（新稳定版），目前最新开发版（1.9.2）尚未在"Wine Team PPA"中提供，因此latest和dev标签当前包含相同版本（1.8）。待开发版可用后将更新。

镜像提供以下标签版本：

• suchja/wine:latest：基于debian:jessie基础镜像，提供Wine最新稳定版（当前为1.6.2）。虽为稳定版但版本较旧（约2年），部分功能可能无法正常工作，同时使用较旧版本的mono以确保兼容性。镜像大小约445MB
• suchja/wine:dev：基于ubuntu:14.04基础镜像，提供较新的开发版Wine（2015年12月24日发布的1.8版本）。由于Wine在Ubuntu上支持更好，开发版更容易获取。镜像大小约740MB

如需最新 bug 修复或前沿版本，建议使用suchja/wine:dev；否则suchja/wine:latest的稳定版已能满足基本需求。

核心组件

除基础镜像包含的组件外，该镜像还提供：

• Wine：允许在Linux机器上运行Windows应用程序
• winetricks：用于安装和更新Wine重要组件的工具（如.NET Framework）

镜像结构

遵循"关注点分离（SoC）"原则，镜像基于以下基础镜像构建：

https://github.com/tianon/docker-brew-debian/blob/188b27233cedf32048ee***e8f8c6fc0fc0cb4/jessie/Dockerfile / https://github.com/tianon/docker-brew-ubuntu-core/blob/7fef77c821d7f806373c04675358ac6179eaeaf3/trusty/Dockerfile%EF%BC%88%E5%8F%96%E5%86%B3%E4%BA%8E%E6%89%80%E9%80%89%E6%A0%87%E7%AD%BE%EF%BC%89

https://registry.hub.docker.com/u/suchja/x11client/dockerfile/%EF%BC%9A%E5%9C%A8%E7%8B%AC%E7%AB%8B%E5%AE%B9%E5%99%A8%E4%B8%AD%E6%98%BE%E7%A4%BAX Window内容

https://registry.hub.docker.com/u/suchja/wine/dockerfile/%EF%BC%9A%E5%BD%93%E5%89%8D%E9%95%9C%E5%83%8F

使用场景和适用范围

• 无图形界面需求：运行Windows控制台应用程序
• 有图形界面需求：配合suchja/x11server运行带GUI的Windows应用
• 开发场景：创建Windows安装包、测试Windows应用在Linux环境下的兼容性

使用方法和配置说明

选择标签

首先选择合适的标签，以下示例默认使用稳定版suchja/wine:latest。

注意：Wine是多进程应用，每次运行wine命令会启动wineserver及其他非子进程。因此在Dockerfile中使用RUN wine your-app.exe会导致问题（Docker认为命令已完成但其他进程仍在运行，可能损坏Wine前缀）。建议仅交互式使用Wine，或在每次调用后等待wineserver完成（参考https://registry.hub.docker.com/u/suchja/wix/%E7%A4%BA%E4%BE%8B%EF%BC%89%E3%80%82

无界面模式（Headless）

无需图形输出时，可直接启动容器：

bash
docker run --rm -it --entrypoint /bin/bash suchja/wine:latest

使用--entrypoint选项可查看Wine窗口输出信息，并抑制基础镜像suchja/x11client的入口脚本执行。可尝试使用wineconsole或Wine的控制台用户界面运行控制台应用。

通过suchja/x11server实现GUI

如需图形输出，需先运行基于https://registry.hub.docker.com/u/suchja/x11server/%E7%9A%84%E5%AE%B9%E5%99%A8%EF%BC%9A

bash
docker run -d --name display -e VNC_PASSWORD=newPW -p 5900:5900 suchja/x11server

然后启动Wine容器：

bash
docker run --rm -it --link display:xserver --volumes-from display suchja/wine:latest /bin/bash

--link display:xserver和--volumes-from display选项仅在需要通过suchja/x11server显示图形时使用，否则可省略（Wine会因无法显示图形而输出警告）。

初始化Wine

容器中未预初始化Wine前缀，首次使用需执行：

bash
wine wineboot --init

若未正确链接suchja/x11server，会出现X服务器未运行或$DISPLAY未定义的警告，运行控制台应用时可忽略。

使用Wine

初始化后，验证版本：

bash
wine --version

验证GUI功能（需已连接X服务器）：

bash
wine notepad.exe

可能出现窗口无标题栏的问题，可使用winegui命令（带额外参数的wine别名）解决：

bash
winegui notepad.exe

或通过winecfg修改图形配置：运行winecfg，切换到"Graphics"选项卡，取消勾选：

• Allow the window manager to decorate the windows（允许窗口管理器装饰窗口）
• Allow the window manager to control the windows（允许窗口管理器控制窗口）

环境变量

可通过docker run -e VARIABLE_NAME=VALUE或容器内export VARIABLE_NAME=VALUE设置以下环境变量：

• WINEDEBUG：控制Wine调试输出，默认值为-all（无输出）。例如：

  bash
  export WINEDEBUG=+all  # 输出所有组件的信息、警告和错误
  

  更多信息：Wine调试通道

• WINEDLLOVERRIDES：控制是否使用原生DLL。例如禁用wine-mono（如需运行原生.NET框架）：

  bash
  export WINEDLLOVERRIDES=mscoree=d
  

  更多信息：Wine DLL覆盖

• WINEARCH：控制Wine架构，默认win32（32位Windows）。初始化前缀前可修改：

  bash
  export WINEARCH=''  # 清除架构设置
  

  更多信息：WINEARCH

• WINEPREFIX：定义Wine前缀目录（存储Windows文件和配置），默认/home/xclient/.wine。可创建多个前缀并切换：

  bash
  export WINEPREFIX=/path/to/new/prefix  # 使用新前缀
  

已知问题

不要在Dockerfile中调用wine

如使用方法所述，Wine多进程特性会导致Dockerfile中RUN wine命令执行异常，可能损坏Wine前缀。

X错误：BadValue

与suchja/x11server配合使用时，执行Wine命令（尤其是首次wine wineboot --init）可能出现：

X Error of failed request:  BadValue (integer parameter out of range for operation)
  Major opcode of failed request:  130 (MIT-SHM)
  Minor opcode of failed request:  3 (X_ShmPutImage)
  Value in failed request:  0x140
  Serial number of failed request:  213
  Current serial number in output stream:  219

推测与远程X服务器相关，目前未发现实际影响，欢迎有X Window/Wine经验者提供解决方案。

维护

该镜像无固定维护计划，Wine发布新版本时可能更新。如遇问题，可在https://github.com/suchja/wine%E6%8F%90%E4%BA%A4issue%EF%BC%8C%E5%B0%86%E5%B0%BD%E5%BF%AB%E5%A4%84%E7%90%86%E3%80%82

版权信息

构建该镜像的https://github.com/suchja/wine%E6%BA%90%E7%A0%81%E6%97%A0%E7%89%88%E6%9D%83%E9%99%90%E5%88%B6%EF%BC%88%E8%A7%81LICENSE.md%EF%BC%89%EF%BC%8C%E5%8F%AF%E8%87%AA%E7%94%B1%E4%BD%BF%E7%94%A8%EF%BC%88%E5%A6%82Dockerfile%E5%92%8CREADME.md%EF%BC%89%E3%80%82