LogVar 弹幕 API (纯本地缓存版) 部署指南

📝 序言

本教程专为 “极简主义” 用户设计。

根据您的定制需求，我们将完全摒弃外部数据库（Redis/Upstash），仅利用容器自身的本地缓存机制运行 logvar/danmu-api。这种模式配置最简单，没有任何外部依赖，完全依靠挂载的本地目录进行数据交换。

1 目录与环境准备

为了配合您的配置文件路径，我们需要先在 NAS 上建立对应的文件夹。

1.1 创建目录结构

请在终端执行以下命令，或者在文件管理器中手动创建：

Bash

1# 创建主目录及子目录
2mkdir -p /mnt/docker/apps/danmu-api/config
3mkdir -p /mnt/docker/apps/danmu-api/cache

1.2 权限确认

确保该目录允许 Docker 读写。由于您在配置中指定了 PUID=1000，请确保文件夹的所有者 ID 也是 1000（飞牛 NAS 默认主用户通常即为 1000）。

2 核心部署：配置 Docker Compose

2.1 创建文件

在 /mnt/docker/apps/danmu-api/ 目录下，新建 docker-compose.yaml 文件。

2.2 写入配置

以下代码已对格式进行了标准化整理：

 1# 项目名称：弹幕API (本地缓存极简版)
 2# 说明：仅依赖本地挂载目录，无外部数据库
 3# ---
 4
 5name: danmu-api
 6services:
 7  danmu-api:
 8    # 镜像地址
 9    image: logvar/danmu-api:latest
10    # 容器名
11    container_name: danmu-api
12    # 主机名
13    hostname: danmu-api
14    # 环境变量
15    environment:
16      # --- 系统权限设置 ---
17      - PUID=1000
18      - PGID=1000
19      - TZ=Asia/Shanghai
20      - UMASK=022
21      # --- 访问令牌设置 ---
22      # 客户端/播放器连接用的 Token (可修改)
23      - TOKEN=danmu
24      # 网页后台管理员密码 (建议修改)
25      - ADMIN_TOKEN=admin_secret_key_2025
26    # 目录映射：宿主机目录:容器内目录
27    volumes:
28      # 配置目录
29      - /mnt/docker/apps/danmu-api/config:/app/config 
30      # 缓存目录 (数据主要存储区)
31      - /mnt/docker/apps/danmu-api/cache:/app/.cache 
32    # 网络模式
33    network_mode: bridge
34    # 端口映射
35    ports:
36      # 主机端口:容器端口
37      - 9321:9321
38    # 重启策略
39    restart: always

3 启动与验证

3.1 启动服务

在 SSH 终端中执行：

Bash

1cd /mnt/docker/apps/danmu-api
2docker compose up -d

或者在飞牛 Docker 管理器中，通过“添加项目”直接粘贴上面的 YAML 代码并启动。

3.2 运行状态检查

启动后，请务必检查容器是否稳定运行：

1docker logs -f danmu-api

• 如果容器正常运行：您将看到服务启动日志。

4 使用指南

4.1 客户端连接

• API 地址：http://{NAS_IP}:9321/danmu
• API Token：danmu
• ADMIN_TOKEN：admin_secret_key_2025

4.2 数据持久化说明

在您的配置中，数据保存在 /mnt/docker/apps/danmu-api/cache。

• 备份：请定期备份该目录，以防弹幕数据丢失。
• 清理：如果 cache 目录过大，可手动清理其中的临时文件。

5 常见问题 (Troubleshooting)

6 总结与效果展示

至此，您的 LogVar 弹幕 API (纯本地版) 应该已经成功在 NAS 上运行了！

通过这种“极简”部署方式，我们摒弃了复杂的外部数据库依赖，仅凭 NAS 本地的存储空间就实现了弹幕的私有化托管。这不仅最大程度地节省了系统资源，也让数据安全完全掌握在自己手中。

6.1 运行效果图

部署完成后，服务运行平稳。以下是实际部署的实机效果展示：

• 浏览器访问 http://NAS_IP:9321/danmu 的后台界面

• 成功进入弹幕 API 的 Web 管理后台

• 第三方播放器连接成功的画面，客户端成功连接本地服务器，弹幕加载正常

6.2 公益弹幕API

如果不想自己搭建，也可以使用公益的，但是肯定没有自己搭建的好。

1https://danmu.99600000.xyz/danmu

Created with ❤️ by 十三