「宝塔面板 + LNMP」快速搭建 Piwigo 私有相册，全程图形化操作，适合新手。
一、环境准备（宝塔面板）
1. 登录宝塔
-
浏览器访问：
http://你的服务器IP:8888 -
输入账号密码登录（首次安装会显示）
2. 安装 LNMP 环境
在「软件商店」安装：
-
Nginx（最新稳定版）
-
MySQL 5.7 或 8.0（推荐 5.7）
-
PHP 8.2+（官方推荐，至少 7.4）
-
安装 PHP 时务必勾选：
gd、exif、fileinfo、zip扩展
-
-
phpMyAdmin（可选，管理数据库）
二、新建网站与数据库
-
左侧「网站」→「添加站点」
-
域名：填你的域名或服务器 IP
-
根目录：默认
/www/wwwroot/你的域名 -
数据库：MySQL，自动创建（记录账号密码）
-
PHP 版本：选刚装的 8.2+
-
-
关闭防跨站（关键）
-
网站 → 对应站点 →「设置」→「防跨站攻击」→ 关闭
-
三、下载并上传 Piwigo 源码
方法 A：官网下载（推荐）
-
下载 Full archive 完整压缩包（约 30MB）
方法 B：网络安装脚本（可选）
-
下载
piwigo-netinstall.php上传到网站根目录，访问后自动下载安装
上传到宝塔
-
网站 → 根目录 →「上传」→ 选刚下的 zip
-
解压到当前目录
-
把解压后所有文件剪切到根目录（避免二级目录）
-
例如：
/www/wwwroot/你的域名/piwigo/*→ 移到/www/wwwroot/你的域名/
-
四、设置目录权限（必须）
在宝塔「文件」管理器，进入网站根目录，对以下目录设置 755 权限（所有者可读写执行）：
-
local/ -
galleries/ -
cache/ -
upload/命令（SSH 执行）：
chmod -R 755 /www/wwwroot/你的域名/local chmod -R 755 /www/wwwroot/你的域名/galleries chmod -R 755 /www/wwwroot/你的域名/cache chmod -R 755 /www/wwwroot/你的域名/upload
五、浏览器安装 Piwigo
-
访问你的域名 / IP，自动进入安装页面
-
填写数据库信息（宝塔创建时的）：
-
数据库主机：
localhost或127.0.0.1 -
数据库名：宝塔自动生成的（如
piwigo） -
用户名：数据库用户名
-
密码：数据库密码
-
表前缀：默认
piwigo_
-
-
设置管理员账号、密码、邮箱
-
点击「开始安装」→ 完成
六、常见问题解决
-
报错：缺少 gd/ImageMagick
-
宝塔 → 软件商店 → PHP → 安装
gd或ImageMagick扩展，重启 PHP
-
-
目录无写入权限
-
按步骤四重新设置
local、galleries、cache、upload权限为 755
-
-
上传图片失败 / 缩略图不生成
-
确认 PHP
exif、fileinfo已开启 -
内存建议 ≥ 128M，执行时间 ≥ 300s（PHP 设置）
-
七、完成与使用
-
安装完成后，用管理员账号登录后台
-
可直接网页上传照片、创建相册、管理用户
-
支持主题切换、插件扩展（如视频支持、EXIF 读取）