中文 | English

基于 Docker 的微信/QQ Linux 客户端，使用 Selkies WebRTC 技术提供浏览器访问支持。

本项目将官方微信/QQ Linux 客户端封装在 Docker 容器中，通过 Selkies 技术实现在浏览器中直接使用微信/QQ，无需在本地安装微信/QQ 客户端。适用于服务器部署、远程办公等场景。

如果升级后部分功能缺失，请先清空本地挂载目录下的openbox目录(如./config/.config/openbox)。

• 🌐 浏览器访问：通过 Web 浏览器直接使用微信，无需本地安装
• 🐳 Docker化部署：简单的容器化部署，环境隔离
• 🔒 数据持久化：支持配置和聊天记录持久化存储
• 🎨 中文支持：完整的中文字体和本地化支持，支持本地中文输入法
• 🖼️ 图片复制：支持通过侧边栏面板开启图片复制
• 📁 文件传输：支持通过侧边栏面板进行文件传输
• 🖥️ AMD64和ARM64架构支持：兼容主流CPU架构
• 🔧 硬件加速：可选的 GPU 硬件加速支持
• 🪟 窗口切换器：左上角增加切换悬浮窗，方便切换到后台窗口，为后续添加其它功能做基础
• 🤖 自动启动：可配置自动启动微信和QQ客户端（可选）

• Docker
• Docker Compose
• 支持WebRTC的现代浏览器（Chrome、Firefox、Safari等）

1. 直接使用已构建的镜像进行快速部署

GitHub Container Registry镜像：

docker run -it -p 3001:3001 -v ./config:/config --device /dev/dri:/dev/dri ghcr.io/nickrunning/wechat-selkies:latest

Docker Hub镜像：

docker run -it -p 3001:3001 -v ./config:/config --device /dev/dri:/dev/dri nickrunning/wechat-selkies:latest

2. 访问微信

   在浏览器中访问：https://localhost:3001 或 https://<服务器IP>:3001

   注意： 映射3000端口用于HTTP访问，3001端口用于HTTPS访问，建议使用HTTPS。

1. 创建项目目录并进入

   mkdir wechat-selkies
   cd wechat-selkies

2. 创建 docker-compose.yml 文件

    services:
      wechat-selkies:
        image: nickrunning/wechat-selkies:latest    # or ghcr.io/nickrunning/wechat-selkies:latest
        container_name: wechat-selkies
        ports:
          - "3000:3000"       # http port
          - "3001:3001"       # https port
        restart: unless-stopped
        volumes:
          - ./config:/config
        devices:
          - /dev/dri:/dev/dri # optional, for hardware acceleration
        environment:
          - PUID=1000                    # user ID
          - PGID=100                     # group ID
          - TZ=Asia/Shanghai             # timezone
          - LC_ALL=zh_CN.UTF-8           # locale
          - AUTO_START_WECHAT=true       # default is true
          - AUTO_START_QQ=false          # default is false
          # - CUSTOM_USER=<Your Name>      # recommended to set a custom user name
          # - PASSWORD=<Your Password>     # recommended to set a password for selkies web ui

3. 启动服务

   docker-compose up -d

1. 克隆项目

   git clone https://github.com/nickrunning/wechat-selkies.git
   cd wechat-selkies

2. 启动服务

   docker-compose up -d

3. 访问微信

   在浏览器中访问：https://localhost:3001 或 https://<服务器IP>:3001

更多自定义配置请参考 Selkies Base Images from LinuxServer。

本项目支持同时推送到 GitHub Container Registry 和 Docker Hub。如需启用 Docker Hub 推送功能，请在仓库下添加Environment Secrets和Environment Variables:

Environment Secrets:

• DOCKERHUB_USERNAME: 你的 Docker Hub 用户名
• DOCKERHUB_TOKEN: 你的 Docker Hub Access Token Environment Variables:
• ENABLE_DOCKERHUB: 设置为 true 来启用 Docker Hub 推送

在 docker-compose.yml 中可以配置以下环境变量：

• 3001: Web UI 访问端口

• ./config:/config: 微信配置和数据持久化目录

注意： 如果升级后右键菜单缺少 WeChat 相关选项，请先清空本地挂载目录下的openbox目录(如./config/.config/openbox)。

如果您的系统支持 GPU 硬件加速，Docker Compose 配置中已包含相关设备映射：

devices:
  - /dev/dri:/dev/dri

wechat-selkies/
├── docker-compose.yml          # Docker Compose 配置文件
├── Dockerfile                  # Docker 镜像构建文件
├── LICENSE                     # License
├── README.md                   # 项目说明文档
├── config/                     # 配置和数据持久化目录
└── root/                       # 容器初始化文件
    ├── defaults/
    │   └── autostart           # 自动启动配置
    └── wechat.png              # 微信图标

1. 无法访问 Web UI
   • 检查端口 3001 是否被占用
   • 确认 Docker 容器正常运行：docker ps

查看容器运行日志：

docker-compose logs -f wechat-selkies

• 基础镜像：ghcr.io/linuxserver/baseimage-selkies:ubuntunoble
• 微信客户端：官方微信 Linux 版本
• Web 技术：Selkies WebRTC
• 容器化：Docker + Docker Compose

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建特性分支：git checkout -b feature/your-feature
3. 提交更改：git commit -am 'Add some feature'
4. 推送分支：git push origin feature/your-feature
5. 提交 Pull Request

本项目采用 MIT License 开源协议。详见 LICENSE 文件。

• 项目许可证: MIT License - 宽松的开源许可证
• 依赖项说明: 本项目使用 LinuxServer.io baseimage-selkies 作为基础镜像
• 许可证兼容性: 由于本项目仅使用基础镜像而未修改其源码，根据容器化软件的许可证实践，可以采用MIT许可证
• 源码开放: 完整项目源代码在 GitHub 上公开：https://github.com/nickrunning/wechat-selkies

本项目与腾讯公司无任何关联，属于独立的第三方开源项目。

• 微信® 是 腾讯公司 的注册商标和版权作品
• 本项目中使用的微信相关图标、logo 等视觉元素的版权归腾讯公司所有
• 本项目仅为技术展示和学习目的，不用于商业用途
• 如有版权争议，将立即移除相关内容

• 本项目严格遵守相关法律法规和用户协议
• 用户使用本项目时应遵守当地法律法规
• 本项目不对用户的使用行为承担法律责任
• 如腾讯公司认为存在侵权行为，请联系我们立即处理

• 本项目仅供学习、研究和个人使用
• 禁止用于任何商业目的或盈利活动
• 用户应自行承担使用风险和法律责任
• 请遵守微信用户协议和相关服务条款

• 微信官方网站
• Selkies WebRTC
• LinuxServer.io
• xiaoheiCat/docker-wechat-sogou-pinyin