ubuntu上jellyfin怎么配置_运维文库_资讯中心

发布时间:2026-04-27 18:58:07

阅读量:2

一、准备工作 在Ubuntu上配置Jellyfin前，需完成系统更新及必要依赖安装，确保后续步骤顺利执行：

sudo apt update && sudo apt upgrade -y  # 更新系统包
sudo apt install apt-transport-https ca-certificates gnupg curl -y  # 安装依赖工具

二、添加Jellyfin官方仓库 为避免第三方源的安全风险，建议通过Jellyfin官方APT仓库安装：

创建密钥环目录并导入GPG密钥（用于验证软件包完整性）：

mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg

添加Jellyfin仓库（根据Ubuntu版本调整）：

echo "deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

三、安装Jellyfin 通过APT包管理器安装Jellyfin（自动解决依赖关系）：

sudo apt update  # 刷新包列表
sudo apt install jellyfin -y  # 安装Jellyfin

四、启动与管理Jellyfin服务 确保Jellyfin服务正常运行并设置开机自启：

sudo systemctl start jellyfin  # 启动服务
sudo systemctl enable jellyfin  # 开机自启
sudo systemctl status jellyfin  # 检查服务状态（显示"active (running)"即为正常）

五、访问与基础配置

访问Web界面：在浏览器中输入http://<服务器IP>:8096（如http://192.168.1.100:8096），首次访问需创建管理员账户（设置用户名、密码及邮箱）。
添加媒体库：登录后点击左侧导航栏“Libraries”→“+”→选择媒体类型（视频/音频/图片）→指定媒体文件所在目录（如/home/user/Movies）→点击“Scan Library”自动扫描并添加媒体。

六、高级配置（可选）

配置远程访问：
- 允许端口通过防火墙（若启用UFW）：
```
sudo ufw allow 8096/tcp  # 允许Jellyfin默认端口
sudo ufw enable  # 启用防火墙
```
- 设置端口转发（非局域网环境）：在路由器后台将外部端口（如8096）转发至服务器内部IP的8096端口。

设置SSL证书（启用HTTPS）：

安装Certbot及Apache模块：

sudo apt install certbot python3-certbot-apache -y
sudo a2enmod proxy proxy_http ssl proxy_wstunnel remoteip http2 headers  # 启用必要模块
sudo systemctl restart apache2

获取SSL证书（替换your_domain.com为你的域名）：

sudo certbot certonly --agree-tos --email your_email@example.com --no-eff-email --webroot -w /var/www/html -d your_domain.com

配置Apache反向代理（编辑虚拟主机文件）：

sudo nano /etc/apache2/sites-available/jellyfin.conf

添加以下内容（替换域名及证书路径）：

:80>
    ServerName your_domain.com
    Redirect permanent / https://your_domain.com/

:443>
    ServerName your_domain.com
    DocumentRoot /var/www/html/jellyfin/public_html
    ProxyPreserveHost On
    ProxyPass "/.well-known/" "!"
    ProxyPass "/" "http://localhost:8096/"
    ProxyPassReverse "/" "http://localhost:8096/"
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-Forwarded-Port "443"

保存后重启Apache：

sudo systemctl restart apache2

启用硬件加速（提升播放性能，以NVIDIA显卡为例）：

安装NVIDIA驱动及Container Toolkit：

sudo ubuntu-drivers autoinstall  # 自动安装适合的NVIDIA驱动
sudo systemctl reboot  # 重启服务器
distribution=$(. /etc/os-release;echo $ID$VERSION_ID) && curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg && curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sed 's#deb http#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] http#' | sudo tee /etc/apt/sources.list.d/nvidia-docker.list && sudo apt update && sudo apt install -y nvidia-container-toolkit && sudo systemctl restart docker

重启Jellyfin容器（若使用Docker安装）：
```
sudo docker restart jellyfin
```

七、常见问题排查

无法访问Web界面：检查防火墙是否允许8096端口、Jellyfin服务是否运行（sudo systemctl status jellyfin）。
媒体库未扫描：确认媒体目录权限（Jellyfin用户需有读取权限）、网络连接是否正常。
硬件加速无效：确认显卡驱动是否正确安装、Jellyfin配置中是否启用了硬件加速（Web界面→“Playback”→“Hardware Acceleration”）。

以上就是关于“ubuntu上jellyfin怎么配置”的相关介绍，筋斗云是国内较早的云主机应用的服务商，拥有10余年行业经验，提供丰富的云服务器、租用服务器等相关产品服务。云服务器资源弹性伸缩，主机vCPU、内存性能强悍、超高I/O速度、故障秒级恢复；电子化备案，提交快速，专业团队7×24小时服务支持！

简单好用、高性价比云服务器租用链接：https://www.jindouyun.cn/product/cvm