boringcat/wechat

boringcat/wechat:work 镜像文档

镜像概述

本镜像基于深度操作系统，在https://github.com/bestwu%E6%8F%90%E4%BE%9B%E7%9A%84https://github.com/bestwu/docker-wine%E9%95%9C%E5%83%8F%E5%9F%BA%E7%A1%80%E4%B8%8A%E4%BF%AE%E6%94%B9%60Dockerfile%60%E4%B8%8E%60entrypoint.sh%60%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8Docker%E5%AE%B9%E5%99%A8%E4%B8%AD%E8%BF%90%E8%A1%8C%E4%BC%81%E4%B8%9A%E5%BE%AE%E4%BF%A1%E3%80%82

核心功能与特性

• 基于deepin-wine运行企业微信，内置版本3.0.14.1205（不建议更新至3.0.16.1608，会报wlanapi.dll错误）
• 支持HIDPI显示，通过环境变量DPI调整显示分辨率
• 支持持久化配置，可挂载企业微信数据目录和wine配置目录
• 解决容器退出值非0问题，优化关闭检测，避免自动更新导致容器退出
• 支持声音设备访问，通过挂载/dev/snd实现音频输出
• 支持文件共享，可挂载主机目录实现容器与主机文件互传

更新版本记录

2020/04/09

• 更换wine配置（镜像体积较大）
• 内置企业微信版本更新至3.0.14.1205
• 提示：不建议更新至3.0.16.1608，会出现wlanapi.dll错误

2020/03/13

• 解决容器退出时返回值非0的问题
• 优化WXWork目录挂载问题：
  • 问题原因：企业微信认为C:\users\wechat\Document\WXWork（对应容器内/home/wechat/WXWork）不可读
  • 解决方案：使用wechat用户创建软链接，最终建议将WXWork挂载至/home/wechat/WXWork

2020/03/11

• 优化关闭检测机制，避免因自动更新重启导致容器退出（存在递归溢出风险）
• 支持向企业微信传递启动参数

2020/03/06

• 适配HIDPI显示，通过环境变量DPI设置（如DPI=120），且修改后持久化生效
• 解决容器关闭缓慢问题
• 挂载/home/wechat/.deepinwine/Deepin-WXWork时不会覆盖已有文件，可用于更新企业微信
• 企业微信更新程序无法直接启动，但启动时的自动更新功能可用；如需手动更新，可解压最新安装包覆盖对应文件夹

2020/02/23

• 暂未测试容器内直接启动更新功能，建议挂载wine目录后手动覆盖最新版企业微信
• 挂载/home/wechat/.deepinwine时建议先备份，或在无需写入权限时以ro（只读）方式挂载

注意事项

entrypoint.sh相关

• 使用host网络时可能出现无法联网问题（容器内ping和wget正常，原因未明）
• 启动时会通过chmod命令将/WXWork和/home/wechat的所有者修改为$GID:$UID
• 启动时会将/home/wechat/.deepinwine下所有目录和文件的所有者修改为$GID:$UID，持久化时需特别注意权限问题
• 若挂载WXWork目录后主机目录无文件，可在企业微信内手动配置“文件存储”位置解决；建议使用持久化配置，非持久化可能存在问题

准备工作

允许X11服务访问

运行以下命令允许所有用户访问X11服务：

bash
xhost +

查看系统audio gid

执行以下命令获取主机audio组的gid：

bash
getent group audio | cut -d ":" -f3

例如Archlinux系统通常返回995。

使用方法

通过docker-compose运行

创建docker-compose.yml文件：

yaml
version: '2'
services:
  wechat:
    image: boringcat/wechat:work
    hostname: WXWork    # 可选，用于显示主机名
    devices:
      - /dev/snd        # 声音设备
    volumes:
      - /tmp/.X11-unix:/tmp/.X11-unix  # X11显示
      - $HOME/WXWork:/WXWork           # 企业微信文件存储
      - $HOME:/HostHome                # 可选，主机文件共享
      - $HOME/wine-WXWork:/home/wechat/.deepinwine/Deepin-WXWork  # 可选，持久化wine配置
    environment:
      DISPLAY: unix$DISPLAY
      QT_IM_MODULE: fcitx
      XMODIFIERS: "@im=fcitx"
      GTK_IM_MODULE: fcitx
      AUDIO_GID: 995  # 可选，默认995（Archlinux），需与主机audio gid一致
      GID: 1000       # 可选，默认1000，主机当前用户gid
      UID: 1000       # 可选，默认1000，主机当前用户uid
      DPI: 96         # 可选，默认96，HIDPI显示设置
      WAIT_FOR_SLEEP: 1  # 可选，启动与退出时检测PID的间隔时间（秒）

启动服务：

bash
docker-compose up -d

通过docker run命令运行

bash
docker run -d --name wechat --device /dev/snd \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $HOME/WXWork:/WXWork \
  -v $HOME:/HostHome \
  -v $HOME/wine-WXWork:/home/wechat/.deepinwine/Deepin-WXWork \
  -e DISPLAY=unix$DISPLAY \
  -e XMODIFIERS=@im=fcitx \
  -e QT_IM_MODULE=fcitx \
  -e GTK_IM_MODULE=fcitx \
  -e AUDIO_GID=`getent group audio | cut -d: -f3` \
  -e GID=`id -g` \
  -e UID=`id -u` \
  -e DPI=96 \
  -e WAIT_FOR_SLEEP=1 \
  boringcat/wechat:work

配置参数说明

环境变量

卷挂载

hostname

设置容器主机名（如WXWork），可优化显示效果。

权限说明

• AUDIO_GID需与主机audio组gid一致，解决声音设备访问权限
• GID和UID需与主机当前用户一致，解决挂载目录读写权限问题