bpatrik/pigallery2

PiGallery2

概述和主要用途

PiGallery2是一个以目录优先的照片画廊网站，提供丰富的用户界面，专为低资源服务器（尤其是树莓派）优化。它能递归展示目录结构，动态生成缩略图，支持多种图片和视频格式，适合个人或小型服务器上的照片管理与展示。

官网：http://bpatrik.github.io/pigallery2/

实时演示

Heroku实时演示：[***]

• 演示页面首次加载可能需要30秒（免费服务启动时间）

!PiGallery2 - 动画演示

核心功能和特性

支持的媒体格式

• 图片：jpg, jpeg, jpe, webp, png, gif, svg
• 视频：mp4, ogg, ogv, webm

目录渲染

• 递归列出子目录
• 网格布局展示照片
  • 显示标签/关键词、位置、GPS坐标
  • 滚动时按需渲染照片

动态缩略图生成

• 多种尺寸缩略图生成
• 优先为可见照片生成缩略图
• 缩略图保存到临时文件夹重用
• 支持多核CPU和硬件加速（sharp/gm可选，Jimp作为JS fallback）

自定义灯箱

• 全屏照片/视频查看
• 键盘导航支持
• 加载时显示低分辨率缩略图
• Exif信息面板
• 视频自动播放
• 手势操作（左右滑动、上滑）
• 快捷键支持

其他核心功能

• 客户端缓存（目录和搜索结果）
• GPS照片地图渲染
  • 支持.gpx文件路径显示
  • 默认集成OSM和Mapbox，可自定义地图提供商
• 两种运行模式
  • 无数据库模式：基础用户管理和密码保护
  • SQL数据库模式：更快的目录列表、即时搜索（含自动完成）、分享功能（支持链接过期）
• 人脸支持：读取XMP人脸区域元数据，显示人脸边界框
• 国际化：支持多语言（当前含英语、匈牙利语）
• 响应式设计：适配手机、平板、桌面设备
• 设置页面UI：可视化配置界面
• 随机照片URL：生成随机照片链接，可用于第三方应用（如桌面背景）
• Docker化部署：简化安装和依赖管理

使用场景和适用范围

• 低资源设备：特别优化用于树莓派等嵌入式设备
• 个人照片管理：以原生目录结构组织照片集
• 家庭/小型团队：简单部署的照片共享平台
• 地理标记照片展示：集成地图显示带GPS坐标的照片和路径

详细使用方法和配置说明

1. 快速开始

1.1 直接安装（树莓派适用）

1.1.0 安装Node.js

bash
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

树莓派完整Node.js安装指南：[***]

1.1.1 安装PiGallery2

从发布版安装

bash
cd ~
wget https://github.com/bpatrik/pigallery2/releases/download/1.7.0/pigallery2.zip
unzip pigallery2.zip -d pigallery2
cd pigallery2
npm install

从源码安装

bash
cd ~
wget https://github.com/bpatrik/pigallery2/archive/master.zip
unzip master.zip
cd pigallery2-master
npm install
npm build

注意：运行npm run create-release可在release文件夹生成生产就绪版本；使用npm run create-release -- --languages=fr,ro可限制构建语言（默认包含英语）

1.1.2 运行应用

bash
npm start

首次运行将生成config.json配置文件，默认管理员账户：admin，密码：admin。可通过UI设置界面或直接编辑配置文件进行自定义。

1.2 Docker运行

无需安装依赖，直接使用Docker镜像。所有镜像标签：https://hub.docker.com/r/bpatrik/pigallery2/tags/

基础运行命令：

bash
docker run -d -p 80:3000 \
  -v /本地照片路径:/app/data/photos \
  -v /本地配置路径:/app/config \
  bpatrik/pigallery2:latest

• -p 80:3000：端口映射（主机端口:容器端口）
• -v /本地照片路径:/app/data/photos：挂载照片目录
• -v /本地配置路径:/app/config：持久化配置文件

Docker配置详情：https://github.com/bpatrik/pigallery2/blob/master/docker/README.md

1.3 高级配置

支持四种配置方式：

• UI设置界面：通过应用内可视化配置
• 编辑config.json：首次运行后生成，手动修改后重启
• 命令行参数：

  bash
  node start -- --Server-port=3000 --Client-authenticationRequired=false
  

  （运行npm start -- --config-only可仅生成配置文件）
• 环境变量：如Server-port=3000

1.4 实用提示

• Nginx反向代理：建议配置Nginx作为前端代理，提升性能和安全性（参考：[***]
• HTTPS配置：使用Certbot快速部署SSL证书（参考：[***]
• 依赖安装问题：若模块安装失败，安装构建工具：

  bash
  apt-get install build-essential libkrb5-dev gcc g++
  

2. 自定义语言翻译

1. 从源码安装应用（发布版不支持翻译）
2. 添加目标语言（如法语）：

   bash
   npm run add-translation -- --fr
   

   在src/frontend/translate生成messages.fr.xls（含谷歌翻译初稿）
3. 编辑翻译文件修正内容
4. 测试翻译：

   bash
   npm install
   npm start
   

5. （可选）提交PR将翻译贡献到项目

已知错误

• EXIF方向标签：处理EXIF方向信息可能导致加载延迟（详见：https://github.com/bpatrik/pigallery2/issues/11%EF%BC%89
• 弱服务器视频播放：低带宽环境下视频可能占用过多资源，建议转码为低比特率版本

致谢

跨浏览器测试由Browser Stack赞助
[]([***]