从零搭建开源项目Tunarr：全平台适配的Docker部署媒体服务指南

Tunarr作为dizqueTV的继任者，是一款强大的开源媒体服务工具，支持跨平台部署和自定义媒体流。通过容器化技术（Containerization），我们可以在任何支持Docker的系统上快速搭建个性化电视服务，轻松管理和流式传输媒体内容。本指南将从需求定位到运维管理，全面介绍如何使用Docker部署Tunarr，让你从零开始构建专属的媒体中心。

1. 需求定位：Tunarr与容器化部署的优势

1.1 传统部署与容器化方案对比

特性	传统部署	Docker容器化部署
环境依赖	需手动安装依赖，易冲突	容器隔离，环境一致性
跨平台性	需针对不同系统适配	一次构建，到处运行
版本管理	升级复杂，易出问题	镜像版本控制，一键回滚
资源占用	系统级安装，资源占用高	轻量级隔离，资源利用率高
部署效率	步骤繁琐，耗时较长	一条命令完成部署

1.2 适用场景与选型建议

• 快速体验场景：适合初次接触Tunarr的用户，推荐使用docker run命令快速部署，无需复杂配置。
• 生产环境场景：适合长期使用，推荐Docker Compose方案，便于管理配置、更新和维护。
• 多服务协同场景：如果需要与其他服务（如Plex、Jellyfin）协同工作，建议使用Docker Compose编排服务。

2. 环境准备：Docker与Docker Compose安装

2.1 检查系统要求

Tunarr对系统要求不高，推荐配置：

• CPU：双核及以上
• 内存：至少2GB
• 硬盘：至少10GB可用空间
• 网络：稳定的互联网连接

2.2 安装Docker和Docker Compose

操作目标：安装Docker和Docker Compose 执行命令：

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装Docker
sudo apt install -y docker.io

# 安装Docker Compose
sudo apt install -y docker-compose

# 启动Docker服务并设置开机自启
sudo systemctl enable --now docker

# 将当前用户添加到docker组（避免每次使用sudo）
sudo usermod -aG docker $USER

效果验证：重启终端后执行以下命令，显示版本信息即安装成功

docker --version
docker-compose --version

[!TIP] Windows和macOS用户可以直接安装Docker Desktop，它包含了Docker和Docker Compose，图形化界面更易于管理。

3. 核心部署：两种部署模式的实现步骤

3.1 快速部署模式（Docker Run）

操作目标：使用Docker Run快速启动Tunarr 执行命令：

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

效果验证：打开浏览器访问http://localhost:8000，出现Tunarr欢迎界面即部署成功

3.2 生产部署模式（Docker Compose）

操作目标：使用Docker Compose部署Tunarr 执行命令：

# 创建部署目录
mkdir -p ~/tunarr && cd ~/tunarr

# 创建docker-compose.yml文件
cat > docker-compose.yml << EOF
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
EOF

# 启动服务
docker-compose up -d

效果验证：执行docker-compose ps命令，查看服务状态为"Up"即部署成功

4. 功能强化：配置媒体源与硬件加速

4.1 初始配置向导

访问http://localhost:8000后，将进入Tunarr设置向导：

1. 连接媒体源：添加本地媒体文件夹或连接Plex、Jellyfin等媒体服务器
2. 安装FFmpeg：Tunarr需要FFmpeg进行媒体转码，可通过向导自动安装
3. 完成设置：点击"Finish"进入主界面

4.2 硬件加速配置

Tunarr支持多种硬件加速方案，可根据硬件类型选择：

硬件类型	配置方法	优势
NVIDIA GPU	添加runtime: nvidia和环境变量NVIDIA_VISIBLE_DEVICES=all	转码性能最佳，支持4K HDR
Intel QSV	添加设备映射/dev/dri:/dev/dri	低功耗，适合Intel处理器平台
AMD VA-API	添加设备映射/dev/dri:/dev/dri	开源驱动支持，兼容性好

NVIDIA GPU加速配置示例：

services:
  tunarr:
    image: chrisbenincasa/tunarr:latest
    container_name: tunarr
    ports:
      - "8000:8000"
    runtime: nvidia
    environment:
      - LOG_LEVEL=INFO
      - TZ=Asia/Shanghai
      - NVIDIA_VISIBLE_DEVICES=all
    volumes:
      - ./data:/config/tunarr
    restart: unless-stopped

5. 运维管理：日常维护与性能调优

5.1 基本运维命令

查看容器状态：

docker ps | grep tunarr

查看日志：

docker logs -f tunarr

停止服务：

docker-compose down

更新Tunarr：

docker-compose pull
docker-compose up -d

5.2 性能调优技巧

资源配置计算公式：

• 内存：每10个频道分配1GB内存
• CPU：每5个频道分配1个CPU核心
• 存储：根据媒体文件大小计算，建议预留30%空间

优化配置示例：

services:
  tunarr:
    # 其他配置...
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G
        reservations:
          cpus: '1'
          memory: 2G

5.3 常见故障诊断

问题1：无法访问Web界面

• 检查容器是否运行：docker ps | grep tunarr
• 检查端口映射：netstat -tuln | grep 8000
• 检查防火墙设置：sudo ufw allow 8000

问题2：媒体文件无法播放

• 检查媒体文件权限：确保容器内可以访问媒体文件
• 检查FFmpeg是否安装：在容器内执行ffmpeg -version
• 检查转码配置：降低转码分辨率或比特率

问题3：容器启动后立即退出

• 查看日志：docker logs tunarr
• 检查卷挂载权限：确保本地目录有读写权限
• 检查端口是否被占用：更换端口或停止占用端口的服务

6. 开始使用Tunarr：创建个性化电视频道

6.1 频道管理界面

Tunarr提供直观的频道管理界面，可以创建、编辑和删除电视频道，设置频道名称、图标和转码配置。

6.2 节目指南

通过节目指南可以查看和管理所有频道的播放计划，支持按时间和频道筛选节目。

[!TIP] 初次使用建议从简单频道开始，逐步添加媒体源和节目安排，熟悉系统功能后再进行复杂配置。

总结

通过Docker部署Tunarr，我们可以快速搭建一个跨平台的自定义媒体服务。无论是家庭娱乐还是小型企业使用，Tunarr都能满足你对个性化电视内容的需求。本文介绍的从零搭建过程，涵盖了环境准备、核心部署、功能强化和运维管理等方面，希望能帮助你顺利部署和使用Tunarr。现在，开始探索创建属于你自己的电视频道吧！