Jellyfin Android TV 完全实战手册：从第一次开机到搭建私人影院的进阶全攻略

Jellyfin Android TV 完全实战手册：从第一次开机到搭建私人影院的进阶全攻略

【免费下载链接】jellyfin-androidtvAndroid TV Client for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-androidtv

Jellyfin Android TV 是一款完全免费、开源的 Android TV 媒体中心客户端，它把你家里的电视、投影仪变成连接私有媒体库的窗口，无需订阅、无需云服务，所有影视资源都由你自己的服务器掌控。这份手册将按照你从拿到设备、连接服务器、打磨播放体验、再到折腾进阶功能的真实路径展开，手把手带你走完从新手到老玩家的每一步，把 Jellyfin Android TV 这台"影音主机"彻底玩明白。

一、开篇先想清楚三件事：这个开源客户端凭什么值得装

在动手安装之前，先用三分钟想清楚"你要用它解决什么问题"，这会决定后续所有设置的走向。

它到底是什么Jellyfin Android TV 是 Jellyfin 媒体服务器在电视端的官方客户端。你可以把它理解成一个"遥控面板"：真正的影片、音乐、照片都存在你自己的服务器（NAS、旧电脑、树莓派都行）上，电视端只负责展示和播放。这种"客户端 + 服务器"的架构带来的直接好处是——数据永远在自己手里，不用担心某个平台突然下架或关闭。

它和在线视频平台有什么本质区别

• 没有广告、没有会员墙：看什么、看多久，全由你的媒体库说了算。
• 原盘画质与多声道直通：本地资源可以完整保留码率，配合支持直通的设备，杜比全景声这类高阶音频格式也能原样输出。
• 进度、收藏全同步：同一套账户体系，电视、手机、网页端看到的都是同一份"追剧进度"。

它适合谁

• 家里有 NAS 或旧电脑闲置、想搭建家庭影院的人；
• 反感在线平台广告和会员套路、追求资源自主权的人；
• 需要给老人孩子一个"只看得见该看的内容"的电视界面的人。

想明白这三点，接下来所有的配置就都有方向了。😉

二、第一次开机：连接服务器与账号登录的最快上手路径

这一章解决"怎么装、怎么连、怎么进"三件事，走完这套流程，你就能看到自己的媒体库了。

第一步：把客户端装到电视上Jellyfin Android TV 支持 Android TV、Nvidia Shield、亚马逊 Fire TV 等主流电视盒子设备，安装渠道有三个：

1. 直接在电视自带的应用商店搜索 "Jellyfin"；
2. 在 F-Droid 等开源应用商店下载；
3. 从项目发布页面下载 APK 后手动安装。

动手党如果想尝鲜最新代码，也可以把仓库 clone 到本地自行编译，仓库地址为https://gitcode.com/gh_mirrors/je/jellyfin-androidtv，进入项目目录后执行./gradlew assembleDebug，生成的 APK 位于app/build/outputs/apk/debug目录下，直接传到电视上安装即可。

第二步：连接你的服务器首次启动会进入服务器选择页，有两种方式：

1. 自动发现：只要电视和服务器在同一个局域网内，应用会自动扫描并列出检测到的服务器（discovered_servers_empty表示没有扫描到，需要手动输入）；
2. 手动输入：点击手动添加，填入服务器的 IP 地址或域名。注意局域网内建议填内网 IP，外网访问则用域名加端口。

第三步：登录账号登录方式同样有两条路：

• 账号密码：输入 Jellyfin 服务器上的用户名和密码，这是最常规的方式；
• Quick Connect 快连：在电视上选择 Quick Connect 会生成一组 6 位数字代码，然后在手机或电脑上打开 Jellyfin 任意客户端，进入用户菜单找到 Quick Connect 页面输入这串代码，电视就会自动登录。这个方法在遥控器打字很痛苦的电视上尤其好用。

第四步：开启自动登录走一遍"设置 > 登录"路径，打开自动登录开关。之后每次开机直接进入媒体库首页，跳过输密码的环节，这是电视端体验的第一道"幸福感来源"。如果家里有多台设备共用，也可以不开启，保留每次登录的确认步骤。

连接完成后，首页会按"我的媒体、继续观看"等分区展示你的媒体库内容

三、第一场电影：画质、音效、字幕的黄金三角配置

连接只是开始，真正决定"爽不爽"的是播放体验。这一章按"画面 → 声音 → 字幕"的顺序逐一打磨，每个设置都给出推荐值。

画质三连调：缩放、比特率、刷新率

缩放模式决定了影片如何铺满屏幕。在"设置 > 播放 > 视频"中找到默认缩放模式，主流选项与适用场景如下：

最大流媒体比特率在"设置 > 播放"下，是解决卡顿的第一开关。推荐按网络条件选择：

• 家庭局域网、有线连接：直接拉满上限，本地资源尽量原码率播放；
• 依赖无线 Wi-Fi：建议从 20–40 Mbps 起步，实测卡顿就逐档下调；
• 外网远程播放：按上行带宽酌情降到 4–10 Mbps，保证流畅优先。

刷新率切换在"设置 > 播放 > 高级"里，开启后应用会根据视频帧率自动把电视切换到匹配的刷新率，看 24fps 电影时画面会更跟手、少抖动。如果你的电视支持 HDMI 2.1 等可变刷新率特性，这个开关几乎是必开的。

声音：直通优先，夜间模式救急音频设置集中在"设置 > 播放 > 音频"：

• 音频输出模式：支持直通的设备选"直通"（Direct），把杜比数字、DTS 等编码原样交给功放或回音壁解码，音质最完整；设备不支持多声道时选"下混为立体声"（Downmix to stereo），保证所有设备都能出声。
• 夜间模式：开启后应用会自动压平音量起伏，深夜追剧时不会被突然的爆炸声吓到。属于实验性功能，追求极致的用户可以按需尝试。

字幕：把"看不清"变成"刚刚好"字幕设置在"设置 > 播放 > 字幕"，真正影响观感的是这几项：

1. 字号：根据观看距离选择，客厅 3 米开外建议比默认大两档；
2. 距底部偏移：OLED 电视担心烧屏或字幕被遮挡时，可以适当调高；
3. 背景与透明度：画面亮的时候给字幕加一层半透明黑底，对比度立刻上来；
4. 加粗：投影或大尺寸电视上建议开启，边缘更锐利。

播放过程中可随时呼出控制栏调整进度、音轨、字幕与缩放

小提示：播放中按遥控器确认键也能临时调整缩放和字幕，不必每次退回设置页。

四、把首页长成你喜欢的样子：主题、分区与屏保定制

一套真正顺手的首页，应该做到"开机就是自己想看的"。这一章教你把它调教到位。

主题三选一在"设置 > 自定义 > 应用主题"里可以切换：

• 深色（默认）：最百搭，任何环境都不刺眼；
• 经典翠绿：Jellyfin 传统配色，老用户的情怀之选；
• 柔和紫：色调更暖，适合卧室这类偏温馨的使用场景。

三种主题会在切换后即时生效，建议每种各用一天再定夺。

首页分区自由编排默认首页从上到下是"我的媒体、继续观看、最近添加"等固定模块，但它们其实全部可以自定义。路径在"设置 > 自定义 > 首页分区"，可用的分区包括：

• 我的媒体：电影、音乐、剧集等媒体库入口；
• 继续观看 / 继续收听：影视和音乐各自独立的"看到哪算哪"进度栏；
• 最近添加：新入库内容的快速入口；
• 下一集（Next up）：追剧党的核心阵地；
• 直播电视：有 IPTV 或录制服务时非常实用；
• 正在录制：定时录制功能的状态卡片。

操作方式很简单：为每个槽位选择你想展示的分区，不需要的槽位设成"无"即可。建议首页只保留 3–5 个分区，信息密度太高反而影响找片效率。

屏幕时钟与屏保

• 在"设置 > 自定义"里可以开启时钟显示，并可分别控制"浏览时显示"和"播放时显示"，看片时不想被打扰就只保留浏览时显示；
• 屏保在"设置 > 屏保"下配置：启用"应用内屏保"后，设置闲置启动时间（建议 5–10 分钟），屏保会轮播媒体库里的海报与剧照。家庭场景建议顺手开启最高年龄分级限制，这样屏保只会展示适合全家观看的内容。

定制后的首页在大屏上分区清晰，遥控器上下左右即可快速定位

五、全家共用一个盒子：多账户、家长控制与快速切换

如果这台电视是全家人共用，那么这一章能帮你把"每个人的观影世界"彻底分开。

每个账户都是独立的房间Jellyfin 的多账户不是简单的"换头像"，而是完全隔离的三件套：

1. 观看进度：爸爸的剧看到第三集，切到孩子的账户不会受影响；
2. 收藏与播放列表：各自维护自己的收藏夹和队列；
3. 播放偏好：字幕大小、主题、夜间模式等设置按账户记忆，不用反复调整。

家长控制的实用思路电视端本身不做内容购买，所以"限制"的重点是内容分级。两条路径配合使用效果最好：

1. 屏保年龄分级：前面提到的"设置 > 屏保 > 最高年龄分级"，保证待机画面不露"不合适的海报"；
2. 服务器端账户权限：在 Jellyfin 服务器后台为儿童账户单独设置允许的年龄分级和媒体库范围，电视端会自动遵守，孩子能看到的永远只有被允许的内容。

一键切换账户在主界面右上角点击用户头像，即可弹出账户切换菜单。结合"设置 > 登录"里的自动登录选项，你可以把默认账户设为最常使用的人，其他家庭成员用时再手动切换，兼顾方便与隐私。

六、从看一集到刷一季：连续播放、队列、影院模式的进阶体验

追剧党最关心的体验升级都在这一章：怎样让播放"接得上、停得顺、跳得快"。

自动连播一集不落在"设置 > 播放"里开启队列所有剧集（Queue all episodes），播放剧集时应用会自动把后续剧集加进播放队列。之后你只需要躺着按播放键，一集结束自动接下一集，观影节奏完全不用断。

下一集倒计时自定义"设置 > 播放 > 下一集"里有两个关键项：

• 下一集提示时间：一集快结束时弹出的"即将播放下一集"倒计时，可设 5–60 秒，也可以设为"无限"彻底禁用；
• 显示下一集信息：可切换为带缩略图的样式，画面更直观，确认要不要继续看更方便。

影片未看完自动接续"继续观看"分区会自动记录每个影片的播放位置，中途离开再回来，直接从上一次的位置续播。配合"设置 > 行为"里的闲置超时提示，遥控器丢在旁边一段时间后会弹出"还在看吗"的确认框，防止误触暂停导致进度丢失。

影院模式与跳过片头

• 开启"设置 > 播放 > 影院模式"后，正片开始前会先播放服务器配置的片头、预告片，还原一点点影院的仪式感；
• 在"设置 > 播放 > 媒体分段"里可以为片头设置动作，选择"询问是否跳过"或"直接跳过"，从此片头曲一次都不用再看；
• 顺带一提，"设置 > 播放"里还有快进快退时长的设置项，默认 30 秒，习惯快速刷剧的可以调成 60 秒。

详情页可以查看版本、预告片、演职员信息，并一键加入播放队列

直播电视与定时录制如果你的服务器配置了电视直播源（IPTV），首页的"直播电视"分区会展示频道和节目指南（EPG）。节目单支持按小时向前/向后加载，配合"正在录制"分区，错过直播也能回看。这块属于锦上添花，按需启用即可。

七、卡顿、花屏、没声音？一份电视端自检调优手册

再好的配置也难免遇到问题，这一章按"症状 → 排查 → 解决"的思路给出完整的自检流程。

症状一：播放频繁缓冲、画质自动降低

1. 先确认网络：电视尽量用有线，无线至少连 5GHz 频段；
2. 打开"设置 > 播放 > 最大流媒体比特率"，逐档下调观察是否改善；
3. 如果资源本身码率很高，而服务器转码性能有限，适当降低比特率可以显著减少服务器压力。

症状二：画面花屏、黑屏或编码不兼容在"设置 > 播放 > 高级"中：

• 确认HDR 级别设置是否为自动，手动指定了不支持的级别会直接导致黑屏；
• 软件编解码器开关保持默认即可，强行启用可能反而降低性能；如果设备缺少硬件解码能力，倒是可以开启它让软件解码兜底。

症状三：画面与声音不同步

• 尝试在播放器设置里调整音频延迟；
• 字幕不同步时，可以先检查是否为转码烧录导致，在"设置 > 播放 > 字幕"中调整字幕偏移；
• 如果问题只出现在转码时，可以尝试开启"转码时烧录字幕"，这会牺牲字幕样式但能根治同步问题。

症状四：想定位问题但不知道从哪下手

1. 清除图片缓存：长时间使用后海报缓存可能膨胀，在"设置"中查看缓存占用并一键清理，能解决一部分"首页加载变慢"的问题；
2. 向服务器报告播放能力：在"设置 > 故障排查"里可以把当前设备的解码能力生成一份文档提交给服务器，服务器据此优化转码参数，这是排查兼容性问题的"官方工具"；
3. 崩溃报告：在"设置 > 崩溃报告"里开启"发送崩溃报告到服务器"，并把日志一并上传，这样开发者才能定位问题；日常使用可以关闭以保护隐私。

电视端播放控制针对遥控器优化，进度条与按钮都更容易按准

排查的万能口诀：先网络、后设置、再报告。大部分问题按这个顺序走一遍都能定位到根因。

八、老玩家的隐藏玩法：遥控器重映射与开发者选项

走到这一步，你已经不是新手了。本章解锁几个"藏得比较深"的进阶功能，让操作效率再上一个台阶。

把遥控器变成你的专属遥控器在"设置 > 自定义 > 遥控器按键"里，可以对遥控器上的物理按键进行重映射。操作方法很直接：选中要自定义的功能，然后按一下你想绑定的按键，应用会记住这次对应关系。比如把不常用的按键改成"切换音轨"或"切换字幕"，看片时就不用再进菜单里翻了。建议只改 2–3 个高频按键，改太多反而记不住。

外部播放器接管播放如果内置播放器在某些片源上表现不佳，"设置 > 播放"里的使用外部播放器选项可以让你用设备上安装的第三方播放器打开影片。适合对某种编码格式有特殊偏好的用户，缺点是外部播放器与应用的进度回传可能不同步。

开发者选项里有什么在"设置"底部进入开发者选项，这里集中了实验性功能：

• 刷新率缩放：可选"在电视上缩放"或"在设备上缩放"，用于处理刷新率切换时的画面偏移问题；
• 播放能力相关的高级项：涉及编解码器级别等参数，默认全部保持自动，只有明确知道自己设备支持什么时才去动它。

深挖播放信息播放过程中可以查看当前的实时播放信息，包括码率、分辨率、缓冲状态、编码方式等。这些数据在你调整比特率、排查卡顿时非常有用，建议配合第七章的排查流程一起使用，用数据说话比凭感觉调设置靠谱得多。

九、结语：把电视还给你，把影院留在家

到这里，你已经完整走过了 Jellyfin Android TV 的安装、连接、播放打磨、界面定制、多账户管理、连续播放、故障排查与进阶玩法全流程。这套开源客户端最大的价值，不在于它功能多，而在于它把"媒体中心"这件事的控制权彻底交还给了你——数据在你手里、界面按你的习惯长、账户为每个人独立、体验随设备能力自适应。剩下的，就是打开一部电影，关灯，享受属于你自己的家庭影院。如果这篇文章有帮到你，现在就去把收藏夹里吃灰的那部 4K 原盘打开吧，祝观影愉快！🎬

【免费下载链接】jellyfin-androidtvAndroid TV Client for Jellyfin项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-androidtv