Photoview
一款简洁易用的自托管照片画廊，自动索引目录、生成缩略图，支持 RAW 格式和 EXIF，自带人脸识别。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
专为摄影师打造的自托管照片相册，一键 Docker 部署，管理万张高清照片。
核心功能
- 紧密绑定文件系统：目录结构直接映射为网页相册
- 用户管理：每个用户可绑定独立的媒体路径
- 共享功能：相册或单张媒体可通过链接分享，可选密码保护
- 支持 RAW 格式及 EXIF 解析
- 视频支持：常见格式自动转码为 web 优化格式
避坑指南
- •注意：Docker 镜像仓库已迁移到 new registry，旧 compose 文件中的镜像地址需要更新。PostgreSQL 版本在 master 分支切换到了 18，升级前务必备份数据库。不支持 Portainer 等封装层，遇到问题请在原生 Docker Compose 环境中复现。
适用场景
- 摄影师集中管理并展示自己的高分辨率作品集
- 家庭用户自建私有云相册，替代 Google Photos
- 媒体爱好者按文件夹结构组织并分享大量照片和视频
详细介绍
Photoview 是一款专为摄影师打造的、界面简洁易用的自托管照片和视频相册。它能扫描你文件系统中的指定目录，并以文件夹结构为蓝本将内容呈现在网页上。核心亮点包括：支持 RAW 格式（如 CR2、NEF、ARW 等）和 EXIF 元数据提取；自动生成缩略图，浏览超快；视频转码后可直接在浏览器播放；内置人脸识别功能，自动将同一个人物的照片归类。用户管理方面，每个用户可以绑定不同的媒体目录，并可对外共享整本相册或单张照片，支持密码保护。Photoview 支持通过 Docker、Debian/Ubuntu、Arch Linux、NixOS、Unraid、YunoHost 和 TrueNAS 等方式部署，数据库可选 SQLite、MariaDB 或 PostgreSQL。该项目维护活跃，Discord 社区响应及时。
常见问题与排障 (1)
故障排除如何修复在Photoview中添加CR3文件时出现的'unsupported media type'错误？
Photoview 目前无法显示 CR3 文件。作为临时解决方案，使用 exiftool 提取嵌入的全尺寸 JPEG：exiftool -b -JpgFromRaw IMAGE.CR3 > IMAGE.JPG。然后将生成的 JPG 添加到您的库中。未来的更新将本地自动化此提取过程。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已安装 Docker 和 Docker Compose
步骤2：下载官方 docker-compose.example.yml 文件，保存为 docker-compose.yml
步骤3：修改环境变量，设置管理员密码和媒体目录路径
- 步骤1：确保已安装 Docker 和 Docker Compose
- 步骤2：下载官方 docker-compose.example.yml 文件，保存为 docker-compose.yml
- 步骤3：修改环境变量，设置管理员密码和媒体目录路径
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
进入 docker-compose.yml 所在目录，执行 `docker compose down -v` 删除容器和卷。如需彻底清除数据库和配置文件，手动删除持久化目录。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ