whatever4711/picapport

Picapport容器化部署

镜像概述和主要用途

该Docker镜像基于Alpine系统构建，集成了Picapport照片管理工具，提供便捷的照片组织、浏览和网络分享功能。适用于个人或家庭照片库管理，支持跨设备访问照片资源。

核心功能和特性

• 多架构支持：兼容Linux的amd64、i386、arm32v6、arm64v8、ppc64le、s390x架构及Windows的amd64架构
• 灵活配置：通过picapport.properties文件自定义服务器端口、照片路径、缓存策略等参数
• 数据持久化：支持挂载卷存储配置文件、照片库和缓存数据，确保数据不丢失
• 资源控制：可通过环境变量调整Java虚拟机内存分配（初始内存XMS和最大内存XMX）

使用场景和适用范围

• 个人照片库的集中管理与远程访问
• 家庭局域网内照片分享服务
• 需要跨设备（如手机、电脑、平板）访问照片资源的场景

详细使用方法和配置说明

基础启动命令

Windows和Linux系统

bash
docker run -d --name picapport -p 8080:80 whatever4711/picapport

启动后可通过 http://localhost:8080 访问Picapport服务。

自定义配置

1. 创建配置文件 picapport.properties，可配置参数参考Picapport服务器指南，示例配置：

   properties
   server.port=80                  # 容器内服务端口
   robot.root.0.path=/srv/photos   # 容器内照片存储路径
   foto.jpg.usecache=2             # 启用照片缓存
   foto.jpg.cache.path=/srv/cache  # 缓存文件存储路径
   

2. 将配置文件保存到本地文件夹（如 ./config），通过卷挂载到容器。

挂载卷说明

• 配置文件挂载：-v /本地配置文件夹路径:/opt/picapport/.picapport
• 照片库挂载：-v /本地照片文件夹路径:/srv/photos
• 缓存挂载：-v /本地缓存文件夹路径:/srv/cache 或使用Docker卷

完整挂载示例

bash
docker run -d --name picapport \
  -p 8080:80 \
  -v $PWD/config:/opt/picapport/.picapport \
  -v /path/to/fotos:/srv/photos \
  -v /path/to/cache:/srv/cache \
  whatever4711/picapport

Docker Compose配置

使用docker-compose.yml简化部署：

yaml
version: '3'

volumes:
  cache:  # 缓存数据卷

services:
  picapport:
    image: whatever4711/picapport
    restart: always
    expose:
      - 80
    environment:
      - XMS=512m          # Java初始内存分配
      - XMX=1g            # Java最大内存分配
      - PICAPPORT_LANG=de # 界面语言（如de为德语，en为英语）
    networks:
      - backend
    volumes:
      - /path/to/configuration:/opt/picapport/.picapport  # 配置文件目录
      - /path/to/fotos:/srv/photos                         # 照片库目录
      - cache:/srv/cache                                   # 缓存卷

networks:
  backend:

启动命令：docker-compose up -d

环境变量说明