nickrunning/wechat-selkies

WeChat Selkies

请以项目文档为准：[https://github.com/nickrunning/wechat-selkies]

中文 | English

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

项目简介

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

升级注意事项

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

功能特性

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

快速开始

环境要求

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

快速部署

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

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

Docker Hub镜像：

bash
docker run -it -p 3001:3001 -v ./config:/config nickrunning/wechat-selkies:latest

2. 访问微信

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

自定义部署步骤（源码部署）

1. 克隆项目

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

2. 启动服务

   bash
   docker-compose up -d
   

3. 访问微信

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

配置说明

更多自定义配置请参考 https://github.com/linuxserver/docker-baseimage-selkies%E3%80%82

Docker Hub 推送配置

本项目支持同时推送到 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 配置中已包含相关设备映射：

yaml
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

日志查看

查看容器运行日志：

bash
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

许可证

本项目采用 GNU General Public License v3.0 开源协议。详见 LICENSE 文件。

重要说明：本项目依赖 https://github.com/linuxserver/docker-baseimage-selkies%EF%BC%88GPL-3.0 许可证），因此整个项目需要遵循 GPL-3.0 的传染性要求。

📜 许可证合规说明

本项目严格遵循开源许可证要求：

1. 依赖项许可证: 使用了 GPL-3.0 许可证的 linuxserver/docker-baseimage-selkies 基础镜像
2. 传染性影响: 根据 GPL-3.0 第5条，衍生作品必须采用相同许可证
3. 源码提供: 完整项目源代码已在 GitHub 上公开：https://github.com/nickrunning/wechat-selkies
4. 分发要求: 任何分发本项目的个人或组织都必须：
   • 保持 GPL-3.0 许可证
   • 提供完整源代码访问
   • 保留所有版权声明和许可证通知

如需了解更多关于 GPL-3.0 许可证的信息，请访问：[***]

免责声明与版权声明

🚨 重要声明

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

📋 版权声明

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

⚖️ ***合规

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

🎯 使用条款

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

相关链接

• 微信官方网站
• https://github.com/selkies-project
• https://github.com/linuxserver
• https://github.com/xiaoheiCat/docker-wechat-sogou-pinyin

Star History

![Star History Chart]([***]