一个人人都能部署的基于 js 的弹幕 API 服务器，支持爱优腾芒哔人韩巴弹幕直接获取，兼容弹弹play的搜索、详情查询和弹幕获取接口规范，并提供日志记录，支持vercel/netlify/edgeone/cloudflare/docker/claw等部署方式，不用提前下载弹幕，没有nas或小鸡也能一键部署。

本项目仅为个人爱好开发，代码开源。如有任何侵权行为，请联系本人删除。

有问题提issue或 私信机器人 都ok。

新加了 tg频道 ，方便发送更新通知，以及群组，太多人私信咨询了，索性增加一个 互助群 ，大家有问题可以在群里求助。

请不要在国内媒体平台宣传本项目！

• API 接口：
  • GET /api/v2/search/anime?keyword=${queryTitle}：根据关键字搜索动漫。
  • POST /api/v2/match：根据关键字匹配动漫，用于自动匹配。（已支持在match接口中通过@语法动态指定平台优先级，如赴山海 S01E28 @qiyi；已支持从网盘资源命名，如无忧渡.S01E01.2160p.WEB-DL.H265.DDP.5.1中提取 title/season/episode）
  • GET /api/v2/search/episodes：根据关键词搜索所有匹配的剧集信息。
  • GET /api/v2/bangumi/:animeId：获取指定动漫的详细信息。
  • GET /api/v2/comment/:commentId?withRelated=true&chConvert=1：获取指定弹幕评论，支持返回相关评论和字符转换。
  • POST /api/v2/comment/by-url：通过视频URL直接获取弹幕。
  • GET /api/logs：获取最近的日志（最多 500 行，格式为 [时间戳] 级别: 消息）。
• 弹幕格式输出：支持 JSON 和 XML 两种格式输出，通过以下方式配置：
  • 环境变量：DANMU_OUTPUT_FORMAT=json|xml（默认：json）
  • 查询参数：?format=xml 或 ?format=json（优先级最高）
  • 优先级：查询参数 > 环境变量 > 默认值
  • 示例：GET /api/v2/comment/10001?format=xml 返回 XML 格式弹幕
  • XML 格式说明：完全遵循 Bilibili 标准格式，8字段标准弹幕属性
• 日志记录：捕获 console.log（info 级别）和 console.error（error 级别），JSON 内容格式化输出。
• 智能缓存管理：支持内存缓存搜索结果和弹幕数据，避免短期内重复的不必要API请求。包括：
  • 搜索结果缓存（可通过 SEARCH_CACHE_MINUTES 配置，默认1分钟）
  • 弹幕缓存（可通过 COMMENT_CACHE_MINUTES 配置，默认5分钟）
  • 用户偏好记录（可通过 MAX_LAST_SELECT_MAP 配置，默认100条）
  • Redis 分布式缓存支持（可选）
• 部署支持：支持本地运行、Docker 容器化、Vercel 一键部署、Netlify 一键部署、Edgeone 一键部署、Cloudflare 一键部署、Claw部署和 Docker 一键启动。
• 手动选择记忆：支持记住之前搜索title时手动选择的anime，并在后续的match自动匹配时优选该anime【实验性】。
• 手动搜索支持输入播放链接获取弹幕：支持手动搜索的播放器输入爱优腾芒哔播放链接可获取弹幕，如senplayer。
• 弹幕转换功能：支持通过环境变量配置弹幕转换规则，包括：
  • 将顶部和底部弹幕转换为浮动弹幕（CONVERT_TOP_BOTTOM_TO_SCROLL）
  • 将彩色弹幕转换为纯白弹幕（CONVERT_COLOR_TO_WHITE）
  • 解决部分播放器不支持顶部/底部弹幕和彩色弹幕的问题

• Node.js（v18.0.0 或更高版本；理论兼容更低版本，请自行测试）
• npm
• Docker（可选，用于容器化部署）

1. 克隆仓库：

   git clone <仓库地址>
   cd <项目目录>

2. 安装依赖：

   npm install

3. 启动服务器：

   npm start

   服务器将在 http://{ip}:9321 运行，默认token是87654321。

   热更新支持：修改 .env 文件后，应用会自动检测并重新加载配置（无需重启应用）。

   或者使用下面的命令

   # 启动
   node ./danmu_api/server.js
   # 测试
   node --test ./danmu_api/worker.test.js

4. 测试 API： 使用 Postman 或 curl 测试：

   • GET http://{ip}:9321/87654321
   • GET http://{ip}:9321/87654321/api/v2/search/anime?keyword=生万物
   • POST http://{ip}:9321/87654321/api/v2/match
   • GET http://{ip}:9321/87654321/api/v2/search/episodes?anime=生万物
   • GET http://{ip}:9321/87654321/api/v2/bangumi/1
   • GET http://{ip}:9321/87654321/api/v2/comment/1?withRelated=true&chConvert=1
   • POST http://{ip}:9321/87654321/api/v2/comment/by-url
   • GET http://{ip}:9321/87654321/api/logs

1. 构建 Docker 镜像：

   docker build -t danmu-api .

2. 运行容器：

   docker run -d -p 9321:9321 --name danmu-api -e TOKEN=87654321 danmu-api

   • 使用-e TOKEN=87654321设置TOKEN环境变量，覆盖Dockerfile中的默认值。
   • 或使用 --env-file .env 加载 .env 文件中的所有环境变量：docker run -d -p 9321:9321 --name danmu-api --env-file .env danmu-api

   热更新支持：如需支持环境变量热更新（修改 .env 文件后无需重启容器），请使用 Volume 挂载：

   docker run -d -p 9321:9321 --name danmu-api -v $(pwd)/.env:/app/.env --env-file .env danmu-api

   推荐：使用 docker compose 部署可以更方便地管理配置和支持热更新，详见下方"Docker 一键启动"部分。

3. 测试 API： 使用 http://{ip}:9321/{TOKEN} 访问上述 API 接口。

1. 拉取镜像：

   docker pull logvar/danmu-api:latest

2. 运行容器：

   docker run -d -p 9321:9321 --name danmu-api -e TOKEN=87654321 logvar/danmu-api:latest

   • 使用-e TOKEN=87654321设置TOKEN环境变量。
   • 或使用 --env-file .env 加载 .env 文件中的所有环境变量：docker run -d -p 9321:9321 --name danmu-api --env-file .env logvar/danmu-api:latest

   热更新支持：如需支持环境变量热更新（修改 .env 文件后无需重启容器），请使用 Volume 挂载：

   docker run -d -p 9321:9321 --name danmu-api -v $(pwd)/.env:/app/.env --env-file .env logvar/danmu-api:latest

   或使用 docker compose 部署（推荐，支持环境变量热更新）：

   services:
     danmu-api:
       image: logvar/danmu-api:latest
       ports:
         - "9321:9321"
       # 热更新支持：挂载 .env 文件，修改后容器会自动重新加载配置（无需重启容器）
       volumes:
         - ./.env:/app/.env
       restart: unless-stopped

   可以使用 watchtower 监控有新版本自动更新：

   services:
     watchtower:
       image: containrrr/watchtower
       container_name: watchtower-gx
       restart: always
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock
       environment:
         - TZ=Asia/Shanghai  # 保持时区正确
       command:
         - --cleanup         # 更新后清理旧镜像
         - --interval        # 间隔参数
         - "12600"           # 30分钟（1800秒），适合测试
         - danmu-api         # 监控的目标容器名

3. 测试 API： 使用 http://{ip}:9321/{TOKEN} 访问上述 API 接口。

点击以下按钮即可将项目快速部署到 Vercel：

注意：请将按钮链接中的 https://github.com/huangxd-/danmu_api 替换为你的实际 Git 仓库地址。编辑 README.md 并更新链接后，推送到仓库，点击按钮即可自动克隆和部署。

• 设置环境变量：部署后，在 Vercel 仪表板中：
  1. 转到你的项目设置。
  2. 在“Environment Variables”部分添加 TOKEN 变量，输入你的 API 令牌值。
  3. 保存更改并重新部署。
• 示例请求：https://{your_domain}.vercel.app/87654321/api/v2/search/anime?keyword=子夜归

• Settings > Functions > Advanced Setting > Function Region 切换为 Hong Kong，能提高访问速度，体验更优

  hk有可能访问不了360或其他源，可以尝试切其他region，如新加坡等

• vercel在国内被墙，请配合代理使用或绑定自定义域名

点击以下按钮即可将项目快速部署到 Netlify：

默认访问domain：https://{你的部署项目名}.netlify.app

• 设置环境变量：部署后，在 Netlify 仪表板中：
  1. 点击Project configuration。
  2. 在“Environment variables”部分点击 “Add a variable” 添加 TOKEN 变量，输入你的 API 令牌值。
  3. 保存更改并重新部署。

注意：部署时请在环境变量配置区域填写你的TOKEN值，该变量将用于API服务的身份验证相关功能

示例请求：https://{your_domain}/{TOKEN}/api/v2/search/anime?keyword=子夜归确认是否部署成功

部署的时候项目加速区域最好设置为"全球可用区（不含中国大陆）"，不然不绑定自定义域名貌似只能生成3小时的预览链接？相关文档

也可直接用国际站的部署按钮一键部署，默认选择"全球可用区（不含中国大陆）"

如果每次访问都遇到404等问题，可能是edgeone pages修改了访问策略，每次接口请求都转发到了新的环境，没有缓存，导致获取不到对应的弹幕，推荐用vercel部署。

解决方法：请配置环境变量UPSTASH_REDIS_REST_URL和UPSTASH_REDIS_REST_TOKEN，开启upstash redis存储

点击以下按钮即可将项目快速部署到 Cloudflare：

注意：请将按钮链接中的 https://github.com/huangxd-/danmu_api 替换为你的实际 Git 仓库地址。编辑 README.md 并更新链接后，推送到仓库，点击按钮即可自动克隆和部署。

• 设置环境变量：部署后，在 Cloudflare 仪表板中：
  1. 转到你的 Workers 项目。
  2. 转到“Settings” > “Variables”。
  3. 添加 TOKEN 环境变量，输入你的 API 令牌值。
  4. 保存并部署。
• 示例请求：https://{your_domain}.workers.dev/87654321/api/v2/search/anime?keyword=子夜归

创建一个worker，将danmu_api/worker.js里的代码直接拷贝到你创建的worker.js里，然后点击部署。

cf部署可能不稳定，推荐用vercel/netlify部署。

支持 forward/senplayer/hills/小幻/yamby/eplayerx/afusekt 等支持弹幕API的播放器。

以senplayer为例：

1. 获取到部署之后的API地址，如 http://192.168.1.7:9321/87654321 ，其中87654321是默认token，如果有自定义环境变量TOKEN，请替换成相应的token
2. 将API地址填入自定义弹幕API，在设置 - 弹幕设置 - 自定义弹幕API
3. 播放界面点击弹幕按钮 - 搜索弹幕，选择你的弹幕API，会根据标题进行搜索，等待一段时间，选择剧集就行。

API 支持返回 Bilibili 标准 XML 格式的弹幕数据，通过查询参数 ?format=xml 指定。

XML 格式示例：

<?xml version="1.0" ?>
<i>
    <d p="5.0,5,25,16488046,1751533608,0,0,13190629936">有 162 条弹幕来袭~请做好准备🔥！</d>
    <d p="4.0,5,25,13818234,1751533608,0,0,84261947057">阿姐我来啦！[打call了]</d>
    <d p="5.0,1,25,16488046,1751533608,0,0,33648506749">2025-07-02打卡</d>
</i>

属性 p 字段说明（8个字段，逗号分隔）：

1. 时间：弹幕出现时间（秒）
2. 类型：1=滚动, 4=底部, 5=顶部
3. 字体：字体大小（25=中, 18=小）
4. 颜色：RGB 转十进制（16777215=白色）
5. 时间戳：Unix 时间戳（秒）
6. 弹幕池：弹幕池编号（通常为0）
7. 用户Hash：用户唯一标识（数字格式）
8. 弹幕ID：弹幕唯一编号（11位数字）

使用示例：

• 获取 JSON 格式：GET /api/v2/comment/10001
• 获取 XML 格式：GET /api/v2/comment/10001?format=xml
• 通过 URL 获取 XML：POST /api/v2/comment/by-url?format=xml （body: {"videoUrl":"..."}）

注意：

小幻在填写API的时候需要在API后面加上/api/v2，如http://192.168.1.7:9321/87654321/api/v2

（已对小幻做兼容，/api/v2可加可不加都可以正确处理）

小幻在使用时可能出现掉匹配无法加载弹幕的问题，详见这个issue，可以通过配置环境变量UPSTASH_REDIS_REST_URL和UPSTASH_REDIS_REST_TOKEN，开启upstash redis存储解决

有很多人问FW能不能用，FW推荐直接使用插件，如果非要使用，则可以配合 https://raw.githubusercontent.com/huangxd-/ForwardWidgets/refs/heads/main/widgets.fwd 里的danmu_api插件使用

# EPISODE_TITLE_FILTER 默认值
(特别|惊喜|纳凉)?企划|合伙人手记|超前(营业|vlog)?|速览|vlog|reaction|纯享|加更(版|篇)?|抢先(看|版|集|篇)?|抢鲜|预告|花絮(独家)?|特辑|彩蛋|专访|幕后(故事|花絮|独家)?|直播(陪看|回顾)?|未播(片段)?|衍生|番外|会员(专享|加长|尊享|专属|版)?|片花|精华|看点|速看|解读|影评|解说|吐槽|盘点|拍摄花絮|制作花絮|幕后花絮|未播花絮|独家花絮|花絮特辑|先导预告|终极预告|正式预告|官方预告|彩蛋片段|删减片段|未播片段|番外彩蛋|精彩片段|精彩看点|精彩回顾|精彩集锦|看点解析|看点预告|NG镜头|NG花絮|番外篇|番外特辑|制作特辑|拍摄特辑|幕后特辑|导演特辑|演员特辑|片尾曲|插曲|高光回顾|背景音乐|OST|音乐MV|歌曲MV|前季回顾|剧情回顾|往期回顾|内容总结|剧情盘点|精选合集|剪辑合集|混剪视频|独家专访|演员访谈|导演访谈|主创访谈|媒体采访|发布会采访|采访|陪看(记)?|试看版|短剧|精编|Plus|独家版|特别版|短片|发布会|解忧局|走心局|火锅局|巅峰时刻|坞里都知道|福持目标坞民|.{3,}篇|(?!.*(入局|破冰局|做局)).{2,}局|观察室|上班那点事儿|周top|赛段|直拍|REACTION|VLOG|全纪录|开播|先导|总宣|展演|集锦|旅行日记|精彩分享|剧情揭秘

# 如果你想新增过滤词，请自定义EPISODE_TITLE_FILTER，示例如下，每个词用'|'隔开，增加的词都会追加到默认值后面
测试|test

# 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|啊这|哇哦)/

# 注释如下：
/.{20,}/  # 屏蔽20字符及以上的弹幕
/^\d{2,4}[-/.]\d{1,2}[-/.]\d{1,2}([日号.])?$/  # 屏蔽日期弹幕
/^(?!哈+$)([a-zA-Z\u4e00-\u9fa5])\1{2,}/  # 屏蔽单个汉字或者字母连续出现3次及以上的弹幕（排除纯“哈”重复）
/[0-9]+.[0-9]\s(w|万)+\s*(\+|个|人|在看)+/  # 屏蔽几点几万在看的弹幕
/^[a-z]{6,}$/  # 屏蔽6个及以上连续小写字母的弹幕
/^(?:qwertyuiop|asdfghjkl|zxcvbnm)$/  # 屏蔽键盘连续行的弹幕
/^\d{5,}$/  # 屏蔽5位及以上纯数字的弹幕
/^(\d)\1{2,}$/  # 屏蔽三个及以上相同数字重复的弹幕
/\d{1,4}/  # 屏蔽1-4位数字的弹幕
/(20[0-3][0-9])/  # 屏蔽2000-2039年份相关的弹幕
/(0?[1-9]|1[0-2])月/  # 屏蔽月份表述的弹幕
/\d{1,2}[.-]\d{1,2}/  # 屏蔽类似时间或日期分隔的数字弹幕
/[@#&$%^*+\|/\-_=<>°◆◇■□●○★☆▼▲♥♦♠♣①②③④⑤⑥⑦⑧⑨⑩]/  # 屏蔽特殊符号或表情符号的弹幕
/[一二三四五六七八九十百\d]+刷/  # 屏蔽数字或汉字数字后跟“刷”的弹幕
/第[一二三四五六七八九十百\d]+/  # 屏蔽“第几”序号相关的弹幕
/(全体成员|报到|报道|来啦|签到|刷|打卡|我在|来了|考古|爱了|挖坟|留念|你好|回来|哦哦|重温|复习|重刷|再看|在看|前排|沙发|有人看|板凳|末排|我老婆|我老公|撅了|后排|周目|重看|包养|DVD|同上|同样|我也是|俺也|算我|爱豆|我家爱豆|我家哥哥|加我|三连|币|新人|入坑|补剧|冲了|硬了|看完|舔屏|万人|牛逼|煞笔|傻逼|卧槽|tm|啊这|哇哦)/  # 屏蔽常见互动、报到或口语化弹幕词汇

danmu_api/
├── .github/
│   └── workflows/
│       ├── docker-image.yml
│       └── sync_fork.yml # vercel自动同步配置文件
├── danmu_api/
│   ├── esm-shim.js     # Node.js低版本兼容层
│   ├── server.js       # 本地node启动脚本
│   ├── worker.js       # 主 API 服务器代码
│   ├── worker.test.js  # 测试文件
├── netlify/
│   └── functions/
│       └── api.js      # netlify 中间处理逻辑
├── node-functions/
│   ├── [[...path]]..js # edgeone pages 所有路由跳转指向index
│   └── index.js        # edgeone pages 中间处理逻辑
├── .env.example
├── .gitignore
├── Dockerfile
├── edgeone.json        # edgeone pages 配置文件
├── LICENSE
├── netlify.toml        # netlify 配置文件
├── package.json
├── README.md
├── vercel.json         # vercel 配置文件
└── wrangler.toml       # cloudflare worker 配置文件

• 本地运行：修改 .env 文件后，应用会自动检测并重新加载配置（无需重启应用）。
• Docker 部署：需要使用 Volume 挂载 .env 文件才能支持热更新。推荐使用 docker compose 部署（见"Docker 一键启动"部分），配置 Volume 后修改 .env 文件容器会自动重新加载配置。
• Vercel/Netlify/Cloudflare：需要在平台的环境变量设置中修改，然后重新部署才能生效。

• 日志存储在内存中，服务器重启后会清空。
• /api/logs 中的 JSON 日志会格式化显示，带缩进以提高可读性。
• 搜索结果和弹幕数据存储在内存中，服务器重启后会清空，可通过配置 UPSTASH_REDIS_REST_URL 和 UPSTASH_REDIS_REST_TOKEN 启用 Redis 持久化存储。
• 搜索结果缓存默认时间为 1 分钟，可通过环境变量 SEARCH_CACHE_MINUTES 调整（设置为 0 表示不缓存）。
• 确保 package.json 中包含 node-fetch 依赖。
• 一键部署需要将项目推送到公开的 Git 仓库（如 GitHub），并更新按钮中的仓库地址。
• 运行 Docker 容器时，需通过 -e TOKEN=87654321 传递 TOKEN 环境变量。
• cloudflare貌似被哔风控了。
• 如果想更换兜底第三方弹幕服务器，请添加环境变量OTHER_SERVER，示例https://api.danmu.icu。
• 如果想更换vod站点，请添加环境变量VOD_SERVERS，示例金蝉@https://zy.jinchancaiji.com,789@https://www.caiji.cyou,听风@https://gctf.tfdh.top（支持多个服务器并发查询）。
• 当配置多个VOD站点时，可通过VOD_RETURN_MODE环境变量控制返回结果方式：all（返回所有站点结果）或fastest（默认，只返回最快的站点结果，避免结果过多）。
• 推荐vercel/netlify部署，cloudflare/edgeone/claw不稳定，当然最稳定还是自己本地docker部署最佳。
• /api/v2/comment接口默认限流：1分钟内同一IP只能请求3次，可通过环境变量RATE_LIMIT_MAX_REQUESTS调整（设置为0表示不限流）。

喂饭教程1：danmu_api vercel 自动同步部署方案 - 永远保持最新版本！实时同步原作者更新

喂饭教程2：logvar弹幕搭建教程（docker/claw）

以API示例 http://192.168.1.7:9321/87654321 为例

1. 首先确认你的api部署成功 访问 http://192.168.1.7:9321/87654321 有json输出
2. 检查你在播放器的填写是否正确，有无多余空格等
3. 播放器请求后，查看 http://192.168.1.7:9321/87654321/api/logs 日志，看请求是否有报错，比如有用户在自己软路由上搭建，但走了全局代理，导致人人等访问不了，请确保走直连
4. 如果你播放的影片片名不规范，很可能搜不到，请确保片名规范