bestwu/qq

镜像概述

该Docker镜像基于深度操作系统，提供在Linux环境下运行QQ系列即时通讯工具的方法，支持多种版本，满足不同用户需求。

支持的标签（Tags）

• im：对应QQ（https://github.com/top-bettercode/docker-qq/blob/master/im/Dockerfile%EF%BC%89
• light/latest：对应QQLight（https://github.com/top-bettercode/docker-qq/blob/master/im.light/Dockerfile%EF%BC%89
• office：对应TIM（https://github.com/top-bettercode/docker-qq/blob/master/office/Dockerfile%EF%BC%89
• eim：对应EIM（https://github.com/top-bettercode/docker-qq/blob/master/eim/Dockerfile%EF%BC%89

核心功能

1. 支持在Linux环境下运行QQ、TIM等即时通讯工具
2. 支持中文输入（fcitx输入法）
3. 可访问声音和视频设备
4. 挂载本地目录保存用户数据（如TencentFiles）
5. 提供docker-compose和docker run两种部署方式

使用场景

• Linux系统用户需要使用QQ或TIM进行即时通讯、办公协作
• 容器化环境中需要运行QQ系列工具的场景

配置说明

准备工作

允许所有用户访问X11服务：

bash
xhost +

获取系统组ID

为正常访问声音和视频设备，需获取对应组ID：

• 获取audio组ID：

  bash
  getent group audio | cut -d: -f3
  

• 获取video组ID：

  bash
  getent group video | cut -d: -f3
  

部署方式

docker-compose

创建docker-compose.yml文件：

yml
version: '2'
services:
  qq:
    image: bestwu/qq:office
    container_name: qq
    devices:
      - /dev/snd # 声音设备
    volumes:
      - /tmp/.X11-unix:/tmp/.X11-unix
      - $HOME/TencentFiles:/TencentFiles
    environment:
      - DISPLAY=unix$DISPLAY
      - XMODIFIERS=@im=fcitx # 中文输入
      - QT_IM_MODULE=fcitx
      - GTK_IM_MODULE=fcitx
      - AUDIO_GID=63 # 替换为实际audio组ID
      - GID=$GID # 主机当前用户GID
      - UID=$UID # 主机当前用户UID

运行：

bash
docker-compose up -d

docker run

直接执行命令：

bash
docker run -d --name qq \
  --device /dev/snd \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $HOME/TencentFiles:/TencentFiles \
  -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 VIDEO_GID=`getent group video | cut -d: -f3` \
  -e GID=`id -g` \
  -e UID=`id -u` \
  bestwu/qq:office

维护命令

• 停止容器：docker stop qq
• 删除容器：docker rm qq（强制删除加-f参数）

已知问题及解决

1. 界面未显示：若出现MIT-SHM错误，需禁用该功能： 编辑/etc/X11/xorg.conf添加：

   bash
   Section "Extensions"
       Option "MIT-SHM" "Disable"
   EndSection
   

   重启系统。
2. 无声音：可尝试使用PulseAudio配置（参考原文档替代方案）。
3. 其他问题：如KDE桌面无法显示、摄像头检测不到等（具体参考原文档已知问题部分）。