Jellyfin Media Player
Jellyfin Media Player 1.12.0 是连接自建 Jellyfin 服务器的开源桌面客户端，结合 Web 界面与 mpv 播放，支持硬件解码、音频直通和更多格式直接播放。
适合做什么
Jellyfin Media Player 适合在桌面设备连接已有 Jellyfin 服务器，以 mpv 获得更广的直接播放、硬件解码和音频直通能力。它不是媒体服务器，也不包含任何影视内容或共享资源。
稳定版与更名边界
1.12.0 于 2025-03-20 发布，是最后一个稳定 Qt 5 版。项目已更名为 Jellyfin Desktop，2.0.0 仍标记为预发布且不会迁移旧设置；升级时需要重新添加服务器并逐项验证。
直接播放、转码与凭据
容器、编码、音频或字幕不兼容时，服务器可能重封装或转码，字幕烧录尤其消耗资源。客户端本地保存配置、缓存、日志和服务器会话，公用设备应退出账号，不公开带有令牌的日志。
维护记录
本页依据 Jellyfin Media Player 1.12.0 官方发布资产、Qt 5 终版说明、Jellyfin Desktop 更名与设置迁移、mpv 播放、转码机制、平台范围及 GPL-2.0 许可复核，检查日期为 2026-08-06。
选择下载方式
下载前请核对资源版本和授权范围。本站不提供破解软件及未经授权的资料。
Jellyfin Media Player 1.12.0 安装与服务器连接教程
先确认已有可访问的 Jellyfin 服务器、账号和授权媒体，再安装客户端并用一段普通视频验证直接播放；硬件解码、字幕和高级 mpv 配置放在基础连接正常后处理。
安装前准备
- 准备 Jellyfin 服务器地址、有效账号和必要的双重验证信息，确认服务器版本及网络可达。
- 核对 Windows x86/x64、macOS Intel/Apple Silicon 或匹配发行版的 Linux DEB；macOS 12 已不在 1.12.0 支持范围。
- 使用自己拥有或获授权的媒体，记录服务端转码能力、局域网带宽和客户端显示设备规格。
安装步骤
- 01
安装 1.12.0 对应构建
Windows 根据架构选择安装器，较老 CPU 遇到启动错误时使用官方 legacy x64 构建；macOS 选择芯片对应 DMG，Linux 选择匹配系统的 DEB。
- 02
添加服务器并登录
输入完整服务器地址，确认协议、域名、端口和子路径都正确，再登录账号；不要在未知设备保存长期凭据。
- 03
测试直接播放
选择普通 H.264/AAC 样本，打开播放信息检查直接播放、重封装或转码状态，再测试字幕、音轨和全屏。
快速上手
- 01
校准硬件解码
只有出现高 CPU、卡顿、绿屏或紫屏时再切换硬件解码；每次只改一项，并同时查看客户端日志和服务端转码日志。
- 02
检查字幕造成的转码
分别测试无字幕、文本字幕和图形字幕；若启用字幕后开始视频转码，优先核对客户端字幕兼容和服务器性能。
- 03
保存迁移信息
记录服务器地址、配置和 mpv 选项。未来升级 Jellyfin Desktop 2.x 时不要预期自动迁移，应重新添加服务器并验证播放。
使用建议
- 1.12.0 于 2025-03-20 发布，是最后一个稳定 Qt 5 版本，覆盖 Windows、macOS 和多个 Linux 发行版。
- 本版修复 Wayland 黑屏、SRT 字幕挤压、连接超时、Web 客户端缓存和 Linux 证书验证等问题。
- 客户端使用服务器提供的 Web 界面并通过 mpv 播放；服务器更新、权限和转码配置会直接影响体验。
- 客户端会在本地保存配置、缓存、日志和服务器凭据，公用设备使用后应退出账号并清理相应资料。
故障排查与卸载方法
登录后空白、连接超时或反复要求服务器地址怎么办？
核对协议、端口、反向代理子路径、证书和服务器版本，先用浏览器确认同一地址可登录；检查客户端日志但不要公开访问令牌。
播放卡顿或服务器 CPU 很高怎么办？
打开播放信息判断是否转码，依次测试无字幕、降低码率和关闭客户端硬件解码；结合服务端日志确认编码能力、带宽和 GPU 配置。
- 记录服务器和自定义配置保存必要的服务器地址与 mpv 配置，退出账号并确认公用设备不再保留可用会话；不要复制或公开访问令牌。
- 卸载并按需清理资料退出客户端后按系统卸载；确认不再使用时再删除本地配置、缓存和日志。媒体文件位于服务器，不会随客户端卸载而删除。
常见问题
Jellyfin Media Player 自带媒体服务器和影片吗？
不带。它是桌面客户端，必须连接你自己或获授权使用的 Jellyfin 服务器；服务器负责用户、媒体库和转码。客户端不会提供影视内容，也不代替服务器安装与存储。
1.12.0 与 Jellyfin Desktop 2.0.0 有什么关系？
1.12.0 是最后一个稳定 Qt 5 版；项目后来更名为 Jellyfin Desktop，并发布 2.0.0 预发布版。2.0.0 不迁移旧版设置，需要重新配置客户端并添加服务器，当前页面仍以 1.12.0 稳定版为准。
为什么播放时服务器仍然转码？
只要容器、视频、音频或字幕有一项不被客户端兼容，就可能直接串流、重封装或转码；烧录字幕通常最耗服务器算力。先查看播放信息，再判断是编码、字幕、带宽还是硬件解码问题。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。