📂
媒体扫描
根据文件夹命名与文件结构自动识别电影、季与集、专辑与曲目，读取嵌入或同目录元数据，拉取封面与简介，生成可筛选、可排序的库界面，支持后续增量扫描与手动纠正。
平台面向个人与小型团队自建媒体库场景，支持将本地磁盘中的电影、电视剧集、音乐专辑、有声书、漫画与照片统一扫描入库。元数据与封面可自动匹配，形成按类型、年份、艺人与合集浏览的结构化视图，便于长期维护与检索。
用户在浏览器或专用客户端中登录本地服务器后，即可浏览库内容并选择直连播放或转码播放。播放进度、收藏与偏好按账户隔离保存。远程访问需自行配置网络通道，数据与认证流程均留在用户可控环境内，减少对外部服务的依赖。
从入库到多端播放的完整链路，均围绕自托管场景设计。
根据文件夹命名与文件结构自动识别电影、季与集、专辑与曲目，读取嵌入或同目录元数据，拉取封面与简介，生成可筛选、可排序的库界面，支持后续增量扫描与手动纠正。
在客户端能力允许时优先直连原始文件，减少转码开销。支持常见容器与编码组合，播放进度实时回写，方便跨设备续看同一内容。
在设备不支持原始编码时启用硬件加速转码，兼容Intel、NVIDIA与AMD方案。可显著降低CPU负载，适合多路并发或高码率片源的流畅输出。
创建独立账户与权限，每位用户拥有独立的观看记录与收藏。管理员可按库分配访问范围，满足家庭成员或小范围共享的隔离需求。
通过官方与社区插件补充字幕、元数据源、片头跳过、认证对接与报表等能力。插件独立安装与启停，不影响核心服务的稳定性与升级路径。
覆盖浏览器、桌面、手机、电视与游戏主机等常见终端。官方与社区客户端均可连接同一服务器，实现进度同步与统一播放控制体验。
以下卡片展示平台常见内容形态与字段结构，便于理解库视图呈现方式。
2026年11月12日，在城南资料室，化名林澈的整理员完成高清版本校验，将片源移入电影库主目录，系统随后自动匹配海报与演职员信息并生成可播放条目。
2026年11月11日晚间，在宿舍局域网环境，化名阿北的用户完成第三季文件命名规范调整，触发增量扫描后各集按季归入剧集库并保留观看进度。
2026年11月13日上午，在工作室工作站，化名青禾的管理员将无损曲目与封面写入音乐目录，平台识别艺人与曲目列表后生成可播放的专辑页。
2026年11月12日下午，在书房书架旁，化名周予的读者将电子书文件放入图书目录，系统读取元数据后在作者与合集视图中建立可阅读条目。
2026年11月10日，在山区临时工作站，化名老陈的拍摄者将成片拷贝至移动硬盘并接入服务器，平台完成入库后生成带章节标记的播放页。
2026年11月13日清晨，在公寓客厅电视前，化名小林的用户通过电视客户端继续观看未完结剧集，进度从手机端自动同步并显示下一集入口。
2026年11月11日，在办公室工位，化名阿凯的收藏者将现场录音与曲目列表整理进音乐库，平台按专辑结构展示并支持连续播放与收藏标记。
2026年11月12日傍晚，在家庭客厅投影前，化名阿敏的用户打开照片库浏览近期旅行相册，平台按日期与地点聚类展示并支持全屏幻灯播放。
从架构到客户端的六项稳定特征，说明自托管场景下的实际表现。
媒体文件、元数据与用户账户均保存在用户自行部署的服务器上，不依赖外部云端账号即可完成登录与播放。远程访问通道由用户自行搭建，数据流向与权限边界清晰，适合对隐私与数据归属有明确要求的使用场景。
核心播放、硬件转码、多用户与官方客户端均不设置付费解锁门槛。用户在合规使用自有片源的前提下，可完整使用转码、直播电视插件与库管理能力，无需为基础功能额外付费或绑定商业账户。
在具备对应显卡或核显的环境中，可启用Intel Quick Sync、NVIDIA NVENC等加速方案，降低高分辨率与多路并发时的CPU压力。Docker部署时通过设备映射即可让容器使用宿主机加速能力，适配常见家用与小型服务器硬件。
浏览器、桌面端、Android与iOS、Android TV、Fire TV、Roku、Xbox及部分智能电视均有官方或成熟社区客户端。同一账户下的播放进度与收藏可跨端同步，减少在不同设备间重复寻找与记录的成本。
官方仓库与社区贡献的插件可扩展元数据、字幕、片头检测、认证与报表等能力。插件以可选组件形式存在，用户可按需安装与停用，在保持核心服务简洁的同时获得针对性增强，并跟随社区持续更新。
服务器与主要客户端以开源许可发布，代码与构建过程可公开审查。用户可自行编译、修改或审计行为，部署方式涵盖Docker、原生包与源码构建，便于纳入既有运维流程与安全评估体系。
清晰的文件夹与文件命名能显著提高自动识别准确率。电影通常采用“片名 (年份)”结构，剧集则按“剧名/Season XX/集文件”层级存放，音乐按艺人与专辑组织。平台扫描时会结合文件名、同目录nfo或嵌入元数据生成库条目。若命名混乱，易出现识别错误或重复条目，需在入库前统一规范。对于混合内容目录，可拆分为多个媒体库并分别指定类型，避免电影与剧集规则互相干扰。长期维护时，建议将原始文件与转码缓存、元数据数据库分盘存放，原始片源使用大容量机械盘，系统与缓存使用固态盘，以平衡成本与随机读写性能。
直连播放在客户端支持原始编码时最为省资源，一旦编码或容器不被支持，平台会启动转码。硬件转码依赖显卡或核显的编解码能力，Intel核显与NVIDIA消费级卡在家用场景中较为常见。部署前需确认驱动与容器设备映射是否正确，否则会回退到软件转码并占用大量CPU。多路并发或4K片源对加速单元压力更大，可在设置中限制同时转码路数，并观察温度与功耗。图书与漫画主要消耗存储与元数据解析，对转码依赖较低，可与影音库共用服务器但单独规划存储路径。定期检查转码日志有助于发现不兼容的编码组合，并针对常用客户端优化直连优先策略。
平台默认面向局域网使用，远程访问需用户自行配置反向代理、HTTPS证书或虚拟专用网络。不建议将管理端口直接暴露在公网。通过反向代理可统一域名与证书，并配合访问控制与失败锁定策略降低风险。多用户场景下，应为每位成员分配独立账户并限制可访问的媒体库，避免共享单一管理员账户。备份应覆盖配置目录、元数据数据库与插件数据，媒体文件可按需增量备份。版本升级前建议完整备份并阅读变更说明，尤其在涉及数据库结构或客户端兼容性调整时。遵循最小权限与定期审计原则，可使自托管环境在可控成本下保持稳定与可恢复性。
近期版本与客户端更新摘要，便于跟踪功能变化。
电视端客户端完成设置页重构，支持更多字幕格式的直接渲染，并改进外部播放器衔接逻辑。用户可在设置中选择内置或第三方播放器，部分播放器可回传进度。建议在升级前确认服务器版本满足最低要求，并检查字幕与外挂轨道的显示效果。
近期稳定版将图书与漫画元数据读取及阅读界面进一步整合进核心，减少对独立插件的依赖。作者、合集与文件夹视图可用，阅读端统一全屏与翻页行为。已有图书库的用户可在升级后重新扫描以获得更完整的元数据展示。
转码链路跟随上游编解码组件更新，优化部分GPU上的缩放与色调映射表现。使用硬件加速的用户在升级后可复查转码预设与设备映射，确认高分辨率与HDR相关路径仍按预期工作，并关注日志中的兼容性提示。
手机客户端对下载管理与车载音频场景进行界面与逻辑调整，播放稳定性与进度同步有所改进。依赖离线缓存的用户可在更新后重新检查下载队列与存储权限，确保常用片单在无网络环境下仍可访问。
社区持续贡献元数据源、字幕与认证相关插件，部分插件适配新版服务器接口。管理员在安装第三方插件前应确认来源与权限范围，并在测试环境验证后再用于生产库，避免与核心服务产生冲突。
官方文档更新Docker环境下的显卡与核显映射示例，以及常见发行版的安装脚本说明。新部署用户可按文档完成设备节点映射与权限配置，减少因映射缺失导致的转码回退问题，并建立基础的备份与升级检查清单。
来自自托管用户的实际使用感受摘录。
将多年积累的电影与剧集统一入库后，按类型与年份浏览变得清晰。电视与手机进度同步稳定，家庭成员各自账号互不干扰，日常使用成本可控。
硬件转码在核显上表现符合预期，多路播放时CPU占用明显下降。命名规范调整后识别准确率提升，偶发需手动纠正的条目也可快速处理。
从其他方案迁移后，本地账号与无强制云登录更符合使用习惯。插件补充字幕与元数据后，库的完整度提高，文档对容器部署的说明也足够清晰。
音乐库与播放列表满足通勤听歌需求，手机端续播可靠。图书入口在新版本中更完整，阅读界面与影音库并列后，资料类内容也便于集中管理。
小团队共享同一服务器时，权限按库划分很实用。远程通过自建通道访问，数据仍留在自有环境，备份脚本与版本升级流程已形成固定习惯。
电视客户端在客厅使用频率最高，操作路径简单。外挂字幕与多音轨切换正常，偶尔遇到冷门编码会触发转码，整体流畅度可接受。
开源许可与可审计性是选择该方案的主要原因。自行编译与Docker部署都尝试过，长期运行稳定，社区对问题反馈的响应也比较及时。
照片库按日期聚类后便于回顾旅行记录。与影音共用同一套账户体系，减少多套系统登录的麻烦，存储规划时把原图与缓存分开即可。
剧集自动按季归集后，追更与补旧都更省事。跳过片头类插件在部分剧集上有效，未覆盖的可手动快进，整体仍比分散文件管理高效。
首次部署按文档完成设备映射后，转码路径一次跑通。后续主要工作是规范命名与定期备份，日常维护量比预期要低，适合长期挂机使用。
围绕入库、转码、客户端与安全边界的常见问题。
在服务器端添加媒体文件夹路径后，平台会自动识别电影、剧集、音乐与图书结构，抓取元数据与封面，生成可浏览的库视图。扫描过程支持增量更新，后续新增文件可触发重新识别。命名规范越清晰，识别准确率越高。
平台支持Intel Quick Sync、NVIDIA NVENC与AMD相关加速方案。服务器需具备对应显卡或核显，并正确安装驱动。Docker部署时需将设备节点映射进容器。开启硬件转码可显著降低CPU占用，适合多路并发或高分辨率片源。
官方与社区客户端覆盖浏览器、Windows与macOS桌面、Android与iOS手机、Android TV与Fire TV、Roku、Xbox以及部分智能电视系统。用户可根据设备选择对应客户端，实现统一账号下的进度同步与播放控制。
平台以本地服务器为核心，账号与认证完全由用户自行管理，不强制绑定任何第三方云账号。远程访问可通过反向代理或虚拟专用网络自行配置，数据与播放行为留在用户控制的环境中。
官方仓库与社区插件可补充元数据源、字幕下载、跳过片头、主题曲检测、认证对接与报表等功能。插件以独立组件形式安装，不影响核心服务稳定性，用户可按需启用或关闭。
近期版本将图书元数据读取与阅读界面整合进核心服务，支持从OPF与ComicInfo等文件提取信息，提供作者、合集与文件夹视图，阅读端支持全屏与滑动翻页，形成与影音并列的内容入口。
平台支持多用户账户，每位用户拥有独立的播放进度、收藏与偏好设置。管理员可分配媒体库访问权限，家庭成员或共享对象可在同一服务器上各自保留观看历史，互不干扰。
Docker Compose适合多数家庭与小型服务器环境，便于版本升级与硬件设备映射。原生包适合希望直接使用系统资源的Linux主机。无论何种方式，建议为元数据与转码缓存配置固态存储，媒体文件放在大容量磁盘。
jellyfin定位为完全开源的自托管媒体系统，面向需要将个人或小团队影音与图书集中管理并多端播放的用户，强调本地掌控与无强制订阅。
提供媒体扫描入库、直连与硬件转码播放、多用户进度同步、插件扩展以及覆盖浏览器与主流终端的客户端连接能力。
满足将分散片源统一整理、在电视与移动端续看、在无外部账号条件下完成家庭或小范围共享，以及需要可审计开源架构的部署需求。
功能不设付费门槛，数据与认证留在自有环境，硬件转码与客户端覆盖面可满足日常影音库运维，社区与文档持续更新便于长期维护。