云微 · WechatOnCloud

云微 (WechatOnCloud) 是一款开源的“服务端微信”解决方案，允许你在自己的 NAS 或服务器上运行官方原版微信 PC 版。通过 Docker 容器化技术与 Web 串流技术，它实现了多个浏览器/设备共享同一个微信会话，彻底打破了微信对多设备登录的限制。无需修改微信客户端，即可在任意设备上通过浏览器获得原汁原味的 PC 微信体验。

核心亮点：共享、隔离、原生体验

1. 多端共享同一会话

• Web 化访问：基于 KasmVNC 将微信画面串流至浏览器，支持 Chrome、Safari 等主流浏览器。
• PWA 支持：可安装为 iOS 主屏幕应用或桌面 Chrome 应用，获得接近原生的 App 体验。
• 跨设备同步：无论在家用电脑、公司笔记本还是手机端，登录同一面板账号即可无缝接续消息与文件传输。

2. 多实例与权限管理

• 独立容器隔离：每个微信实例运行在独立的 Docker 容器中，拥有独立的数据卷，互不干扰。
• RBAC 权限控制：支持管理员与子账号体系。管理员可创建多个实例，并精确分配哪些子账号可访问特定实例。
• 软锁协作机制：当多人尝试操作同一实例时，自动启用“只读+申请接管”模式，避免键鼠冲突，保障操作秩序。

3. 极致优化的 Web 体验

• 中文输入修复：针对 KasmVNC 的 IME Input Mode 进行深度优化，解决远程桌面常见的中文丢字/卡顿问题，实现流畅打字。
• 文件与剪贴板中转：支持拖拽上传/下载文件至微信桌面；提供文本剪贴板中转功能，方便在本地与远程微信间复制文字。
• 按需加载微信本体：镜像不包含微信安装包，首次使用时通过面板一键下载并安装官方 Linux 版微信，保持镜像轻量。

4. 安全优先架构

• 最小化暴露：宿主仅暴露面板端口（默认 36080），微信实例容器仅在内部网络运行，由面板反向代理。
• 凭据保护：KasmVNC 连接凭据由服务端注入，前端无法获取；docker.sock 仅管理员可触达，防止容器逃逸风险。
• 内网推荐：建议仅在内网、VPN 或经过 HTTPS 反代的环境下访问，确保通信安全。

快速开始：Docker Compose 部署

1. 环境准备

确保已安装 Docker 及 Docker Compose 插件。支持 x86_64 和 arm64 架构。

2. 部署步骤

方式 A：拉取官方镜像（推荐）

git clone https://github.com/Gloridust/WechatOnCloud.git WechatOnCloud
cd WechatOnCloud
cp .env.example .env            # 务必修改 WOC_PASSWORD 默认密码
docker compose up -d            # 自动从 GHCR 拉取最新镜像

方式 B：本地自构建（若官方镜像未发布）

git clone https://github.com/Gloridust/WechatOnCloud.git WechatOnCloud
cd WechatOnCloud
cp .env.example .env
./scripts/build-local.sh        # 本地构建面板与微信实例镜像
docker compose up -d

3. 初始化配置

1. 浏览器访问 http://<NAS_IP>:36080。
2. 使用 .env 中设置的管理员账号登录（默认 admin / wechat，请首次登录后修改密码）。
3. 在「实例」页面点击「新建微信实例」，命名并分配权限。
4. 进入新实例，点击「下载并安装」微信（约 200MB，带进度条）。
5. 安装完成后点击「进入电脑版微信」，使用手机微信扫码登录。

资源占用参考

• 建议配置：每增加一个活跃实例，建议预留 1 vCPU + 1.5 GiB 内存。
• 示例：4 核 / 8 GiB NAS 可从容运行 3-4 个轻度使用的微信实例。

适用场景

• 家庭消息中心：在 NAS 上常驻运行微信，通过手机/平板随时查看家庭群消息。
• 多设备办公：在公司电脑、家用笔记本间无缝切换微信会话，无需反复扫码。
• 团队/家庭共享：通过子账号权限管理，让家庭成员共用一个工作微信或客服微信，同时保留操作审计。
• 隐私保护：数据完全本地存储，不经过第三方云服务器，保障聊天记录安全。