bianque-app 扁鹊生活App(部署于 maizihehuo)

扁鹊生活业务主站:百草园 H5 农场游戏、舌诊、管理后台、招聘模块与小程序的完整应用,自负载一(103.239.244.41)迁入。

访问方式

• App/H5 主站:https://app.bianquezhiyin.com/(游戏入口 /game/,管理端 /game/admin.html)
• 管理后台:https://bq.bianquezhiyin.com/(admin/dist 静态 + /api 反代)
• 深圳KK 同源站:https://shezhenkk.bianquezhiyin.com/(同 30001 API)
• 后端 API:127.0.0.1:30001(仅本机,经 nginx 反代);招聘模块 127.0.0.1:31002
• SSH:ssh -i ~/.ssh/external_ai_key -p 1208 root@100.64.0.21

技术架构

• 后端:Node.js backend/server.js,PM2 进程名 bianque-backend(端口 30001),Git 仓库为腾讯工蜂 git.code.tencent.com/yunmai/bianquezhiyu.git
• 招聘模块:recruit/app.py Python FastAPI,venv 内 uvicorn,PM2 进程 bianque-recruit(31002,已重启 18 次需关注)
• 前端:H5 与 Admin 均为构建产物静态目录(h5/dist、admin/dist);游戏为单文件 index.html(无构建链)
• 小程序:miniprogram/ 目录
• nginx:宝塔 vhost nginx_bq_app.conf、nginx_bq_admin.conf、bq.bianquezhiyin.com.conf

数据

• 核心数据库:SQLite /www/wwwroot/bianque-app/backend/bianque.db(内含用户/农场/植物/题目等;历史上约 66 用户/669 农场量级)
• 备份:同目录 bianque.db.backup.* 多份手工备份;每日 3:20 backup-daily.sh(cron,日志 /var/log/bianque-backup.log),并有 backup-daily.sh.bak.before-fnos-* 显示同步到飞牛 NAS 的逻辑
• MySQL 侧:宝塔 MySQL 有 appdata 库(面板标注"150/41迁入·root 管理")
• 凭据:Coze API Key、飞书 Token 等存在于项目配置与交接文档(见下),不抄录

使用方法

• 关键页面:游戏首页 /game/、管理端 /game/admin.html、App API /api/*
• 后台入口:bq 域名管理端;账号在管理端自身(数据库内),数据库文件位置见上
• 交接文档(含历史凭据,勿外传):/www/wwwroot/server-handoff-2026-09-07.md
• 部署前端:本地改完 → node tools/farmverify.js game-index.html 校验 → scp 到 h5/dist/game/index.html → 双端 md5sum 比对;纯前端改动不重启 PM2

维护方式

• 启停:pm2 restart bianque-backend / pm2 restart bianque-recruit;pm2 logs bianque-backend
• 日志:pm2 logs;nginx 日志在宝塔默认位置(/www/wwwlogs/)
• 配置:后端环境变量/配置文件在 backend/ 目录;nginx 配置 /www/server/panel/vhost/nginx/
• 部署脚本:deploy.sh、backup-bianque.sh

现状与风险

• 运行中,但 bianque-backend 重启 13 次、bianque-recruit 重启 18 次,建议查日志
• 历史遗留:Coze API Key 曾过期导致飞书提醒失效(交接文档记录),需确认是否已更换
• 交接文档 server-handoff-2026-09-07.md 含明文密码且放在 wwwroot(可被 web 命中风险低但存在)
• 备份链完好(每日 3:20 + fnos 异地)

优化建议

1. 【安全】mv /www/wwwroot/server-handoff-2026-09-07.md /root/ && chmod 600 /root/server-handoff-2026-09-07.md,移出 web 可达目录
2. 【可维护性】pm2 logs bianque-recruit --lines 200 | tail -100 排查重启原因;若内存不足考虑 --max-memory-restart 300M
3. 【备份】验证异地备份可恢复:在飞牛 NAS 取一份近期 bianque.db 副本做 sqlite3 .restore 演练
4. 【安全】确认 app.bianquezhiyin.com 管理端 /game/admin.html 是否有登录保护,无则加 nginx basic_auth
5. 【性能】SQLite 并发写场景建议开启 WAL:sqlite3 bianque.db "PRAGMA journal_mode=WAL;"(低峰执行)