ubuntu jellyfin插件支持

Ubuntu 上的 Jellyfin 插件支持与安装

支持概览 在 Ubuntu 上，Jellyfin 提供完善的插件生态，支持通过 Web 管理界面直接安装与管理插件；若使用 Docker 部署，同样可以通过复制插件目录并重启容器来扩展功能。常见功能涵盖：播放增强、元数据与刮削、登录与通知、直播电视、媒体清理与皮肤管理等。

安装方式与步骤

• 原生系统安装（Ubuntu 20.04+ 示例）

  • 添加官方仓库并安装：
    • sudo apt update && sudo apt install apt-transport-https ca-certificates curl
    • 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 [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/ubuntu $(lsb_release -c -s) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
    • sudo apt update && sudo apt install jellyfin -y
  • 启动服务：sudo systemctl start jellyfin
  • 访问控制台：浏览器打开 http://<服务器IP>:8096，在“插件”页进行安装与管理。

• Docker 部署

  • 运行容器（示例）：
    • docker run -d --name jellyfin -e PUID=1000 -e PGID=1000 -p 8096:8096 -v /path/to/config:/config -v /path/to/media:/media jellyfin/jellyfin
  • 安装插件（以插件目录方式为例）：
    • 将插件目录复制到容器：docker cp SamplePlugin jellyfin:/config/plugins/SamplePlugin
    • 重启容器：docker restart jellyfin
  • 进入 Web 控制台（http://:8096）在“插件”页完成启用与配置。

常用插件推荐

• 播放与体验：intro-skipper（片头片尾自动跳过）、InPlayerEpisodePreview（播放器剧集列表）
• 元数据与媒体管理：jellyfin-ani-sync（AniList 等进度同步）、jellyfin-plugin-metashark（豆瓣/TheMovieDB 元数据）、jellyfin-plugin-maxsubtitle（中文字幕）、Bangumi（中文番剧元数据）
• 账号与通知：jellyfin-plugin-sso（SSO 登录）、TelegramNotifier（Telegram 通知）
• 直播与运维：jellyfin-plugin-enigma2（Enigma2/Vu+ 直播源）、media-cleaner（过期媒体清理）、skin-manager（皮肤管理）、Newsletter-Plugin（新增媒体简报）

常见问题与排查

• 版本与兼容性：插件需与 Jellyfin 版本匹配，旧版本可能存在兼容问题。建议定期更新：sudo apt update && sudo apt upgrade jellyfin；安装或更新插件后如遇异常，优先检查插件兼容性与版本匹配。
• 日志定位：查看服务器日志以快速定位问题：tail -f /var/log/jellyfin/server.log，关注关键词如 MetadataService、Scraping、Failed，并留意 403/429 等 HTTP 状态码（可能涉及第三方 API 限流）。
• 字幕与字体：若播放器中文显示异常（方块/乱码），在 Docker 环境中可安装中文字体并重启容器：docker exec -it jellyfin /bin/bash -c “apt update && apt install -y fonts-noto-cjk-extra” && docker restart jellyfin；也可在播放界面“字幕 → 添加字幕文件”加载本地 .srt/.ass 文件。