PiGallery2
快速、目录优先的相册网站，专为低资源服务器（如树莓派）优化，只读不修改原文件。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
给树莓派等低配设备用的极简相册，按文件夹展示照片，绝不碰你的原图。
核心功能
- 极致轻量：树莓派也能流畅运行
- 目录优先：直接按你的文件夹结构展示照片
- 只读安全：绝不修改原始照片文件
- 一键Docker部署，无需复杂配置
避坑指南
- •首次访问可能需等待30-60秒，因为容器启动加载索引。
- •不支持在线编辑/删除照片（只读设计）。
- •原生安装方式不官方维护，建议始终用Docker。
- •大量照片（数万张）首次扫描较慢，后续会缓存。
适用场景
- 家庭照片服务器，让家人随时浏览
- 树莓派NAS + 相册，低功耗全天候运行
- 个人备份照片查看器，不破坏原始文件
详细介绍
PiGallery2 是一款为低性能服务器（尤其是树莓派）优化的快速相册网页应用。它直接读取你现有的文件夹结构来展示照片，绝不修改原始文件。采用 Docker 一键部署，安装极其简单。主要特点包括：目录优先浏览、只读模式保护原文件、极低资源占用、支持常见图片格式。非常适合家庭媒体服务器、个人备份库或轻量级云相册。提供基础的用户权限和分享功能。
常见问题与排障 (1)
故障排除如何修复启用VAAPI硬件加速时出现的FFmpeg错误：'Option hwaccel cannot be applied to output url'？
当硬件加速选项（如 -hwaccel vaapi）被放置在输出文件之后时，会出现此错误。请确保所有硬件加速选项都位于输入文件（-i）之前。示例命令：ffmpeg -hwaccel vaapi -hwaccel_output_format vaapi -vaapi_device /dev/dri/renderD128 -i input.mp4 ...
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已安装Docker（无Docker则先安装）
步骤2：运行命令：docker run -p 80:80 -v /你的照片目录:/app/data/images -v pigallery2-config:/app/data/config bpatrik/pigallery2
步骤3：浏览器访问 http://localhost 即可看到你的照片目录
- 步骤1：确保已安装Docker（无Docker则先安装）
- 步骤2：运行命令：docker run -p 80:80 -v /你的照片目录:/app/data/images -v pigallery2-config:/app/data/config bpatrik/pigallery2
- 步骤3：浏览器访问 http://localhost 即可看到你的照片目录
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器：docker stop [容器名]；删除容器：docker rm [容器名]；删除镜像：docker rmi bpatrik/pigallery2；删除数据卷：docker volume rm pigallery2-config（注意：会删除配置，但不会影响原照片文件夹）。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ