前言
在数字时代，照片管理成了许多人的刚需。手机、相机、无人机拍下的照片散落在不同设备中，寻找一张特定照片往往要翻遍整个相册。飞牛NAS（fnOS）作为一款轻量、易用的NAS系统，配合Photoprism这个AI驱动的照片管理工具，可以让你轻松实现照片的自动整理、人脸识别、标签分类和智能搜索。本文将手把手教你如何在飞牛NAS上部署Photoprism，打造属于你自己的智能照片库。
准备工作
在开始之前，请确保你的飞牛NAS已经完成以下基础配置：
- 飞牛NAS系统已安装并正常运行（建议使用最新版本）
- 已开启SSH服务或能够直接使用飞牛NAS的终端
- 拥有管理员权限的账号
- 至少分配了10GB以上的存储空间用于照片库（根据实际照片量调整）
- 确保NAS可以正常访问互联网，用于拉取Docker镜像
安装Docker环境
飞牛NAS默认集成了Docker，但建议检查是否已启用。如果尚未安装，可以通过以下步骤快速部署。
首先通过SSH登录到你的飞牛NAS，或者直接在NAS的本地终端中执行命令。输入：
sudo docker --version
如果显示版本号，说明Docker已就绪。如果没有，执行：
sudo apt update && sudo apt install docker.io docker-compose -y
安装完成后，启动Docker服务并设置开机自启：
sudo systemctl start docker
sudo systemctl enable docker
创建Photoprism的目录结构
为了让文件管理更清晰，我们需要在飞牛NAS上创建专门用于Photoprism的文件夹。建议将其放在共享存储卷中，方便后续备份和管理。
在飞牛NAS的文件管理器中，或者通过SSH命令行执行：
mkdir -p /volume1/photoprism/storage
mkdir -p /volume1/photoprism/originals
mkdir -p /volume1/photoprism/database
这里/volume1是飞牛NAS的默认存储卷，你可以根据实际情况替换。originals文件夹用于存放原始照片，storage用于存放缓存和数据库文件，database用于持久化SQLite数据库（如果使用SQLite模式）。
编写Docker Compose配置文件
在/volume1/photoprism目录下创建一个docker-compose.yml文件：
cd /volume1/photoprism
touch docker-compose.yml
然后用你喜欢的文本编辑器（如vim、nano）编辑该文件，写入以下内容：
version: '3.5'
services:
photoprism:
image: photoprism/photoprism:latest
container_name: photoprism
restart: unless-stopped
ports:
- "2342:2342"
environment:
PHOTOPRISM_ADMIN_USER: "admin"
PHOTOPRISM_ADMIN_PASSWORD: "your_strong_password"
PHOTOPRISM_DATABASE_DRIVER: "sqlite"
PHOTOPRISM_SITE_URL: "http://your_nas_ip:2342/"
PHOTOPRISM_DISABLE_TENSORFLOW: "false"
PHOTOPRISM_FFMPEG_ENCODER: "software"
PHOTOPRISM_ORIGINALS_LIMIT: "5000"
PHOTOPRISM_HTTP_COMPRESSION: "gzip"
volumes:
- "./originals:/photoprism/originals"
- "./storage:/photoprism/storage"
- "./database:/photoprism/database"
devices:
- "/dev/dri:/dev/dri" # 可选，用于硬件加速（如果CPU支持）
请注意替换以下参数：
PHOTOPRISM_ADMIN_PASSWORD：设置一个强密码，建议包含大小写字母、数字和特殊字符。PHOTOPRISM_SITE_URL：修改为你的飞牛NAS的实际IP地址，例如http://192.168.1.100:2342/。- 如果你有Intel或AMD的集成显卡，可以保留
devices部分以启用硬件加速，否则可以删除这一行。
启动Photoprism
在/volume1/photoprism目录下，执行以下命令启动容器：
sudo docker-compose up -d
第一次启动时会自动拉取Photoprism镜像，根据网络速度可能需要几分钟。拉取完成后，容器会自动启动。
检查容器运行状态：
sudo docker ps
如果看到photoprism容器状态为Up，说明部署成功。
访问与初始配置
打开浏览器，输入http://你的NASIP:2342，例如http://192.168.1.100:2342。你会看到Photoprism的登录页面。
使用你在docker-compose.yml中设置的用户名admin和密码登录。首次登录后，建议立即修改密码并设置语言为中文。在设置界面中找到“用户”选项，可以修改密码；在“设置”中的“界面”部分选择简体中文。
导入照片
Photoprism支持多种导入方式。最简单的是将照片直接放入originals文件夹。你可以通过飞牛NAS的文件管理器，或者SMB/NFS等网络共享方式，将手机、相机中的照片复制到/volume1/photoprism/originals目录下。
导入后，在Photoprism的界面中点击“索引”按钮，系统会自动扫描新照片并开始AI分析。索引过程会根据照片数量和时间长短，可能需要几分钟到几小时。
如果你希望自动导入，可以在Photoprism的设置中开启“自动索引”功能，并设置定期扫描间隔。
AI功能的使用
Photoprism的核心优势在于其AI能力。部署完成后，你可以体验以下功能：
- 人脸识别：自动检测照片中的人脸，并允许你为人物命名，后续可以按人物搜索照片。
- 地理位置标签：如果照片包含GPS信息，Photoprism会自动生成地图视图。
- 物体识别：自动识别照片中的物体、场景（如“海滩”、“日落”、“猫”等），并生成标签。
- 颜色搜索：按主色调筛选照片，非常实用。
- 智能搜索：支持关键词、日期、地点、人物等组合搜索。
这些功能默认是开启的。你可以在设置中调整AI模型的精度或关闭某些功能以节省资源。
性能优化与注意事项
- 硬件资源：Photoprism的AI处理对CPU有一定要求。如果你的NAS性能有限，可以在设置中降低“索引精度”或“人脸识别质量”。
- 存储空间：索引过程中会生成缩略图和缓存文件，建议确保
storage目录有足够的空间（至少是照片总量的20%）。
- 定期备份：虽然Photoprism使用SQLite数据库，但建议定期备份
database目录和originals目录。你可以借助飞牛NAS的快照功能或rsync脚本实现自动备份。
- 端口冲突：如果2342端口已被占用，可以在
docker-compose.yml中修改外部端口，例如"2343:2342"。
常见问题排查
如果访问页面时遇到“502 Bad Gateway”错误，通常是因为容器尚未完全启动。执行sudo docker logs photoprism查看日志，等待索引进程完成即可。
如果照片无法显示，检查originals目录的权限。确保Docker容器内的用户（默认uid 1000）有读取权限。你可以通过sudo chown -R 1000:1000 /volume1/photoprism/originals修改权限。
总结
通过以上步骤，你已经在飞牛NAS上成功部署了Photoprism，拥有了一个具备AI智能分析能力的照片管理系统。它不仅能帮你自动整理海量照片，还能通过人脸识别、物体识别等功能轻松找到任何一张照片。相比商业云相册，Photoprism完全本地化运行，隐私安全且无订阅费用。建议定期更新镜像版本，以获得最新的功能和性能改进。现在，开始享受你的智能照片库吧。