30 分钟搭好私人影音库Jellyfin 家庭媒体中心部署指南【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin周六晚上孩子在平板上找动画片而整部片源还躺在你电脑的硬盘里。Jellyfin 是一个自由开源的家庭媒体服务器把电影、剧集、音乐、照片放到一台常开的机器上电视、手机、平板直接连过去看不用来回倒文件也不用第三方网盘所有数据留在家里。整个过程大概 30 分钟跟着走就行。选一条部署路径先判断你要走哪条路Docker 路线把运行时依赖全部打进镜像装完即是成品升级也只是拉新镜像包管理器路线适合不想装 Docker 的 Windows、Linux 机器编译分支留给想读源码、改行为的人普通用户可以跳过。机器按需求分三档档位CPU内存存储典型用法轻量至少 2 颗 2.0 GHz 核心2 GB50 GB 硬盘即可1-2 人看 1080P几乎全直连标准4 核 3.0 GHz支持硬加速8 GB500 GB SSD 起4K 直连、多设备并发性能6 核 3.5 GHz支持硬加速16 GBSSD 4 TB 机械盘多人同时在线且常转码怎么选按最多的同时在线人数 最差的播放格式定档。只有一台电视、片源都是 H.264轻量档就够。Docker 一键启动装好 Docker 后把下面这段按自己路径改一改直接贴进终端docker run -d --name jellyfin --restart unless-stopped \ -e TZAsia/Shanghai \ -p 8096:8096 -p 8920:8920 \ -v /opt/jellyfin/config:/config \ -v /opt/jellyfin/cache:/cache \ -v /mnt/media:/media \ --device /dev/dri:/dev/dri \ jellyfin/jellyfin:latest--device那行是给 Intel/AMD 核显硬件加速用的没有对应硬件就删掉。跑通后的成功标志是日志里出现Server running且浏览器能打开http://你的IP:8096。首次进入会提示创建管理员账号这一步完成才叫部署完。各系统的差异很小系统推荐做法LinuxDocker 或发行版软件源仓库 deployment/ 目录里还有现成的容器模板可参考WindowsDocker Desktop 或 PowerShell 包管理器macOSDocker 容器媒体目录放本机卷再挂载首次启动后的 3 件事服务跑起来只是开始真正能用还要做三件事。第 1 件媒体库 5 分钟建好控制台进入「库」→「添加媒体库」选类型电影/剧集/音乐/照片指向挂载好的/media下对应子目录元数据语言选中文确认后系统立即开始扫描。扫完每部片子自动配上海报、简介、演员表这就是 Jellyfin 媒体库设置的全部动作——它靠文件名和内部元数据认片子所以文件夹怎么放很关键。Jellyfin 家庭媒体中心媒体库界面第 2 件硬件加速三步开启「播放」页签 → 「硬件加速」选你的显卡NVIDIA 选 NVENCIntel/AMD 核显选 QuickSync/VA-API→ 「转码质量」选「均衡」→ 保存并重启。这一步的意义Jellyfin 优先让设备直接播放原片只有在格式不兼容时才转码而 Jellyfin 硬件加速就是把转码从 CPU 卸到显卡上CPU 占用从 80% 掉到 10% 以内。Jellyfin 硬件加速转码设置界面保存后跑一下这条命令确认容器里的 ffmpeg 能看到硬件编码器docker exec jellyfin ffmpeg -hide_banner -encoders | grep -iE nvenc|qsv|vaapi输出里出现h264_nvenc、h264_qsv或h264_vaapi之类的名字即为生效。第 3 件把门关上每个家庭成员单独建账号权限按需勾选别共用管理员「网络」页签把局域网访问和远程访问分开管远程只开给需要的 IP 段要对外访问就先配 HTTPS「网络」页签上传 Lets Encrypt 证书、打开 HTTP 自动跳转。原因一句话8096 端口指向你的全库弱密码和裸露端口是最常见的翻车点。5 个最常被问到的问题Q18096 端口被占了怎么办把-p 8096:8096改成-p 8097:8096重建容器即可浏览器改用 8097 访问。容器内部端口始终是 8096改的只是宿主机那一侧所以不用动任何配置。Q2手机上看要转码、还卡优先让设备直连原片。两个方向在「播放」里确认对应设备已支持直连格式或者在「设备」页签里给这台设备单独调整直连规则。实在要转码就用上文的 Jellyfin 硬件加速把负担移给显卡。Q3文件名怎么放才认得全电影用片名 (年份).扩展名比如流浪地球 (2019).mp4剧集按「剧名/第 1 季/剧名 S01E01.扩展名」放。扫描器主要靠这个模式认片认集命名乱就会漏扫或识别错。Jellyfin 媒体库电影海报墙示例Q4升级会丢数据吗不会。库数据都在挂载的卷里Linux 默认在/var/lib/jellyfinDocker 下就是/config映射的目录。升级 拉新镜像、重新 run几秒的事升级前先跑一次「系统」→「备份」做个快照更稳。Q5想在外网访问怎么弄路由器做端口转发 控制台网络页签里开 HTTPS同时配强密码和 IP 白名单。没有公网 IP 可以用内网穿透工具。核心原则远程入口永远是加密的、受限的别把 8096 裸挂公网。接下来可以做什么手机、电视装客户端同一账号多设备同步播放进度开启 Trickplay快进时显示缩略图画面找片段快很多装一两个官方插件补数据源或字幕把完整系统备份纳入定期任务数据多一分保障。Jellyfin 的更新节奏很快遇到文档没覆盖的行为直接翻一遍 Emby.Server.Implementations/ 这类核心目录比自己猜要快。如果你愿意投入更多时间官方渠道常年欢迎提 bug、翻译界面和写插件——部署完只是开始。【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考