jbrns/nexroll

NeXroll — Docker镜像概述

镜像概述

• 官方镜像：jbrns/nexroll（建议使用固定标签如jbrns/nexroll:1.4.6）
• 用途：单容器Web UI + API解决方案，用于管理Plex和Jellyfin媒体服务器的预卷内容
• 核心组件：FastAPI后端、预构建React前端、内置FFmpeg工具、健康检查端点

核心功能

1. 预卷内容管理：通过Web UI或API添加、编辑、删除预卷视频
2. 媒体服务器集成：支持连接Plex和Jellyfin，配置预卷播放规则
3. 数据持久化：存储SQLite数据库、预卷文件、缩略图及安全令牌
4. API支持：提供Swagger文档（/docs）和健康检查端点（/health）
5. 跨平台部署：支持Linux主机网络和Windows/macOS端口映射模式

使用场景

• 为Plex/Jellyfin媒体服务器添加自定义预卷视频的用户
• 需要通过可视化界面批量管理预卷内容的管理员
• 跨平台部署预卷管理工具的场景（Linux、Windows、macOS）

配置说明

持久化数据

• 挂载主机目录到容器的/data路径，存储数据库、预卷文件等
• 示例：-v ./nexroll-data:/data（Docker Compose中使用volumes配置）

环境变量

• NEXROLL_PORT：服务端口（默认9393）
• NEXROLL_DB_DIR：数据库目录（默认/data）
• NEXROLL_PREROLL_PATH：预卷存储路径（默认/data/prerolls）
• NEXROLL_SECRETS_DIR：安全令牌目录（默认/data）
• TZ：时区（默认UTC）
• 可选初始化变量：PLEX_URL、PLEX_TOKEN、JELLYFIN_URL、JELLYFIN_API_KEY

部署示例

Linux（推荐主机网络模式）

yaml
version: "3.8"
services:
  nexroll:
    image: jbrns/nexroll:1.4.6
    network_mode: "host"
    environment:
      - NEXROLL_PORT=9393
      - NEXROLL_DB_DIR=/data
      - NEXROLL_PREROLL_PATH=/data/prerolls
      - NEXROLL_SECRETS_DIR=/data
      - TZ=UTC
    volumes:
      - ./nexroll-data:/data
    restart: unless-stopped

执行命令：

bash
mkdir -p ./nexroll-data
docker compose up -d
# 访问http://你的主机IP:9393

跨平台（端口映射模式）

适用于Docker Desktop（Windows/macOS）：

yaml
version: "3.8"
services:
  nexroll:
    image: jbrns/nexroll:1.4.6
    ports:
      - "9393:9393"
    environment:
      - NEXROLL_PORT=9393
      - NEXROLL_DB_DIR=/data
      - NEXROLL_PREROLL_PATH=/data/prerolls
      - NEXROLL_SECRETS_DIR=/data
      - TZ=UTC
    volumes:
      - ./nexroll-data:/data
    restart: unless-stopped

Docker Desktop中访问主机Plex：http://host.docker.internal:32400（需开放防火墙）

升级方法

bash
docker compose pull
docker compose up -d

参考文档

• 构建文件：Dockerfile
• Compose示例：docker-compose.yml
• 完整部署指南：DOCKER.md