Photonix 照片管理器

这是一个基于Web技术的照片管理应用。您可以在自己的家庭服务器上运行它，通过任何设备轻松从照片库中找到所需内容。智能筛选功能由物体识别、位置感知、色彩分析等算法自动实现。

该项目目前仍在开发中，尚未达到1.0版本的功能完整状态。如果您不介意使用尚有缺陷的版本，或希望参与贡献，请运行Docker镜像并试用一下。我们非常欢迎更多开发者加入！

社区与社交

请加入我们的讨论，并通过关注我们的社交媒体账号帮助提升项目知名度，您的支持将不胜感激 :)

• Gitter在线聊天
• Docker Hub
• Twitter
• Instagram
• LinkedIn
• Indie Hackers

赞助

如果您认为Photonix具有价值，或者认同我们的发展方向，我们诚挚地邀请您每月给予支持。

• GitHub赞助
• Patreon

安装与运行

最简单的运行方式是使用Docker Compose，按照以下步骤使用预构建的镜像即可。

首先创建一个用于运行的新目录，并下载示例Docker Compose文件：

mkdir photonix
cd photonix
curl https://raw.githubusercontent.com/photonixapp/photonix/master/docker/docker-compose.example.yml > docker-compose.yml

然后为容器外存储的数据创建卷目录：

mkdir -p  data/photos

最后启动Docker Compose，它会拉取并运行所需的Docker镜像：

docker-compose up

启动几秒钟后，您就可以在浏览器中访问http://localhost:8888/。

接下来您需要创建用户名、密码和相册。目前这一步骤需在命令行中完成，请打开一个新的终端窗口执行以下命令。将USERNAME替换为您自己的用户名：

docker-compose run photonix python photonix/manage.py createsuperuser --username USERNAME --email example@example.com
docker-compose run photonix python photonix/manage.py create_library USERNAME "My Library"

您可以将一些照片移动到data/photos文件夹中，它们应该会被立即检测并导入。测试完成后，您可以编辑docker-compose.yml文件中的卷挂载路径，将其改为您平时存放照片的位置，例如./data/photos。系统数据库、缩略图和其他缓存数据会单独存储，不会污染照片所在的目录。请务必自行做好备份，以防止意外发生。

升级

如果您使用的是预构建的Docker镜像，可以通过以下命令进行升级：

# 按Ctrl-C停止服务
docker-compose pull
docker-compose up

开发

项目中提供了一个Makefile以及独立的Docker Compose文件docker-compose.dev.yml，供您开发时使用。克隆仓库后，该配置会构建镜像、将代码以卷的形式挂载、实现JS更改的热重载并自动刷新浏览器，同时对大多数Python代码更改也会自动重启服务器。

git clone git@github.com:photonixapp/photonix.git
cd photonix
mkdir -p  data/photos
make build
make start

如果遇到类似Error starting userland proxy: listen tcp 0.0.0.0:5432: bind: address already in use的错误，可能是您本地已存在PostgreSQL等服务监听默认端口。您可以通过编辑docker/docker-compose.dev.yml文件，将'5432:5432'改为'5433:5432'等方式，为Photonix的服务指定其他端口号。此方法同样适用于Redis或Web服务器端口。

若需进入Bash或Python交互式环境进行开发，可使用以下命令：

make shell

测试

项目使用PyTest作为测试框架，并用于创建测试固定装置。最简便的测试方式是在Docker容器内运行：

make test

Photonix 照片管理工具快速上手指南

Photonix 是一款基于 Web 技术的开源照片管理应用，支持对象识别、位置感知和色彩分析等智能过滤功能。适合部署在家庭服务器上，通过浏览器随时访问和管理照片库。

环境准备

• 操作系统：支持 Linux、macOS 或 Windows（需安装 Docker）
• 前置依赖：
  • Docker
  • Docker Compose
• 网络要求：可访问 Docker Hub（国内用户建议使用镜像加速器）

💡 国内用户推荐配置 Docker 镜像加速（如阿里云、腾讯云等），以加快 photonixapp/photonix 镜像拉取速度。

安装步骤

1. 创建项目目录并下载配置文件：

mkdir photonix
cd photonix
curl https://raw.githubusercontent.com/photonixapp/photonix/master/docker/docker-compose.example.yml > docker-compose.yml

2. 创建数据卷目录：

mkdir -p data/photos

3. 启动服务：

docker-compose up

4. 等待几秒后，在浏览器访问：

http://localhost:8888/

5. 在新终端窗口创建管理员账户和照片库（替换 USERNAME 为你的用户名）：

docker-compose run photonix python photonix/manage.py createsuperuser --username USERNAME --email example@example.com
docker-compose run photonix python photonix/manage.py create_library USERNAME "My Library"

基本使用

1. 将照片文件放入 data/photos 目录，系统将自动检测并导入。
2. 登录 Web 界面（http://localhost:8888/），使用创建的账号密码进入。
3. 在界面中可按对象、地点、颜色等维度智能筛选照片。
4. 如需更改照片存储路径，编辑 docker-compose.yml 中的 ./data/photos 挂载点即可。

⚠️ 注意：系统数据库、缩略图和缓存数据独立存储，不会污染原始照片目录。请自行定期备份重要数据。