Files
xiaoyin-gateway/docs/project-audit-2026-10-23.md
T
Jidekin a2bb72f17e refactor!: 全量改名 —— 仓库 / 目录 / 服务 / 文档 / 站点全部换成 xiaoyin-gateway
老板要求「全改」,所以这次不只是展示名:

仓库
  · Gitea  Jidekin/api-gateway      → Jidekin/xiaoyin-gateway
  · GitHub wangjinding/api-gateway   → wangjinding/xiaoyin-gateway
  · 本地 remote 两个都改了,ls-remote 验证可访问

本机
  · /root/dsh/projects/api-gateway → xiaoyin-gateway
  · /root/.venvs/api-gateway       → xiaoyin-gateway
  · supervisor [program:api-gateway] → [program:xiaoyin-gateway]
    (reread + update + 重启后 RUNNING,根接口正常返回 小银网关 2.9.16)

引用同步
  · security/uptime-check.sh、backup-app-data.sh、backup-restore-drill.sh 的路径
  · AGENTS.md、home-network.md(后者已同步思源)
  · README / CHANGELOG / docs / Makefile 提示语 / 前端包名 / 站点里的 git clone 地址

有意保留的两处
  · 前端备份数据的 kind: 'api-gateway-backup' —— 数据格式标识,改了旧备份认不出来
  · frontend/dist 里的同名常量(同上)
2026-11-20 16:07:31 +08:00

3.6 KiB
Raw Blame History

小银网关项目体检报告(2026-10-23)

范围:/root/dsh/projects/xiaoyin-gateway(v2.9.15)。方法:跑测试 + 静态检查 + 数据/权限/备份审计 + 真实接口压测。

一、已修复(本次体检发现)

# 问题 严重度 处理
1 225 个测试用例跑不起来(pytest 未装,tests/ 6197 行) 高 装入 venv + requirements-dev.txt
2 4 个用例断言旧内存版 /logs(改读库时引入的回归) 高 断言前 flush();改用 /logs/calls 断言管理员视角
3 3 处夹具引用已下线的 grok-4.6 中 改 grok-4.7
4 测试读写生产库 高 tests/conftest.py 把 CALLLOG_DB 指向临时目录
5 /logs 库映射缺 video_id 中 api_calls 增列(自动迁移)
6 测试不幂等(失败残留账号) 低 用例开头先删

结果:218/225 → 225/225 通过。

二、已按建议落地(运维/容量)

项 内容
每日备份 backup-app-data.sh + dsh-gateway-backup.timer(03:30):VACUUM INTO 快照 + 配置/账号/会话/历史,留 14 份
备份恢复演练 backup-restore-drill.sh:解包 → 校验 SQLite integrity/行数、JSON 可解析、权限 600(已接入每日报告)
每人 QPS server.rate_limit_rps: null → 20(按账号桶;实测 120 并发触发 55 个 429)
库体积上限 CALLLOG_MAX_BYTES=2GiB,按「有效数据量」精确收紧到 80% + 按需 VACUUM(含 wal_checkpoint)
接口存活监控 uptime-check.sh 接入每日报告:本机/公网/4 台关键服务,进程活着但接口挂也能发现
WAF 白名单自愈 waf-whitelist-guard.sh + 每小时 timer:^/v1/ 被面板覆盖时自动补回并 reload

三、评估后不做的项(附理由)

项 为什么不做
CSP 去掉 unsafe-eval 产物里的 new Function 来自 vue-i18n 的 JIT 编译器;去掉会直接打断全部翻译(复现「界面显示变量名」)。站点是登录后的管理台、无内联脚本,风险本来就窄
FTS5 全文搜索 当前 400 行,LIKE '%kw%' 全表扫 <10ms;10 万行以后再说
echarts 按需引入 已独立 chunk + 懒加载,只影响 2 个页面,改造收益 < 风险
熔断/限流/失败计数落盘 重启重置是更安全的默认(宁可多试一次,不要一直熔断)
sessions token 加密(上一轮误判) app/sessions.py 早就只存 sha256("sess:"+token),盘上无可用凭证

四、体检通过项

  • SQLite integrity_check = ok;索引齐全;文件权限 600
  • 安全响应头齐全(CSP / X-Frame-Options: DENY / nosniff)
  • TODO / FIXME:0 处;53 处 except Exception 全部有日志或兜底,无裸 pass
  • history.py 有三重上限(条目数/单条字节/整文件字节)
  • /v1/media/download 有域名白名单 + 内网地址拦截(SSRF)
  • 密码 salt+hash;API Key 明文存储是产品需求(页面需反复复制),靠文件权限 600 兜底
  • 阻塞 IO 都走 _offload 线程池

五、仍然存在的已知取舍(记录在案)

  1. /logs 只看自己的(含 admin)—— 看全站要走「日志 → 调用日志」页签。
  2. 实时页列表只给前 8KB 预览,展开时调 /logs/entry/{id} 取全文(避免 200 条大内容拖垮接口)。
  3. unsafe-eval 必须保留(见上)。
  4. WAF 规则以文件为准:面板保存会覆盖 → 已有每小时自愈兜底,但仍建议最终在面板里也配置一份。