核心特性
????️多架构— amd64 / arm64 预构建镜像（Docker Hub + GHCR，GitHub Actions 自动发布）。
????️多实例—一个面板管理多个独立实例，每个实例独立容器+独立数据卷，互不干扰。
????多应用（微信 + 浏览器） — 新建实例时可选微信或Chromium 浏览器；浏览器实例用于登录 Telegram / X / Instagram 等网页版社媒，登录状态写入数据卷、常驻云端、多端共享。
????多端共享+权限—多浏览器/设备共享同一会话；子账号体系，按账号分配可访问的实例（RBAC）。
????️PC界面—左侧实例栏+右侧内嵌桌面，侧栏可折叠，移动端自动转抽屉；实例图标可自定义（内置图标/上传）。
????微信交互下载 · 浏览器开箱即用—镜像不压缩微信，面板一键「下载安装/更新」带详情条、按架构取包；Chromium 已烤进镜像，创建即用、不需要下载。
????实例生命周期—启动/停止/重启/升级（拉新镜像重建、保留聊天记录），均在面板内一键完成。
????文件传输 + 文本剪切板—拖拽上传 + 下载 + 删除，直达实例桌面~/Desktop；文本可经剪切板中转送实例进（本地http下也可用）。
????多端协作软锁—同一实例多人操作时自动+申请占领，避免按键鼠打架。
????安全优先—面板为唯一入口，KasmVNC 凭证服务端注入、永不下发前端；docker.sock 仅管理员可触达。
???? PWA — iOS 「添加到主屏幕」、桌面 Chrome 「安装」当 App。
项目简介
项目名称：云微 WechatOnCloud（简称 WOC）
适配硬件：全平台 Docker 部署，支持 x86_64、arm64，兼容飞牛 fnOS、群晖、各类 Linux 服务器、ARM 小主机
核心作用：自建私有云端微信服务，所有手机、电脑、平板浏览器访问共用一套微信会话；额外搭载云端 Chromium 浏览器，常驻挂机 Telegram、X、Instagram、微博等所有网页版平台，登录状态永久保存，全设备无缝同步。
无微信协议破解，运行官方原版 Linux 微信，靠虚拟桌面推流，风控更低；全容器隔离，多账号互不干扰，搭配 RBAC 子账号权限管控，适合自用、多人协作托管账号。
不依赖第三方平台，所有聊天记录、浏览器 Cookie、文件全部存在自己服务器，数据完全私有化。
主要功能清单
- 双类型容器实例
- 微信实例：镜像轻量化，面板一键下载 / 升级官方 Linux 微信，独立数据卷保存聊天记录，重启不掉登录
- Chromium 云端浏览器：浏览器内置镜像无需下载，常驻挂 TG、推特、INS、邮箱、各类网站后台，Cookie 永久留存
- 多实例隔离管理 单面板批量管控 N 个独立容器，每个账号数据完全隔离；支持自定义实例图标、备注命名。
- 精细化权限系统 超级管理员全权限；可创建子账号，给子账号分配指定实例访问权限；子账号只能进入授权会话，无法改动服务配置。多人同用一个账号自带操作软锁，可申请独占键鼠，避免操作冲突。
- 全设备适配 + PWA 电脑端侧边管理栏，移动端自动变为侧边抽屉；支持 Chrome 桌面安装、iOS Safari 添加到主屏幕做成独立 App，告别浏览器标签。
- 文件 + 剪贴板互通 浏览器拖拽上传文件到云端桌面，云端文件可随时下载；内置中转剪贴板，内网 HTTP 环境也能双向复制文字。 深度优化中文输入法，本地输入法打完完整汉字一次性送入容器，解决远程输入卡顿、缺字。
- 实例运维全可视化 面板一键启停、重启、升级容器，升级保留全部账号数据；运行日志持久化，容器重建依旧可查看历史报错、掉线记录。
- 多架构兼容 amd64、arm64 双架构镜像全覆盖，GitHub 自动打包；Docker Hub、GHCR 双镜像源可选，国内可切换南京大学 GHCR 加速源。
硬件配置参考（内存为最大瓶颈）
- 面板常驻：占用内存约 0.12G，CPU 可忽略
- 单微信 / 浏览器闲置挂机：CPU0.1~0.2 核，内存 0.6G
- 单实例活跃聊天 / 浏览网页：CPU0.5~1 核，内存 1~1.5G 推荐配置：
- 2 核 2G：仅勉强跑 1 个实例，不推荐多开
- 4 核 8G：稳定同时运行 3~4 个微信 / 浏览器实例
- 8 核 8G：多开 + 微信视频通话、多标签浏览器流畅运行
重要安全提醒（必看）
- 面板内置 docker.sock 权限，拥有服务器最高权限，严禁直接裸奔公网；只建议内网、VPN、内网穿透访问，公网必须套 Nginx/Caddy 做 HTTPS 加密。
- 默认账号 admin、密码 wechat，部署完成第一时间修改密码，禁止弱密码。
- 能登录面板的用户可查看所有聊天记录、操控账号发消息，不要随意对外分享面板账号。
- 自带机器码、主机名、系统信息伪装功能，可缓解微信异地登录强制下线问题。
面板功能做什么
| 功能 |
谁有空 |
说明 |
| 新建/删除实例 |
管理员 |
一键创建独立实例容器（微信 / Chromium 浏览器）；新建时勾选可访问的子账号、可自定义图标。删除默认保留数据卷，任选彻底清除 |
| 实例权限分配 |
管理员 |
在实例上改“可访问账户”，或在账户上改“可访问实例”，人员管理 |
| 下载并安装/更新微信 |
管理员 |
微信实例一键下载官方Linux版本到数据卷、解压安装、带资料条，后续可「更新到最新版本」（浏览器实例消耗此步骤） |
| 进入实例 |
被授权用户 |
在浏览器中操作对应实例：微信扫码收发消息，或在 Chromium 中登录网页应用 |
| 文件 / 文本传输 |
被授权用户 |
拖拽上传/下载文件；文本经剪贴板中转送入实例 |
| 实例日志 |
管理员 |
查看实例日志，含持久化历史（重启原因 + 上一集装箱日志快照，跨集装箱重建保留） |
| 修改密码 |
所有者 |
修改自己的登录密码 |
| 子账号管理 |
管理员 |
创建/禁用/重置/删除子账号，并分配实例访问权限 |
| 安装为App |
所有者 |
iOS Safari「添加到主屏幕」、桌面 Chrome「安装」当原生 App（PWA） |
子账号是访问套件面板的身份，不是另外开一个微信 / 账号。管理员隐式拥有全部实例访问权；子账号只能看到被授权的实例。微信本体不打进镜像，新建微信实例后在面板点「下载并安装」时才下载到该实例的数据卷（浏览器实例则已随镜像重置），所以镜像小、构建快。
