Leantime项目Docker部署性能优化指南

在Leantime项目管理系统的Docker部署过程中，性能问题是一个常见挑战。本文将深入分析性能瓶颈的原因，并提供多种优化方案，帮助用户提升系统响应速度。

性能问题现象分析

当使用Docker部署Leantime时，用户可能会遇到以下典型症状：

1. 页面加载时间长达10-15秒
2. 操作响应缓慢
3. 容器日志中出现"server reached pm.max_children setting"警告
4. 界面元素频繁重新加载

根本原因解析

这些问题主要源于PHP-FPM配置不足。默认配置中：

• pm.max_children设置为5（处理并发请求的PHP子进程数）
• 其他相关参数如pm.start_servers、pm.min_spare_servers等也较为保守

当并发请求超过配置值时，系统会出现排队等待，导致响应延迟。

优化方案详解

方案一：通过custom.ini文件配置

在宿主机创建config/custom.ini文件，包含以下优化参数：

pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 10
pm.max_spare_servers = 20
pm.max_requests = 2000
memory_limit = 5G
post_max_size = 50M
upload_max_filesize = 50M

将此文件挂载到容器内的/usr/local/etc/php/conf.d/custom.ini位置。

方案二：直接修改PHP-FPM配置

对于更彻底的优化，可以直接修改容器内的PHP-FPM配置文件：

1. 进入容器查找/usr/local/etc/php-fpm.d/www.conf文件
2. 修改以下参数：

pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 10
pm.max_spare_servers = 20
pm.max_requests = 2000

方案三：创建自定义Docker镜像

通过Dockerfile创建优化后的镜像：

FROM leantime/leantime:latest

WORKDIR /usr/local/etc/php/conf.d
RUN sed -i 's/memory_limit = 1G/memory_limit = 5G/' custom.ini
RUN echo 'pm = dynamic' >> custom.ini \
    && echo 'pm.max_children = 50' >> custom.ini \
    && echo 'pm.start_servers = 10' >> custom.ini \
    && echo 'pm.min_spare_servers = 10' >> custom.ini \
    && echo 'pm.max_spare_servers = 20' >> custom.ini

RUN sed -i 's/^pm = .*/pm = dynamic/' /usr/local/etc/php-fpm.d/www.conf \
    && sed -i 's/^pm.max_children = .*/pm.max_children = 50/' /usr/local/etc/php-fpm.d/www.conf \
    && sed -i 's/^pm.start_servers = .*/pm.start_servers = 10/' /usr/local/etc/php-fpm.d/www.conf \
    && sed -i 's/^pm.min_spare_servers = .*/pm.min_spare_servers = 10/' /usr/local/etc/php-fpm.d/www.conf \
    && sed -i 's/^pm.max_spare_servers = .*/pm.max_spare_servers = 20/' /usr/local/etc/php-fpm.d/www.conf

参数调优建议

1. pm.max_children：根据服务器内存调整，每个PHP进程约消耗20-30MB内存
2. pm.start_servers：初始PHP进程数，建议设置为预期平均负载
3. spare_servers：保持足够的空闲进程处理突发请求
4. memory_limit：根据应用需求调整，避免内存不足

其他优化建议

1. 确保Docker主机有足够资源（建议至少3GB内存）
2. 检查反向代理配置（如Traefik/Nginx）是否合理
3. 考虑使用独立的MySQL容器而非共享实例
4. 监控容器资源使用情况，动态调整参数

实施后的验证

优化后应检查：

1. 容器日志中不再出现PHP-FPM警告
2. 页面加载时间降至毫秒级
3. 系统能够稳定处理并发请求

通过以上优化措施，Leantime在Docker环境中的性能可以得到显著提升，为用户提供流畅的使用体验。