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

📝 序言

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

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

1 目录与环境准备

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

1.1 创建目录结构

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

Bash

# 创建主目录及子目录
mkdir -p /mnt/docker/apps/danmu-api/config
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 写入配置

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

# 项目名称：弹幕API (本地缓存极简版)
# 说明：仅依赖本地挂载目录，无外部数据库
# ---

name: danmu-api
services:
  danmu-api:
    # 镜像地址
    image: logvar/danmu-api:latest
    # 容器名
    container_name: danmu-api
    # 主机名
    hostname: danmu-api
    # 环境变量
    environment:
      # --- 系统权限设置 ---
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - UMASK=022
      # --- 访问令牌设置 ---
      # 客户端/播放器连接用的 Token (可修改)
      - TOKEN=danmu
      # 网页后台管理员密码 (建议修改)
      - ADMIN_TOKEN=admin_secret_key_2025
    # 目录映射：宿主机目录:容器内目录
    volumes:
      # 配置目录
      - /mnt/docker/apps/danmu-api/config:/app/config 
      # 缓存目录 (数据主要存储区)
      - /mnt/docker/apps/danmu-api/cache:/app/.cache 
    # 网络模式
    network_mode: bridge
    # 端口映射
    ports:
      # 主机端口:容器端口
      - 9321:9321
    # 重启策略
    restart: always

3 启动与验证

3.1 启动服务

在 SSH 终端中执行：

Bash

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

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

3.2 运行状态检查

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

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` 是否有写入权限。