云微 (WechatOnCloud)：在 NAS 上运行服务端微信，多端浏览器共享同一会话

云微（WechatOnCloud）是一个开源项目，让你在自己的 NAS 或服务器上运行「服务端微信」，多个浏览器共享同一个微信会话。

一句话原理

每个微信实例 = 一个容器，里面跑 Xvfb 虚拟显示 + 官方原版微信，KasmVNC 把画面串到浏览器。同一实例被多个浏览器连上，就是共享同一个微信会话。前面一层自研面板是唯一对外入口，通过 docker.sock 按需创建/销毁实例并反向代理。

快速开始

bash

git clone https://github.com/Gloridust/WechatOnCloud.git
cd WechatOnCloud
cp .env.example .env
# 至少改掉默认密码 WOC_PASSWORD
./scripts/build-local.sh
docker compose up -d

浏览器访问 http://<NAS_IP>:36080，用管理员账号登录面板，新建微信实例，下载并安装微信本体（约 190–210MB），扫码登录即可。

核心特性

多实例管理：一个面板管理多个独立微信会话，每个实例独立容器 + 独立数据卷
多端共享 + 权限：多浏览器共享同一会话；子账号体系，按账号分配实例访问权限（RBAC）
微信 PC 式界面：左侧实例栏 + 右侧内嵌桌面，侧栏可折叠，移动端自动转抽屉
微信本体运行时下载：镜像不打包微信，面板一键下载安装/更新带进度条
文件传输 + 文本剪贴板：拖拽上传/下载/删除文件；文本经剪贴板中转送进微信
多端协作软锁：同一实例多人操作时自动只读 + 申请接管，避免键鼠打架
PWA：iOS 添加到主屏幕、桌面 Chrome 安装当原生 App
多架构：amd64 / arm64 预构建镜像

资源占用

实测（8 核 / 8 GiB 宿主）：

状态	CPU	内存（RSS）
单实例 · 空闲	~0.1–0.2 核	~0.6 GiB
单实例 · 活跃	~0.5–1 核	~1–1.5 GiB
面板本身	可忽略	~0.12 GiB

2 核 / 2 GiB 可跑 1 个实例（轻度）；4 核 / 8 GiB 可跑 3–4 个实例。

注意事项

项目涉及已登录的微信暴露，务必注意安全：

只在内网访问，不要裸暴露公网
务必改掉默认密码
建议外加一层 HTTPS 反代
面板挂载了 docker.sock，等同宿主 root 权限，管理员操作需谨慎

Docker Compose 配置示例

yaml

version: '3.8'
services:
  woc-panel:
    image: ghcr.io/gloridust/woc-panel:latest
    container_name: woc-panel
    ports:
      - "36080:36080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - woc-data:/data
    environment:
      WOC_PASSWORD: "your_strong_password"
      TZ: "Asia/Shanghai"
    restart: unless-stopped

volumes:
  woc-data:

通过 API 管理实例