Ubuntu Jellyfin如何修改设置

Ubuntu 下 Jellyfin 设置修改指南

一 访问管理界面与基础配置

• 在浏览器访问：http://服务器IP:8096，完成初始向导：创建管理员账户、添加媒体库路径、设置元数据语言与远程访问开关。
• 常用管理入口：
  • 控制台 Dashboard > 服务器 > 常规：修改服务器名称、语言、自动扫描间隔等。
  • 控制台 > 媒体库：新增/编辑库，设置内容类型（电影/剧集/音乐）、文件夹路径、元数据与图像抓取器。
  • 控制台 > 用户：创建用户、设置密码与权限、家长控制与播放限制。
  • 控制台 > 播放：转码质量、字幕下载、硬件加速开关等。
  • 控制台 > 网络：基础 URL、端口、外部访问、代理与 HTTPS 相关设置。

二 网络与远程访问设置

• 防火墙放行：启用 UFW 并放行端口（HTTP/HTTPS 或自定义端口），示例：
  • sudo ufw allow 8096
  • sudo ufw allow 443
  • sudo ufw enable && sudo ufw status
• 路由器端口转发（外网访问场景）：在路由器将外部端口（如 8888）转发到服务器内网 IP:8096，并在 Jellyfin 的网络 > 外部访问中按提示设置公网域名/IP 与端口。
• 反向代理与 HTTPS（推荐）：
  • Apache 示例要点：将 /.well-known/ 排除代理；设置 X-Forwarded-Proto/Port；分别代理 / 与 /socket（WebSocket）到 http://127.0.0.1:8096/ 与 ws://127.0.0.1:8096/socket；启用 SSL/HTTP2。
  • Nginx 亦可类似配置，核心是正确转发 WebSocket 与设置转发头。完成后重启反向代理服务。

三 配置文件与系统服务调整

• 服务管理（修改配置后建议重启服务）：
  • 状态/启停：sudo systemctl status/start/stop/restart jellyfin
  • 开机自启：sudo systemctl enable jellyfin
• 配置文件位置与关键项：
  • 主配置：/etc/jellyfin/config.xml（如 HTTP 端口 8096、HTTPS 端口 443、Base URL、远程访问等）。
  • 系统服务：查看/编辑 /etc/jellyfin/jellyfin.conf（如运行用户、环境、工作目录等）。
  • 修改后应用：sudo systemctl restart jellyfin
• 目录权限（媒体库无法扫描或播放异常时使用）：
  • 将媒体目录属主设为 jellyfin:jellyfin，示例：sudo chown -R jellyfin:jellyfin /path/to/media。

四 安全加固与更新维护

• 安全建议：
  • 启用 HTTPS（反向代理或内置证书），对外仅暴露必要端口，禁用不必要的外部访问。
  • 使用 UFW 限制来源 IP（可选），仅放行 SSH/HTTP/HTTPS。
  • 保持系统与 Jellyfin 及时更新：sudo apt update && sudo apt upgrade jellyfin -y
  • 如需自动更新，启用官方仓库后定期执行升级命令（或配置无人值守升级）。

五 常见问题快速排查

• 无法登录或页面打不开：
  • 检查服务：sudo systemctl status jellyfin；必要时 sudo systemctl restart jellyfin
  • 查看日志：tail -n 50 /var/log/jellyfin/jellyfin.log
  • 检查防火墙：sudo ufw status；放行 8096/443
  • 核对权限：媒体目录与配置目录属主为 jellyfin:jellyfin
• 媒体库不显示或权限错误：
  • 确认路径在 Jellyfin 中已添加且系统权限正确（chown/chmod），然后触发扫描。