后台功能与维护

LogVar 自带后台不只是配置页面，还可以看日志、测试接口、查看请求记录、清理缓存、触发重新部署和管理部分环境变量。

访问入口

普通功能入口：

https://你的域名/你的TOKEN

系统管理入口：

https://你的域名/你的ADMIN_TOKEN

如果没有配置 ADMIN_TOKEN，系统管理功能不可用。公开部署时，TOKEN 和 ADMIN_TOKEN 都不要继续使用容易猜到的值。

后台模块

配置预览

用于查看当前生效的配置。敏感变量会脱敏显示。

对应接口：

GET /api/config
GET /你的ADMIN_TOKEN/api/config

返回里常见字段：

• version：当前服务版本。
• envs：配置预览。
• categorizedEnvVars：按 API、来源、匹配、弹幕、缓存、系统分组后的变量。
• hasAdminToken：是否已经配置管理员口令。
• repository：项目仓库地址。

日志查看

用于排查请求有没有进服务、源站有没有报错、播放器路径是否填错。

对应接口：

GET /api/logs
POST /api/logs/clear

非管理员访问时，日志里的客户端 IP 会被脱敏。

接口调试 / 弹幕测试

后台可以直接模拟常用接口：

• 搜索动漫：/api/v2/search/anime
• 搜索剧集：/api/v2/search/episodes
• 自动匹配：/api/v2/match
• 获取详情：/api/v2/bangumi/:animeId
• 获取弹幕：/api/v2/comment/:commentId

弹幕测试还会展示：

• 弹幕数量
• 视频时长
• 高能时刻
• 平均密度
• 匹配耗时
• 类型分布
• 弹幕热力图
• JSON / XML 导出

排查播放器问题时，先在后台弹幕测试里确认服务能搜到并拉到弹幕，再去播放器里填地址。

推送弹幕

推送弹幕功能用于向 OK 影视等播放器发送刷新请求。

常见推送地址格式：

http://127.0.0.1:9978/action?do=refresh&type=danmaku&path=

相关变量：

DANMU_PUSH_URL=http://127.0.0.1:9978/action?do=refresh&type=danmaku&path=

使用条件：

• 播放器和弹幕服务需要能互相访问。
• 局域网使用时，确认手机、盒子、服务器在同一网络里。
• 公网推送时，确认播放器端口可达。

请求记录

用于查看最近 API 请求历史和今日请求数。

对应接口：

GET /api/reqrecords
GET /你的ADMIN_TOKEN/api/reqrecords

返回字段包括：

• interface：请求路径。
• params：POST 请求体参数。
• timestamp：请求时间。
• method：请求方法。
• clientIp：客户端 IP，非管理员会脱敏。
• todayReqNum：今日请求数。

请求记录只记录核心弹幕接口，例如搜索、匹配、FongMi、详情、弹幕和分片接口。

清理缓存

用于清空内存缓存、搜索缓存、弹幕缓存、请求记录、手动选择记忆和 Bangumi Data 缓存。

对应接口：

POST /api/cache/clear

清理后通常会重置：

• animes
• episodeIds
• lastSelectMap
• searchCache
• commentCache
• requestHistory
• reqRecords
• todayReqNum

如果启用了本地缓存、Upstash Redis 或本地 Redis，服务会尝试同步更新对应缓存。

最近 animes 缓存

用于查看最近缓存过的作品、分集、合并子源等信息。

对应接口：

GET /api/cache/animes

它适合排查“刚才搜到的候选到底来自哪个源”“合并后有哪些子源”等问题。

重新部署

对应接口：

POST /api/deploy

不同部署平台行为不同：

• Node.js / Docker：通常不需要重新部署，配置修改可自动生效或通过重启容器生效。
• Vercel / Netlify / EdgeOne / Cloudflare / Hugging Face：需要配置 DEPLOY_PLATFROM_* 变量后，后台才能调用平台 API 触发部署。

环境变量写回

后台保存变量时会调用：

POST /api/env/set
POST /api/env/add
POST /api/env/del

请求体示例：

{
  "key": "SOURCE_ORDER",
  "value": "360,vod,renren,hanjutv"
}

普通用户建议走后台页面，不要手写接口。平台 Token、Cookie、API Key 都是敏感信息，不要公开截图。

AI 连通性测试

对应接口：

POST /api/ai/verify

请求体示例：

{
  "aiBaseUrl": "https://api.openai.com/v1",
  "aiModel": "gpt-4o",
  "aiApiKey": "你的AI_API_KEY"
}

没有配置 AI_API_KEY 时会返回 AI_API_KEY 未配置。连通失败时，HTTP 状态可能仍是 200，要看正文里的 success 和 ok。

平台变量要求

后台写回环境变量和触发重新部署时，通常需要这些变量：

平台	DEPLOY_PLATFROM_ACCOUNT	DEPLOY_PLATFROM_PROJECT	DEPLOY_PLATFROM_TOKEN
Vercel	不需要	项目 ID	API Token
Netlify	账户 ID	站点 ID	Personal Access Token
EdgeOne Pages	不需要	项目 ID	API Token / 密钥
Cloudflare Workers	账户 ID	Worker 脚本名称	API Token
Hugging Face Spaces	用户名或组织名	Space 名称	User Access Token
Node.js / Docker	不需要	不需要	不需要

后台排查顺序

1. 打开 /你的ADMIN_TOKEN，确认能进入后台。
2. 在“配置预览”确认当前变量是否生效。
3. 在“接口调试 / 弹幕测试”确认搜索、匹配、取弹幕是否正常。
4. 看“请求记录”，确认播放器有没有真的请求到服务。
5. 看“日志查看”，定位 401、429、源站失败或路径异常。
6. 必要时“清理缓存”，再重新测试。
7. 云平台修改变量后，按提示触发重新部署。