8f8af073f2
- Add automatic config version control for seamless upgrades - Update autostart script to use wechat-start.sh for better initialization - Add comprehensive WeChat management scripts (start, restart, unminimize) - Enhance right-click menu with WeChat restart and restore functionality - Improve Dockerfile cleanup process for smaller image size - Add volume mounting examples in documentation for data persistence - Include upgrade troubleshooting notes for openbox configuration - Add Star History chart and additional reference links This update ensures users get the latest menu configurations automatically without manual intervention during container updates.
6.4 KiB
WeChat Selkies
中文 | English
基于 Docker 的微信 Linux 客户端，使用 Selkies WebRTC 技术提供浏览器访问支持。
项目简介
本项目将官方微信 Linux 客户端封装在 Docker 容器中，通过 Selkies 技术实现在浏览器中直接使用微信，无需在本地安装微信客户端。适用于服务器部署、远程办公等场景。
功能特性
- 🌐 浏览器访问：通过 Web 浏览器直接使用微信，无需本地安装
- 🐳 Docker化部署：简单的容器化部署，环境隔离
- 🔒 数据持久化：支持配置和聊天记录持久化存储
- 🎨 中文支持：完整的中文字体和本地化支持，支持本地中文输入法
- 🖼️ 图片复制：支持通过侧边栏面板开启图片复制
- 📁 文件传输：支持通过侧边栏面板进行文件传输
- 🖥️ AMD64和ARM64架构支持：兼容主流CPU架构
- 🔧 硬件加速：可选的 GPU 硬件加速支持
快速开始
环境要求
- Docker
- Docker Compose
- 支持WebRTC的现代浏览器（Chrome、Firefox、Safari等）
快速部署
- 直接使用已构建的镜像进行快速部署
docker run -it -p 3001:3001 -v ./config:/config ghcr.io/nickrunning/wechat-selkies:latest
-
访问微信
在浏览器中访问：
https://localhost:3001或https://<服务器IP>:3001
自定义部署步骤（源码部署）
-
克隆项目
git clone https://github.com/nickrunning/wechat-selkies.git cd wechat-selkies -
启动服务
docker-compose up -d -
访问微信
在浏览器中访问：
https://localhost:3001或https://<服务器IP>:3001
配置说明
更多自定义配置请参考 Selkies Base Images from LinuxServer.
环境变量配置
在 docker-compose.yml 中可以配置以下环境变量：
| 变量名 | 默认值 | 说明 |
|---|---|---|
TITLE |
WeChat Selkies |
Web UI 标题 |
PUID |
1000 |
用户 ID |
PGID |
100 |
组 ID |
TZ |
Asia/Shanghai |
时区设置 |
LC_ALL |
zh_CN.UTF-8 |
语言环境 |
CUSTOM_USER |
- | 自定义用户名（推荐设置） |
PASSWORD |
- | Web UI 访问密码（推荐设置） |
端口配置
3001: Web UI 访问端口
数据卷挂载
./config:/config: 微信配置和数据持久化目录
如果升级后右键菜单缺少
./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 # 微信图标
故障排除
常见问题
- 无法访问 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！
- Fork 本项目
- 创建特性分支：
git checkout -b feature/your-feature - 提交更改：
git commit -am 'Add some feature' - 推送分支：
git push origin feature/your-feature - 提交 Pull Request
许可证
本项目采用 GNU General Public License v3.0 开源协议。详见 LICENSE 文件。
重要说明：本项目依赖 LinuxServer.io baseimage-selkies（GPL-3.0 许可证），因此整个项目需要遵循 GPL-3.0 的传染性要求。
📜 许可证合规说明
本项目严格遵循开源许可证要求：
- 依赖项许可证: 使用了 GPL-3.0 许可证的
linuxserver/docker-baseimage-selkies基础镜像 - 传染性影响: 根据 GPL-3.0 第5条，衍生作品必须采用相同许可证
- 源码提供: 完整项目源代码已在 GitHub 上公开：https://github.com/nickrunning/wechat-selkies
- 分发要求: 任何分发本项目的个人或组织都必须：
- 保持 GPL-3.0 许可证
- 提供完整源代码访问
- 保留所有版权声明和许可证通知
如需了解更多关于 GPL-3.0 许可证的信息，请访问：https://www.gnu.org/licenses/gpl-3.0.html
免责声明与版权声明
🚨 重要声明
本项目与腾讯公司无任何关联，属于独立的第三方开源项目。
📋 版权声明
- 微信® 是 腾讯公司 的注册商标和版权作品
- 本项目中使用的微信相关图标、logo 等视觉元素的版权归腾讯公司所有
- 本项目仅为技术展示和学习目的，不用于商业用途
- 如有版权争议，将立即移除相关内容
⚖️ 法律合规
- 本项目严格遵守相关法律法规和用户协议
- 用户使用本项目时应遵守当地法律法规
- 本项目不对用户的使用行为承担法律责任
- 如腾讯公司认为存在侵权行为，请联系我们立即处理
🎯 使用条款
- 本项目仅供学习、研究和个人使用
- 禁止用于任何商业目的或盈利活动
- 用户应自行承担使用风险和法律责任
- 请遵守微信用户协议和相关服务条款