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

📝 序言#

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

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

1 目录与环境准备#

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

1.1 创建目录结构#

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

Bash

1
# 创建主目录及子目录
2
mkdir -p /mnt/docker/apps/danmu-api/config
3
mkdir -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

5
name: danmu-api
6
services:
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

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

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

3.2 运行状态检查#

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

1
docker 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)#

现象	可能原因	解决方案
后台设置无法打开	缺少 Fake 变量	由于去掉了 `DEPLOY_PLATFROM` 变量，后台部分面板可能无法加载，但不影响 API 播放。
弹幕无法保存	权限问题	检查 `/mnt/docker/apps/danmu-api/cache` 是否有写入权限。