H
HomeGallery
1.1k stars·文件管理·已提供 SHA-256 校验码，下载后可自行核对文件完整性
一个自托管开源网络相册，支持 AI 图片搜索、人脸识别和移动端浏览。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自建相册，AI 帮你找照片，无需云服务。
核心功能
- AI 反向图片搜索：上传一张夕阳照，自动找到图库里所有相似夕阳照片，无需手动打标签
- 人脸检测和相似人脸搜索：轻松聚合同一人物的所有照片
- 虚拟滚动无限流式浏览：超 40 万张照片也能流畅滑动
- 视频转码与 Chromecast 投屏：直接在电视上播放
- 支持只读和离线媒体源：预览生成后原始盘可离线，节省空间
避坑指南
- •整个媒体索引加载到浏览器内存中，10 万张照片约 12MB 压缩 JSON，浏览器内存占用约 100MB，大库建议使用性能和内存较充裕的设备。
- •AI 反向图片搜索默认使用公共 API (api.home-gallery.org)，所有预览图会发送到该服务（不保留数据），若对隐私有要求需自建 API 服务器。
- •地理反向查询依赖 OpenStreetMap Nominatim 服务，仅发送坐标。
- •仅支持单用户，所有文件在登录后全部可见，不适合多用户权限管理。
适用场景
- 家庭照片管理：将 NAS 中散落的手机照片、相机照片统一管理，AI 帮你按人脸、地点、内容自动分类
- 个人媒体档案：将过去十几年积累的照片视频集中存储，按需快速找到某张照片或某个人
- 自建隐私相册：避免将私密照片上传到 Google Photos 等云服务，所有数据保留在本地
HomeGallery 是一个自托管的开源网络相册，旨在让您完全掌控个人照片和视频收藏。它可运行在本地 NAS 或服务器上，支持 AI 反向图片搜索、人脸检测与识别、强大的查询语言以及移动端友好的 PWA 体验。能处理超大规模媒体库（已验证 40 万+文件），提供虚拟滚动实现无限流式浏览，兼容只读/离线媒体源。提供 Linux、macOS、Windows 和 Docker 版本。无需依赖云服务，注重隐私保护。
标签
self-hostedphoto-galleryvideo-galleryAIface-recognitionreverse-image-searchdockerPWAopen-sourceprivacy
快速上手
1
2
安装软件
双击下载的安装程序，按提示完成安装
3
步骤1：下载对应平台的二进制文件（Linux/macOS/Windows）或拉取 Docker 镜像
4
步骤2：运行初始化命令，指定照片目录作为媒体源（如 ~/Pictures）
5
步骤3：启动服务器，浏览器打开 http://localhost:3000 即可浏览
安装指引
- 步骤1：下载对应平台的二进制文件（Linux/macOS/Windows）或拉取 Docker 镜像
- 步骤2：运行初始化命令，指定照片目录作为媒体源（如 ~/Pictures）
- 步骤3：启动服务器，浏览器打开 http://localhost:3000 即可浏览
文件完整性
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码运维指引
卸载说明
删除 HomeGallery 数据目录和配置文件即可完全卸载。如果使用 Docker，停止并删除容器，再删除映射的数据卷。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
3 FAQs