媒体服务器

Jellyfin 媒体服务器部署

Jellyfin 免费开源媒体服务器的快速部署指南

Jellyfin 是完全免费开源的媒体服务器，无需订阅费用，支持硬件转码

📺 Jellyfin 媒体服务器部署

Jellyfin 是一个完全免费开源的媒体服务器，可以管理和播放您的电影、电视剧、音乐等媒体文件。

为什么选择 Jellyfin？

🆓 完全免费：无订阅费用，无功能限制
🔧 硬件转码：免费使用 GPU 加速转码
📱 多端支持：支持各种设备和客户端
🌐 活跃社区：开源项目，持续更新维护
🎨 可定制：丰富的插件和主题支持

💻 系统要求

组件	最低要求	推荐配置
CPU	双核 2.0GHz	四核 2.4GHz+
内存	2GB RAM	4GB+ RAM
存储	100MB 系统空间	SSD 系统盘

🚀 部署方式

🐳 Docker 部署（推荐）

创建目录

mkdir -p ~/jellyfin/{config,cache,media}
cd ~/jellyfin

创建 docker-compose.yml

version: '3.8'
services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    restart: unless-stopped
    ports:
      - "8096:8096"
    volumes:
      - ./config:/config
      - ./cache:/cache
      - ./media:/media:ro
    environment:
      - JELLYFIN_PublishedServerUrl=http://你的IP:8096

启动服务
```
docker-compose up -d
```

💾 系统直接安装

# 添加官方仓库密钥
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/jellyfin.gpg

# 添加仓库
echo "deb [arch=amd64] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

# 更新并安装
sudo apt update
sudo apt install jellyfin

# 启动并设置开机自启
sudo systemctl enable --now jellyfin

# 检查服务状态
sudo systemctl status jellyfin

# 安装 EPEL 仓库
sudo dnf install epel-release

# 添加 Jellyfin 仓库
sudo dnf config-manager --add-repo https://repo.jellyfin.org/releases/server/centos/jellyfin-centos.repo

# 安装 Jellyfin
sudo dnf install jellyfin

# 启动服务
sudo systemctl enable --now jellyfin

# 开放防火墙端口
sudo firewall-cmd --add-port=8096/tcp --permanent
sudo firewall-cmd --reload

# 使用 AUR 安装
yay -S jellyfin-bin

# 或者使用官方仓库
sudo pacman -S jellyfin

# 启动服务
sudo systemctl enable --now jellyfin

# 添加用户到 jellyfin 组
sudo usermod -aG jellyfin $USER

# 使用 Homebrew 安装
brew install --cask jellyfin

# 或者手动安装
# 1. 从官网下载 .dmg 文件
# 2. 拖拽到 Applications 目录
# 3. 首次运行需要在系统偏好设置中允许

# 启动服务
brew services start jellyfin

下载安装包

访问 Jellyfin 官网
下载最新版本的 Windows 安装包

运行安装程序

右键选择"以管理员身份运行"
按照安装向导完成安装
选择安装目录（默认：C:\Program Files\Jellyfin\Server）

配置服务

安装完成后会自动注册为 Windows 服务
在服务管理器中设置为自动启动
或使用命令行：sc config jellyfin start=auto

防火墙配置

首次启动时 Windows 防火墙会询问是否允许
或手动添加端口 8096 到防火墙例外

# 使用 pkg 安装
sudo pkg install jellyfin

# 或者从 ports 编译安装
cd /usr/ports/multimedia/jellyfin
sudo make install clean

# 启用服务
sudo sysrc jellyfin_enable="YES"

# 启动服务
sudo service jellyfin start

# 检查状态
sudo service jellyfin status

# 快速启动（单次运行）
docker run -d \
  --name jellyfin \
  -p 8096:8096 \
  -v /path/to/config:/config \
  -v /path/to/cache:/cache \
  -v /path/to/media:/media:ro \
  --restart unless-stopped \
  jellyfin/jellyfin:latest

# 使用 Docker Compose（推荐生产环境）
# 创建 docker-compose.yml 文件（见上面的 Docker 部署部分）
docker-compose up -d

基础配置

访问 Web 界面
- 浏览器打开：http://你的IP:8096
- 选择界面语言
创建管理员账户
- 设置用户名和密码
添加媒体库
- 选择媒体类型（电影、电视剧、音乐）
- 设置媒体文件夹路径
- 完成初始设置

硬件转码（可选）

如果需要硬件转码，可以添加设备映射：

services:
  jellyfin:
    # ...其他配置...
    devices:
      - /dev/dri:/dev/dri
    group_add:
      - "109" # render 组

services:
  jellyfin:
    # ...其他配置...
    runtime: nvidia
    environment:
      - NVIDIA_VISIBLE_DEVICES=all
      - NVIDIA_DRIVER_CAPABILITIES=compute,video,utility

📱 客户端下载

Web 客户端：直接浏览器访问
移动端：在应用商店搜索 "Jellyfin"
桌面端：从官网下载
电视端：Android TV、Apple TV 等应用商店

❓ 常见问题

无法访问？

检查防火墙是否开放 8096 端口
确认服务是否正常运行

性能优化建议

使用 SSD 存储配置文件
启用硬件转码（如果硬件支持）
合理规划媒体文件目录结构

🔗 相关工具

Plex 配置 - 专业媒体服务器
Emby 设置 - 功能丰富的媒体服务器
qBittorrent 配置 - 推荐的 BT 下载客户端
Transmission 配置 - 轻量级 BT 客户端
MoviePilot 配置 - 自动化影视资源管理

🚀 快速开始流程

部署 → Docker 环境部署 Jellyfin
配置 → 访问 Web 界面进行初始化设置
添加 → 配置媒体库和文件夹映射
优化 → 启用硬件转码和其他高级功能
享受 → 使用各种客户端观看媒体内容

📚 更多高级配置请参考官方文档

MoviePilot 配置指南

全自动影视资源管理系统部署与配置完整指南

Plex 媒体服务器部署

Plex 媒体服务器的快速部署和配置指南