支持的环境变量

目标：这页不是只列变量名，而是帮你看懂每个变量：它是什么、默认值是什么、什么时候要改、怎么填。

如果你还没打开管理员界面，先看 UI 与环境变量。已经能打开后台的话，进入 系统配置 后按下面索引点变量名即可跳到对应说明。

后台顶部有 6 个分类：API配置、源配置、匹配配置、弹幕配置、缓存配置、系统配置。每一行就是一个变量，右侧点 编辑 会打开该变量的编辑窗口。

不用回云平台网页。打开：

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

这里是跳转索引，不写默认值。点变量名会跳到下面对应的小节；默认值、参考值和填写方法都写在变量正文里。

• 访问口令：先看 TOKEN 和 ADMIN_TOKEN，公开部署不要用容易猜的值。
• 搜索来源：先看 SOURCE_ORDER，再看 VOD_SERVERS。360 / vod 属于采集站 / 聚合源，爱优腾芒和 B 站属于官源。
• 过滤匹配：搜出来总是预告、花絮、合集，就看 ENABLE_ANIME_EPISODE_FILTER、ANIME_TITLE_FILTER、EPISODE_TITLE_FILTER。
• 弹幕清洗：弹幕太脏或太多，看 BLOCKED_WORDS、GROUP_MINUTE、DANMU_LIMIT。
• 缓存和时间轴：重复请求多看缓存变量；弹幕早晚不同步看 DANMU_OFFSET。

控制 API 入口和访问保护。公开部署时，最先确认这组。

• TOKEN：普通 API 访问口令。
• ADMIN_TOKEN：管理员入口口令。
• RATE_LIMIT_MAX_REQUESTS：同 IP 每分钟限流。

TOKEN：普通 API 访问口令

是什么：它是普通接口路径中的口令，播放器、Emby 插件、影视壳调用弹幕 API 时会用到。

默认值：87654321

什么时候改：公开部署建议改成自己的字符串；如果保持默认值，项目允许很多接口不带 token 请求，适合本地测试但不适合公开服务。

怎么填 / 注意：API 地址一般是 https://你的域名/TOKEN。默认 token 时，也可以直接请求 /api/v2/...。

ADMIN_TOKEN：管理员入口口令

是什么：它控制后台管理入口。配置后访问 https://你的域名/ADMIN_TOKEN 才能打开系统配置。

默认值：空

什么时候改：一旦需要在网页里修改环境变量、清理缓存或触发部署，就必须配置；公开部署时一定不要用容易猜到的值。

怎么填 / 注意：建议用长随机字符串；不要截图真实值。

RATE_LIMIT_MAX_REQUESTS：同 IP 每分钟限流

是什么：它是接口防刷的第一道限制，保护公开 API 不被同一 IP 高频请求拖垮。

默认值：3

什么时候改：公开服务建议保留；自己调试接口时可临时调大。填 0 表示关闭限流，不建议长期公开使用。

怎么填 / 注意：范围：0-50；常用：3、10、0。

决定去哪些地方找候选条目和弹幕，是自动匹配是否准确的关键。

• SOURCE_ORDER：搜索来源顺序。
• MERGE_SOURCE_PAIRS：多源合并规则。
• OTHER_SERVER：第三方兜底弹幕服务器。
• CUSTOM_SOURCE_API_URL：自定义弹幕源 API。
• VOD_SERVERS：VOD 采集站列表。
• VOD_RETURN_MODE：VOD 返回模式。
• VOD_REQUEST_TIMEOUT：VOD 请求超时。
• BILIBILI_COOKIE：B 站 Cookie。
• DOUBAN_COOKIE：豆瓣 Cookie。
• YOUKU_CONCURRENCY：优酷并发数。

SOURCE_ORDER：搜索来源顺序

是什么：它决定搜索和自动匹配时的来源优先级。排在前面的来源会更早参与匹配，先后顺序会影响最终自动返回哪个弹幕。

默认值：360,vod,renren,hanjutv

什么时候改：想覆盖广就保留默认；想优先官方平台可加入 iqiyi、youku、tencent、imgo、bilibili；看动画较多可加 dandan、animeko、bahamut。

怎么填 / 注意：采集站/聚合源：360、vod。官源：爱优腾芒、B 站等，如 iqiyi、youku、tencent、imgo、bilibili。独立弹幕源：dandan、animeko、bahamut。

MERGE_SOURCE_PAIRS：多源合并规则

是什么：它会让同一条结果同时取多个来源的弹幕，再按规则合并。适合单个源弹幕少、想用别的源补量的情况。

默认值：空

什么时候改：先把单源跑通再开合并；合并太多会让排错变难，也可能混入重复或时间轴不一致的弹幕。

怎么填 / 注意：格式：主源&副源&副源，多组用英文逗号分隔。示例：imgo&iqiyi,dandan&bahamut&animeko,imgo。

OTHER_SERVER：第三方兜底弹幕服务器

是什么：当本项目需要走第三方弹幕服务兜底时，会请求这里配置的服务器。

默认值：https://api.danmu.icu

什么时候改：一般不用改；只有默认服务器不可用、你有更稳定的兼容服务，或想换其它公共服务时再改。

怎么填 / 注意：官方列出的其它可选地址包括：https://fc.lyz05.cn、https://dmku.hls.one、https://se.678.ooo、https://danmu.56uxi.com、https://dm.lxlad.com。

CUSTOM_SOURCE_API_URL：自定义弹幕源 API

是什么：它让项目把一个自定义 API 当作 custom 来源参与搜索和匹配。

默认值：空

什么时候改：只有你有自己的兼容服务时再填；填完还要在 SOURCE_ORDER 里加入 custom，否则不会被调用。

VOD_SERVERS：VOD 采集站列表

是什么：vod 不是单个网站，而是一组资源站。这里决定 vod 去哪些采集站找视频条目，再用条目匹配弹幕。

默认值：金蝉@https://zy.jinchancaiji.com,789@https://www.caiji.cyou,听风@https://gctf.tfdh.top

什么时候改：默认能用就先不动；如果某站慢、失效或结果脏，可以删除；如果你知道稳定资源站，可以按格式添加。

怎么填 / 注意：格式：名称@URL,名称@URL。采集站负责找条目，不代表弹幕一定来自该采集站。

VOD_RETURN_MODE：VOD 返回模式

是什么：当配置多个 VOD 站点时，它决定是只拿最快站点，还是汇总所有站点。

默认值：fastest

什么时候改：想速度快、结果少，用默认 fastest；想覆盖更广、愿意手动挑结果，用 all。

怎么填 / 注意：可选值：fastest、all。all 结果更多，也更容易重复或混入错误条目。

VOD_REQUEST_TIMEOUT：VOD 请求超时

是什么：它防止慢速或失效采集站卡住整个搜索。单位是毫秒。

默认值：10000 毫秒

什么时候改：站点经常慢但能返回时调大；公开部署或追求速度时不要太大。

怎么填 / 注意：官方建议：5000-15000。

BILIBILI_COOKIE：B 站 Cookie

是什么：填入后可帮助抓取完整弹幕，或启用港澳台 App 接口。

默认值：空

什么时候改：只有 B 站搜索不稳定、接口受限、需要港澳台接口时再填。Cookie 是敏感信息。

怎么填 / 注意：弹幕获取通常至少需要 SESSDATA=xxxx；港澳台区域稳定 App 搜索可能还需要 bili_jct=xxxx 或 access_key=xxxx。

DOUBAN_COOKIE：豆瓣 Cookie

是什么：用于豆瓣相关搜索和详情接口，提供登录态可提升稳定性。

默认值：空

什么时候改：遇到豆瓣搜索异常、频繁验证、返回不稳定时再填。Cookie 是敏感信息。

怎么填 / 注意：格式示例：bid=xxxx; ll="118282"; ...。

YOUKU_CONCURRENCY：优酷并发数

是什么：并发越高，优酷弹幕请求可能越快，但失败概率和压力也可能增加。

默认值：8

什么时候改：默认通常够用；优酷请求慢可小幅调高，失败多就调低。

怎么填 / 注意：范围：1-16。

决定搜到多个候选时怎么选，重点影响自动匹配准不准。

• PLATFORM_ORDER：自动匹配平台优先级。
• ANIME_TITLE_FILTER：剧名过滤规则。
• EPISODE_TITLE_FILTER：集标题过滤规则。
• ENABLE_ANIME_EPISODE_FILTER：剧名/集标题过滤开关。
• STRICT_TITLE_MATCH：严格标题匹配。
• TITLE_TO_CHINESE：外文标题转中文。
• ANIME_TITLE_SIMPLIFIED：剧名繁转简。
• TITLE_MAPPING_TABLE：剧名映射表。
• AI_BASE_URL：AI 服务地址。
• AI_MODEL：AI 模型名称。
• AI_API_KEY：AI API Key。
• AI_MATCH_PROMPT：AI 匹配提示词。
• USE_BANGUMI_DATA：Bangumi Data 辅助匹配。

PLATFORM_ORDER：自动匹配平台优先级

是什么：它不是搜索来源，而是“候选已经搜到后”的排序偏好。

默认值：空

什么时候改：你更信任某个平台弹幕时再配置；不填时返回第一个满足条件的平台。

怎么填 / 注意：示例：bilibili1,qq 表示有 B 站先用 B 站，否则用腾讯。合并平台可写 dandan&animeko。

ANIME_TITLE_FILTER：剧名过滤规则

是什么：它按正则过滤动漫/剧名，比如把广告、合集、无关标题排除掉。

默认值：空

什么时候改：需要配合 ENABLE_ANIME_EPISODE_FILTER=true 才会在手动搜索过滤里生效。

怎么填 / 注意：官方参考：使用 | 分隔多个关键词，例如 广告|预告|无关剧名。

EPISODE_TITLE_FILTER：集标题过滤规则

是什么：它按正则过滤剧集或综艺的集标题，主要避免自动匹配到预告、花絮、PV、采访、特辑等。

默认值：内置长正则；手动填写会完整覆盖默认值

什么时候改：如果默认过滤误伤，或你想额外过滤特定词，再自定义。自定义后会完全覆盖默认规则，不是追加。

怎么填 / 注意：官方自定义示例：测试|test。只支持 match 自动匹配相关流程。

(特别|惊喜|纳凉)?企划(?!(书|案|部))|合伙人手记|超前(营业|vlog)?|速览|vlog|(?<!(Chain|Chemical|Nuclear|连锁|化学|核|生化|生理|应激))reaction|(?<!(单))纯享|加更(版|篇)?|抢先(看|版|集|篇)?|(?<!(被|争|谁))抢[先鲜](?!(一步|手|攻|了|告|言|机|话))|抢鲜|预告(?!(函|信|书|犯))|(?<!(死亡|恐怖|灵异|怪谈))花絮(独家)?|(?<!(一|直))直拍|(制作|拍摄|幕后|花絮|未播|独家|演员|导演|主创|杀青|探班|收官|开播|先导|彩蛋|NG|回顾|高光|个人|主创)特辑|(?<!(行动|计划|游戏|任务|危机|神秘|黄金))彩蛋|(?<!(嫌疑人|证人|家属|律师|警方|凶手|死者))专访|(?<!(证人))采访(?!(吸血鬼|鬼))|(正式|角色|先导|概念|首曝|定档|剧情|动画|宣传|主题曲|印象)[\s\.]*[PpＰｐ][VvＶｖ]|(?<!(鸦|雪|纸|相|照|图|名|大))片花|(?<!(退居|回归|走向|转战|隐身|藏身|的))幕后(?!(主谋|主使|黑手|真凶|玩家|老板|金主|英雄|功臣|推手|大佬|操纵|交易|策划|博弈|BOSS|真相))(故事|花絮|独家)?|衍生(?!(品|物|兽))|番外(?!(地|人))|直播(陪看|回顾)?|直播(?!(.*(事件|杀人|自杀|谋杀|犯罪|现场|游戏|挑战)))|未播(片段)?|会员(专享|加长|尊享|专属|版)?|(?<!(提取|吸收|生命|魔法|修护|美白))精华|看点|速看|解读(?!.*(密文|密码|密电|电报|档案|书信|遗书|碑文|代码|信号|暗号|讯息|谜题|人心|唇语|真相|谜团|梦境))|(?<!(案情|人生|死前|历史|世纪))回顾|影评|解说|吐槽|(?<!(年终|季度|库存|资产|物资|财务|收获|战利))盘点|拍摄花絮|制作花絮|幕后花絮|未播花絮|独家花絮|花絮特辑|先导预告|终极预告|正式预告|官方预告|彩蛋片段|删减片段|未播片段|番外彩蛋|精彩片段|精彩看点|精彩集锦|看点解析|看点预告|NG镜头|NG花絮|番外篇|番外特辑|制作特辑|拍摄特辑|幕后特辑|导演特辑|演员特辑|片尾曲|(?<!(生命|生活|情感|爱情|一段|小|意外))插曲|高光回顾|背景音乐|OST|音乐MV|歌曲MV|前季回顾|剧情回顾|往期回顾|内容总结|剧情盘点|精选合集|剪辑合集|混剪视频|独家专访|演员访谈|导演访谈|主创访谈|媒体采访|发布会采访|陪看(记)?|试看版|短剧|精编|(?<!(Love|Disney|One|C|Note|S\d+|\+|&|\s))Plus|独家版|(?<!(导演|加长|周年))特别版(?!(图|画))|短片|(?<!(新闻|紧急|临时|召开|破坏|大闹|澄清|道歉|新品|产品|事故))发布会|解忧局|走心局|火锅局|巅峰时刻|坞里都知道|福持目标坞民|福利(?!(院|会|主义|课))篇|(福利|加更|番外|彩蛋|衍生|特别|收官|游戏|整蛊|日常)篇|独家(?!(记忆|试爱|报道|秘方|占有|宠爱|恩宠))|.{2,}(?<!(市|分|警|总|省|卫|药|政|监|结|大|开|破|布|僵|困|骗|赌|胜|败|定|乱|危|迷|谜|入|搅|设|中|残|平|和|终|变|对|安|做|书|画|察|务|案|通|信|育|商|象|源|业|冰))局(?!(长|座|势|面|部|内|外|中|限|促|气))|(?<!(重症|隔离|实验|心理|审讯|单向|术后))观察室|上班那点事儿|周top|赛段|VLOG|(?<!(大案|要案|刑侦|侦查|破案|档案|风云|历史|战争|探案|自然|人文|科学|医学|地理|宇宙|赛事|世界杯|奥运))全纪录|开播|先导|总宣|展演|集锦|旅行日记|精彩分享|剧情揭秘(?!(者|人))|(?:^|】\s*|\]\s*)(?:[SC]|SP|OP|ED|PV)\d+(?:[\s:：\.\-]|$)

ENABLE_ANIME_EPISODE_FILTER：剧名/集标题过滤开关

是什么：它是 ANIME_TITLE_FILTER 和 EPISODE_TITLE_FILTER 的总开关。

默认值：false

什么时候改：搜索结果经常混入预告、花絮、合集、解说时打开；如果发现正片被过滤掉，先关掉排查。

怎么填 / 注意：可选值：true、false。启用后会影响 GET /api/v2/bangumi/{id} 和 GET /api/v2/search/anime。

STRICT_TITLE_MATCH：严格标题匹配

是什么：默认是宽松模糊匹配，容易搜到更多结果；严格模式只匹配标题开头或完全匹配。

默认值：false

什么时候改：标题短、常误匹配时开启。例如搜“遮天”时，可避免匹配“古惑仔3之只手遮天”。

怎么填 / 注意：可选值：true、false。

TITLE_TO_CHINESE：外文标题转中文

是什么：适合网盘资源没有刮削、文件名是英文标题的情况。

默认值：false

什么时候改：需要配置 TMDB_API_KEY 才有意义；不用外文资源可不填。

怎么填 / 注意：示例场景：Blood.River.S01E05 这类标题。

ANIME_TITLE_SIMPLIFIED：剧名繁转简

是什么：用于繁简标题不一致时提升搜索命中率。

默认值：false

什么时候改：片名来源常是繁体、但弹幕源常用简体时打开。

怎么填 / 注意：可选值：true、false。

TITLE_MAPPING_TABLE：剧名映射表

是什么：用于别名、续作改名、平台译名不同等场景。

默认值：空

什么时候改：当自动匹配总是搜旧名、别名或搜不到时配置。

怎么填 / 注意：格式：原始标题->映射标题;原始标题->映射标题。示例：唐朝诡事录->唐朝诡事录之西行;国色芳华->锦绣芳华。

AI_BASE_URL：AI 服务地址

是什么：用于 AI 自动匹配功能的 API 地址。

默认值：https://api.openai.com/v1

什么时候改：只有要启用 AI 匹配时再配置；兼容 OpenAI 接口的服务也可填自己的地址。

AI_MODEL：AI 模型名

是什么：指定 AI 自动匹配时调用哪个模型。

默认值：gpt-4o

什么时候改：只在配置 AI_API_KEY 并启用 AI 匹配时有意义。

AI_API_KEY：AI API 密钥

是什么：用于 AI 服务身份验证。

默认值：空

什么时候改：只有需要 AI 辅助匹配时填写；属于敏感密钥，不要公开。

AI_MATCH_PROMPT：AI 匹配提示词

是什么：默认提示词会让 AI 按标题相似度、季、集、年份、平台偏好等规则返回候选索引。

默认值：内置默认提示词

什么时候改：普通用户不要改；只有你清楚当前 AI 匹配哪里错了，再针对性调整。

USE_BANGUMI_DATA：Bangumi Data 加速匹配

是什么：开启后会下载并缓存动画元数据，用于提升动画源检索和匹配速度，也可能解锁隐藏/区域番剧。

默认值：false

什么时候改：本地和 Docker 部署建议先挂载 .cache 再开；云部署会缓存到临时内存，体验不佳就关闭。

决定返回弹幕怎么过滤、去重、限量、转格式和修时间轴。

• BLOCKED_WORDS：屏蔽词列表。
• GROUP_MINUTE：按时间窗口合并重复弹幕。
• DANMU_LIMIT：弹幕数量限制。
• DANMU_SIMPLIFIED_TRADITIONAL：弹幕简繁体转换。
• DANMU_PUSH_URL：弹幕推送地址。
• LIKE_SWITCH：弹幕点赞数显示开关。
• DANMU_OFFSET：弹幕时间偏移。
• CONVERT_TOP_BOTTOM_TO_SCROLL：顶部/底部弹幕转滚动弹幕。
• CONVERT_COLOR：弹幕颜色转换。
• COLOR_POOL：自定义颜色池。
• DANMU_OUTPUT_FORMAT：弹幕输出格式。

BLOCKED_WORDS：弹幕屏蔽词

是什么：它按正则或关键词过滤弹幕内容，适合屏蔽广告、日期、刷屏、报到、无意义数字等。

默认值：空

什么时候改：默认不屏蔽。想清洗弹幕再填；规则太激进会误杀正常弹幕。

怎么填 / 注意：格式：多个规则用英文逗号分隔，正则写成 /规则/。

/.{20,}/,/^\d{2,4}[-/.]\d{1,2}[-/.]\d{1,2}([日号.]*)?$/,/^(?!哈+$)([a-zA-Z\u4e00-\u9fa5])\1{2,}/,/[0-9]+\.*[0-9]*\s*(w|万)+\s*(\+|个|人|在看)+/,/^[a-z]{6,}$/,/^(?:qwertyuiop|asdfghjkl|zxcvbnm)$/,/^\d{5,}$/,/^(\d)\1{2,}$/,/^\d{1,4}$/,/(20[0-3][0-9])/,/(0?[1-9]|1[0-2])月,/\d{1,2}[.-]\d{1,2}/,/[@#&$%^*+\|/\-_=<>°◆◇■□●○★☆▼▲♥♦♠♣①②③④⑤⑥⑦⑧⑨⑩]/,/[一二三四五六七八九十百\d]+刷/,/第[一二三四五六七八九十百\d]+/,/(全体成员|报到|报道|来啦|签到|刷|打卡|我在|来了|考古|爱了|挖坟|留念|你好|回来|哦哦|重温|复习|重刷|再看|在看|前排|沙发|有人看|板凳|末排|我老婆|我老公|撅了|后排|周目|重看|包养|DVD|同上|同样|我也是|俺也|算我|爱豆|我家爱豆|我家哥哥|加我|三连|币|新人|入坑|补剧|冲了|硬了|看完|舔屏|万人|牛逼|煞笔|傻逼|卧槽|tm|啊这|哇哦)/

GROUP_MINUTE：弹幕合并去重分钟数

是什么：表示按 N 分钟分组后对弹幕合并去重，减少重复刷屏。

默认值：1

什么时候改：默认 1 分钟适合大多数情况；想保留原始弹幕就填 0。

怎么填 / 注意：范围：0-30，0 表示不去重。

DANMU_LIMIT：弹幕数量限制

是什么：当弹幕很多时，它按等间隔采样限制总数，减少播放器压力。

默认值：0

什么时候改：弹幕太密、播放器卡顿时设置；追求完整弹幕就保留 0。

怎么填 / 注意：单位是 k（千）。例如 5 表示超过 5000 条时控制到约 5000 条。

DANMU_SIMPLIFIED_TRADITIONAL：弹幕简繁转换

是什么：用于统一弹幕文字形态，避免同一语言繁简混杂。

默认值：default

什么时候改：只在你希望全部转简体或繁体时修改。

怎么填 / 注意：可选值：default 不转换、simplified 繁转简、traditional 简转繁。

DANMU_PUSH_URL：弹幕推送地址

是什么：某些播放器或影视壳支持通过接口刷新/推送弹幕，这里填默认推送地址。

默认值：空

什么时候改：不用推送弹幕功能就留空；使用 OK 影视等播放器时再按播放器要求填写。

怎么填 / 注意：官方示例：http://127.0.0.1:9978/action?do=refresh&type=danmaku&path=。

LIKE_SWITCH：点赞数显示开关

是什么：开启后会在弹幕内容后显示点赞数，先去重再拼接点赞标记。

默认值：true

什么时候改：想减少干扰可以关闭；默认低于 5 赞不会显示，避免低赞弹幕干扰。

DANMU_OFFSET：弹幕时间偏移

是什么：可按剧名、季、集、来源配置偏移秒数，解决弹幕时间轴与视频不一致。

默认值：空

什么时候改：某部剧弹幕整体早了或晚了再填；正数表示弹幕延后，负数表示提前。

怎么填 / 注意：示例：overlord/S01:90,re-zero/S02@bilibili:120,re-zero/S02/E03@dandan&bilibili:10。百分比模式：东方/S03/E02@tencent%:11。

CONVERT_TOP_BOTTOM_TO_SCROLL：顶底弹幕转滚动

是什么：有些播放器不支持顶部/底部弹幕，这个开关会把 ct=5/ct=4 转成 ct=1。

默认值：false

什么时候改：播放器显示顶底弹幕有问题时打开；正常播放器不用改。

CONVERT_COLOR：弹幕颜色转换

是什么：解决部分播放器不支持彩色弹幕，或希望弹幕颜色更统一的问题。

默认值：default

什么时候改：播放器不支持彩色时可用 white；想让白色弹幕随机变彩色用 color。

怎么填 / 注意：可选值：default、white、color。

COLOR_POOL：随机颜色池

是什么：只有 CONVERT_COLOR=color 时生效，用来控制随机颜色范围。

默认值：内置白、红、橙、黄、绿、青、蓝、紫、粉等十进制颜色值

什么时候改：想自定义彩色弹幕颜色时再改。

怎么填 / 注意：格式：十进制颜色值逗号分隔，例如 16711680,65280,255,16776960。

DANMU_OUTPUT_FORMAT：默认输出格式

是什么：决定弹幕输出格式；查询参数可临时覆盖。

默认值：json

什么时候改：播放器需要 XML 时可以改成 xml；否则保持 JSON。

怎么填 / 注意：可选值：json、xml。优先级：查询参数 ?format= > 环境变量 > 默认值。

决定搜索结果、弹幕结果和手动选择记录保存多久、存在哪里。

• UPSTASH_REDIS_REST_URL：Upstash Redis REST URL。
• UPSTASH_REDIS_REST_TOKEN：Upstash Redis REST Token。
• LOCAL_REDIS_URL：本地 Redis URL。
• SEARCH_CACHE_MINUTES：搜索结果缓存时间。
• COMMENT_CACHE_MINUTES：弹幕内容缓存时间。
• REMEMBER_LAST_SELECT：记住手动选择结果。
• MAX_LAST_SELECT_MAP：手动选择记录上限。
• MAX_ANIMES：anime 条目缓存上限。
• BANGUMI_DATA_CACHE_DAYS：Bangumi Data 缓存天数。

UPSTASH_REDIS_REST_URL：Upstash Redis 地址

是什么：和 Token 配合使用，用于持久化存储缓存和选择记录，减少冷启动丢状态。

默认值：空

什么时候改：Vercel、Cloudflare、EdgeOne 等无本地 Redis 的平台可考虑；本地单实例可先不填。

UPSTASH_REDIS_REST_TOKEN：Upstash Redis Token

是什么：Upstash 访问令牌，和 URL 配套使用。

默认值：空

什么时候改：需要持久化缓存时填写；它是敏感信息，不要公开。

LOCAL_REDIS_URL：本地 Redis 连接地址

是什么：用于本地部署或 Docker 部署接入 Redis。

默认值：空

什么时候改：只有你已经部署 Redis，且希望缓存跨重启保存时填写。

怎么填 / 注意：格式：redis://:password@127.0.0.1:6379/0。

SEARCH_CACHE_MINUTES：搜索缓存时间

是什么：缓存搜索结果，避免短时间重复请求同一个关键词。

默认值：3 分钟

什么时候改：想更快刷新结果就调小；Docker 自用可调大减少请求。

怎么填 / 注意：官方建议：Vercel/Cloudflare 1-5 分钟，Docker 5-30 分钟，0 表示不缓存。

COMMENT_CACHE_MINUTES：弹幕缓存时间

是什么：缓存弹幕数据，独立于搜索结果缓存。

默认值：3 分钟

什么时候改：源站慢、请求多时可调大；想每次拉最新弹幕可设小或 0。

REMEMBER_LAST_SELECT：记住手动选择

是什么：当你手动选过某部剧或某集，下次 match 自动匹配会优先参考上次选择。

默认值：true

什么时候改：默认开启；如果你不想让历史选择影响后续匹配，可关闭。

怎么填 / 注意：这是实验性功能。

MAX_LAST_SELECT_MAP：手动选择记忆上限

是什么：限制 lastSelectMap 记录数，超过后按 FIFO 删除最早记录。

默认值：100

什么时候改：通常不用改；手动选择记录很多时可调大。

怎么填 / 注意：范围：100-1000。

MAX_ANIMES：动漫标题缓存上限

是什么：限制内存/缓存里保存的动漫标题条目数。

默认值：100

什么时候改：通常不用改；搜索范围大且频繁时可适当调大。

怎么填 / 注意：范围：100-1000。

BANGUMI_DATA_CACHE_DAYS：Bangumi Data 缓存天数

是什么：仅在 USE_BANGUMI_DATA=true 时有意义。超过天数后会下载更新。

默认值：7 天

什么时候改：想更频繁更新就调小；填 0 表示每次请求时强制异步更新。

怎么填 / 注意：范围：0-30。

代理、外部 API、日志、黑名单和云平台写回变量。很多是高级项。

• PROXY_URL：代理/反代地址。
• TMDB_API_KEY：TMDB API Key。
• LOG_LEVEL：日志级别。
• IP_BLACKLIST：IP 黑名单。
• DEPLOY_PLATFROM_ACCOUNT：部署平台账号 ID。
• DEPLOY_PLATFROM_PROJECT：部署平台项目名称/ID。
• DEPLOY_PLATFROM_TOKEN：部署平台访问令牌。
• NODE_TLS_REJECT_UNAUTHORIZED：HTTPS 证书校验开关。

PROXY_URL：代理/反代地址

是什么：目前主要对巴哈姆特、TMDB API、Bilibili 生效。

默认值：空

什么时候改：访问巴哈姆特、TMDB 或 B 站相关接口不通时再配。

怎么填 / 注意：支持：普通代理 http://127.0.0.1:7890；万能反代 @http://127.0.0.1；特定反代 bahamut@http://127.0.0.1、tmdb@...、bilibili@...。

TMDB_API_KEY：TMDB API Key

是什么：目前主要对巴哈姆特和外文标题转中文相关能力有帮助。

默认值：空

什么时候改：巴哈译名不同导致搜不到，或启用 TITLE_TO_CHINESE 时配置。

怎么填 / 注意：例如大陆常用译名与巴哈译名不同，配置后可并行从 TMDB 获取日语原名搜索。

LOG_LEVEL：日志级别

是什么：决定运行时输出哪些日志。

默认值：info

什么时候改：生产环境建议 warn；排错时用 info。

怎么填 / 注意：当前实现稳定支持的常用值是 error、warn、info。如果你在其他地方看到 debug，先以当前版本实际行为为准，不要把它当成教程里的默认推荐值。

IP_BLACKLIST：IP 黑名单

是什么：命中规则的请求会被拒绝，用来处理恶意请求或刷接口。

默认值：空

什么时候改：遇到明显异常来源再配置；不要误封自己的代理或 CDN 出口。

怎么填 / 注意：支持逗号/分号/换行分隔，支持正则和 CIDR。示例：192.168.1.10,10.0.0.0/24,2001:db8::/64,/^203\.0\.113\./。

DEPLOY_PLATFROM_ACCOUNT：部署平台账号 ID

是什么：管理员 UI 调用部署平台 API 时需要，用于定位账号。

默认值：空

什么时候改：Docker 和本地 Node 部署不需要；云平台想在 UI 中保存变量并触发部署时再填。

DEPLOY_PLATFROM_PROJECT：部署平台项目名/ID

是什么：管理员 UI 调用云平台 API 时需要，用来定位要修改的项目。

默认值：空

什么时候改：Vercel、EdgeOne 等平台通常重点需要这个和 Token。

DEPLOY_PLATFROM_TOKEN：部署平台 API Token

是什么：管理员 UI 使用它调用平台 API。

默认值：空

什么时候改：只有需要 UI 直接改云平台变量时填写；Docker/本地部署不需要。它是敏感密钥。

NODE_TLS_REJECT_UNAUTHORIZED：HTTPS 证书校验开关

是什么：1 表示校验证书；0 表示忽略证书错误。

默认值：1

什么时候改：只有临时排查自签名证书或反代证书问题时才设为 0，不建议长期公开部署这样用。

怎么填 / 注意：可选值：1、0。

下面这些属于敏感信息，公开截图或发给别人前要检查：

• ADMIN_TOKEN
• TOKEN
• DEPLOY_PLATFROM_TOKEN
• UPSTASH_REDIS_REST_TOKEN
• LOCAL_REDIS_URL
• BILIBILI_COOKIE
• DOUBAN_COOKIE
• TMDB_API_KEY
• AI_API_KEY

正文依据：huangxd-/danmu_api 当前官方 README、config/.env.example、danmu_api/configs/envs.js、danmu_api/ui/js/systemsettings.js。截图来自实际 lixu.indevs.in 演示服务，敏感变量使用演示值，不包含真实密钥。