如何免费用 Jellyfin 搭建家庭照片库:3 步上手加避坑指南

如何免费用 Jellyfin 搭建家庭照片库:3 步上手加避坑指南

【免费下载链接】jellyfinThe Free Software Media System - Server Backend & API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin

你是不是也翻遍手机相册,却找不到去年夏天和女儿在公园的那张照片?Jellyfin 是一个开源免费的媒体服务器,除了影视,它还能把一个普通文件夹变成全家都能访问的照片库,不收费,照片永远留在你的设备上。

📌 家庭照片常见的三个痛点

• 手机快满了,照片想搬去电脑却一直没动手。
• 网盘要年费,照片其实存在别人的服务器上。
• 同一张照片在手机、电脑、NAS 上各有一份,找起来像翻箱底。

🗂 Jellyfin 照片库的 6 个实用能力

• 元数据自动提取:拍摄时间、相机型号、GPS 坐标、关键词都从 EXIF 里读出来,不用手动打标
• 按拍摄时间排期:照片自动归入年份和日期,找"去年旅行那张"不再靠记忆翻
• 多设备共用:浏览器、手机、电视连的是同一个库,一处整理,处处生效
• 本地存放:照片不经过任何第三方服务器,断网也能看
• 原片下载:任意设备拉取无水印原图,画质不打折
• 整库备份:配置、元数据、数据库打包成压缩文件,一键恢复

🚀 安装配置步骤:装好 → 配好 → 用起来

1. 装好:把服务器跑起来

按官方说明部署到一台能长期开机的设备,家用电脑、迷你主机或 NAS 都行,详见 README.md。想从源码构建的话,克隆代码即可:

git clone https://gitcode.com/GitHub_Trending/je/jellyfin

2. 配好:建一个"照片"类型的媒体库

打开网页管理界面新建媒体库,类型选照片,对应代码里 Jellyfin.Data/Enums/CollectionType.cs 中的Photos。填上照片所在文件夹即可,EXIF 解析默认开启,无需额外勾选。

3. 用起来:浏览、下载、自动收新片

扫描完成后,照片按拍摄时间自动排好。任何设备登录 Jellyfin 客户端就能浏览和下载。以后把新照片丢进被监控的文件夹,库会自动收录,不用手动导入。

🔍 核心模块解析:元数据提取与系统备份

自动"图书管理员"。Emby.Photos/PhotoProvider.cs 是照片元数据的来源:它用 TagLib 解析 jpg、webp、avif 等格式的 EXIF,把光圈、快门、ISO、焦距、经纬度、拍摄时间逐项存进 Photo 实体。以前你只能按文件名找照片,现在"去年在京都拍的""iPhone 夜景"都成了可筛选的条件。

真能救命的备份。BackupService.cs 把配置、数据和数据库打包成带 manifest.json 的压缩包;恢复时先校验版本——新版备份不允许灌进旧版,避免"恢复完服务器起不来"。

⚠️ 常见问题解决:照片库 4 个高频坑

• 部分照片没有拍摄日期→ 截图或转存件没有 EXIF,会按文件修改时间排序;想要准确时间线,优先用原始文件。
• 海量照片首次扫描很慢→ 按年份拆成子文件夹,或选低峰期触发扫描;缩略图是增量生成,第二次打开会明显变快。
• 备份文件恢复不了→ 恢复逻辑会比对版本号,先升级 Jellyfin 到与备份相同或更新的版本再操作。
• 网络共享里的照片重启后"消失"→ 确认 NAS 挂载完成后再启动服务,否则库里看不到文件。

🌟 上手前最后确认

✅ 免费开源,没有订阅费 ✅ 照片存本地,隐私自己掌控 ✅ EXIF 自动解析,时间、地点、器材都可筛选 ✅ 多设备浏览,原片随时下载 ✅ 整库备份,一键恢复

如果电脑里已经堆了一堆照片,今晚就把它搬进 Jellyfin,明早手机上就能刷到自己的全家福。

【免费下载链接】jellyfinThe Free Software Media System - Server Backend & API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin