piwigo/piwigo

Piwigo Docker 镜像

镜像概述

基于Alpine的Piwigo容器，旨在简化照片画廊的部署流程。Piwigo是一款开源照片管理系统，该镜像集成Nginx和PHP-FPM，提供轻量、高效的运行环境，适合个人或小型团队搭建和管理照片库。

核心功能与特性

• 轻量基础：基于Alpine Linux，镜像体积小，资源占用低
• 完整组件：集成Nginx、PHP-FPM和MariaDB数据库，提供一站式部署
• 数据持久化：所有关键数据（照片文件、数据库）持久化存储，确保数据安全
• 灵活配置：支持自定义端口、时区，可集成反向代理
• 易于维护：提供备份、更新流程，支持用户自定义脚本扩展功能

使用场景

• 个人照片库搭建
• 家庭或小团队照片共享平台
• 摄影爱好者作品展示网站
• 需要简单部署和管理的中小型图片管理系统

使用方法

启动容器

准备文件结构

创建Piwigo文件夹，并在其中创建compose.yaml和.env文件：

Piwigo
├── .env
└── compose.yaml

编写compose.yaml

yaml
networks:
  piwigo-network:
    external: false

services:
  piwigo-main:
    image: docker.xuanyuan.run/piwigo/piwigo:latest
    restart: always
    environment:
      - TZ=${timezone}
    networks:
      - piwigo-network
    ports:
      - ${piwigo_port}:80
    depends_on:
      - piwigo-db
    volumes:
      - ./piwigo-data/piwigo:/var/www/html/piwigo/
      - ./piwigo-data/scripts:/usr/local/bin/scripts/
  piwigo-db:
    image: docker.xuanyuan.run/library/mariadb:lts
    restart: always
    environment:
      - MARIADB_RANDOM_ROOT_PASSWORD=true
      - MARIADB_USER=piwigodb_user
      - MARIADB_DATABASE=piwigodb
      - MARIADB_PASSWORD=${db_user_password} 
      - TZ=${timezone}
    networks:
      - piwigo-network
    volumes:
      - ./piwigo-data/mysql:/var/lib/mysql

配置.env文件

编辑.env文件，设置数据库密码、端口和时区：

db_user_password=your_strong_password  # 建议使用强密码，可通过密码生成器生成
piwigo_port=8080  # 暴露的端口，可根据需要修改
timezone=Europe/Paris  # 时区设置，如Asia/Shanghai

启动容器

在Piwigo目录下执行：

bash
docker compose up -d

配置反向代理

如需通过域名或子路径访问，可配置Nginx反向代理。

域名访问配置

nginx
server {
    listen 80;
    server_name my_domain.tld;  # 替换为你的域名
    location / {
        proxy_pass http://127.0.0.1:8080/;  # 与.env中的piwigo_port保持一致
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

子路径访问配置（如my_domain.tld/gallery）

在location段添加X-Forwarded-Prefix头：

nginx
server {
    listen 80;
    server_name my_domain.tld;
    location /gallery/ {  # 子路径
        proxy_pass http://127.0.0.1:8080/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Prefix /gallery;  # 子路径前缀
    }
}

安装Piwigo

容器启动后，通过浏览器访问（如http://localhost:8080），在安装页面填写数据库信息：

• 数据库主机：piwigo-db:3306
• 数据库用户：piwigodb_user
• 数据库密码：.env文件中设置的db_user_password值
• 数据库名称：piwigodb

创建管理员账户后，完成安装。

数据备份

1. 停止容器：

bash
docker compose down

2. 使用rsync备份数据目录：

bash
# --delete-before会删除旧备份，请谨慎使用
rsync -r --delete-before ./piwigo-data/ ./piwigo-data.bck/

更新容器

更新前建议先备份数据

1. 停止容器：

bash
docker compose down

2. 拉取最新镜像：

bash
docker compose pull

3. 重启容器：

bash
docker compose up -d

注意：通过Web界面更新Piwigo不能替代容器更新，需通过上述步骤更新容器。

高级选项

使用MySQL替代MariaDB

编辑compose.yaml，将piwigo-db的镜像改为mysql:lts（注意区分大小写）。

使用现有数据库

若需连接已存在的MySQL/MariaDB数据库，使用compose-nodb.yaml并将其重命名为compose.yaml。可通过.env文件设置piwigo_port或直接编辑compose文件修改端口。

自定义启动脚本

在./piwigo-data/scripts/目录下创建user.sh脚本，可在Nginx和PHP启动前执行命令（以root权限运行）。例如安装额外依赖：

bash
# 安装pandoc示例
apk add --no-cache pandoc

Alpine可用软件包列表可参考https://pkgs.alpinelinux.org/packages。

容器架构

组件构成

• piwigo-main：基于Alpine的Nginx+PHP-FPM容器，运行Piwigo应用
• piwigo-db：MariaDB数据库容器，存储Piwigo数据

网络配置

容器通过piwigo-network桥接网络通信，内部流量隔离。

数据持久化

所有持久化数据存储在./piwigo-data/目录：

• piwigo/：Piwigo应用文件，更新时会自动同步新版本文件
• mysql/：MariaDB/MySQL数据库文件
• scripts/：用户自定义脚本目录，用于扩展功能