Jellyfin Linux客户端使用教程 - 问答

Jellyfin Linux 客户端使用教程

一客户端选择与适用场景

Jellyfin Media Player（桌面客户端）：基于 Plex Media Player，集成 MPV 内核，界面与 Jellyfin Web 一致，适合在 Linux 桌面直接浏览与播放，体验接近原生应用。支持通过配置文件自定义播放器行为。
Jellyfin MPV Shim（投屏/控制客户端）：以 MPV 为播放引擎，强调“直连播放、少转码”，支持 SyncPlay 同步观影、移动端 App 远程控制、Shader Packs、SVP 集成、Discord Rich Presence 等，适合 HTPC/家庭影院 场景。

二安装与快速上手

Jellyfin Media Player（Ubuntu/Debian 常用）
- 下载安装：前往 GitHub Releases 下载对应发行版 .deb 包，例如 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 或 https://域名），完成登录与媒体库选择。
Jellyfin MPV Shim（跨平台投屏/控制）
- 安装方式（Linux）：
```
# 方式一：通过 pip
pip install jellyfin-mpv-shim
# 方式二：通过 Flatpak（若发行版已配置 Flathub）
flatpak install flathub com.github.iwalton3.jellyfin-mpv-shim
```
- 启动与连接：运行 jellyfin-mpv-shim，按提示输入 服务器 URL（含端口/子目录），登录后即可使用。托盘图标可用于编辑服务器、查看日志、打开配置目录与菜单。

三常用操作与进阶配置

Jellyfin Media Player
- 界面与播放：与 Web 端一致的浏览/播放控制；如需深度定制，可编辑配置文件 jellyfinmediaplayer.conf 或创建 mpv.conf 调整 MPV 行为（如硬解、缓存、字幕样式等）。
Jellyfin MPV Shim
- 投屏与控制：其他 Jellyfin App（手机/平板）可发现并控制 Shim 客户端；支持 SyncPlay 多人同步观影。
- 播放体验：继承 MPV 全部快捷键；可使用 Shader Packs 增强画质，集成 SVP 实现插帧，支持 Discord Rich Presence 展示播放状态。

四字幕与显示优化

自动/手动添加字幕
- 自动：在 Jellyfin Web 管理端安装字幕插件（如 jellyfin-plugin-maxsubtitle），播放时自动匹配并下载 中文字幕。
- 手动：在播放界面“字幕”→“添加字幕文件”，选择本地 .srt/.ass 文件。
中文字体渲染
- 若字幕出现方块乱码，安装中文字体（以 Docker 部署为例）：
```
docker exec -it jellyfin /bin/bash
apt update && apt install -y fonts-noto-cjk-extra
exit
docker restart jellyfin
```
- 在 Jellyfin 设置中指定已安装字体路径，确保 中文/日文/韩文 正常显示。

五常见问题与排查

找不到媒体文件（权限问题）

确保媒体目录对 jellyfin 用户可读（示例）：

sudo chown -R jellyfin:jellyfin /your/media/folder
# 或创建共享组（推荐）
sudo groupadd media
sudo usermod -aG media jellyfin
sudo chgrp -R media /your/media/folder
sudo chmod -R g+rX /your/media/folder

新增文件未识别
- 在 Web UI 对应媒体库执行“Scan Library”或“Refresh Metadata”。
外网访问
- 不建议直接暴露端口，推荐使用 Tailscale 等内网穿透工具安全访问。
播放卡顿或转码过多
- 优先使用 Jellyfin MPV Shim 或桌面客户端直连播放；确保客户端与服务器网络通畅，并在服务器启用合适的 硬件加速（如 VAAPI/Intel Quick Sync）。

0 赞

0 踩