Tunarr容器化部署指南：打造跨平台流媒体解决方案

Tunarr作为dizqueTV的继任者，是一款功能强大的媒体服务搭建工具，允许部署者创建自定义电视频道并流式传输媒体内容。本指南将通过容器化部署方式，帮助部署者快速构建稳定、高效的个性化电视服务，实现跨平台流媒体内容的管理与分发。

环境准备指南

在开始Tunarr部署前，需确保系统已配置Docker容器运行环境。Docker提供的容器化技术可确保应用在不同平台上的一致性运行，是部署Tunarr的理想选择。

Docker环境验证步骤

执行以下命令验证Docker和Docker Compose是否已正确安装：

# 检查Docker引擎版本
docker --version

# 检查Docker Compose版本
docker-compose --version

[!TIP] 若命令返回版本信息（如Docker version 20.10.21），则说明环境已准备就绪。如未安装，请参考Docker官方文档完成环境配置。

硬件资源建议

• CPU：双核或更高配置，推荐四核以确保转码性能
• 内存：至少4GB RAM，8GB及以上可获得更流畅体验
• 存储：至少10GB可用空间，SSD存储可显著提升媒体文件加载速度

核心部署步骤

Tunarr提供两种容器化部署方式，部署者可根据实际需求选择适合的方案。Docker Compose方式更适合生产环境，便于配置管理和服务扩展。

Docker Run快速部署

执行以下命令可快速启动Tunarr服务：

docker run \
    -e "TZ=Asia/Shanghai" \
    -p 8000:8000 \
    -v "$(pwd)"/tunarr_data:/config/tunarr \
    -v "$(pwd)"/dizque_data:/.dizquetv \
    --name tunarr_service \
    chrisbenincasa/tunarr:latest

参数说明：

• -e "TZ=Asia/Shanghai": 设置容器时区为上海
• -p 8000:8000: 映射主机8000端口到容器8000端口
• --name tunarr_service: 指定容器名称为tunarr_service

验证方法

执行以下命令检查容器运行状态：

docker ps --filter "name=tunarr_service"

若输出中STATUS列显示为Up状态，则表示容器启动成功。

Docker Compose配置指南

对于生产环境部署，推荐使用Docker Compose进行服务编排。

创建配置文件

在部署目录创建docker-compose.yml文件：

version: '3.8'
services:
  tunarr:
    image: chrisbenincasa/tunarr:latest
    container_name: tunarr
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      - LOG_LEVEL=INFO
      - TZ=Asia/Shanghai
    volumes:
      - ./tunarr_data:/config/tunarr

启动服务

执行以下命令启动Tunarr服务：

docker-compose up -d

验证方法

执行以下命令检查服务状态：

docker-compose ps

若状态显示为Up，则服务启动成功。

Docker Desktop图形化配置

对于使用Docker Desktop的部署者，可通过图形界面完成配置：

配置步骤：

1. 在Docker Desktop中搜索chrisbenincasa/tunarr镜像
2. 点击"Run"按钮打开配置窗口
3. 在"Optional settings"中设置：
   • Container name: tunarr
   • Host port: 8000
   • Volumes: 点击"+"添加本地目录映射到/config/tunarr
4. 点击"Run"按钮启动容器

功能配置流程

完成部署后，需通过Web界面进行初始配置，包括媒体源连接和转码工具安装。

访问Web管理界面

在浏览器中输入http://localhost:8000访问Tunarr管理界面，完成初始设置向导：

配置步骤：

1. 完成"Connect Sources"步骤，添加媒体源
2. 完成"Install FFMPEG"步骤，配置转码工具
3. 点击"FINISH"按钮进入主界面

媒体源配置

1. 在左侧导航栏选择"Media Sources"
2. 点击"Add Media Source"按钮
3. 根据媒体源类型（本地文件、Plex、Jellyfin等）填写相关信息
4. 测试连接并保存配置

[!TIP] 配置网络媒体源时，请确保Tunarr容器能够访问目标服务地址，必要时可使用--network=host参数让容器使用主机网络。

验证方法

添加媒体源后，在"Media Sources"页面查看状态是否为"Connected"，表示媒体源配置成功。

电视频道创建

1. 在主界面点击"NEW"按钮创建新频道
2. 设置频道名称、编号和图标
3. 配置节目来源和播放计划
4. 保存并启用频道

进阶优化技巧

为提升Tunarr服务性能，可根据硬件条件配置硬件加速和资源优化。

硬件加速配置

Tunarr支持多种硬件加速方案，可显著提升视频转码性能：

加速方案	配置方法	性能提升	适用场景
NVIDIA GPU	添加runtime: nvidia和环境变量NVIDIA_VISIBLE_DEVICES=all	高（3-5倍）	拥有NVIDIA显卡的服务器
Intel QSV	添加设备映射/dev/dri:/dev/dri	中（2-3倍）	搭载Intel核显的设备
VA-API	添加设备映射/dev/dri:/dev/dri	中（2-3倍）	支持VA-API的Linux系统

NVIDIA加速配置示例

services:
  tunarr:
    image: chrisbenincasa/tunarr:latest
    runtime: nvidia
    environment:
      - NVIDIA_VISIBLE_DEVICES=all
    # 其他配置...

Intel QSV/VA-API配置示例

services:
  tunarr:
    image: chrisbenincasa/tunarr:latest
    devices:
      - /dev/dri:/dev/dri
    # 其他配置...

⚠️ 注意：硬件加速配置前请确保主机已安装相应驱动，NVIDIA用户需安装Nvidia Container Toolkit。

存储优化策略

1. 使用数据卷而非绑定挂载：

   volumes:
     - tunarr_data:/config/tunarr
   volumes:
     tunarr_data:
   

2. 媒体文件独立存储：

   volumes:
     - ./media:/media
   

   将媒体文件存储在独立卷中，便于容量扩展和数据管理。

运维管理指南

日常维护命令

操作	命令
查看服务状态	docker-compose ps
查看日志	docker-compose logs -f --tail=100
停止服务	docker-compose down
重启服务	docker-compose restart

故障排查流程

1. 检查容器状态：

   docker inspect -f '{{.State.Status}}' tunarr
   

2. 查看详细日志：

   docker logs --since 30m tunarr
   

3. 检查端口占用：

   netstat -tulpn | grep 8000
   

版本升级方法

1. 拉取最新镜像：

   docker-compose pull
   

2. 重启服务：

   docker-compose up -d
   

⚠️ 注意：升级前建议备份配置数据，执行cp -r ./tunarr_data ./tunarr_data_backup创建备份。

节目管理与播放

节目指南配置

Tunarr提供直观的节目指南界面，部署者可查看和管理所有频道的播放计划：

功能特点：

• 时间轴式节目展示
• 频道分类筛选
• 节目详情查看
• 播放计划调整

播放测试

1. 在节目指南中选择任意节目
2. 点击节目卡片查看详情
3. 点击"Play"按钮开始播放
4. 验证播放流畅度和画质

[!TIP] 若播放卡顿，可尝试降低转码质量或检查网络带宽。

常见问题速查表

问题	可能原因	解决方案
无法访问Web界面	端口映射错误	检查端口映射配置，执行docker-compose port tunarr 8000
媒体文件无法加载	路径权限问题	确保挂载目录权限正确，设置chmod 755 ./tunarr_data
转码性能低下	未启用硬件加速	配置相应的硬件加速方案
容器启动失败	配置文件错误	检查日志中的错误信息，执行docker-compose logs tunarr
节目指南无内容	媒体源未同步	手动触发同步，在管理界面执行"Refresh Libraries"

通过以上步骤，部署者已完成Tunarr的容器化部署和基本配置。Tunarr提供了丰富的自定义选项，部署者可根据需求进一步探索高级功能，如自定义频道图标、节目编排规则和用户权限管理等，打造完全个性化的媒体服务体验。