云微：在自己的 NAS / 服务器上运行「服务端微信」

AI文摘 此内容由AI根据文章内容自动生成

AI Summary

项目介绍

WechatOnCloud 支持在 NAS / 服务器上运行微信 PC 版（服务端模式），实现多端浏览器共享同一个微信会话。无需修改微信客户端，支持多个独立微信实例管理，通过网页即可随时随地收发消息、音视频通话、文件传输。

另外此项目还有一个瓜，感兴趣的可以吃一下[link]

在飞牛 NAS（x86_64 / arm64）或任意 Docker 主机上运行服务端微信：可管理多个微信实例，每个实例是一个独立的微信会话；多个 web 用户通过浏览器访问被授权的实例，实现跨设备消息同步、多端共享。不修改微信客户端。

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

核心特性

• 🗂️ 多实例 — 一个面板管理多个独立微信会话，每个实例独立容器 + 独立数据卷，互不干扰。
• 👥 多端共享 + 权限 — 多浏览器 / 设备共享同一会话；子账号体系，按账号分配可访问的实例（RBAC）。
• 🖥️ 微信 PC 式界面 — 左侧实例栏 + 右侧内嵌桌面，侧栏可折叠，移动端自动转抽屉。
• 📦 微信本体运行时下载 — 镜像不打包微信，面板一键「下载安装 / 更新」带进度条；按 CPU 架构自动取包。
• 🔁 实例生命周期 — 启动 / 停止 / 重启 / 升级（拉新镜像重建、保留聊天记录），均在面板内一键完成。
• 📎 文件传输 + 文本剪贴板 — 拖拽上传 + 下载 + 删除，直达微信桌面 ~/Desktop；文本可经剪贴板中转送进微信（局域网 http 下也可用）。
• 🧩 多端协作软锁 — 同一实例多人操作时自动只读 + 申请接管，避免键鼠打架。
• 🔒 安全优先 — 面板为唯一入口，KasmVNC 凭据服务端注入、永不下发前端；docker.sock 仅管理员可触达。
• 📱 PWA — iOS「添加到主屏幕」、桌面 Chrome「安装」当原生 App。
• 🏗️ 多架构 — amd64 / arm64 预构建镜像（GHCR + GitHub Actions 自动发布）。

安全须知（必读）

⚠️ 这套系统暴露的是已登录的微信，请务必认真阅读本节。

能登录面板的人就能看聊天记录、以你身份发消息。面板还挂载了宿主的 docker.sock（创建/销毁实例所需），它等同宿主 root 权限。因此：

• 绝不要把面板裸暴露公网：只在内网访问，或经飞牛远程访问 / VPN / 内网穿透；
• 务必改掉默认密码（默认 admin / wechat）：cp .env.example .env 后改 WOC_PASSWORD，或登录后在「修改密码」里改；
• 实例的增删、微信安装/更新等触碰 docker 引擎的操作仅限管理员；docker API 绝不暴露给前端；
• KasmVNC 凭据由面板服务端注入，浏览器永远拿不到；实例容器名由内部随机 ID 派生，避免注入；
• 面板与外网之间再套一层 HTTPS 反代（飞牛自带反代 / Caddy / Nginx）获得正经 TLS；
• 进一步加固（陌生设备验证码、审计日志、并发控制）见 技术方案.md 第 5 节。