yantis/wine

docker-wine 镜像文档

镜像概述和主要用途

docker-wine是一个在Docker环境中运行Wine的镜像，集成了动态图形驱动和VirtualGL技术，支持本地和远程两种方式运行Windows应用程序。它能够自动适配Nvidia和Mesa等最新显卡驱动，无需VNC或窗口管理器即可实现如同本地应用的无缝体验，适用于在Linux系统或远程服务器上便捷运行Windows应用。

核心功能和特性

• 动态驱动适配：自动适配Nvidia和Mesa等最新显卡驱动，无需手动配置
• 本地与远程支持：支持本地直接运行和通过远程服务器运行Windows应用
• 无缝体验：无需VNC或窗口管理器，应用显示效果如同本地程序
• 数据持久化：通过共享卷存储Windows应用数据，确保数据不丢失
• 安全便捷：支持SSH密钥认证，可配置密码登录，保障远程访问安全

使用场景和适用范围

• 在Linux系统上运行仅支持Windows的应用程序
• 远程服务器（如AWS EC2）运行Windows应用以保护本地IP隐私（如Skype）
• 局域网内共享显卡资源运行图形密集型Windows应用
• 开发或测试环境中快速部署Windows应用，避免系统环境冲突

详细使用方法和配置说明

本地使用

基本命令

以下示例启动容器并运行Windows版Skype（首次运行会安装，后续直接启动）：

bash
xhost +si:localuser:$(whoami) >/dev/null
docker run \
    --privileged \
    --rm \
    -ti \
    -e DISPLAY \
    -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
    -v ~/docker-data/wine:/home/docker/wine/ \
    -v /etc/localtime:/etc/localtime:ro \
    -u docker \
    yantis/wine /bin/bash -c "sudo initialize-graphics >/dev/null 2>/dev/null; vglrun /home/docker/templates/skype.template;"

参数说明

• xhost +si:localuser:$(whoami)：允许本地用户访问X11 socket
• --privileged：特权模式，用于访问显卡设备
• --rm：容器退出后自动删除
• -ti：交互式终端，支持CTRL+C终止
• -e DISPLAY：设置显示环境变量，指向本地显示
• -v /tmp/.X11-unix:/tmp/.X11-unix:ro：只读挂载本地X11 socket
• -v ~/docker-data/wine:/home/docker/wine/：共享卷，存储Windows应用数据
• -v /etc/localtime:/etc/localtime:ro：同步容器与主机时间
• -u docker：以docker用户运行容器
• initialize-graphics：初始化显卡驱动
• vglrun：使用VirtualGL运行图形应用

远程使用

服务器端配置

在远程服务器（如AWS EC2）后台运行容器：

bash
docker run \
    --privileged \
    -ti \
    --rm \
    -v $HOME/.ssh/authorized_keys:/authorized_keys:ro \
    -p 49158:22 \
    -v ~/docker-data/wine:/home/docker/wine/ \
    yantis/wine

参数说明

• --privileged：特权模式（若不想使用特权模式，可指定设备，如--device=/dev/nvidia0:/dev/nvidia0等）
• -v $HOME/.ssh/authorized_keys:/authorized_keys:ro：挂载SSH公钥，禁用密码登录（默认密码docker/docker）
• -p 49158:22：映射SSH端口，便于远程连接
• 其他参数同本地使用

客户端连接

2D应用（无需VirtualGL）

bash
ssh -Y docker@hostname -p 49158 -t wine explorer.exe

3D应用（需安装VirtualGL）

• 安装VirtualGL（如Arch Linux：pacman -S virtualgl）
• 仅SSH认证（数据不加密，推荐）：

bash
vglconnect -Y docker@hostname -p 49158 -t vglrun wine explorer.exe

• SSH认证且数据加密：

bash
vglconnect -Y -s docker@hostname -p 49158 -t vglrun wine explorer.exe

注意：远程使用时需开放防火墙端口（4200-4300范围），否则可能出现黑屏或无法显示。

使用示例

示例1：运行Windows版Skype

Skype需要3D图形支持，需初始化显卡驱动：

bash
xhost +si:localuser:$(whoami) >/dev/null
docker run \
    --privileged \
    --rm \
    -ti \
    -e DISPLAY \
    -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
    -v ~/docker-data/wine:/home/docker/wine/ \
    -v /etc/localtime:/etc/localtime:ro \
    -u docker \
    yantis/wine /bin/bash -c "sudo initialize-graphics >/dev/null 2>/dev/null; vglrun /home/docker/templates/skype.template;"

示例2：运行SQLyog（无需3D支持）

SQLyog为2D应用，无需特权模式和3D初始化：

bash
xhost +si:localuser:$(whoami) >/dev/null
docker run \
    --rm \
    -ti \
    -e DISPLAY \
    -v /tmp/.X11-unix:/tmp/.X11-unix:ro \
    -v ~/docker-data/wine:/home/docker/wine/ \
    -u docker \
    yantis/wine sh /home/docker/templates/sqlyog.template

镜像结构

docker-wine基于以下镜像构建：

https://github.com/yantis/docker-archlinux-tiny
└── https://github.com/yantis/docker-archlinux-small
└── https://github.com/yantis/docker-archlinux-ssh-hpn
└── https://github.com/yantis/docker-ssh-hpn-x
└── https://github.com/yantis/docker-dynamic-video
└── https://github.com/yantis/docker-virtualgl
└── https://github.com/yantis/docker-wine

相关链接

• Docker Hub: https://registry.hub.docker.com/u/yantis/wine/
• GitHub: https://github.com/yantis/docker-wine/
• VirtualGL文档: VirtualGL User's Guide