Photoview 是什么？
Photoview 是一款为摄影师设计的自托管网页相册，它的扫描器读取服务器上的文件夹，并把各级目录变成相册。 项目自称“面向自托管个人服务器的相册”，代码以 AGPL-3.0 许可托管在 GitHub 上。
每个用户创建时都会绑定服务器上的一个路径，只能看到该路径下的媒体文件。README 附有公开演示站点的链接。
获取方式
Photoview 是需要你自己安装的服务器程序；文档推荐的方式是 Docker Compose，没有桌面或手机安装程序。
选项 | 获取方式 |
|---|---|
| Docker Compose | Compose 示例：复制 .env、compose 文件和 Makefile，修改后运行 make all |
| 其他平台 | README 列出了 Arch Linux AUR、NixOS、Unraid、YunoHost、TrueNAS 和 EmbassyOS，项目仅提供有限支持 |
| 价格 | 免费，AGPL-3.0，自托管 |
| 官网 | photoview.github.io |
| 隐私政策 | 在官网和 README 中都没有找到隐私政策页面 |
| 源代码 | github.com/photoview/photoview |
| 公开演示 | photos.qpqp.dk，登录信息见 README |
评测的版本：2.4.0，发布于 2024 年 6 月 23 日，是最新的带标签版本；GitHub 上没有为它列出可下载文件。master 分支的提交持续到 2026 年 10 月 29 日，Docker Hub 上的 latest 和 2.4.0 标签也在当天最后一次推送。需要终端和 Docker。
运行要求
README 没有给出内存或 CPU 的最低要求，只说明了支持的平台、数据库以及 Docker 版本的时间范围。
运行环境
- 来源说明:
- 过去一年内发布的 Docker Engine；Debian 12 或 13，或 Ubuntu LTS 及较新的短期支持版本
数据库
- 来源说明:
- SQLite、MariaDB 或 PostgreSQL 17 或 18
媒体处理
- 来源说明:
- RAW 处理和视频处理都可通过环境设置分别关闭
视频加速
- 来源说明:
- 可选 qsv、vaapi 或 nvenc；项目只在 Intel 芯片上验证过 qsv
以上为 README 的说明；PromptQuorum 没有测量内存、CPU 或索引耗时。
上手步骤
以下步骤依据 README 中的 Docker 指南，PromptQuorum 没有实际执行过。
- 1安装 Docker
Why it matters: 在存放照片的服务器上安装 Docker 和 Docker Compose。 - 2复制示例文件
Why it matters: 从 Compose 示例文件夹下载文件，重命名为 .env、docker-compose.yml 和 Makefile，并按你的路径和数据库修改。 - 3让媒体可读并启动
Why it matters: 运行 make readable，使容器能读取你的媒体文件夹，然后运行 make all。 - 4创建管理员并扫描
Why it matters: 打开 8000 端口，在设置向导中填写用户名、密码和照片路径（默认 /photos），然后在设置中点击 Scan All。
主要功能
以下各项均来自项目官网或 README；PromptQuorum 没有测试过其中任何一项。
- 分享。 相册和单个媒体都可以通过公开链接分享，也可以设置密码保护。
- 地图。 EXIF 数据中带 GPS 坐标的照片可以显示在地图上；按示例配置，这需要你自己创建一个免费的 Mapbox 访问令牌。
- 访问控制。 据 README，媒体文件由 Cookie 令牌保护，密码经过哈希处理，API 采用严格的 CORS 策略。
AI 功能及运行位置
人脸识别是项目列出的唯一 AI 功能，它使用 go-face 库，在 Photoview 服务器内部运行。
- 检测与分组。 据 README，扫描器会检测照片中的人脸，并把同一个人的照片分到一组；代码基于 go-face，这是 dlib 的一个开源 Go 封装。
- 模型文件。 用于人脸检测、关键点和识别的三个 dlib 模型文件位于仓库的 data/models 文件夹，其路径可配置。
- 运行位置。 人脸检测代码直接调用本地库，在我们读过的文件中没有网络请求。
- 关闭方式。 将 PHOTOVIEW_DISABLE_FACE_RECOGNITION 设为 1，即可跳过该功能。
数据流向与隐私
Photoview 是自托管的，因此除非你分享照片或启用地图，照片都留在你运行的服务器上。 README 警告说，它自带的基础用户认证不足以保护私人媒体免受互联网上恶意攻击者的侵害，并建议在对外开放前先配置防火墙、VPN、反向代理等防护层。
地图视图会在浏览器中加载 Mapbox 库，并使用你提供的令牌；Mapbox 因此收到哪些数据，我们没有核实。
📌注: 以上是项目自己的说明，而非审计结果。PromptQuorum 没有检查网络流量，也没有查看本文所列文件之外的代码。
适合哪些人
- 把 RAW 图库放在家用服务器上的摄影师，想浏览和分享文件夹而不必移动文件。
- 把家庭照片存在 NAS 上的家庭，需要一个每位用户各有独立文件夹的相册。
- 偏好按文件夹组织的自托管用户，而不是带 AI 搜索和标签的平台。
我们未能核实的内容
- 人脸识别质量。 准确度、分组表现和速度均未测试。
- 与发布版本的差距。 最新带标签版本来自 2024 年 6 月，而 master 已继续向前；它与 2.4.0 差多少没有比较过，README 还提到 PostgreSQL 18 是下一个版本的推荐版本。
- 发送给 Mapbox 的数据。 地图功能会向 Mapbox 发送什么，以及 Mapbox 对免费令牌的条款，均未核实。
- 资源占用。 没有公布内存或 CPU 数据，实际占用也未测量。
- 手机使用体验。 未列出移动应用；浏览器界面在手机上的表现没有测试。
竞品与替代方案
目录中另有三款相册工具同样支持人脸识别，区别在于各自额外提供什么。
PhotoPrism
- 平台:
- Linux、macOS、Windows（Docker）、网页
- 价格 / 许可证:
- 免费 + 付费 / AGPL-3.0
- 主要区别:
- 增加 AI 标签和搜索；设有付费会员
关于PhotoPrism的文章（1篇）
Immich
- 平台:
- Linux 服务器、iOS、Android、网页
- 价格 / 许可证:
- 免费 / AGPL-3.0
- 主要区别:
- 增加手机备份应用和智能搜索
关于Immich的文章（1篇）
- Immich Review: Self-Hosted Photo Library with Smart Search更新于 2026年10月26日
其他提及：
- Facet Review: Local Photo Scoring, Culling and Gallery更新于 2026年10月28日
Facet
- 平台:
- Linux、macOS、Windows、网页
- 价格 / 许可证:
- 免费 / MIT
- 主要区别:
- 增加照片评分与筛选；部分默认模型权重不可商用
关于Facet的文章（1篇）
- Facet Review: Local Photo Scoring, Culling and Gallery更新于 2026年10月28日
请在各应用自己的页面上确认其当前价格、许可证和平台。
常见问题
Photoview 会修改我的照片文件吗？
README 将该相册描述为对你的媒体只读访问，生成的缩略图保存在由 PHOTOVIEW_MEDIA_CACHE 指定的单独缓存文件夹中。
我该用哪种数据库？
SQLite 不需要额外服务，但性能最低，也无法扩展。README 把 MariaDB 作为默认选择，并称 PostgreSQL 通常最快。
如何更新 Photoview？
拉取新镜像并重启容器。README 建议升级前备份数据库，并提示镜像已迁移到 Docker Hub 上的 photoview/photoview 仓库，因此旧的 compose 文件需要改用新的镜像名。
在哪里可以获得帮助？
README 把安装和开发方面的问题引向 Discord 服务器；项目不支持 Portainer 等叠加在 Docker Compose 之上的管理层。
结论
Photoview 是一款成熟、公开开发的相册应用，适合把照片按文件夹放在自己服务器上，想不依赖云服务就能浏览、分享并按人脸整理的人。不足之处在于：最新带标签版本来自 2024 年 6 月，部署需要 Docker 和数据库，人脸识别是唯一的 AI 功能，地图依赖 Mapbox 令牌，而这些在本次都无法测试。它适合已经在运行 Docker、习惯按文件夹管理的自托管用户；需要 AI 搜索或手机备份的人，应当对比上面列出的替代方案。
来源
- Photoview 官网 — 功能概览（2026 年 10 月 30 日查阅）。
- Photoview README — 功能、平台、数据库、部署与安全提示（2026 年 10 月 30 日查阅）。
- Photoview 发布页 — 2.4.0 版，发布于 2024 年 6 月 23 日。
- Photoview 人脸检测代码 — 识别库与环境设置（2026 年 10 月 30 日查阅）。
- Docker Hub 上的 Photoview — 镜像标签（2026 年 10 月 30 日查阅）。