如何在Linux上搭建Jellyfin - 问答

如何在Linux上搭建Jellyfin媒体服务器
Jellyfin是一款开源媒体服务器，支持跨平台运行，可在Linux系统上搭建个人媒体中心。以下是针对不同Linux发行版的详细搭建步骤及注意事项：

一、前期准备

系统要求：确保Linux系统已更新至最新版本（sudo apt update && sudo apt upgrade -y 或对应发行版的更新命令）；
硬件要求：至少1GB内存（推荐2GB以上）、1核CPU（推荐2核以上）、足够存储媒体文件的磁盘空间；
网络要求：服务器需有公网IP或域名（用于远程访问），并开放对应端口（默认8096）。

二、分发行版安装步骤

1. Debian/Ubuntu及其衍生版（推荐APT方式）

添加Jellyfin官方仓库：

sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl gnupg software-properties-common
mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
echo "deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/$(lsb_release -cs) $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

安装Jellyfin：

sudo apt update
sudo apt install -y jellyfin

2. Arch Linux及其衍生版（AUR方式）

使用yay（或其他AUR助手）安装：
```
yay -S jellyfin-git
```

3. CentOS/RHEL（RPM包方式）

CentOS 7/8：

sudo yum install -y epel-release
sudo yum install -y wget
wget https://repo.jellyfin.org/releases/server/centos/jellyfin-$(curl -s https://repo.jellyfin.org/releases/server/centos/latest.txt).el7.x86_64.rpm
sudo yum localinstall -y jellyfin-*.el7.x86_64.rpm

4. Fedora

下载最新RPM包并安装：

wget https://repo.jellyfin.org/releases/server/fedora/jellyfin-$(curl -s https://repo.jellyfin.org/releases/server/fedora/latest.txt).fc$(rpm -E %fedora).x86_64.rpm
sudo dnf install -y jellyfin-*.fc*.x86_64.rpm

5. Docker方式（通用，推荐新手）

安装Docker和Docker Compose：

sudo apt update
sudo apt install -y docker.io docker-compose
sudo systemctl enable --now docker

创建并启动容器：
在用户目录下创建docker-compose.yml文件：

version: '3'
services:
  jellyfin:
    image: jellyfin/jellyfin
    container_name: jellyfin
    network_mode: host  # 直接使用主机网络（简化端口配置）
    volumes:
      - ./config:/config  # 配置文件目录
      - ./cache:/cache    # 缓存目录
      - /path/to/media:/media  # 媒体文件目录（替换为实际路径）
    restart: unless-stopped  # 开机自启

启动容器：

docker-compose up -d

三、启动与开机自启

Systemd服务管理（非Docker方式）：

sudo systemctl enable jellyfin  # 设置开机自启
sudo systemctl start jellyfin   # 启动服务
sudo systemctl status jellyfin  # 查看状态（确认运行中）

Docker方式：
容器创建时已通过restart: unless-stopped实现开机自启，无需额外配置。

四、访问与基本配置

访问Web界面：
在浏览器中输入http://<服务器IP>:8096（如http://192.168.1.100:8096），使用默认管理员账号admin登录（首次登录需修改密码）。
基础配置步骤：
1. 设置管理员密码：登录后立即修改默认密码；
2. 添加媒体库：进入“媒体库”→“添加媒体库”，选择媒体类型（电影/电视节目/音乐/图片），指定媒体文件目录（如/media/movies）；
3. 调整服务器设置：进入“系统”→“通用”，可修改端口（如改为8080）、语言（如中文）、时区等；
4. 添加用户：进入“用户”→“添加用户”，创建普通用户并分配权限（如仅访问电影库）。

五、可选优化配置

1. 配置防火墙

若系统启用了ufw（Ubuntu）或firewalld（CentOS），需开放Jellyfin端口：

sudo ufw allow 8096/tcp  # Ubuntu
sudo firewall-cmd --add-port=8096/tcp --permanent  # CentOS
sudo firewall-cmd --reload

2. 启用硬件加速

NVIDIA显卡（提升转码性能）：
安装NVIDIA驱动和Docker容器工具包：

sudo apt install -y nvidia-driver-535 nvidia-docker2  # Ubuntu示例
sudo systemctl restart docker

修改docker-compose.yml，添加环境变量：

environment:
  - NVIDIA_VISIBLE_DEVICES=all
  - NVIDIA_DRIVER_CAPABILITIES=compute,video,utility

3. 配置SSL证书（HTTPS加密）

使用Let’s Encrypt免费证书（需域名）：
```
sudo apt install -y certbot python3-certbot-nginx  # Nginx反向代理示例
sudo certbot --nginx -d yourdomain.com
```
之后在Jellyfin“系统”→“安全”中配置HTTPS端口（如8443）和证书路径。

4. 反向代理（可选）

通过Nginx/Apache将Jellyfin绑定到域名，隐藏端口并提升安全性：

server {
    listen 80;
    server_name media.yourdomain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name media.yourdomain.com;
    ssl_certificate /etc/letsencrypt/live/media.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/media.yourdomain.com/privkey.pem;

    location / {
        proxy_pass http://localhost:8096;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

重启Nginx后，通过https://media.yourdomain.com访问。

六、常见问题排查

无法访问Web界面：检查防火墙是否开放端口、Jellyfin服务是否运行（systemctl status jellyfin）、Docker容器是否正常（docker ps）；
媒体文件无法扫描：确认媒体目录权限（sudo chown -R jellyfin:jellyfin /path/to/media）、挂载路径是否正确（Docker需检查volumes配置）；
Docker容器频繁重启：查看容器日志（docker logs jellyfin），排查端口冲突或磁盘空间不足问题。

通过以上步骤，即可在Linux系统上成功搭建Jellyfin媒体服务器，实现个人媒体资源的集中管理与流媒体播放。具体配置可根据实际需求调整（如添加更多媒体库、配置远程访问等）。

0 赞

0 踩