记录一次 Lsky Pro 2.1 在低配服务器上的 CPU 异常、PHP-FPM OOM 与上传 502 的完整处理过程。
引言
我对图床的要求其实很简单:稳定上传、别动不动给我 502。
本来这套兰空图床已经安安稳稳跑了很久,直到某天晚上连续传了几张大图,监控里的 CPU 突然被拉满,上传页面一直转圈,最后直接返回 502。重启容器之后能好一阵,但只要再传大图,问题又会复现。
一开始我以为是 Nginx 或 MySQL 的问题,后来翻了内核日志和 PHP-FPM 的记录,才发现事情没那么简单:真正的凶手是一张 8000×6000 的 48MP 大图,以及兰空默认的图片处理链路。
这篇文章就把这次排查和处理的整个过程记录下来,给同样用低配服务器跑兰空图床的朋友一个参考。
我的环境状况
先说一下这台服务器的配置,方便大家对号入座:
| 项目 | 配置 |
|---|---|
| 云服务器 | 2 vCPU / 1.6GB RAM / 40GB 系统盘 |
| 操作系统 | Ubuntu 24.04 |
| 图床程序 | Lsky Pro 2.1 |
| 运行方式 | Docker Compose |
| Web 服务 | Nginx + PHP-FPM 8.2 |
| 数据库 | MySQL 8.0 |
| 图片存储 | S3 兼容对象存储 |
| Swap | 无 |
这个配置跑一个小图床勉强够用,但有一个很致命的点:内存只有 1.6GB,而且没有 Swap。
图床里已经有几百张图片,平时访问量不大,CPU 基本是空闲状态。所以问题不是“平时一直满载”,而是一上传大图就瞬时打满,然后触发 OOM。
处理操作
1. 先看现场:CPU、负载和 OOM
出问题的时候,先看三个地方:系统负载、容器资源、内核日志。
uptime
docker stats --no-stream
dmesg -T | grep -iE "out of memory|oom-kill|killed process"
当时看到的现象大概是这样的:
load average: 0.01, 10.57, 15.33
Out of memory: Killed process 2884 (php-fpm)
total-vm:1209032kB, anon-rss:834064kB
PHP-FPM 单个子进程的 RSS 已经到 834MB,而服务器总共只有 1.6GB 内存。内存不够用之后,kswapd0 开始频繁回收页面,CPU 又被进一步吃掉,最后就是上传 502、容器被 OOM Killer 干掉。
另外一个细节是,PHP-FPM 里还有一个子进程已经跑了 3.7 天。这种长期不回收的进程,本身也会让内存占用越来越难看。
2. 找到大图,确认图片尺寸
接着查了一下最近上传的图片:
SELECT id, name, size, width, height
FROM images
ORDER BY id DESC
LIMIT 10;
结果里出现了:
8000 × 6000
一张 48MP 的 JPEG,文件可能只有几 MB,但解码成像素之后,内存占用完全不是一个量级。按 RGBA 粗略估算,单张图就要几百 MB,再加上缩放、编码时的副本,很容易冲到 800MB 以上。
再看用户组的配置:
image_save_quality = 82
concurrent_upload_num = 50
问题就很明显了。
3. 根因:上传链路里做了太多“重活”
兰空的上传流程里,有两个地方非常吃资源:
- 图片保存质量小于 100 时,会重新编码
- 上传完成后会同步生成缩略图
简化一下代码逻辑,大概是这样:
if ($quality < 100 || $format) {
$handleImage = InterventionImage::make($file)->save(...);
}
以及:
$this->makeThumbnail($image, $file);
这两步都会让 Imagick 把原图完整解码。对于 48MP 的图片来说,解码一次就是几百 MB 内存;如果同时传几张,再加上 PHP-FPM 默认的 5 个子进程,OOM 几乎是必然的。
所以这次问题的本质不是兰空“有 bug”,而是:
默认配置 + 大尺寸原图 + 低内存服务器 + 无 Swap,几个因素叠在一起了。
4. 调整图床的保存策略
第一步先把上传时的重编码关掉。
我直接把用户组的图片保存质量改成了 100:
UPDATE `groups`
SET configs = JSON_SET(
configs,
'$.image_save_quality', 100,
'$.concurrent_upload_num', 3
)
WHERE id = 2;
质量设为 100 后,兰空会跳过上传时的二次编码,CPU 和内存占用会立刻降下来。代价是图片不会被重新压缩,存储体积会大一些。
同时把并发上传数从 50 降到 3,避免多张大图同时进入处理链路。
如果你确实需要压缩,我的建议是:在上传前用本地工具压好,再传给图床。 不要把压缩这件事交给只有 2 核的服务器。
5. 超大图跳过缩略图
只关掉重编码还不够,因为缩略图仍然会全量解码原图。
我加了一个保护:超过 2400 万像素的图片,不再生成服务端缩略图。
public function makeThumbnail(Image $image, mixed $data, int $max = 400, bool $force = false): void
{
// 超大图不做服务端缩略图,避免 Imagick 全量解码打满 CPU/内存
if ($image->width * $image->height > 24000000) {
return;
}
$pathname = public_path($image->getThumbnailPathname());
// ...
}
这样 48MP 的图片上传时不会再触发缩略图解码。没有缩略图时,兰空的 thumb_url 会自动回退到原图,功能不受影响,只是后台列表会加载原图,速度慢一点。
对于低配服务器来说,这个取舍是值得的:宁可少一张缩略图,也不要再 OOM。
6. 收窄 PHP-FPM 的并发和生命周期
接下来给 PHP-FPM 加一层保险。
原来的配置是:
pm.max_children = 5
pm.start_servers = 2
pm.max_spare_servers = 3
改成了:
pm.max_children = 2
pm.start_servers = 1
pm.max_spare_servers = 2
pm.max_requests = 200
request_terminate_timeout = 300s
request_slowlog_timeout = 10s
slowlog = /var/log/php-fpm-slow.log
php_admin_value[memory_limit] = 256M
php_admin_value[max_execution_time] = 300
几个参数的作用:
pm.max_children = 2:最多两个 PHP 进程同时处理请求,避免内存叠加。pm.max_requests = 200:子进程处理一定请求数后自动回收,防止长期运行导致内存膨胀。request_terminate_timeout = 300s:异常卡死的请求会被强制结束,不会一直占着进程。memory_limit = 256M:给单个 PHP 进程设置内存上限。slowlog:记录执行超过 10 秒的请求,方便以后继续排查。
这些配置通过 Docker Compose 只读挂载进容器,重建容器后也不会丢。
7. 限制 ImageMagick 的资源
PHP 层限制了,ImageMagick 层也要限制。
原来的策略给得比较宽松:
<policy domain="resource" name="memory" value="1024MiB"/>
<policy domain="resource" name="map" value="2048MiB"/>
<policy domain="resource" name="area" value="256MP"/>
<policy domain="resource" name="disk" value="2GiB"/>
我改成了更适合这台机器的值:
<policy domain="resource" name="memory" value="256MiB"/>
<policy domain="resource" name="map" value="512MiB"/>
<policy domain="resource" name="area" value="32MP"/>
<policy domain="resource" name="disk" value="1GiB"/>
<policy domain="resource" name="width" value="12000"/>
<policy domain="resource" name="height" value="12000"/>
这样即使以后又遇到超大图,Imagick 也不会无限制地吃内存,而是会触发资源限制或走磁盘缓存,至少不会把整台机器拖死。
8. 增加 2GB Swap 兜底
最后加了一块 2GB 的 Swap。
fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
# 开机自动挂载
echo "/swapfile none swap sw 0 0" >> /etc/fstab
# 降低换出频率
printf "vm.swappiness=10\n" > /etc/sysctl.d/99-lsky-swap.conf
sysctl -w vm.swappiness=10
需要强调的是:Swap 只是兜底,不是解决方案。 真正解决问题的是上面那些图片处理和并发限制。Swap 的作用是万一内存再次冲高,系统还有一点缓冲,不至于立刻 OOM。
9. 重启并验证
改完配置后,重建兰空容器并重载 Nginx:
cd /root/my_server/apps/lsky
docker compose up -d
docker exec nginx-proxy nginx -s reload
然后确认几件事:
# 站点是否正常
curl -I https://image.ilibilib.top/
# PHP-FPM 实际配置
docker exec lsky-app php-fpm -tt 2>&1 | grep -E "pm.max_children|memory_limit|request_terminate_timeout"
# ImageMagick 资源限制
docker exec lsky-app php -r '
$i = new Imagick();
echo $i->getResourceLimit(Imagick::RESOURCETYPE_MEMORY), PHP_EOL;
'
我也用一张普通图片和一张 48MP 图片分别验证了缩略图逻辑:普通图片可以正常生成缩略图,48MP 图片会直接跳过,不会再去解码整张原图。
处理后的状态:
| 项目 | 处理前 | 处理后 |
|---|---|---|
| 空闲 CPU | 瞬时打满 | 约 0% |
| load average | 10 ~ 100+ | 约 0.21 |
| PHP-FPM 子进程 | 5 个,单个可达 834MB | 2 个,约 44MB |
| Swap | 0 | 2GB |
| 大图上传 | 502 / OOM | 不再触发缩略图解码 |
结语
这次排查给我最大的感受是:低配服务器跑图床,瓶颈往往不是带宽,而是图片解码。
一张看起来只有几 MB 的 48MP JPEG,解码之后占用的内存可能超过很多人的想象。如果再叠加“上传时重编码”“同步生成缩略图”“PHP-FPM 多进程并发”这几个默认行为,1.6GB 内存的机器其实很容易被击穿。
这次的处理思路可以总结成三句话:
- 能不解码就不解码:质量设为 100,跳过大图缩略图。
- 能少并发就少并发:PHP-FPM 限制子进程数,上传并发降下来。
- 给资源加边界:PHP、ImageMagick、Swap 都设置上限和兜底。
如果你的兰空图床也跑在 2C1.6G 或类似配置上,建议先检查一下图片保存质量和大图尺寸。如果经常要处理 48MP 原图,升级到 2C4G 或更高配置会更从容;如果不方便升级,至少把上面这些限制加上,别让一张图把整台机器送走。
最后提醒一句:改配置前记得备份。ImageService.php 和用户组配置都值得留一份,出了问题能快速回滚。






