家庭智能照片管理系统Photonix，AI识别分类，NAS一键部署，内网穿透远程访问

项目介绍

Photonix 是一款功能强大的家庭照片管理系统，基于现代化的网络技术构建而成。它允许你在自己的家庭服务器上部署运行，通过任何设备随时随地访问和管理你的整个照片库。

这个项目最大的亮点在于它采用了先进的人工智能算法，能够自动进行对象识别、地理位置感知和色彩分析等智能操作，让你可以通过智能筛选快速找到想要的照片。无论是按内容搜索、按地点查找还是按色调分类，都能轻松实现。

相比于云端服务，Photonix 让你的所有照片数据都掌握在自己手中，隐私性更强，同时也不受云存储容量和流量的限制。

项目地址：点我跳转

部署安装

如果你需要在外出时也能访问家里的照片库，建议配置内网穿透服务。推荐使用帕斯内网穿透，先注册好账号备用。具体的操作步骤可以点我查看内网穿透全平台快速上手指南。

使用 Docker Compose 快速部署

第一步：准备配置文件

打开你的 NAS 设备或任何能运行 Docker 的主机，创建一个新的项目目录并下载官方配置文件：

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

第二步：创建数据目录

为照片和数据库创建必要的存储文件夹：

1mkdir -p data/photos data/db data/raw-photos-processed data/cache data/models

第三步：启动服务

运行以下命令启动 Photonix 及其依赖服务（PostgreSQL 数据库和 Redis 缓存）：

1docker-compose up -d

第四步：创建管理员账户

等待容器完全启动后（约 30 秒），在新的终端窗口运行以下命令创建你的管理员账户。请将 YOUR_USERNAME 替换为你想要的用户名：

1docker-compose run photonix python photonix/manage.py createsuperuser --username YOUR_USERNAME --email your_email@example.com

第五步：创建照片库

接着创建你的第一个照片库，同样将 YOUR_USERNAME 替换为上一步设置的用户名：

1docker-compose run photonix python photonix/manage.py create_library YOUR_USERNAME 'My Photo Library'

第六步：开始使用

打开浏览器访问 http://localhost:8888，使用刚才创建的账户登录，你就可以开始管理你的照片了。

Docker Compose 配置说明

如果你需要自定义配置，可以参考以下配置文件模板：

1version: '3'
2
3services:
4  postgres:
5    container_name: photonix-postgres
6    image: postgres:11.1-alpine
7    environment:
8      POSTGRES_DB: photonix
9      POSTGRES_PASSWORD: password
10    volumes:
11      - ./data/db:/var/lib/postgresql/data
12
13  redis:
14    container_name: photonix-redis
15    image: redis:6.2.2
16
17  photonix:
18    container_name: photonix
19    image: photonixapp/photonix:latest
20    ports:
21      - '8888:80'
22    environment:
23      ENV: prd
24      POSTGRES_HOST: postgres
25      POSTGRES_DB: photonix
26      POSTGRES_USER: postgres
27      POSTGRES_PASSWORD: password
28      REDIS_HOST: redis
29      ALLOWED_HOSTS: '*'
30    volumes:
31      - ./data/photos:/data/photos
32      - ./data/raw-photos-processed:/data/raw-photos-processed
33      - ./data/cache:/data/cache
34      - ./data/models:/data/models
35    links:
36      - postgres
37      - redis

配置说明

端口映射：

容器内部使用 80 端口，映射到主机的 8888 端口。如果 8888 端口已被占用，可修改为其他端口（如 '8889:80'），但容器内的 80 端口保持不变。

存储目录：

./data/photos - 你的照片存储位置，将你的照片放在这个文件夹内，系统会自动检测并导入 ./data/db - 数据库数据持久化目录 ./data/cache - 缩略图和缓存数据存储目录 ./data/models - AI 模型数据存储目录

环境变量设置：

必须设置： - POSTGRES_PASSWORD - 数据库密码（建议修改为强密码）可选设置： - ALLOWED_HOSTS - 允许访问的主机名，默认为 '*' 表示允许所有主机访问其他环境变量保持默认即可。

照片导入

将你的照片放入 ./data/photos 文件夹，系统会自动检测并导入。系统会自动进行图像分析，提取对象、位置和色彩信息，这个过程可能需要一些时间，请耐心等待。

升级更新

如需升级到最新版本，运行以下命令：

1docker-compose pull
2docker-compose up -d

本篇教程结束。祝你使用愉快！