ubuntu上jellyfin插件怎么安装

Ubuntu上安装Jellyfin插件的步骤

1. 前提条件：安装Jellyfin

在安装插件前，需确保Ubuntu系统已安装Jellyfin媒体服务器。若未安装，可通过以下命令完成安装：

• 更新系统包并安装依赖：

  sudo apt update && sudo apt upgrade -y
  sudo apt install apt-transport-https ca-certificates curl -y
  

• 添加Jellyfin官方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
  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
  

• 安装Jellyfin：

  sudo apt update
  sudo apt install jellyfin -y
  

• 启动Jellyfin服务并设置开机自启：

  sudo systemctl start jellyfin
  sudo systemctl enable jellyfin
  

2. 通过Web界面安装插件（推荐）

这是最简单的方式，适用于大多数用户：

• 登录Jellyfin Web界面：在浏览器中输入http://<服务器IP>:8096，使用管理员账号登录。
• 进入插件管理：点击左侧菜单栏设置→插件。
• 浏览或搜索插件：点击浏览按钮，可通过关键词筛选或直接搜索所需插件（如“Plex转码”“直播流”等）。
• 安装插件：找到目标插件后，点击安装按钮，等待安装进度完成。
• 启用插件：安装完成后，返回插件列表，找到已安装的插件，点击右侧开关启用。
• 重启服务（可选）：部分插件需要重启Jellyfin才能生效，可通过系统→服务管理→重启Jellyfin完成。

3. 通过Docker安装插件（适用于Docker部署）

若使用Docker运行Jellyfin，需通过容器方式安装插件：

• 安装Docker和拉取Jellyfin镜像：

  sudo apt update && sudo apt install docker.io -y
  sudo 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
  

  （将/path/to/config和/path/to/media替换为实际配置和媒体文件路径）
• 拉取插件镜像：前往Docker Hub搜索目标插件（如jellyfin/plugin-name），使用docker pull命令拉取：

  docker pull jellyfin/plugin-name:latest
  

• 运行插件容器：将插件容器连接到Jellyfin主容器：

  docker run -d --name jellyfin-plugin --link jellyfin:jellyfin -e JELLYFIN_PORT=8096 -e JELLYFIN_BASE_URL=http://your-jellyfin-server jellyfin/plugin-name:latest
  

• 验证插件：登录Web界面，进入插件→管理，查看新安装的插件并进行配置。

4. 手动安装插件（高级用户）

若插件未提供Web或Docker安装方式，可手动编译安装：

• 安装编译依赖：

  sudo apt install build-essential git -y
  

• 下载插件源码：通过GitHub克隆插件仓库（以example-plugin为例）：

  git clone https://github.com/username/example-plugin.git
  cd example-plugin
  

• 编译并安装：

  make
  sudo make install
  

• 复制插件文件：将编译后的插件文件夹复制到Jellyfin插件目录（通常为/opt/jellyfin/plugins）：

  sudo cp -r example-plugin /opt/jellyfin/plugins/
  

• 重启服务：使插件生效：

  sudo systemctl restart jellyfin
  

注意事项

• 兼容性：安装前确认插件与当前Jellyfin版本兼容（参考插件文档）。
• 依赖项：部分插件需要额外依赖（如.NET、ffmpeg等），需提前安装。
• 备份数据：修改配置或插件前，备份Jellyfin配置文件（/config目录）和媒体库。
• 日志排查：若安装失败，查看Jellyfin日志（/var/log/jellyfin/jellyfin.log）定位问题。