Jellyfin Linux客户端如何使用

Linux 上的 Jellyfin 客户端主要有两种形态：桌面客户端 Jellyfin Media Player 与投屏/外部播放器控制工具 Jellyfin MPV Shim。下面给出各自的安装与使用步骤，以及常见播放优化要点。

安装与快速上手

• Jellyfin Media Player（桌面客户端，推荐）

  • 基于 MPV，界面友好，编解码能力强，适合在 Linux 桌面直接播放本地或服务器媒体库。
  • 发行版包安装（以 Ubuntu 22.04 为例）：
    • 下载安装包（.deb）：
      • 地址示例：https://github.com/jellyfin/jellyfin-media-player/releases/download/v1.10.0/jellyfin-media-player_1.10.0-1_amd64-jammy.deb
      • 终端执行：

        wget https://github.com/jellyfin/jellyfin-media-player/releases/download/v1.10.0/jellyfin-media-player_1.10.0-1_amd64-jammy.deb
        sudo dpkg -i jellyfin-media-player_1.10.0-1_amd64-jammy.deb
        sudo apt-get update && sudo apt-get install -f -y  # 自动补齐依赖
        

    • 首次启动后在客户端内添加服务器地址（如 http://服务器IP:8096），登录后即可浏览与播放。
  • Flatpak 安装（适用于多数发行版）：

    flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
    flatpak install flathub io.jellyfin.JellyfinMediaPlayer
    

  • 以上两种方式任选其一即可完成安装与首启配置。

• Jellyfin MPV Shim（投屏/外部播放器控制）

  • 以 MPV 为播放引擎，支持多数媒体直驱播放、SyncPlay 同步观影、移动端 Jellyfin App 远程控制、丰富的 MPV 快捷键 与 Shader 效果等。
  • 安装与启动（Linux）：
    • 通过 pip（需已安装 Python 3 与 pip）：

      pip install jellyfin-mpv-shim
      

    • 首次运行按提示输入服务器地址（如 http://server_ip:8096 或 https://your_domain），登录后可在网页/手机端发起“投放”，本机 MPV 窗口播放。
    • 托盘图标可用于快速打开设置、查看日志与配置目录。

常用操作与播放优化

• 连接与登录

  • 在客户端或 Shim 中输入服务器地址（含端口，如 8096；若使用反向代理或 HTTPS，使用相应域名与端口），完成用户登录与媒体库加载。

• 外网访问与穿透（可选）

  • 不建议直接暴露 8096 端口到公网，可使用 Tailscale 等内网穿透工具在外出时安全访问家庭网络中的 Jellyfin 服务器。

• 硬件加速与播放流畅度

  • 若需在服务器端进行硬件转码以提升兼容性，可在 Intel 平台安装：

    sudo apt install intel-media-va-driver-non-free
    

  • 客户端侧使用 Jellyfin Media Player 或 MPV Shim 均可受益于服务器端硬件解码，减少卡顿与资源占用。

• 文件权限与媒体库识别

  • 确保媒体目录对 jellyfin 系统用户可读（或将用户加入共享组并授予组权限），否则会出现“看不见/无法播放”的情况。
  • 新放入的内容若未自动出现，可在 Web UI 对应媒体库执行 Scan Library 或 Refresh Metadata。

• 浏览器直用（免安装）

  • 任何 Linux 浏览器 打开 http://服务器IP:8096 即可使用网页端，适合临时访问或无法安装桌面客户端的环境。