wxcode-yyb-fusion
微信协议网关 + 多账号控制台,单个 Docker 容器即可运行。
手机微信扫码授权 → 服务保存并续期凭据 → 对内提供「按账号取小程序 code」与「多账号控制台」两类能力。自带 Web 管理界面、渠道化扫码、账号合并与编队、掉线与保活通知,并与青龙 / 呆呆 / Arcadia 面板联动。
1. 项目定位
很多自动化脚本需要小程序或公众号的 code(wx.login / 网页授权)。手工取码无法持续,直接用账号密码登录又有风险。
本项目的做法是:用手机微信扫码把账号授权一次,服务端保存协议凭据并在后台自动续期,之后脚本只要带上账号引用请求网关,就能随时拿到可用的 code——扫码在浏览器里完成,凭据不出服务器。
配套的控制台把「有哪些账号、各自多久过期、跑在哪个面板、什么时候掉线」放在一张页面上,并提供账号级隔离、脚本目录可见范围与访问令牌等管理能力。
2. 功能总览
| 序号 | 能力 | 说明 |
|---|---|---|
| 1 | 多渠道扫码 | 应用宝、腾讯电脑管家、腾讯手游助手、雷电模拟器、QQ 浏览器 5 条渠道,同一微信号可多渠道绑定后合并 |
| 2 | 取码 | 小程序 wx.login code、公众号网页授权 code、以及 /wx/* 兼容接口(用户信息、手机号、云函数、加密密钥等) |
| 3 | 账号管理 | 扫码添加 / 重复扫码刷新、备注、状态与有效期、合账、账号 ID 压缩、按账号删除 |
| 4 | 保活 | 后台按凭据剩余时间自动刷新,可配置检查间隔与提前量 |
| 5 | 代理 | 每账号独立直连 / 静态代理 / SOCKS5 / 动态代理 API |
| 6 | 面板联动 | 青龙、呆呆、Arcadia 三套面板驱动:同步 YYB_SERVER、按账号建任务、启停、读隔离日志 |
| 7 | 脚本管理 | 内置脚本集合与同步工具,可按账号运行、按目录放行可见范围 |
| 8 | 用户与权限 | 独立登录注册、管理员与普通用户、账号归属、「脚本可读」开关 |
| 9 | 可观测性 | 运行日志与调用记录视图、GET /api/system-logs、掉线通知(Server酱 / PushPlus / 企业微信机器人) |
| 10 | 防封 | 取码熔断、同账号限速、登录预算、网站应用 AppID 拒取与空码临时限制 |
3. 项目地址与界面截图
项目地址:
界面截图:
4. 快速开始
4.1 Linux / macOS
4.2 启动后访问
访问:http://<你的服务器IP>:8088。
容器部署完成会生成初始管理员账号:admin 和 16 位随机密码。密码在容器日志可查看,或者通过以下命令获取:
docker logs <容器名> 2>&1 | grep 管理员账号名可用 YYB_ADMIN_USER 覆盖。
5. 版本亮点:v17
5.1 多取码渠道
取码渠道从 1 条(应用宝) 扩展至 5 条:
| 序号 | 渠道 | 状态 |
|---|---|---|
| 1 | 应用宝 | ✅ 稳定 |
| 2 | 腾讯电脑管家 | ✅ 稳定 |
| 3 | 腾讯手游助手 | ✅ 稳定 |
| 4 | 雷电模拟器 | 🧪 实验 |
| 5 | QQ 浏览器 | ✅ 稳定 |
- 渠道清单由服务端统一下发,扫码页 / 账号卡片 / 设置页共用同一份配置。
- 同一微信号支持多渠道取码合并。
- 账号新增「扫码渠道」标识与「账号矩阵主账号」。
5.2 控制台界面重构
- 全新外壳:横幅 + 分组侧栏 + 底部工具栏。
一级入口调整为:
- 工作台
- 我的微信账号
- 添加账号
- 运行与日志
- 代理设置
- 管理分组:用户管理 / 运行日志。
- 支持明暗主题切换。
新增页面:
- 账号矩阵
- 账号级代理与代理档案
- 已激活短链接
- 系统日志
- 多账号一次性短链接页
5.3 安全与限流
- 新增取码熔断 / 限速 / 登录预算。
- AppID 黑白名单:页面可在线调整,环境变量仅作默认值。
- 新增 H5 取码链路、设备标识。
- 桌面微信快速授权(默认关闭)。
- 协议令牌与集成令牌。
- 掉线通知。
- 青龙脚本管理。
5.4 规模升级
| 序号 | 指标 | 变化 |
|---|---|---|
| 1 | 配置变量 | 16 → 40 项 |
| 2 | HTTP 接口 | 57 → 95 条 |
| 3 | 新增接口 | /api/version、/static/version.json |
6. 目录挂载说明
| 序号 | 宿主机路径 | 容器内路径 | 用途 |
|---|---|---|---|
| 1 | ./data/db | /app/resource/db | 数据库持久化 |
| 2 | ./data/avatars | /app/resource/avatars | 头像缓存 |
| 3 | ./data/qr | /app/resource/qr | 二维码缓存 |
建议将 ./data 目录做定期备份。7. 环境变量
| 序号 | 变量 | 默认值 | 说明 |
|---|---|---|---|
| 1 | TZ | Asia/Shanghai | 容器时区 |
其余 39 项配置可在控制台内在线调整,环境变量仅作为默认值。
8. 数据、备份与升级
8.1 数据位置
数据都在 DATA_DIR(默认 ./data):
db/:SQLite 库。avatars/:头像。qr/:二维码。
8.2 备份与恢复
- 备份:停容器后拷走整个
data/目录。 - 恢复:放回同一路径再启动。
8.3 升级与回滚
- 升级:
docker compose pull && docker compose up -d(或重跑deploy.sh)。数据目录与令牌都保留。 - 回滚:
.env里把IMAGE_TAG固定成旧发布号,例如v16,再up -d。
评论 (0)