Jellyfin 自托管媒体服务器30 分钟搭好全家共享影音台【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin上个月朋友搬来一块 400G 的硬盘里面全是下载好的电影问我这堆文件能不能让全家在电视和手机上随便看。我当天下午就用 Jellyfin 搞定了服务跑在客厅那台旧电脑上电影丢进固定文件夹之后谁想看打开客户端就能播。Jellyfin 是一款完全免费、开源的自托管媒体服务器把你硬盘里的电影、剧集、音乐、照片整理成可检索、可串流的媒体库数据全部留在自己的机器上没有订阅费。跑起来之前先准备这三样先确认机器。Linux、Windows、Mac 的旧电脑都行真正的瓶颈是磁盘读取速度和转码能力全家只是直放 1080pi3 加 4G 内存就绰绰有余想转 4K建议选近几年的 Intel i5带 QuickSyncIntel 的硬件编码或较新的 NVIDIA 卡。第二件事是端口默认的 Web 管理页在 8096确认机器上没被占用。第三件事是规划两个目录一个放配置一个放媒体。媒体目录定下来就别挪挪一次就得全量重扫库。如果机器是 NAS配置目录放配置分区、媒体放数据分区后面备份也顺手。这三样花十分钟不做以后受罪。三条路把 Jellyfin 服务拉起来我一般直接上 Docker一条命令docker run -d --name jellyfin --restartunless-stopped \ -p 8096:8096 \ -v /data/jellyfin/config:/config \ -v /data/media:/media \ jellyfin/jellyfin:latest这条命令在做的事起一个容器跑服务、暴露 8096 端口、把配置和媒体两个目录挂载进去其余都不用管。首次启动要初始化配置等一分钟再刷新页面。以后升级就是换个镜像重建容器媒体不受影响。Debian/Ubuntu 上也可以跳过 Docker装原生包sudo apt update sudo apt install jellyfin sudo systemctl enable --now jellyfin第一条安装第二条开机自启并立即运行。服务默认跑在jellyfin用户下记得给它媒体目录的读权限这个我踩过两次。第三条路是源码编译适合想深挖的人从 gitcode 仓库 https://gitcode.com/GitHub_Trending/je/jellyfin 拿到源码后执行dotnet build --configuration Release产物在Jellyfin.Server/bin/Release/下。不开发就别纠结这条路。第一次打开页面该做什么浏览器里输服务器 IP 加 8096第一屏是创建管理员账户。设好用户名和密码建议强密码这个账号等于全家的钥匙进主界面后它会立刻引导你添加媒体库。流程很顺选内容类型电影、剧集、音乐、照片挑目录保存开始扫描。我建议一次只建一类库电影、剧集、照片分开别全塞一个文件夹指望它自己分辨。扫描花几分钟完成后海报墙和季度列表就自动出来了。这时候别急着翻设置默认值对局域网来说完全够用。库建好后给每个家庭成员开一个账号播放权限、分级限制都能按人头设小孩看不到不合适的东西。让媒体库被正确识别文件命名里我踩过的坑Jellyfin 识别内容几乎全靠文件名和目录结构不读文件内容。所以命名是生命线电影写电影名.年份.1080p.mkv最稳剧集按剧名/Season 01/剧名 S01E01.mkv摆。想确认具体规则命名解析器就在 Emby.Naming/几个文件就能看清它认哪些格式。扫描后没认出来的项十有八九是命名问题不是 bug。说实话这里有个坑年份后面加个「重制版 2」、用全角符号年份就解析不出来海报拉空条目直接落到未分类里中文同名字幕会自动挂上英文字幕后缀乱写则是碰运气。我的做法是导入前先批量重命名一遍扫完抽查再改一轮这十分钟省掉一下午逐条点修正。真不想改的话也可以在界面里手动修正十条以内能忍上百条就别想了。播放不顺畅时先查这三件事按这个顺序查覆盖大部分情况看播放状态播放时是「直接播放」还是「转码」。如果是转码且 CPU 打满说明要么参数太高要么加速没生效。核对硬件加速类型播放 → 转码设置里选对Intel 是 QuickSync、NVIDIA 是 NVENC、AMD 是 AMF。选错类型等于让 CPU 白干活卡顿是必然的。看网络链路局域网基本不出事外网走反向代理时确认带宽够不够、长连接没被代理掐断。榨干性能转码和缓存只动两个地方第一条原则是尽量直放。大多数文件根本不需要转码客户端能直放时服务器只搬字节CPU 完全不动。所以「优化性能」多数时候是让直放生效而不是让转码更快。真到了要转码最有用的配置就是硬件加速类型选对这一项之外别乱动旋钮。存储上我给一条建议配置和缓存目录放 SSD。数据库是个很小的 SQLite 文件但随机读写频繁放 HDD 上首次扫描和元数据加载会明显变慢。插件和二次开发的入口内置的元数据插件都放在 MediaBrowser.Providers/Plugins/ 下Tmdb、Omdb、MusicBrainz、AudioDb每个文件夹就是一个插件。比如 OMDb 这个专门给电影条目补全信息想自己写插件照抄现有插件的目录结构就行provider 类负责抓数据saver 负责落盘。更深的二次开发看 Emby.Server.Implementations/任务调度、库扫描、会话管理都在那读完这两个目录基本就摸清了服务端全貌。遇到问题去哪找资源清单官方文档搜 Jellyfin 文档站Quick Start 和播放排障两篇最值得先读社区搜 Jellyfin 论坛和 Matrix 社区房间常见部署问题基本都有人问过了相关工具想要库自动更新找个定期调用官方库刷新接口的脚本即可元数据源用 TMDB 和 OMDb 的公开 API 就够【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考