bestwu/wechat

bestwu/wechat Docker镜像文档

镜像概述

本镜像基于深度操作系统构建，用于在Docker容器中运行微信客户端。通过容器化方式，可在Linux系统中便捷使用微信，避免直接在主机系统安装依赖。

Dockerfile源码：https://github.com/top-bettercode/docker-wechat

核心功能和特性

• 中文输入支持：兼容fcitx输入法框架，确保微信内中文输入正常
• 音频功能：通过设备映射支持音频输入输出
• 文件持久化：挂载本地目录保存微信文件，避免容器重启后数据丢失
• 权限适配：通过环境变量配置用户ID和组ID，解决挂载目录访问权限问题

使用场景

适用于Linux系统用户需要在容器隔离环境中运行微信客户端，尤其适合希望避免在主机系统安装微信依赖的场景。

使用方法和配置说明

准备工作

1. 允许X11服务访问
   运行以下命令允许所有用户访问X11服务，确保容器能显示图形界面：

   bash
   xhost +
   

2. 获取系统audio组GID
   运行以下命令查看主机audio组的GID，用于配置音频设备访问权限：

   bash
   cat /etc/group | grep audio
   

   示例输出（Fedora 26）：audio:x:63:，其中63即为audio GID。

运行方式

方式一：使用docker-compose

创建docker-compose.yml文件，内容如下：

yaml
version: '2'
services:
  wechat:
    image: bestwu/wechat
    container_name: wechat
    devices:
      - /dev/snd  # 音频设备映射
    volumes:
      - /tmp/.X11-unix:/tmp/.X11-unix  # X11 socket映射，用于图形界面
      - $HOME/WeChatFiles:/WeChatFiles  # 微信文件持久化目录
    environment:
      - DISPLAY=unix$DISPLAY  # 显示环境变量
      - QT_IM_MODULE=fcitx  # QT输入法模块
      - XMODIFIERS=@im=fcitx  # X输入法修饰符
      - GTK_IM_MODULE=fcitx  # GTK输入法模块
      - AUDIO_GID=63  # 可选，默认63（Fedora），需与主机audio GID一致
      - GID=1000  # 可选，默认1000，主机当前用户GID，解决目录权限
      - UID=1000  # 可选，默认1000，主机当前用户UID，解决目录权限

启动容器：

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/WeChatFiles:/WeChatFiles \
  -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` \  # 自动获取主机audio GID
  -e GID=`id -g` \  # 自动获取当前用户GID
  -e UID=`id -u` \  # 自动获取当前用户UID
  bestwu/wechat

环境变量说明