三步打造专属Tunarr电视服务：跨平台Docker部署指南

Tunarr作为dizqueTV的继任者，是一款强大的开源电视服务搭建工具，支持创建自定义电视频道并流式传输媒体内容。通过Docker容器化部署，可实现跨平台兼容，让你在任何设备上轻松构建个性化电视体验，零门槛上手专业级媒体服务。

价值：为什么选择Tunarr+Docker方案

Tunarr通过Docker部署带来三大核心优势：跨平台兼容确保在Linux、Windows和macOS系统上一致运行；资源占用优化技术使服务轻量高效；隔离环境保障系统安全与配置稳定性。无论是家庭娱乐中心还是小型媒体服务器，都能通过简单配置实现效能倍增的媒体流服务。

Tunarr频道管理界面

准备：环境验证清单与资源准备

系统环境检查项

检查内容	命令行验证	可视化操作
Docker引擎	docker --version # 验证Docker版本	Docker Desktop主界面版本信息
Docker Compose	docker-compose --version # 确认编排工具	Docker Desktop设置->Compose版本
网络端口	`netstat -tuln	grep 8000` # 检查端口占用

资源准备清单

1. 硬件要求：至少2GB内存，推荐4GB以上以支持流畅转码
2. 存储空间：至少10GB可用空间（含镜像和配置文件）
3. 网络环境：稳定的互联网连接（用于拉取Docker镜像）
4. 媒体文件：准备本地媒体库或网络媒体源地址

实施：两种部署方案对比与操作指南

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

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

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

1. 创建项目目录并下载配置文件：

mkdir -p /opt/tunarr && cd /opt/tunarr
wget https://gitcode.com/gh_mirrors/tu/tunarr/raw/main/docker/example.compose.yaml -O docker-compose.yml

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完成部署：

Docker Desktop配置界面

1. 在Docker Hub搜索"chrisbenincasa/tunarr"
2. 点击"Run"按钮打开配置窗口
3. 在"Optional settings"中设置：
   • Container name: tunarr
   • Host port: 8000
   • Volumes: 点击"+"添加本地目录映射到/config/tunarr
   • Environment variables: 添加TZ=Asia/Shanghai
4. 点击"Run"完成部署

验证：服务访问与初始配置

容器启动后，通过浏览器访问http://localhost:8000进入Tunarr设置向导：

Tunarr欢迎界面

完成三个配置步骤：

1. 连接媒体源：添加本地文件夹或网络媒体服务器
2. 安装FFmpeg：根据系统自动下载或手动指定路径
3. 完成设置：点击"FINISH"进入频道管理界面

优化：性能调优与硬件加速配置

性能调优参数对照表

参数	推荐值	作用
LOG_LEVEL	WARNING	减少日志输出提升性能
CPU核心限制	2-4	根据服务器配置调整
内存限制	2G	避免资源过度占用
缓存大小	512M	增加节目缓存提升响应速度

硬件加速配置方案

NVIDIA GPU加速

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

Intel QSV加速

services:
  tunarr:
    # ...其他配置...
    devices:
      - /dev/dri:/dev/dri  # 映射显卡设备

拓展：高级功能与社区支持

常见故障速查表

故障现象	可能原因	解决方案
8000端口占用	其他服务占用	lsof -i:8000查找并停止占用进程
媒体文件无法访问	权限问题	调整挂载目录权限为755
转码卡顿	性能不足	启用硬件加速或降低分辨率
无法保存配置	卷挂载错误	检查docker-compose.yml中volumes配置

项目资源与社区支持

• 官方文档：项目内docs目录包含完整使用指南
• 代码仓库：git clone https://gitcode.com/gh_mirrors/tu/tunarr获取最新源码
• 社区渠道：通过项目GitHub Issues提交问题或功能建议
• 更新维护：使用docker-compose pull && docker-compose up -d命令更新服务

Tunarr节目指南

通过本指南部署的Tunarr服务，你已拥有一个功能完备的个性化电视系统。无论是创建主题频道、设置播放计划还是整合多源媒体，Tunarr的灵活配置都能满足你的定制需求。立即开始探索，打造属于你的专属电视服务体验！