viktorstrate/photoview

Photoview 照片画廊

!https://raw.githubusercontent.com/viktorstrate/photoview/master/screenshots/photoview-logo.svg

!https://raw.githubusercontent.com/viktorstrate/photoview/master/screenshots/main-window.png

概述

Photoview 是一款简单易用的照片画廊，可轻松部署在个人服务器上。它专为摄影师设计，旨在提供一种简单快速的方式来浏览包含数千张高分辨率照片的目录。

演示站点

访问 [***]
用户名：demo
密码：demo

核心功能

与文件系统紧密关联

网站展示服务器本地文件系统中的图片，目录直接映射为相册，无需额外数据库管理。

用户管理

每个用户创建时关联本地文件系统路径，仅可访问该路径下的照片，实现权限隔离。

照片分享

支持将照片或相册通过唯一URL分享给其他用户或公开访问，分享方式灵活。

专为摄影设计

支持RAW文件格式及EXIF信息解析，满足摄影师对专业格式的需求。

高性能体验

自动生成缩略图，照片按需加载（仅在屏幕可见时加载），全屏模式下先显示缩略图直至高清图加载完成，确保流畅浏览。

Docker部署

本节介绍如何通过Docker在服务器上部署Photoview。确保已安装并运行Docker和docker-compose。

步骤1：创建docker-compose.yml文件

在本地创建新的docker-compose.yml文件，复制https://github.com/viktorstrate/photoview/blob/master/docker-compose.example.yml%E4%B8%AD%E7%9A%84%E5%86%85%E5%AE%B9%E5%88%B0%E8%AF%A5%E6%96%87%E4%BB%B6%E3%80%82

步骤2：编辑配置文件

打开docker-compose.yml，找到以Change This:开头的注释，根据实际环境修改对应值。本地测试可保持默认配置。

步骤3：启动服务

执行以下命令启动服务：

bash
$ docker-compose up -d

若未修改docker-compose.yml中的端点或端口，服务可通过 http://localhost:8000 访问。

初始设置

若部署正确，首次访问网站时将显示初始设置向导。

!https://github.com/viktorstrate/photoview/raw/master/screenshots/initial-setup.png

设置管理员账户

输入新的用户名和密码。

配置照片路径

照片路径需填写Docker容器内的路径，该路径通过docker-compose.yml中api->volumes配置映射。默认路径为/photos。

完成设置

系统将创建新管理员用户，其可访问初始设置中指定路径下的照片。

扫描照片

照片需扫描后才会显示，可手动启动扫描：导航至“设置”页面，点击“全部扫描”。