YYB-Go-Enhanced 部署留档（拾光坞 N3 + 家用 PC）

整理日期：2026-09-07
用途：微信小程序取 code 服务端，配合青龙面板跑签到脚本
环境：拾光坞 N3（ARM64）/ 家用 PC（Window)/ Clash

一、背景与选型结论

项目生态

选 YYB-Go-Enhanced 的理由

• Web 登录鉴权（管理员/普通用户），不再裸奔
• Token 自动保活，扫码一次管很久（原版约一个月失效重扫）
• 原生支持 PushPlus 通知
• 扫码后一键同步 YYB_SERVER 到青龙（OpenAPI）
• 账号级代理（品赞/巨量/静态/动态 API），解决异地登录风控
• 官方 Docker 镜像同时构建 amd64 + arm64，N3 可用

二、PC 端：导出 arm64 镜像文件（.tar）

1. 确认前提

• Docker Desktop 已运行（任务栏鲸鱼图标）
• Clash 已开启

2. 给 Docker 挂代理(可跳过)

Docker Desktop → Settings → Resources → Proxies：

• 开 Manual proxy configuration
• HTTP / HTTPS 都填 http://127.0.0.1:7892
• Apply & restart

3. 拉取 arm64 镜像

PowerShell 执行：

docker pull --platform linux/arm64 ghcr.io/525815266/yyb-go-enhanced:latest

⚠️ --platform linux/arm64 不能省——PC 是 x86，不带会拉成 amd64，N3 导入即废。

4. 验证架构（防呆）(可跳过)

docker image inspect ghcr.io/525815266/yyb-go-enhanced:latest --format "{{.Os}}/{{.Architecture}}"

输出必须是 linux/arm64。

5. 导出 tar 到桌面

docker save -o C:\Users\Administrator\Desktop\yyb-go-enhanced-arm64.tar ghcr.io/525815266/yyb-go-enhanced:latest

三、N3 端：导入镜像并建容器

1. 上传并导入

1. 拾光坞管理页 → 文件管理 (我的镜像)→ 上传 tar 文件
2. Docker → 镜像管理 → 导入镜像 → 选中 yyb-go-enhanced-arm64.tar
3. 导入后如显示 <none>，在 UI 里重命名/tag

2. 容器配置

3. 目录挂载（三条，先在本地建好空目录）

db = 数据库（最关键，丢了账号全没）｜avatars = 头像缓存｜qr = 二维码
懒人方案：只挂一条 本地父目录 → /app/resource，但必须预先建好 db/avatars/qr 三个空子目录再启动。

四、初始化与青龙对接

1. 初始化

1. 浏览器开 http://192.168.1.118:8000
2. 首个注册的账号自动成为管理员
3. 添加微信账号 → 手机扫码授权 → 备注账号
4. 控制台点「添加/同步到面板」一键写入青龙环境变量

2. 青龙环境变量

YYB_SERVER=192.168.1.118:8000@openid

• 格式：IP:端口@账号标识，一行一个多账号
• 不带 http:// 前缀
• @ 后可用账号 ID 或 OpenID（OpenID 长期更稳，删号重加不会变）

3. 青龙拉脚本库（维护中的 fork）

ql repo "https://github.com/lcmovie/YYB-GO-Script-i.git" "^wx-script/.*\.(js|py)$" "" "" "main" "js py"

可用脚本（wx-script）：飞猪、京东快递、中通快递、小米社区、嘉立创、君品荟、红色火箭、海信爱家、习酒花园、微信支付提现笔笔省。

4. 面板对接（可选，控制台里配也行）

环境变量方式：

PANEL_TYPE=qinglong
QL_URL=http://192.168.1.118:5700
QL_CLIENT_ID=青龙的ClientID
QL_CLIENT_SECRET=青龙的ClientSecret

青龙 Client ID/Secret 在青龙面板：系统设置 → 应用设置 → 新建应用（勾环境变量读写权限）。

五、注意事项

1. 8000 端口严禁映射公网——服务持有微信登录态，家里内网随便跑
2. 微信 code 一次性：多个脚本别同一时刻挤一个账号，青龙 cron 错开
3. refresh token 约 30 天可能失效：控制台会提示"建议重扫"，看到就重扫一次
4. 升级方式：PC 重新 pull → save tar → N3 导入 → 重建容器；数据都在挂载目录，不丢
5. 拾光坞 N3/N3Plus 为 ARM64 系统，所有镜像必须 arm64（含以后拉其他镜像同理）

附：快速排障