企业官网建设流程全解析

Jellyfin 照片管理实操：四步搭起自建家庭照片库

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

Jellyfin 照片管理可以把散落在手机、相机和旧硬盘里的照片整理成一个私有照片库：按拍摄时间、设备和地点自动归类，在电脑、手机和电视上随时查看，所有文件始终保存在你自己的服务器上。

第一步：三步把照片库搭起来

搭建过程不需要复杂的网络配置，跟着界面操作即可。

1. 安装 Jellyfin 服务。在自己的电脑、NAS 或树莓派上运行服务端，源码方式获取：

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

   也可以使用发行版提供的安装包部署。

2. 添加照片类型媒体库。登录 Web 控制台，进入"媒体库"设置，新建时选择"照片"类型，给库起一个名字（如"家庭相册"），指定照片文件夹的路径，并确认元数据提取选项已启用。

3. 让照片进入目录。照片可以通过 Web 界面直接上传，也可以把相机卡内容通过 SMB/NFS 等网络共享同步过去；如果照片持续产生，配置定时任务定期扫描指定文件夹即可保持同步。

📷 完成这三步后，Jellyfin 会开始扫描目录并为每张照片建立记录。

第二步：Jellyfin 如何读懂每张照片

照片文件内部嵌有一段叫 EXIF 的数据块（记录拍摄参数的元数据），Jellyfin 正是靠解析它来"读懂"照片。核心逻辑在 Emby.Photos/PhotoProvider.cs 中：它调用 TagLib 这个开源文件标签库打开图片，逐字段读取 EXIF 结构。

using var file = TagLib.File.Create(item.Path); if (file is TagLib.Image.File image) { item.CameraMake = image.ImageTag.Make; item.CameraModel = image.ImageTag.Model; item.Width = image.Properties.PhotoWidth; item.Latitude = image.ImageTag.Latitude; }

从代码可以看到解析的机制：TagLib 打开文件后，相机品牌型号、像素尺寸、坐标等信息被逐一取出，写入库中的照片记录。实际提取的字段包括：

• 相机制造商与型号、拍摄软件
• 拍摄日期时间（同时作为库内排序和分年依据）
• 光圈、快门、ISO 感光度、曝光时间、焦距
• 图片宽高
• 经纬度与海拔
• 方向标记（浏览时据此自动旋转，竖拍照片不会横着显示）
• 文件内自带的评分、关键词与标题

解析只对 jpg、png、webp、tiff、avif、cr2 等常见格式生效；如果某张照片的宽高在 EXIF 里缺失，程序会回退到图像处理器直接测量像素，保证尺寸字段不为空。

第三步：把照片用起来

元数据入库之后，照片就不再是一堆文件名，而是可以查询的结构化数据。

分类与筛选。你可以按年份、月份组织照片，也可以按相机型号把设备各归各的；带 GPS 信息的光片能按地点聚合。手动补充的标签和评分同样参与筛选——比如找出所有打了五星标"旅行"标签的照片。

多端访问。🗂️ 照片库支持从多个入口访问：

• 浏览器端提供大尺寸浏览和幻灯片播放，适合家庭聚会时投屏；
• iOS 与 Android 官方客户端支持离线下载，地铁里也能翻照片；
• 智能电视端可以当照片墙使用，遥控器翻页即可。

各端读取的是同一份服务端数据，你在某一端补的标签，其他端刷新后都能看到。

第四步：守住照片——权限配置与备份

照片属于敏感数据，这一环节建议认真配置。

权限如何配置。为每位家庭成员建立独立账户，然后在用户设置中控制两个维度：一是对哪些相册有查看权，二是是否允许下载原图。编辑与删除属于更敏感的权限，建议只对少数管理账户开放，避免有人误删或改动原始照片。Jellyfin 的认证与授权机制保证未登录请求无法触达任何媒体内容。

备份机制。系统级备份由 Jellyfin.Server.Implementations/FullSystemBackup/BackupService.cs 实现，支持定时触发，可选择备份范围，照片库配置与元数据都在覆盖之内。配合"数据只落在本地、原始文件只读"这两点，你的照片在访问层和存储层都有基本保障。

🔐 建议把备份文件放到与媒体库不同的磁盘或设备，防止单点故障连库带备一起丢失。

自建照片库的价值在于三点：照片始终存在你控制的硬件上，元数据让海量照片可被检索，权限与备份让共享变得放心。搭好后坚持定期备份，它就是一份能传下去的家庭档案。

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