libzonda/linux-qq-release repository overview

⁠Linux QQ Docker Image

This Docker image provides Tencent QQ for Linux with a web-accessible GUI, based on jlesage/baseimage-gui:ubuntu-24.04-v4.

⁠Highlights

• Multi-Instance Support: Easily run multiple QQ accounts in one container.
• Integrated Browser: Firefox integration to ensure all links open properly.
• Optional Taskbar: Switch on tint2 using ENABLE_TASKBAR=1.

⁠Multi-Instance

⁠Taskbar Support

⁠Secure Access

⁠Features

• Web GUI (noVNC): Access QQ directly via browser at http://localhost:5800.
• Integrated Browser: Built-in Firefox (non-Snap) ensures external links (Email, Qzone) open correctly.
• Multi-Instance: Support running multiple QQ accounts simultaneously in one container via QQ_INSTANCE_COUNT.
• Chinese Support: Pre-configured zh_CN.UTF-8 locale and fonts (Noto Sans CJK, WenQuanYi).
• Multi-Arch: Supports linux/amd64 and linux/arm64.

⁠Quick Start

⁠Docker Run

docker run -d \
    --name=linuxqq \
    -p 5800:5800 \
    -v /path/to/config:/config \
    -e QQ_INSTANCE_COUNT=1 \
    libzonda/linux-qq-release:latest-amd64

⁠Docker Compose

services:
  linuxqq:
    image: libzonda/linux-qq-release:latest-amd64
    container_name: linuxqq
    restart: unless-stopped
    ports:
      - "5800:5800"
    volumes:
      - ./config:/config
    environment:
      - TZ=Asia/Shanghai
      - QQ_INSTANCE_COUNT=1
      - KEEP_APP_RUNNING=1
      # - VNC_PASSWORD=secret

⁠Configuration

⁠Environment Variables

⁠Volumes

Disclaimer: This project is for personal use and convenience. All rights to the QQ software belong to Tencent.