Ownphotos 的开发已迁移至 LibrePhotos

Ownphotos 的开发已迁移至 LibrePhotos 请在此处使用：https://github.com/LibrePhotos/librephotos

旧项目仅供存档，建议使用 LibrePhotos

Ownphotos

截图

实时演示

实时演示在此。 用户名为 demo，密码为 demo1234。

Discord 服务器

https://discord.gg/dPCdTBN

它是什么？

• 自托管的类 Google Photos 克隆，略微侧重于酷炫的图表展示
• 后端使用 Django，前端使用 React。
• 处于开发中。欢迎贡献！

目前项目仍处于非常早期阶段，因此仅建议用于试用。

功能

- 当前已实现：

• 手动标注部分人脸，并训练人脸分类器自动标注其余人脸。
• 按照片中的人物查看照片。
• 自动生成带有精美标题的“事件”相册，如“柏林星期四”。
• 在地图上查看照片。
• 后端缓存机制。
• 按日期分组查看照片。
• “优化”的前端（React Virtualized……我尽力了）。
• 检测照片中的物体，并支持按物体搜索。
• 按地点搜索照片。
• 身份验证（使用 JWT）。
• 创建自定义相册。
• 支持 Docker 部署。

- 即将推出：

• 短期：

  • 分享照片/相册。
  • 提升稳定性。

• 长期计划，尚未深入考虑：

  • 基本的照片编辑功能，如旋转。
  • 标注未检测到的人脸。
  • 添加更多酷炫图表。

它使用了哪些技术？

• 人脸检测： face_recognition
• 人脸分类/聚类： scikit-learn
• 物体检测： densecap、places365
• 逆地理编码： Mapbox：需要 API 密钥。每月前 5 万次地理编码查询免费。

如何运行它？

Docker

Ownphotos 包含独立的后端和前端服务器。后端提供 RESTful API，前端则负责呈现界面。两者通过代理进行连接。最简便的方式是使用 Docker。

若希望后端服务器可通过 ownphotos-api.example.com 访问，而前端则可通过 ownphotos.example.com 从外部访问，则需在代理中配置跨域资源共享（CORS）。

使用 Docker Compose 方法（推荐）

wget https://raw.githubusercontent.com/hooram/ownphotos/dev/docker-compose.yml.template
cp docker-compose.yml.template docker-compose.yml

在您喜欢的文本编辑器中打开 docker-compose.yml 文件，修改标有 # CHANGE ME 的行。

docker-compose up -d

启动几秒后，您应该能够访问 Ownphotos：localhost:3000。 默认用户名为 admin，密码为 admin。请注意，在公共服务器上务必通过 docker-compose.yml 文件更改默认密码。

设置后的第一步

您需要以管理员身份登录，并为用户设置扫描目录。为此，请点击右上角按钮，进入“管理区域”。在此页面上会显示用户列表，手动为所需用户设置“扫描目录”。只有管理员可以执行此操作。随后，您可以前往“仪表板 - 图库”，点击绿色的“扫描照片（文件系统）”按钮。如果您拥有 Nextcloud 实例，也可以在“仪表板 - 图库”页面中输入相关信息。登录后（“Nextcloud 扫描目录”旁边的圆点会变为绿色），您可以选择已登录 Nextcloud 账户中的一个顶级目录。设置完成后，点击蓝色的“扫描照片（Nextcloud）”按钮。后端系统将复制您指定的 Nextcloud 目录内容。

基本思路如下：

• 对于扫描本地文件系统中的照片：
  • 只有管理员可以更改用户的“扫描目录”，包括管理员本人。
  • 普通用户无法自行更改其“扫描目录”。
  • 只有管理员可以通过“用户图标（右上角）- 管理区域”找到控制该功能的页面。
• 对于扫描外部 Nextcloud 实例中的照片：
  • 任何用户都可以更改自己的 Nextcloud 接入点，并选择 Nextcloud 账户中的一个顶级目录。

Ownphotos 快速上手指南

重要提示：Ownphotos 项目已停止维护，开发团队已迁移至新项目名称 LibrePhotos。

• 新项目地址：https://github.com/LibrePhotos/librephotos
• 本文档仅作为旧版 Ownphotos 的归档参考，强烈建议新用户直接部署 LibrePhotos 以获得最新功能和安全更新。

---

1. 环境准备

在部署前，请确保您的服务器满足以下要求：

• 操作系统：Linux (推荐 Ubuntu/CentOS) 或 macOS
• 核心依赖：
  • Docker
  • Docker Compose
• 网络要求：
  • 需访问外网以下载镜像和依赖包。
  • 若使用地图反向地理编码功能，需准备 Mapbox API Key（每月前 50,000 次查询免费）。
• 硬件建议：由于涉及人脸识别和物体检测（基于深度学习），建议至少配备 4GB 内存及多核 CPU。

2. 安装步骤

推荐使用 Docker Compose 进行一键部署。

第一步：获取配置文件

下载 docker-compose.yml 模板文件：

wget https://raw.githubusercontent.com/hooram/ownphotos/dev/docker-compose.yml.template
cp docker-compose.yml.template docker-compose.yml

第二步：修改配置

使用文本编辑器打开 docker-compose.yml，找到标记为 # CHANGE ME 的行进行修改。 主要需要配置的内容包括：

• 数据库密码
• Mapbox API Key（如需地图功能）
• 管理员默认密码（生产环境务必修改）

vim docker-compose.yml
# 或
nano docker-compose.yml

第三步：启动服务

在配置文件所在目录执行以下命令启动容器：

docker-compose up -d

等待几秒钟让服务初始化。启动完成后，您可通过浏览器访问：

• 前端地址：http://localhost:3000
• 默认账号：admin
• 默认密码：admin

安全警告：若在公网服务器部署，请务必在 docker-compose.yml 中修改默认密码，并在启动后尽快更改。

3. 基本使用

启动成功后，请按以下步骤配置照片库：

步骤一：设置扫描目录

1. 使用 admin 账号登录系统。
2. 点击右上角的用户图标，选择 "Admin Area"（管理区域）。
3. 在用户列表中找到目标用户，手动设置 "Scan Directory"（扫描目录）。
   • 注意：只有管理员有权设置本地文件系统的扫描路径。

步骤二：开始扫描照片

1. 返回主界面，进入 Dashboard - Library。
2. 点击绿色的 "Scan photos (file system)" 按钮。
3. 系统将开始索引指定目录下的照片，并进行人脸检测、物体识别及自动分类。

进阶：连接 Nextcloud（可选）

如果您的照片存储在 Nextcloud 实例上：

1. 普通用户可在 Dashboard - Library 页面自行配置 Nextcloud 连接。
2. 登录 Nextcloud 账户后，选择顶层目录。
3. 当 Nextcloud 状态指示灯变绿后，点击蓝色的 "Scan photos (Nextcloud)" 开始同步。

核心功能体验

扫描完成后，您可以体验以下功能：

• 人脸浏览：查看按人物分类的照片。
• 智能相册：系统自动生成如“周四在柏林”的事件相册。
• 地图模式：在地图上查看照片分布。
• 物体搜索：通过物体标签（如“猫”、“海滩”）搜索照片。