Repolode
提交项目
xemle

xemle/home-gallery

可自托管的网页相册，用于浏览个人照片和视频，支持标签、移动端体验以及相似图片和人脸搜索。

可替代:Google Photos

在 GitHub 查看官网
Star
1,201
Fork
107
未关闭 Issue
54
最近提交
7天前

这是什么？

HomeGallery 是一个可自托管的网页相册，用于浏览个人照片和视频。它运行在你自己的电脑或 NAS 上，索引一个或多个本地素材目录，原始文件无需交给云服务。

相册提供虚拟滚动的无限照片流、单选和多选打标签，以及支持 and、or、not 运算的查询语言。它还支持以图搜图找相似照片、人脸检测与按相似人脸搜索、GPS 坐标反查地址，以及视频转码。手机上可通过 PWA 使用。

媒体按内容识别，重复文件只处理一次，重命名后无需重新生成预览。元数据可导出为 XMP 边车文件，相册也可导出为静态网站。提供 Linux、macOS、Windows 预编译程序和 Docker 镜像。

核心功能

  • 01虚拟滚动的无限照片流
  • 02支持单选和多选打标签
  • 03相似图片搜索和人脸搜索
  • 04视频转码，并可投屏到 Chromecast 设备
  • 05GPS 坐标反查地理位置
  • 06基于内容去重并快速检测文件增删改移
  • 07可导出 XMP 边车文件和静态网站

适用场景

  • 在手机上浏览存放于家中 NAS 的家庭照片库
  • 无需手动打标签，在大型个人图库中查找相似的日落或美食照片
  • 离线或只读外接硬盘完成一次索引后继续使用
  • 将照片集导出为静态网站发布

快速上手

  1. 1

    下载预编译的二进制文件

    curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64 -o gallery
  2. 2

    赋予二进制文件可执行权限

    chmod 755 gallery
  3. 3

    使用媒体源目录初始化配置

    ./gallery init --source ~/Pictures
  4. 4

    启动服务器，然后打开 localhost:3000

    ./gallery run server

使用前须知

  • 整个媒体数据库会加载到浏览器中，因此超大媒体库可能性能不佳。
  • 物体和人脸识别默认使用项目的公共 API，预览图会发送到外部服务器，除非你在本地运行该 API。
  • 项目自述为个人业余项目，不提供任何保证。

标签

#self-hosted#photo-gallery#face-recognition#image-search#tagging#video#nodejs#pwa#calculate-previews#exif

常见问题

home-gallery 是什么？
可自托管的网页相册，用于浏览个人照片和视频，支持标签、移动端体验以及相似图片和人脸搜索。 HomeGallery 是一个可自托管的网页相册，用于浏览个人照片和视频。它运行在你自己的电脑或 NAS 上，索引一个或多个本地素材目录，原始文件无需交给云服务。
home-gallery 可以免费使用吗？用的什么许可证？
home-gallery 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
home-gallery 还在维护吗？
活跃维护中。home-gallery 最近一次提交是在 2026年10月13日。
home-gallery 适合用来做什么？
在手机上浏览存放于家中 NAS 的家庭照片库 无需手动打标签，在大型个人图库中查找相似的日落或美食照片 离线或只读外接硬盘完成一次索引后继续使用 将照片集导出为静态网站发布
home-gallery 怎么安装和运行？
下载预编译的二进制文件: curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64 -o gallery 赋予二进制文件可执行权限: chmod 755 gallery 使用媒体源目录初始化配置: ./gallery init --source ~/Pictures 启动服务器，然后打开 localhost:3000: ./gallery run server
在哪里获取 home-gallery？
源代码和安装说明在 GitHub 上：https://github.com/xemle/home-gallery

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目