Tunarr容器化部署指南：从零搭建个性化媒体服务

一、Tunarr核心价值解析

Tunarr作为dizqueTV的继任者，是一款开源的媒体服务搭建工具，让你能够创建自定义电视频道并流式传输本地或网络媒体内容。通过容器化部署，你可以快速搭建一个功能完备的个性化电视服务，实现媒体内容的集中管理与个性化播放。

核心优势

• 灵活的频道管理：支持创建多个自定义频道，每个频道可独立配置节目内容和播放计划
• 多源媒体整合：无缝对接Plex、Jellyfin等主流媒体服务器，集中管理分散的媒体资源
• 智能节目编排：提供多种节目调度模式，支持按类别、时长等条件自动填充节目内容
• 跨平台兼容性：通过Docker容器化部署，可在Windows、macOS和Linux系统上稳定运行

二、环境准备与兼容性检查

部署前检查清单

在开始部署前，请确保你的系统满足以下要求：

检查项目	最低要求	推荐配置
操作系统	Windows 10/11、macOS 10.15+或Linux	Ubuntu 20.04 LTS
Docker版本	Docker 20.10+	Docker 24.0+
Docker Compose	v2.0+	v2.17+
内存	2GB RAM	4GB RAM
存储空间	至少1GB空闲空间	10GB以上空闲空间
网络	稳定的互联网连接	千兆网络环境

环境兼容性检查

打开终端或命令提示符，执行以下命令检查Docker环境：

# 检查Docker版本
docker --version

# 检查Docker Compose版本
docker compose version

# 验证Docker是否正常运行
docker run --rm hello-world

如果所有命令都能正常执行并返回预期结果，说明你的Docker环境已经准备就绪。

三、多方案容器化部署指南

方案一：快速启动（适合测试体验）

如果你想快速体验Tunarr的功能，可以使用以下docker run命令一键启动服务：

docker run \
    -v "$(pwd)"/tunarr:/config/tunarr \  # 映射配置文件目录到当前目录的tunarr文件夹
    -v "$(pwd)"/.dizquetv:/.dizquetv \  # 兼容旧版dizqueTV数据
    -e "TZ=Asia/Shanghai" \             # 设置时区为上海
    -p 8000:8000 \                      # 映射Web访问端口
    chrisbenincasa/tunarr                # 使用最新版Tunarr镜像

方案二：Docker Compose部署（推荐生产环境）

对于长期使用，推荐使用Docker Compose进行部署，便于管理和维护：

1. 创建项目目录并进入：

mkdir -p /path/to/tunarr && cd /path/to/tunarr

2. 创建docker-compose.yml文件：

version: '3.8'
services:
  tunarr:
    image: chrisbenincasa/tunarr:latest  # 使用最新稳定版镜像
    container_name: tunarr              # 容器名称
    ports:
      - "8000:8000"                     # 端口映射
    environment:
      - LOG_LEVEL=INFO                  # 日志级别
      - TZ=Asia/Shanghai                # 时区设置
    volumes:
      - ./data:/config/tunarr           # 配置文件持久化
    restart: unless-stopped             # 自动重启策略

3. 启动服务：

docker compose up -d

方案三：Docker Desktop图形界面部署

如果你使用Docker Desktop，可以通过图形界面进行配置：

1. 在Docker Desktop中搜索chrisbenincasa/tunarr镜像并下载
2. 点击"Run"按钮，在弹出的配置窗口中：
   • 设置容器名称为tunarr
   • 配置端口映射：主机端口8000映射到容器端口8000
   • 添加卷映射：将本地目录映射到容器的**/config/tunarr**
   • 设置环境变量TZ=Asia/Shanghai
3. 点击"Run"按钮启动容器

四、初始配置与功能探索

访问Tunarr Web界面

容器启动后，打开浏览器访问http://localhost:8000，你将看到Tunarr的欢迎界面：

按照设置向导完成以下步骤：

1. 连接媒体源：配置Plex、Jellyfin等媒体服务器
2. 安装FFmpeg：根据系统提示安装媒体转码工具
3. 完成设置：点击"Finish"进入主界面

媒体源配置

1. 在左侧导航栏中选择"Settings"
2. 切换到"SOURCES"选项卡
3. 点击"+ ADD"按钮添加媒体源
4. 选择媒体源类型并填写相关信息

功能验证步骤

部署完成后，请按照以下步骤验证核心功能：

1. 媒体源连接测试：在设置页面检查媒体源状态是否显示为"Healthy"
2. 创建测试频道：点击"Channels"页面的"NEW"按钮创建新频道
3. 添加节目内容：为测试频道添加媒体内容并保存
4. 查看节目指南：访问"Guide"页面确认节目安排正确显示

五、性能优化与问题解决

硬件加速配置

NVIDIA GPU加速

如果你的系统配备NVIDIA显卡，可以启用硬件加速提升转码性能：

version: '3.8'
services:
  tunarr:
    image: chrisbenincasa/tunarr:latest
    container_name: tunarr
    ports:
      - "8000:8000"
    runtime: nvidia  # 使用NVIDIA运行时
    environment:
      - LOG_LEVEL=INFO
      - NVIDIA_VISIBLE_DEVICES=all  # 允许访问所有NVIDIA设备
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/config/tunarr
    restart: unless-stopped

Intel QSV/VA-API加速

对于Intel集成显卡或独立显卡，添加设备映射即可启用硬件加速：

version: '3.8'
services:
  tunarr:
    image: chrisbenincasa/tunarr:latest
    container_name: tunarr
    ports:
      - "8000:8000"
    environment:
      - LOG_LEVEL=INFO
      - TZ=Asia/Shanghai
    devices:
      - /dev/dri:/dev/dri  # 映射DRI设备
    volumes:
      - ./data:/config/tunarr
    restart: unless-stopped

常见问题排查

问题1：容器启动后无法访问Web界面

排查步骤：

1. 检查容器运行状态：docker ps | grep tunarr
2. 查看容器日志：docker logs tunarr
3. 确认端口映射是否正确：netstat -tuln | grep 8000

解决方案：

• 如果容器未运行，检查配置文件是否有误
• 如果端口被占用，修改映射端口（如8001:8000）
• 检查防火墙设置，确保8000端口已开放

问题2：媒体源连接失败

排查步骤：

1. 确认媒体服务器是否正常运行
2. 检查媒体服务器地址和端口是否正确
3. 验证访问令牌或API密钥是否有效

解决方案：

• 在媒体服务器中重新生成API密钥
• 确保Tunarr容器能够访问媒体服务器网络
• 检查媒体服务器防火墙设置，允许Tunarr访问

官方文档参考

更多高级配置和功能说明，请参考官方文档：docs/deployment.md

总结

通过本指南，你已经掌握了Tunarr的容器化部署方法，包括环境准备、多方案部署、初始配置和性能优化。Tunarr提供了强大的自定义电视频道功能，让你能够打造专属的媒体播放体验。无论是家庭娱乐还是小型企业使用，Tunarr都能满足你对媒体内容管理和播放的个性化需求。

现在，你可以开始探索Tunarr的更多高级功能，如节目编排、定时任务和多客户端支持，进一步优化你的媒体服务体验。