📦 AirWeChat (Containerized Remote WeChat)

您的私有化微信数据保险箱。

运行在 Docker 容器中的全功能 Linux 微信。 像空气一样轻盈，随时随地访问，数据物理隔离，无缝跨端漫游，自带时光机备份。

快速开始 • 功能特性 • 时光机 • 客户端指南

---

✨ 核心特性 (Features)

• 🛡️ 零痕迹防泄露: 所有的聊天记录、文件、图片仅存储在您的私有服务器上。关闭浏览器，本地不留任何缓存。
• 💾 存储“无限”: 无论登录多少个设备，本地仅需一个浏览器。彻底解决“微信吃硬盘”问题。
• 🚀 跨端无缝漫游: 办公室电脑没聊完？回家打开浏览器继续聊。状态、草稿、窗口位置完美同步。
• ⌨️ 原生输入体验: 内置 Fcitx 中文输入法，配合 Chrome App Mode，给你媲美本地应用的流畅体验。
• ⏪ 时光机回溯: 内置一键快照脚本，误删聊天记录？一秒回到“昨天下午”。

🚀 快速开始 (Quick Start)

极简部署

只需三步，立即拥有您的私有微信云：

# 1. 克隆项目
git clone https://github.com/ox01024/air-wechat.git
cd air-wechat

# 2. 启动容器 (自动构建)
docker-compose up -d

# 3. 访问
# 打开浏览器访问 http://localhost:3000

提示: 首次启动会自动下载构建镜像，视网络情况需等待 2-5 分钟。

⏪ 时光机备份 (Time Machine)

我们为您准备了类似 macOS Time Machine 的数据管理工具。

创建快照 (Backup)

./scripts/backup.sh

将在 backups/ 目录下生成带时间戳的 .tar.gz 存档。

时光倒流 (Restore)

./scripts/restore.sh

脚本会自动列出所有备份点，选择一个编号，系统将自动停止容器、回滚数据并重启。

🖥 原生体验 (Client Guide)

不要在浏览器标签页里用微信！使用 App Mode 获得最佳体验。

Windows / macOS / Linux:

# Chrome
chrome --app=http://<Your-Server-IP>:3000

# Edge
msedge --app=http://<Your-Server-IP>:3000

💡 使用技巧

• 中文输入: 按 Ctrl + Space 切换容器内输入法。
• 剪贴板: 支持文本双向同步。大段文字建议使用左侧侧边栏的 Clipboard 工具注入。
• 全屏沉浸: 窗口自动去边框，且随浏览器窗口大小自适应分辨率。

🛠 高级配置

编辑 docker-compose.yml 自定义您的实例：

变量	说明	默认值
PUID/PGID	权限用户 ID	1000
CUSTOM_USER	Web 访问用户名	(空)
PASSWORD	Web 访问密码	(空)
shm_size	共享内存大小	4gb (勿改小)

📜 致谢

• 基于 LinuxServer.io WebTop 构建
• 感谢所有开源贡献者

---

Made with ❤️ for Privacy