[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72408":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},72408,"wechat-selkies","nickrunning\u002Fwechat-selkies","nickrunning","基于Selkies的Linux网页版微信\u002FQQ\u002FTelegram，支持本地中文输入法，支持三方应用，支持AMD64和ARM64。","https:\u002F\u002Fhub.docker.com\u002Fr\u002Fnickrunning\u002Fwechat-selkies",null,"Python",2811,250,13,3,0,9,37,92,27,29.2,"MIT License",false,"master",true,[27,28,29,30,31],"docker","qq","vnc","web","wechat","2026-06-12 02:03:02","# WeChat Selkies\n\n[![GitHub Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fnickrunning\u002Fwechat-selkies?style=flat-square&logo=github&color=yellow)](https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies\u002Fstargazers)\n[![GitHub Forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fnickrunning\u002Fwechat-selkies?style=flat-square&logo=github&color=blue)](https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies\u002Fnetwork\u002Fmembers)\n[![GitHub Issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fnickrunning\u002Fwechat-selkies?style=flat-square&logo=github&color=red)](https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies\u002Fissues)\n[![GitHub License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fnickrunning\u002Fwechat-selkies?style=flat-square&color=green)](https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies\u002Fblob\u002Fmaster\u002FLICENSE)\n[![Docker Pulls](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fpulls\u002Fnickrunning\u002Fwechat-selkies?style=flat-square&logo=docker&color=blue)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fnickrunning\u002Fwechat-selkies)\n[![Docker Image Size](https:\u002F\u002Fimg.shields.io\u002Fdocker\u002Fimage-size\u002Fnickrunning\u002Fwechat-selkies?style=flat-square&logo=docker&color=orange)](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fnickrunning\u002Fwechat-selkies)\n[![GitHub Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fnickrunning\u002Fwechat-selkies?style=flat-square&logo=github&include_prereleases)](https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies\u002Freleases)\n[![GitHub Workflow Status](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fnickrunning\u002Fwechat-selkies\u002Fdocker.yml?style=flat-square&logo=github-actions&label=build)](https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies\u002Factions)\n[![GitHub Last Commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fnickrunning\u002Fwechat-selkies?style=flat-square&logo=github&color=purple)](https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies\u002Fcommits)\n\n中文 | [English](README_en.md)\n\n基于 Docker 的微信\u002FQQ Linux 客户端，使用 Selkies WebRTC 技术提供浏览器访问支持。\n\n## 项目简介\n\n本项目将官方微信\u002FQQ Linux 客户端封装在 Docker 容器中，通过 Selkies 技术实现在浏览器中直接使用微信\u002FQQ，无需在本地安装微信\u002FQQ 客户端。适用于服务器部署、远程办公等场景。\n\n## 升级注意事项\n\n> 如果升级后部分功能缺失，请先清空本地挂载目录下的openbox目录(如`.\u002Fconfig\u002F.config\u002Fopenbox`)。\n\n> 仓库内置了上游微信版本自动检测机制：GitHub Actions 会定时检查官方 `.deb` 包版本，检测到变化后自动更新 `versions\u002Fupstream.env` 并触发镜像构建。\n\n## 功能特性\n\n- 🌐 **浏览器访问**：通过 Web 浏览器直接使用微信，无需本地安装\n- 🐳 **Docker化部署**：简单的容器化部署，环境隔离\n- 🔒 **数据持久化**：支持配置和聊天记录持久化存储\n- 🎨 **中文支持**：完整的中文字体和本地化支持，支持本地中文输入法\n- 🖼️ **图片复制**：支持通过侧边栏面板开启图片复制\n- 📁 **文件传输**：支持通过侧边栏面板进行文件传输\n- 🖥️ **AMD64和ARM64架构支持**：兼容主流CPU架构\n- 🔧 **硬件加速**：可选的 GPU 硬件加速支持\n- 🪟 **窗口切换器**：左上角增加切换悬浮窗，方便切换到后台窗口，为后续添加其它功能做基础\n- 🤖 **自动启动**：可配置自动启动微信和QQ客户端（可选）\n- 📋 **桌面快捷方式集成**：自动扫描 `~\u002FDesktop\u002F` 下的 `.desktop` 文件并添加到右键菜单，方便启动第三方应用（如通过 proot-apps 安装的应用）\n- 📂 **文件管理器**：内置 PCManFM 轻量文件管理器，右键菜单即可启动，方便管理容器内文件\n\n## 截图展示\n![微信截图](.\u002Fdocs\u002Fimages\u002Fwechat-selkies-1.jpg)\n![QQ截图](.\u002Fdocs\u002Fimages\u002Fwechat-selkies-2.jpg)\n\n## 快速开始\n\n### 环境要求\n\n- Docker\n- Docker Compose\n- 支持WebRTC的现代浏览器（Chrome、Firefox、Safari等）\n\n### 快速部署\n\n1. **直接使用已构建的镜像进行快速部署**\n\nGitHub Container Registry镜像：\n```bash\ndocker run -it -p 3001:3001 -v .\u002Fconfig:\u002Fconfig --device \u002Fdev\u002Fdri:\u002Fdev\u002Fdri ghcr.io\u002Fnickrunning\u002Fwechat-selkies:latest\n```\n\nDocker Hub镜像：\n```bash\ndocker run -it -p 3001:3001 -v .\u002Fconfig:\u002Fconfig --device \u002Fdev\u002Fdri:\u002Fdev\u002Fdri nickrunning\u002Fwechat-selkies:latest\n```\n\n> **精简版镜像**：如果只需要微信（不含 QQ 和文件管理器），可使用 `minimal` 标签，镜像体积更小：\n> ```bash\n> docker run -it -p 3001:3001 -v .\u002Fconfig:\u002Fconfig --device \u002Fdev\u002Fdri:\u002Fdev\u002Fdri ghcr.io\u002Fnickrunning\u002Fwechat-selkies:minimal\n> ```\n> 精简版也支持版本号标签，如 `:1.2.3-minimal`、`:1.2-minimal`，方便锁定特定版本。\n\n2. **访问微信**\n   \n   在浏览器中访问：`https:\u002F\u002Flocalhost:3001` 或 `https:\u002F\u002F\u003C服务器IP>:3001`\n   > **注意：** 映射3000端口用于HTTP访问，3001端口用于HTTPS访问，建议使用HTTPS。\n\n### Docker Compose 部署\n1. **创建项目目录并进入**\n   ```bash\n   mkdir wechat-selkies\n   cd wechat-selkies\n   ```\n2. **创建 docker-compose.yml 文件**\n   ```yaml\n    services:\n      wechat-selkies:\n        image: nickrunning\u002Fwechat-selkies:latest    # or ghcr.io\u002Fnickrunning\u002Fwechat-selkies:latest\n        container_name: wechat-selkies\n        ports:\n          - \"${HTTP_PORT:-3000}:3000\"\n          - \"${HTTPS_PORT:-3001}:3001\"\n        restart: unless-stopped\n        volumes:\n          - .\u002Fconfig:\u002Fconfig\n        devices:\n          - \u002Fdev\u002Fdri:\u002Fdev\u002Fdri\n        environment:\n          - PUID=${PUID:-1000}\n          - PGID=${PGID:-100}\n          - TZ=Asia\u002FShanghai\n          - LC_ALL=zh_CN.UTF-8\n          - AUTO_START_WECHAT=true\n          - AUTO_START_QQ=false\n          - CUSTOM_USER=${CUSTOM_USER:-}\n          - PASSWORD=${PASSWORD:-}\n        shm_size: \"${SHM_SIZE:-1gb}\"\n    ```\n3. **创建 `.env` 文件（可选）**\n\n   复制 `.env.example` 并按需修改，未设置的变量将使用默认值：\n   ```bash\n   cp .env.example .env\n   ```\n   `.env` 文件示例：\n   ```env\n   HTTP_PORT=3000\n   HTTPS_PORT=3001\n   PUID=1000\n   PGID=100\n   # CUSTOM_USER=\n   # PASSWORD=\n   SHM_SIZE=1gb\n   ```\n4. **启动服务**\n   ```bash\n   docker compose up -d\n   ```\n\n### 源码部署\n\n1. **克隆项目**\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies.git\n   cd wechat-selkies\n   ```\n\n2. **启动服务**\n   ```bash\n   docker compose up -d\n   ```\n\n3. **访问微信**\n\n   在浏览器中访问：`https:\u002F\u002Flocalhost:3001` 或 `https:\u002F\u002F\u003C服务器IP>:3001`\n\n> **构建精简版**：源码部署时可通过 build-arg 构建仅含微信的精简镜像：\n> ```bash\n> docker build --build-arg INSTALL_QQ=false --build-arg INSTALL_PCMANFM=false -t wechat-selkies:minimal .\n> ```\n\n### 配置说明\n\n更多自定义配置请参考 [Selkies Base Images from LinuxServer](https:\u002F\u002Fgithub.com\u002Flinuxserver\u002Fdocker-baseimage-selkies)。\n\n#### Docker Hub 推送配置\n\n本项目支持同时推送到 GitHub Container Registry 和 Docker Hub。如需启用 Docker Hub 推送功能，请在仓库下添加Environment Secrets和Environment Variables:\n\n**Environment Secrets:**\n* DOCKERHUB_USERNAME: 你的 Docker Hub 用户名\n* DOCKERHUB_TOKEN: 你的 Docker Hub Access Token\n**Environment Variables:**\n* ENABLE_DOCKERHUB: 设置为 `true` 来启用 Docker Hub 推送\n\n#### 环境变量配置\n\n在 `docker-compose.yml` 中可以配置以下环境变量，支持通过 `.env` 文件覆盖带有 `${VAR:-default}` 的配置项：\n\n| 变量名 | 默认值 | 说明 |\n|--------|--------|------|\n| `TITLE` | `WeChat Selkies` | Web UI 标题 |\n| `PUID` | `1000` | 用户 ID |\n| `PGID` | `100` | 组 ID |\n| `TZ` | `Asia\u002FShanghai` | 时区设置 |\n| `LC_ALL` | `zh_CN.UTF-8` | 语言环境 |\n| `CUSTOM_USER` | - | 自定义用户名（推荐设置） |\n| `PASSWORD` | - | Web UI 访问密码（推荐设置） |\n| `AUTO_START_WECHAT` | `true` | 是否自动启动微信客户端 |\n| `AUTO_START_QQ` | `false` | 是否自动启动 QQ 客户端 |\n\n#### 端口配置\n\n- `3001`: Web UI 访问端口\n\n#### 数据卷挂载\n\n- `.\u002Fconfig:\u002Fconfig`: 微信配置和数据持久化目录\n\n> **注意：** 如果升级后右键菜单缺少 `WeChat` 相关选项，请先清空本地挂载目录下的openbox目录(如`.\u002Fconfig\u002F.config\u002Fopenbox`)。\n\n## 安装第三方应用（如 Telegram）\n\n本项目支持通过 [proot-apps](https:\u002F\u002Fgithub.com\u002Flinuxserver\u002Fproot-apps) 安装第三方 Linux 应用。以 Telegram 为例：\n\n1. 在浏览器中打开容器桌面\n2. 点击左侧 **侧边栏** → **应用程序**（Applications）\n3. 在应用列表中找到 **Telegram**\n4. 点击 **安装**（Install）按钮，等待安装完成\n\n安装完成后，应用快捷方式会自动出现在 `~\u002FDesktop\u002F` 目录下，**右键菜单会自动刷新**，无需重启容器即可从菜单中启动该应用。\n\n> **提示：** 如需卸载应用，同样通过侧边栏 → 应用程序，选中对应应用后点击 **卸载**（Uninstall）即可，右键菜单会自动更新。\n\n## 高级配置\n\n### 硬件加速\n\n如果您的系统支持 GPU 硬件加速，Docker Compose 配置中已包含相关设备映射：\n\n```yaml\ndevices:\n  - \u002Fdev\u002Fdri:\u002Fdev\u002Fdri\n```\n\n## 目录结构\n\n```\nwechat-selkies\u002F\n├── docker-compose.yml          # Docker Compose 配置文件\n├── .env.example                # 环境变量示例文件\n├── Dockerfile                  # Docker 镜像构建文件\n├── LICENSE                     # License\n├── README.md                   # 项目说明文档\n├── config\u002F                     # 配置和数据持久化目录\n└── root\u002F                       # 容器初始化文件\n    ├── defaults\u002F\n    │   └── autostart           # 自动启动配置\n    └── wechat.png              # 微信图标\n```\n\n## 故障排除\n\n### 更新微信\u002FQQ版本\n\n当微信或QQ提示\"版本过期\"时，只需重新拉取最新镜像并重建容器即可，聊天记录和配置不受影响：\n\n```bash\n# 使用预构建镜像\ndocker compose pull && docker compose up -d\n\n# 使用源码构建\ngit pull && docker compose up -d --build\n```\n\n> **注意：** 微信和QQ的安装包 URL 指向官方最新版本，重新构建镜像时会自动下载最新版。\n\n对于仓库维护者，当前自动化流程如下：\n\n1. `Detect Upstream Package Updates` 每 6 小时检查一次微信官方安装包版本，也支持手动触发\n2. 如果检测到版本号或安装包哈希变化，工作流会更新 `versions\u002Fupstream.env`\n3. 该文件变更提交到 `master` 后，会自动触发 `Build and Publish Docker Image`\n\n版本状态文件位于 `versions\u002Fupstream.env`，当前记录了：\n\n- 微信 amd64\u002Farm64 下载地址\n- 微信 amd64\u002Farm64 解析出的版本号\n- 微信 amd64\u002Farm64 安装包 SHA256\n- 最近一次发生变更的检测时间\n\n### 常见问题\n\n1. **无法访问 Web UI**\n   - 检查端口 3001 是否被占用\n   - 确认 Docker 容器正常运行：`docker ps`\n\n### 日志查看\n\n查看容器运行日志：\n```bash\ndocker compose logs -f wechat-selkies\n```\n\n## 技术架构\n\n- **基础镜像**：`ghcr.io\u002Flinuxserver\u002Fbaseimage-selkies:ubuntunoble`\n- **微信客户端**：官方微信 Linux 版本\n- **Web 技术**：Selkies WebRTC\n- **容器化**：Docker + Docker Compose\n\n## 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\n\n1. Fork 本项目\n2. 创建特性分支：`git checkout -b feature\u002Fyour-feature`\n3. 提交更改：`git commit -am 'Add some feature'`\n4. 推送分支：`git push origin feature\u002Fyour-feature`\n5. 提交 Pull Request\n\n## 许可证\n\n本项目采用 **MIT License** 开源协议。详见 [LICENSE](LICENSE) 文件。\n\n### 📜 许可证说明\n\n- **项目许可证**: MIT License - 宽松的开源许可证\n- **依赖项说明**: 本项目使用 [LinuxServer.io baseimage-selkies](https:\u002F\u002Fgithub.com\u002Flinuxserver\u002Fdocker-baseimage-selkies) 作为基础镜像\n- **许可证兼容性**: 由于本项目仅使用基础镜像而未修改其源码，根据容器化软件的许可证实践，可以采用MIT许可证\n- **源码开放**: 完整项目源代码在 GitHub 上公开：https:\u002F\u002Fgithub.com\u002Fnickrunning\u002Fwechat-selkies\n\n## 免责声明与版权声明\n\n### 🚨 重要声明\n\n**本项目与腾讯公司无任何关联，属于独立的第三方开源项目。**\n\n### 📋 版权声明\n\n- **微信®** 是 **腾讯公司** 的注册商标和版权作品\n- 本项目中使用的微信相关图标、logo 等视觉元素的版权归腾讯公司所有\n- 本项目仅为技术展示和学习目的，不用于商业用途\n- **如有版权争议，将立即移除相关内容**\n\n### ⚖️ 法律合规\n\n- 本项目严格遵守相关法律法规和用户协议\n- 用户使用本项目时应遵守当地法律法规\n- 本项目不对用户的使用行为承担法律责任\n- **如腾讯公司认为存在侵权行为，请联系我们立即处理**\n\n### 🎯 使用条款\n\n- 本项目仅供学习、研究和个人使用\n- 禁止用于任何商业目的或盈利活动\n- 用户应自行承担使用风险和法律责任\n- 请遵守微信用户协议和相关服务条款\n\n## 相关链接\n\n- [微信官方网站](https:\u002F\u002Fweixin.qq.com\u002F)\n- [Selkies WebRTC](https:\u002F\u002Fgithub.com\u002Fselkies-project)\n- [LinuxServer.io](https:\u002F\u002Fgithub.com\u002Flinuxserver)\n- [xiaoheiCat\u002Fdocker-wechat-sogou-pinyin](https:\u002F\u002Fgithub.com\u002FxiaoheiCat\u002Fdocker-wechat-sogou-pinyin)\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=nickrunning\u002Fwechat-selkies&type=Date)](https:\u002F\u002Fwww.star-history.com\u002F#nickrunning\u002Fwechat-selkies&Date)\n","基于Selkies的微信\u002FQQ\u002FTelegram Linux网页版客户端，支持通过浏览器直接访问，无需本地安装。项目核心功能包括Docker化部署、数据持久化存储、完整的中文字体和本地化支持（如中文输入法）、图片复制及文件传输等，并且兼容AMD64与ARM64架构，还提供了可选的GPU硬件加速。适合用于服务器部署、远程办公或任何需要在非Windows系统上运行这些即时通讯工具的场景。",2,"2026-06-11 03:41:55","high_star"]