在自托管相册这个圈子里，PhotoPrism没有Immich那么热闹，但它是很多NAS老用户的选择。这个GitHub星标4万的开源项目，今年6月底和7月底连着发布了两个重要版本：260601和260728。如果你的Docker还跑在旧镜像上，建议先看完这篇再决定升不升——这次不是堆功能，而是直接对着PhotoPrism用户最容易踩的两个事故场景去的：磁盘被写满、图片解码漏洞。
先说结论：不是所有人都要急着升，但有两类人建议尽快升级，往下看。
磁盘写满保护来了，但默认是关的
长期用PhotoPrism的人，都懂"索引到一半磁盘满了"的恐怖。我在官方GitHub上翻到过2024年就有用户报告空间错误导致PhotoPrism无法启动的issue。扫描或转码时磁盘写满，弹出的报错往往不指向真正原因，比如缩略图生成失败、`no space left on device`，得自己登录主机查磁盘占用才能定位。GitHub今年5月底社区正式提交了这一需求，6月1日的260601版本就把功能落地了：当磁盘剩余空间低于设定阈值时，PhotoPrism自动暂停索引、导入和上传。覆盖面比想象中广——RAW转换、视频转码、数据库备份、HTTP上传、WebDAV同步、ZIP打包下载，所有写盘路径都归它管，不会再闷头把磁盘写到死。这个功能对家庭场景是真刚需。小红书上有家庭用户用一台二手小主机跑PhotoPrism存娃的照片，配置不高，新导入将近3万张照片一天就扫描完了——这种规模的图库，索引中途磁盘写满就是灾难。小红书
但注意最大的坑：这个功能默认关闭。官方解释是网络挂载、FUSE、容器overlay这类文件系统没法可靠探测剩余空间，误报会错误阻断写入。要开启的话，在docker-compose里加环境变量：
```
PHOTOPRISM_STORAGE_FREE=10
```
1到99表示要求保留的最低剩余空间百分比（10就是至少留10%总容量），官方参数说明写得很直白：最低剩余百分比（1-99），达到后暂停索引、导入和上传，-1关闭检查。PhotoPrism官方文档无论设多少，还有一个100MB的绝对下限，哪个先到按哪个算；设0或100以上则用内置默认的1%。触发后日志里会有警告，对应操作被跳过，空间释放后自动恢复。
再补两个细节：这个选项只能由管理员通过环境变量或命令行改，官方特意没把它放进Web设置界面，升级后别去设置页里找；它和`PHOTOPRISM_FILES_QUOTA`（限制索引文件总大小，单位GB，始终生效）是两套独立机制，别搞混。
如果你的PhotoPrism跑在本地磁盘上（NAS内置存储池、直挂的SSD/HDD），建议升级时顺手把阈值设了；用SMB等网络挂载的，先确认该挂载点的剩余空间读取是否可靠再开。
安全修复，才是这次该升级的硬理由
260601是一次以安全为主的维护版本，其中一条值得单独说：负责HEIC/HEIF解码的libheif从v1.21.2升级到v1.22.2，一次修掉17个CVE。PhotoPrism官方文档HEIC是iPhone照片库的主力格式，PhotoPrism索引时必然要解码它。如果你的相册开放了公网访问，或者经常导入外部来源的图片，解码层漏洞属于"处理一张恶意图片就可能中招"的类型。另外，Ubuntu基础镜像里的Pebble组件也被移除（CVE-2026-39821），用户资料接口的授权校验同步做了加固。
今年1月底飞牛OS爆出严重安全漏洞，其内置的内网穿透服务FN Connect成为主要攻击入口之一，暴露公网的设备被批量打穿。知乎那件事之后，自托管圈的安全神经明显绷紧了。PhotoPrism是一个整天在读图片文件的应用，图片解码库的风险面比多数人想象的大。
260728加了什么，免费版能不能用
7月底的大版本260728，有几个值得一看的点：
360°全景照片和视频支持交互式浏览了。PhotoPrism官方文档我核对了官方版本对比页，360°全景列在所有版本的支持列表里，免费社区版也有。缩略图和视频分辨率上限同步提到16K，放大看全景细节不糊。
PDF支持内联查看，多页文档不用下载就能直接读。
XMP里的GPS坐标和人脸区域可以导入了，sidecar文件和内嵌XMP都支持，从Lightroom等软件迁移的人会比较受用。
AI侧给OpenAI兼容接口加了service_tier选项，能降低API调用成本；Ollama的默认配置和限流重试也做了修复。
设置界面整体重组，新增了无障碍（Accessibility)分区，比如可以禁止悬停自动弹出操作菜单。
升级风险高不高？我去查了发布后的GitHub情况：260728上线以来新增issue只有19个，大部分是功能请求和改进建议，没有集中的bug报告；8月21日有用户反馈网页端和CLI的人物搜索结果数量不一致，属于从旧备份恢复数据库后的边界情况，当天就被关闭了。GitHub从稳定性看，这个版本可以放心上。
还停在老版本的，这次升级会顺带拿到这些
不少人可能还停在去年底的版本。现在升到260728，会一并拿到：
重新设计的信息侧边栏（Info Sidebar）：全屏查看器里直接改元数据、相册和标签，还能手动给人脸打标签。PhotoPrism官方文档
人脸识别换成ONNX管线，彻底替代了老的Pigo检测器（这是260523的更新，顺带还有拖拽上传、标签筛选的NOT/AND运算符、HEIC/AVIF原生读取、分层TIFF和PSD支持）。
260305让Ollama可以用`OLLAMA_BASE_URL`和`OLLAMA_API_KEY`直接配置，接本地模型更省事。
谁现在就该升，谁可以等
对号入座：
尽快升：相册开放了公网访问、或经常导入外部图片的（安全修复是硬需求）；磁盘余量紧张的NAS用户（升级同时把磁盘保护配上）。
可以观望：纯内网使用、磁盘宽裕、现有功能够用——这次升级对你不是必选项，等下个版本一起跟也行。
别顺手追latest：把版本号锁住，换版本前对照release notes确认。
升级前的检查清单，两步。先给数据库做一份转储——PhotoPrism默认每天自动备份一次数据库、保留最近3份，手动备份用这条命令：
```bash
docker compose exec photoprism photoprism backup -i -f
```
官方对备份的最低要求是"原片文件夹+索引数据库"，建议升级前按这个标准过一遍。PhotoPrism官方文档
然后拉新镜像重启，看日志确认正常再投入使用：
```bash
docker compose pull && docker compose up -d
```
originals目录和storage目录也要纳入日常备份计划——缩略图、sidecar文件和配置都在storage里，一起备份能省掉重新生成的时间。
最后说给还在观望的人：这个项目依然很活跃（写这篇的前一天仓库还有新提交），但稳定版节奏大概每一到三个月才发一个，从今年3月5日、5月23日、6月1日到7月28日就能看出来。PhotoPrism官方文档错过这波，旧版本一停又是好几个月。既然选择了自托管，不如趁这次双版本更新，把相册好好升一次级。
