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）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！