responsive-photo-gallery 镜像文档

镜像概述和主要用途

responsive-photo-gallery是一个基于NodeJS和Express框架的后端服务，旨在以移动友好且美观的方式展示照片集。默认在3000端口启动Web服务器，支持通过Docker容器快速部署或作为Node模块运行。提供照片浏览、缩略图缓存、API认证等功能，并可通过环境变量灵活配置。

核心功能和特性

• 移动友好的照片展示界面，适配多种设备尺寸
• 自动生成和缓存照片缩略图，提升加载性能
• 基于JWT的API认证机制，保障访问安全
• 内置Swagger文档（访问路径/api-docs/），方便API调试
• 支持持久化存储配置和认证数据，确保服务重启后配置不丢失
• 丰富的环境变量配置，支持端口、路径、密钥等参数自定义

使用场景和适用范围

• 个人照片库：搭建个人专属的照片展示平台
• 家庭相册：创建共享家庭照片库，支持多设备访问
• 小型团队：用于团队内部照片资源的集中管理和分享
• 开发者测试：作为照片服务后端进行API开发和集成测试

使用方法和配置说明

Docker容器部署

通过Docker容器快速部署，需挂载照片目录和持久化存储目录：

docker run -d --name responsive-photo-gallery \
  -v '/path/to/album/folders:/images:ro' \  # 本地照片目录（只读挂载）
  -v '/your/persistent/storage/dir:/data:rw' \  # 持久化存储目录（配置、缩略图等，读写挂载）
  -p 8000:3000 \  # 端口映射（本地8000端口映射到容器3000端口）
  jwater7/responsive-photo-gallery

部署完成后，通过浏览器访问http://localhost:8000即可使用照片库服务。

作为Node模块运行

如需本地开发或自定义，可作为Node模块运行：

# 安装依赖
npm install
cd frontend
npm install
cd ..

# 构建前端资源
npm run build-frontend

# 启动服务
npm start

环境变量配置

通过环境变量自定义服务行为，支持以下参数：

后端配置变量

前端配置变量