NAS部署Piwigo开源相册完整指南：Docker Compose一键搭建私有图片库

Piwigo：

在数字化时代，我们的照片散落在手机、硬盘、云盘等各处，管理起来异常繁琐。公有云相册存在隐私担忧、存储空间限制和订阅费用等问题。Piwigo 作为一款开源、可自托管的照片管理软件，为组织、团队和个人提供了将照片管理权收回自己手中的解决方案。

本文将手把手指导您，如何通过 Docker Compose 在您的NAS上快速部署 Piwigo，构建一个完全私有的、可通过网页轻松访问和管理的个人或家庭相册中心。

Piwigo 是一款诞生于2002年的成熟开源项目，其核心设计理念是专注照片管理本身。它不追求花哨的AI功能，而是提供了稳定、可靠的照片上传、分类、标注和共享的基础能力。

核心特性一览：

开源免费：代码完全开放，可免费部署和使用。
网页化管理：通过浏览器即可完成所有照片管理操作，无需安装专用客户端。
多用户支持：可创建不同用户并分配权限，适合家庭或小团队共享。
多主题切换：提供多种界面主题，可根据喜好更换。
插件扩展：支持通过插件扩展功能（如添加水印、连接社交媒体等）。
原生中文支持：界面完全中文化，对中文用户友好。

Demo 站点：

https://piwigo.org/demo

安装

Docker Compose

services:
  piwigo-main:
    image: piwigo/piwigo:latest
    container_name: piwigo-main
    ports:
      - 8080:80
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./piwigo:/var/www/html/piwigo
      - ./scripts:/usr/local/bin/scripts
    depends_on:
      - piwigo-db
    restart: always

  piwigo-db:
    image: docker.io/library/mariadb:lts
    container_name: piwigo-db
    environment:
      - MARIADB_RANDOM_ROOT_PASSWORD=false
      - MARIADB_DATABASE=piwigodb
      - MARIADB_USER=piwigodb_user
      - MARIADB_PASSWORD=piwigodb_password
      - TZ=Asia/Shanghai
    volumes:
      - ./mysql:/var/lib/mysql
    restart: always

参数说明（更多参数建议去看文档）

:::
TZ（环境变量）：时区设置

/var/www/html/piwigo（路径）：piwigo 配置文件

/usr/local/bin/scripts（路径）：额外加载依赖项和其他文件

MARIADB_RANDOM_ROOT_PASSWORD（环境变量）：是否开启随机密码

MARIADB_DATABASE（环境变量）：数据库名称

MARIADB_USER（环境变量）：数据库用户账号

MARIADB_PASSWORD（环境变量）：数据库用户账号的密码

/var/lib/mysql（路径）：数据库文件

:::

使用

浏览器中输入 http://NAS的IP:8080 就能看到界面

先切换默认语言为“简体中文”

按实际情况，填写数据库信息（如果是复制上面模板部署，可以参考填入）

piwigo-db
piwigodb_user
piwigodb_password
piwigodb

设置管理员账户

都设置完成，就可以点击“开始安装”

如果显示这个界面，说明数据库正常连接，已经安装完成可以使用了

后面再添加图片，点击跳过

进入面板，整体界面比较简陋

右上角，点击进入管理后台

管理后台，目前还没占用空间

创建一个相册

填写相册名称，点击创建

创建成功后，点击添加图片

点击“开始上传”

图片上传完成

回到首页，就能看到前面创建的相册

图片展示效果还行

点开单张图片样式（右边显示信息有点问题）

如果对默认主题不喜欢，也提供很多主题

总结

Piwigo 是一款定位清晰的开源工具。它用一个词概括就是：“够用”。

✅ 优点：
- 部署简单，Docker一行命令搞定。
- 逻辑清晰，相册-图片的管理方式符合直觉。
- 完全自主，数据隐私有保障。
- 资源占用低，对老旧NAS友好。
⭕ 不足：
- 界面设计相对传统，现代化程度一般。
- 缺乏AI智能功能（人脸识别、场景分类、智能搜索等）。
- 原生手机端App体验较弱（虽有第三方App，但体验不一）。