Home-Gallery 是什么？
Home-Gallery 是一款自托管图库，照片和视频仍保存在你自己的文件夹里。 README 说明，项目作者把媒体存放在家中的 NAS 上，希望图库离数据源更近，并认为云服务无法解决其隐私顾虑。
README 面向的是懂电脑、能自己解决问题的用户，并把“只有一个用户、提供所有文件”列为设计目标。一个小型网页服务器读取你的媒体文件夹，你通过浏览器或可安装的网页应用使用它。
获取方式
Home-Gallery 以适用于 Linux、macOS 和 Windows（x64 版本）的预构建命令行二进制文件或 Docker 镜像形式提供；没有双击安装程序，也没有应用商店页面。
选项 | 获取方式 |
|---|---|
| Linux 二进制文件 | home-gallery-latest-linux-x64，下载后赋予可执行权限 |
| macOS 二进制文件 | home-gallery-latest-darwin-x64（x64 版本） |
| Windows 二进制文件 | home-gallery-latest-win-x64.exe |
| Docker | Docker Hub 上的 xemle/home-gallery；安装指南涵盖 Compose |
| 文档 | home-gallery.org/docs |
| 官网 | home-gallery.org（页面中链接了演示图库） |
| 源代码 | github.com/xemle/home-gallery（MIT） |
| 所有构建 | dl.home-gallery.org/dist 列出所有版本和不稳定构建 |
评测版本：v1.21.0，下载索引和 git 标签上的日期均为 2026 年 3 月 1 日；该仓库没有 GitHub Releases，2026 年 10 月 13 日的最近一次推送属于更新日志 Unreleased 下尚未发布的改动。安装需要终端。根据二进制安装指南，首次启动较慢，macOS 或 Windows 的安全软件可能拦截该应用，需要手动放行。在项目网站和已阅读的文档中没有找到独立的隐私政策页面；隐私相关说明见 README 和 API 服务器页面。
上手步骤
以下步骤依据项目的 README 和文档，PromptQuorum 未实际执行。
- 1下载二进制文件或拉取镜像
Why it matters: 从下载索引获取适合你系统的构建，在 Linux 或 macOS 上赋予可执行权限，或使用 README 中的 Docker 快速开始。 - 2用你的照片文件夹初始化配置
Why it matters: init 命令接受一个或多个媒体文件夹，并在当前目录写入 gallery.config.yml。 - 3启动服务器并打开图库
Why it matters: 运行服务器命令，在浏览器中打开 localhost:3000；页面打开期间，媒体会被导入。 - 4决定 AI 步骤在哪里运行
Why it matters: 保留默认的公共 API，把图库指向你自己的 API 服务器，或在配置中关闭 AI 功能。
主要功能
以下各项均来自项目官网、README 或文档，PromptQuorum 没有测试其中任何一项。
- 浏览。 照片和视频的网页图库，被描述为适合手机使用，官网列出可安装（PWA）。
- 标签。 可为单张或多张图片打标签。
- 发现。 相似图片搜索，无需手动标签即可找到日落、食物或建筑，另有物体检测、人脸检测和相似人脸搜索。
- 合并来源。 多个媒体文件夹（如硬盘、相机文件和手机文件）可在同一个图库中提供。
数据流向与隐私
默认情况下，相似图片搜索、物体检测和人脸识别使用项目位于 api.home-gallery.org 的公共 API，按 README 所述，所有预览图都会发送到那里。 README 补充说不会保留图片或隐私数据；这是项目自己的说法，PromptQuorum 无法核实。README 还提到，这个公共 API 支持树莓派（Raspberry Pi）等低性能设备。
API 服务器也可以作为 Docker 容器在本地运行，图库配置可以指向它，或关闭每一项 AI 功能。因此 Home-Gallery 开箱即为混合模式，自行托管 API 服务器后才是本地模式。反向地理编码时，图库会向 OpenStreetMap 的 Nominatim 服务查询，按 README 只传输地理坐标。配置页面介绍了登录用户、访问规则以及默认监听地址 0.0.0.0 和端口 3000，但没有说明开箱时是否要求登录。
📌注: 以上是项目的说法，以及 PromptQuorum 对其文档的理解。未检查网络流量，也未审计源代码。
适合哪些人
- 拥有 NAS 或家用服务器的自托管用户，希望不用云账号，就在浏览器中提供现有的照片和视频文件夹。
- 拥有超大档案库的用户，希望在一个图库中搜索全部内容，并能接受整个索引加载到浏览器中。
- 重视隐私且会用 Docker 的用户，愿意自己托管 API 服务器。
我们未能核实的内容
- AI 质量与模型。 API 服务器页面没有列出任何模型，搜索相关性、人脸识别和速度均未测试。
- 硬件需求。 已阅读的文档没有给出图库本身或自托管 API 服务器的最低内存或 CPU 要求。
- 完全本地运行。 使用自托管 API 服务器且断网的运行方式未测试。
- Apple Silicon。 macOS 只列出了 x64 构建；文中没有说明它能否在较新的 Mac 上运行。
- 发布节奏。 最新标签来自 2026 年 3 月，而更新的工作列在更新日志的 Unreleased 下。
- 安装步骤。 这些步骤来自文档，PromptQuorum 没有执行。
竞品与替代方案
目录中同一细分领域还有三款已评测的照片库工具。
Immich
- 平台:
- 服务器（Docker）、iOS、Android、浏览器
- 价格 / 许可证:
- 免费 / AGPL-3.0
- 主要区别:
- 手机应用支持备份，服务器端有智能搜索；未发现 Home-Gallery 的原生应用，只有网页应用
关于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日
PhotoPrism
- 平台:
- 服务器（Docker）、浏览器
- 价格 / 许可证:
- 免费 Community / AGPL-3.0
- 主要区别:
- 据其评测，内置 AI 的标签和人脸识别在你的服务器上运行，而 Home-Gallery 把这一步交给 API 服务器
关于PhotoPrism的文章（1篇）
Facet
- 平台:
- Docker 或脚本、浏览器
- 价格 / 许可证:
- 免费 / MIT
- 主要区别:
- 在你自己的机器上为照片评分和筛选；Home-Gallery 侧重浏览、标签和发现
关于Facet的文章（1篇）
- Facet Review: Local Photo Scoring, Culling and Gallery更新于 2026年10月28日
请在各应用自己的页面确认其当前价格、许可证和平台。
常见问题
怎样让 AI 步骤留在我自己的机器上？
运行 Docker 镜像 xemle/home-gallery-api-server（支持 amd64 和 arm64），并在 gallery.config.yml 的 extractor.apiServer.url 中填入它的地址；文档给出了端口 3001 的示例。也可以用 extractor.apiServer.disable 关闭功能，可选值为 similarDetection、objectDetection 和 faceDetection。
可以在手机上使用 Home-Gallery 吗？
README 把在手机上查看自己的媒体列为目标，官网列出了 PWA。未发现原生手机应用。
它支持多个用户吗？
README 以一个用户为目标，而配置页面介绍了用户、访问规则和按用户设置的过滤器。PromptQuorum 没有测试多用户配置。
如何更新？
二进制安装指南说明：先停止服务器，替换二进制文件，并在重新启动服务器之前运行导入命令。
结论
Home-Gallery 是一种免费、采用 MIT 许可证的方式，可以从你自己的服务器提供大型照片和视频档案，并带有标签和 AI 发现功能。另一方面，部署需要终端，除非你自己托管 API 服务器，否则 AI 功能会把预览图发送到项目的公共 API，最新带标签版本来自 2026 年 3 月，而且关于 AI 质量的说法这里都无法核实。它适合习惯使用 Docker 或命令行的自托管用户；想要双击即用的应用或开箱即完全本地的 AI 的用户，应该另选其他工具。
来源
- Home-Gallery 官网 — 概览、平台和文档链接，2026 年 10 月 30 日查阅。
- Home-Gallery README — 动机、快速开始、限制，以及外部服务与隐私章节，2026 年 10 月 30 日查阅。
- API 服务器文档 — 公共 API 与本地 Docker 部署，2026 年 10 月 30 日查阅。
- 配置文档 — 服务器、认证和提取器设置，2026 年 10 月 30 日查阅。
- 二进制安装指南 — 平台、首次启动和升级说明，2026 年 10 月 30 日查阅。
- GitHub 上的 Home-Gallery — 标签、更新日志和提交活动，2026 年 10 月 30 日查阅。