YYB-Go-Enhanced:应用宝协议服务增强版,一站式微信账号管理与自动化方案
项目地址: https://github.com/525815266/YYB-Go-Enhanced
一、项目背景
在自动化脚本和签到工具的日常运维中,微信登录态的管理一直是个令人头疼的问题。传统的方案要么依赖手动扫码、要么需要复杂的抓包逆向,维护成本高且稳定性差。
YYB-Go-Enhanced 是基于 SuperNaiBA/YYB_GO 深度整理和增强的开源项目,它提供了一套完整的应用宝协议服务,将微信扫码登录、账号管理、wx.login code 获取、Token 自动续期、以及青龙/呆呆面板自动化运维整合到一个统一的 Web 控制台中。
如果你正在寻找一种"扫码一次,长期自动运行"的微信账号托管方案,这个项目值得深入了解。
二、核心功能一览
1. 双模式微信授权
- 手机扫码登录:标准的微信网页授权流程,手机扫码确认即可
- 本机微信快速授权(Windows 专属):检测本地已登录的微信客户端,一键确认授权,无需掏手机
2. 账号与 OpenID 集中管理
- 授权成功后自动展示账号 ID、OpenID 和存活状态
- 支持填写账号备注,便于多账号区分
- 一键同步到青龙面板
YYB_SERVER环境变量,重复操作自动去重
3. 自动保活机制
- 后台每 30 分钟检查一次账号状态
- Access Token 剩余不足 45 分钟时自动续期
- 业务调用失败时也会按需触发续期,无需人工干预
4. 双面板接入支持
| 面板 | 鉴权方式 | 特点 |
|---|---|---|
| 青龙面板 (Qinglong) | Client ID / Client Secret | 主流自动化面板,生态丰富 |
| 呆呆面板 (daidai-panel) | App Key / App Secret | 轻量级替代方案 |
Web 控制台支持自动识别面板类型、测试连接,且不会回传 Secret 明文。
5. 账号级运行管理
- 每个微信账号可独立创建、启停青龙脚本任务
- 运行日志使用独立抽屉连续刷新,支持超过 2MB 的大日志索引
- 账号独立推送:Server酱、PushPlus、企业微信机器人
6. 完整的 API 接口
提供 /wx/* 和 /wxapp/* 两套兼容接口:
GET /wx/code— 获取小程序wx.logincodePOST /wx/getuserinfo— 获取用户信息POST /wx/getphonenumber— 获取手机号POST /wx/cloud— 云函数调用POST /wx/encryptkey— 加密能力转发POST /wx/qrcodeauth— 二维码授权会话POST /wx/mpgeta8key— 文章会话POST /wx/appmsgext— 文章扩展数据POST /wx/appmsglike— 文章点赞
三、系统架构
┌─────────────────────────────────────────────────────────────┐
│ YYB-Go-Enhanced │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │
│ │ Web 控制台 │ │ API 服务 │ │ 后台保活任务 │ │
│ │ (账号管理) │ │ (/wx/*) │ │ (Token 自动续期) │ │
│ └─────────────┘ └─────────────┘ └─────────────────────┘ │
│ │
│ ┌─────────────────┐ ┌─────────────────────────────────┐ │
│ │ 认证数据库 │ │ 微信协议数据库 (SQLite) │ │
│ │ (SQLite/MySQL) │ │ │ │
│ └─────────────────┘ └─────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
┌─────────┐ ┌──────────┐ ┌──────────┐
│ 青龙面板 │ │ 呆呆面板 │ │ 微信服务 │
└─────────┘ └──────────┘ └──────────┘技术选型
- 后端语言:Go
- 认证存储:SQLite(默认)/ MySQL(可选)
- 协议存储:独立 SQLite
- 部署方式:Docker Compose
- 前端:内置 Web 控制台(统一管理平台外壳)
四、快速部署指南
前置条件
- Docker & Docker Compose
- 名为
qinglong_default的 Docker 网络(若无青龙,可手动创建)
1. 创建网络
docker network create qinglong_default2. 配置环境变量
cp .env.example .env关键配置项:
# 认证驱动:sqlite / mysql / none(关闭登录,仅本机调试)
YYB_AUTH_DRIVER=sqlite
YYB_AUTH_DSN=
YYB_COOKIE_SECURE=false
# 保活配置(可选)
YYB_KEEPALIVE_INTERVAL=30m
YYB_KEEPALIVE_AHEAD=45m
# 青龙面板配置(可选)
PANEL_TYPE=qinglong
QL_URL=http://qinglong:5700
QL_CLIENT_ID=你的ClientID
QL_CLIENT_SECRET=你的ClientSecret
# 呆呆面板配置(可选)
PANEL_TYPE=daidai
DAIDAI_URL=http://daidai-panel:5700
DAIDAI_APP_KEY=你的AppKey
DAIDAI_APP_SECRET=你的AppSecret3. 构建并启动
docker compose up -d --build访问地址:http://服务器IP:8000
4. 初始化管理员
- 方式一:首次打开控制台注册的第一个账号自动成为管理员
方式二:启动前设置环境变量预创建
YYB_ADMIN_USER=admin YYB_ADMIN_PASSWORD=your_password
五、使用流程
第一步:添加微信账号
- 打开 Web 控制台,点击「扫码添加」
- 手机微信扫码确认,或 Windows 本机微信快速授权
- 填写账号备注,点击「添加到青龙」
第二步:配置面板连接
- 进入控制台「系统入口」→「青龙连接设置」
- 填入面板地址、Client ID、Client Secret
- 点击「测试并保存」,系统自动识别面板类型
第三步:运行脚本
- 进入「账号运行管理」(
/runs) - 选择账号,配置推送(Server酱/PushPlus/企业微信)
- 发现脚本仓库中的
.js/.py任务 - 为每个"账号 + 脚本"创建独立任务,点击「运行一次」
第四步:查看日志
- 管理页按账号隔离日志
- 支持实时刷新、搜索、大日志索引
六、API 调用示例
获取 wx.login code
curl -X POST http://yyb-go:8000/wxapp/getCode \
-H 'Content-Type: application/json' \
-d '{"ref":"1","app_id":"wx0000000000000000"}'云函数调用
curl -X POST http://yyb-go:8000/wx/cloud \
-H 'Content-Type: application/json' \
-d '{
"ref": "1",
"app_id": "wx0000000000000000",
"payload": {
"api_name": "callFunction",
"data": {"name": "签到", "data": {}}
}
}'刷新单个账号状态
curl -X POST http://yyb-go:8000/accounts/refresh \
-H 'Content-Type: application/json' \
-d '{"ref":"1"}'七、安全与合规
⚠️ 重要提醒:
- 不要直接暴露到公网:
/wx/*、/wxapp/*等协议接口不要求浏览器 Cookie,建议仅在可信局域网内运行 - 敏感信息保护:
.env、SQLite 数据库、登录凭据、真实 OpenID 不要提交到 Git - Token 有失效风险:
wx.logincode 是短期一次性的,refresh token 也可能被服务端撤销,失效后需重新扫码 - 合法合规:本项目仅供学习和个人研究使用,请遵守相关平台条款及所在地法律法规
八、与上游项目的差异
| 特性 | YYB_GO (上游) | YYB-Go-Enhanced (本项目) |
|---|---|---|
| 账号信息展示 | 基础 | ✅ 增强,OpenID 可见 |
| Web 控制台 | 基础 | ✅ 统一管理平台外壳,资源修复 |
| 用户权限系统 | ❌ | ✅ 管理员/普通用户/注册控制 |
| 青龙面板接入 | 基础 | ✅ 自动识别、账号级任务管理 |
| 呆呆面板支持 | ❌ | ✅ 完整适配 |
| 本机微信授权 | ❌ | ✅ Windows 快速授权 |
| 自动保活 | ❌ | ✅ Token 自动续期 |
| 账号独立推送 | ❌ | ✅ Server酱/PushPlus/企微机器人 |
| Docker 部署 | 基础 | ✅ 多架构镜像、GitHub Actions 自动构建 |
九、总结
YYB-Go-Enhanced 将分散的微信协议管理、账号托管、自动化运维整合到了一个统一的 Go 服务中。它的核心价值在于:
- 降低维护成本:一次扫码,长期自动保活
- 多账号隔离:每个微信账号独立运行、独立日志、独立推送
- 面板兼容:同时支持青龙和呆呆两大主流面板
- 开箱即用:Docker Compose 一键部署,内置 Web 控制台
如果你正在维护多个微信自动化脚本,厌倦了频繁的扫码和手动管理,这个项目可以帮你把运维工作简化到一个 Web 页面内完成。
GitHub 仓库: https://github.com/525815266/YYB-Go-Enhanced
Star 支持作者,Issue 反馈问题,PR 共建生态! ⭐
评论 (0)