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 即可使用网页端，适合临时访问或无法安装桌面客户端的环境。

最新问答

相关标签