ubuntu jellyfin配置方法

Ubuntu 下 Jellyfin 配置全流程

一 环境准备与安装

• 更新系统并安装依赖
  • sudo apt update && sudo apt upgrade -y
  • sudo apt install -y apt-transport-https ca-certificates curl gnupg
• 导入 GPG 密钥（推荐写入 keyrings）
  • sudo mkdir -p /etc/apt/keyrings
  • curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
• 添加 APT 仓库（自动识别发行版代号）
  • echo “deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/ubuntu $(awk -F= ‘/^VERSION_CODENAME=/{print $2}’ /etc/os-release) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
• 安装并启动服务
  • sudo apt update && sudo apt install -y jellyfin
  • sudo systemctl enable --now jellyfin
  • sudo systemctl status jellyfin
• 防火墙放行（如启用 UFW）
  • sudo ufw allow 8096/tcp
  • 如使用云服务器，还需在云平台安全组放行 TCP 8096。

二 首次初始化设置

• 访问 Web 界面：在浏览器打开 http://服务器IP:8096
• 设置管理员账户与密码
• 添加媒体库
  • 选择内容类型（如：电影、电视剧、音乐）
  • 指定媒体文件夹路径（需保证 Jellyfin 进程可读）
• 选择元数据语言（如：中文）
• 远程访问：按需开启“允许远程访问”
• 完成后进入控制台进行用户、播放、转码等细化设置。

三 反向代理与 HTTPS（Apache 示例）

• 安装与启用模块
  • sudo apt install -y apache2 certbot python3-certbot-apache
  • sudo a2enmod proxy proxy_http ssl proxy_wstunnel remoteip http2 headers
  • sudo systemctl restart apache2
• 获取证书（将域名替换为你的）
  • sudo certbot certonly --agree-tos --email you@example.com --no-eff-email --webroot -w /var/www/html -d your_domain
• 配置虚拟主机 /etc/apache2/sites-available/jellyfin.conf
  • 建议将 HTTP 重定向到 HTTPS，并在 443 虚拟主机中反向代理到 http://127.0.0.1:8096
  • 注意 WebSocket：ProxyPass “/socket” “ws://127.0.0.1:8096/socket”
• 启用站点并重启
  • sudo a2ensite jellyfin.conf && sudo systemctl reload apache2
• 访问：使用 https://your_domain 打开 Jellyfin。

四 权限与路径排错要点

• 目录权限与所有权
  • 若媒体目录无法读取，修正权限与属主（示例将目录替换为你的实际路径）：
    • sudo chmod 755 -R /path/to/media
    • sudo chown -R jellyfin:jellyfin /path/to/media
• 防火墙与云安全组
  • 本地防火墙放行 8096/tcp
  • 云服务器需在控制台安全组放行 TCP 8096
• 服务状态与日志
  • 查看与重启：sudo systemctl status jellyfin / sudo systemctl restart jellyfin
  • 日志路径：/var/log/jellyfin/（排查启动、扫描、播放问题）。

五 Docker 部署与中文界面（可选）

• 安装 Docker（略）
• 运行容器（将卷与用户 ID 替换为你的环境）
  • sudo docker run -d
    –name jellyfin
    –volume /path/to/media:/media
    –volume /path/to/config:/config
    -e UID=1000 -e GID=1000
    -p 8096:8096
    jellyfin/jellyfin
• 访问 http://localhost:8096 完成初始化，在“设置 → 界面语言”选择 中文。