Photoview是一款专为摄影爱好者设计的照片画廊应用程序，以其简洁直观的界面和出色的用户体验著称，能够高效地管理和浏览包含数千张高分辨率图片的庞大图库。
核心功能特性
- • 深度整合文件系统：应用程序直接读取服务器本地文件系统中的图像文件，自动将文件夹结构映射为相册分类
- • 灵活的用户管理机制：每个用户账户可关联指定本地文件系统路径，实现精确的访问权限控制
- • 便捷的分享功能：支持通过公共链接分享相册和单个媒体文件，并可选择添加密码保护增强安全性
- • 专业摄影支持：完整兼容RAW格式文件，并提供详细的EXIF信息解析功能
- • 全面的视频支持：兼容多种常见视频格式，自动进行网络优化处理提升播放体验
- • 智能人脸识别：自动检测照片中的人脸特征，将识别出的同一人物照片进行智能分组
- • 卓越的性能表现：自动生成图片缩略图，采用懒加载技术，全屏模式下优先显示预览图直至高清图完全加载
- • 完善的安全保障：所有媒体资源均受cookie令牌保护，密码经过安全哈希处理，API接口实施严格的CORS策略
在线体验平台
体验账号：demo
登录密码：demo
详细安装步骤：使用Docker Compose部署Photoview
基于SQLITE数据库的Docker Compose配置方案
services:
photoview:
image: photoview/photoview:2
container_name: photoview
user: root
ports:
- 8008:80
environment:
- PHOTOVIEW_DATABASE_DRIVER=sqlite
- PHOTOVIEW_SQLITE_PATH=/home/photoview/database/photoview.db
- PHOTOVIEW_MEDIA_CACHE=/home/photoview/media-cache
- PHOTOVIEW_LISTEN_IP=0.0.0.0
- PHOTOVIEW_LISTEN_PORT=80
volumes:
- /vol1/1000/docker/photoview/cache:/home/photoview/media-cache
- /vol1/1000/docker/photoview/database:/home/photoview/database
- /vol1/1000/docker/photoview/photos:/photos
- /etc/localtime:/etc/localtime
restart: unless-stopped
关键参数说明（建议查阅官方文档获取更详细配置信息）
:::
PHOTOVIEW_DATABASE_DRIVER（环境变量）：指定数据库类型选择（支持mariadb、sqlite或postgres）
PHOTOVIEW_SQLITE_PATH（环境变量）：定义SQLITE数据库文件的存储路径
PHOTOVIEW_MEDIA_CACHE（环境变量）：设置媒体缓存文件的存放目录
PHOTOVIEW_LISTEN_IP（环境变量）：配置服务监听地址
PHOTOVIEW_LISTEN_PORT（环境变量）：设定服务监听端口号
MAPBOX_TOKEN（环境变量，可选）：Mapbox地图服务的访问令牌，用于照片地理位置标注功能
:::
启动过程中若出现初始化失败提示，通常是由于目录权限设置问题导致
sudo chmod -R 777 /vol1/1000/docker/photoview
检查数据库映射路径，确认已有文件生成即表示部署成功
实用提示：
前述配置采用SQLITE数据库方案，如需使用MYSQL数据库可参考以下模板，官方文档中提供更为详尽的参数说明。
基于MYSQL数据库的Docker Compose配置方案
services:
photoview:
image: photoview/photoview:2
container_name: photoview
user: root
depends_on:
- mariadb
ports:
- 8008:80
environment:
- PHOTOVIEW_DATABASE_DRIVER=mariadb
- PHOTOVIEW_MYSQL_URL=photoview:photosecret@tcp(mariadb)/photoview
- PHOTOVIEW_MEDIA_CACHE=/home/photoview/media-cache
- PHOTOVIEW_LISTEN_IP=0.0.0.0
- PHOTOVIEW_LISTEN_PORT=80
volumes:
- /vol1/1000/docker/photoview/cache:/home/photoview/media-cache
- /vol1/1000/docker/photoview/photos:/photos
- /etc/localtime:/etc/localtime
restart: unless-stopped
mariadb:
image: mariadb:lts
container_name: mariadb
environment:
- MARIADB_DATABASE=photoview
- MARIADB_USER=photoview
- MARIADB_PASSWORD=photosecret
- MARIADB_ROOT_PASSWORD=superphotosecret
volumes:
- /vol1/1000/docker/photoview/database:/var/lib/mysql
- /etc/localtime:/etc/localtime
restart: unless-stopped
使用指南：探索Photoview的核心功能
在浏览器地址栏输入http://NAS的IP:8008即可访问应用程序界面
首次访问需要完成账户注册流程，在存储照片路径栏位填写“/photos”参数
进入设置界面，将系统语言切换为中文显示
为提升截图展示效果，将主题模式调整为深色界面
将待管理的图片文件放置于指定的照片存储路径
若图片未自动显示，可手动触发扫描功能（若左下角未显示任务进度，可能因权限问题导致操作失败）
时间线视图按拍摄时间顺序排列照片，提供清晰的时间浏览体验
图片详情页面展示完整的元数据信息，支持生成分享链接供他人访问
开启照片全屏浏览模式
相册功能基于文件夹结构自动分类，符合大多数用户的文件管理习惯
技术提示：
测试采用人脸识别训练数据集，包含5个不同人物各100张照片。有兴趣的用户可测试自身图片的识别准确率，测试数据集下载链接：https://pan.baidu.com/s/1cqO_eJbL7acYSHi_dujxTg?pwd=1234
人物识别功能利用CPU进行人脸检测（支持核显加速但需额外配置），识别准确度处于基本可用水平，能够完成主要人脸的识别任务
与飞牛系统识别效果对比（默认设置识别率较低，调整为宽松模式后有所改善）
设置界面提供基础的多用户管理功能
总结评价：Photoview的优缺点与适用场景
Photoview作为一款轻量级实用的照片画廊解决方案，仅需简单映射相册目录即可快速部署使用，支持人脸识别技术和多用户管理功能。虽然存在一些功能限制——例如缺少网页端直接上传图片的便捷操作、人脸识别精度有待进一步提升、用户管理模块相对基础等，但作为专注于图片展示的轻量级工具，其核心的图片展示与分享能力已足够满足日常使用需求，特别适合追求简洁操作体验、以图片展示和分享为主要应用场景的用户群体。
综合推荐指数：⭐⭐⭐（适用于展示和分享需求）
用户体验评分：⭐⭐⭐（界面简洁流畅，功能直观易用）
部署难度评估：⭐⭐（配置过程简单直接）