LNMP环境配置常见问题解答

LNMP环境配置常见问题解答

一 快速排查流程

• 明确症状：是访问不了、502/504、白屏、还是服务起不来，记录出现时间与复现路径。
• 服务状态与语法：使用systemctl status nginx php-fpm mariadb查看状态；用nginx -t、php-fpm -t校验配置。
• 资源与端口：用top/htop/vmstat/iostat看CPU/内存/IO；用**ss -tulpen | grep -E ‘(:80|:443|:9000)’**查端口占用与进程。
• 日志定位：优先看**/var/log/nginx/error.log**、/var/log/php-fpm/error.log、/var/log/mysql/error.log，必要时开启更详细的错误报告。
• 连通与策略：测试内外网连通性；核对防火墙/安全组是否放行80/443/9000；如启用SELinux，核查是否拦截。
• 修复与回滚：修改配置后reload/restart对应服务；保留变更记录，便于回滚与复盘。

二 高频问题对照表

三 配置要点与最佳实践

• Nginx与PHP-FPM通信：常用TCP 127.0.0.1:9000或Unix Socket。示例：
  • TCP：
    • Nginx：
      • fastcgi_pass 127.0.0.1:9000;
      • fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      • include fastcgi_params;
    • PHP-FPM（pool）：listen = 127.0.0.1:9000
  • Unix Socket（性能更好）：
    • PHP-FPM：listen = /run/php/php-fpm.sock; listen.owner = nginx; listen.group = nginx; listen.mode = 0660
    • Nginx：fastcgi_pass unix:/run/php/php-fpm.sock;
• PHP安全与性能：在php.ini中设置cgi.fix_pathinfo=0；按站点需要开启必要扩展（如mysqli/pdo_mysql/gd/mbstring）；设置合适的memory_limit、upload_max_filesize、post_max_size。
• 文件权限：网站根目录建议755，文件644；目录属主与Nginx/PHP-FPM运行用户保持一致（如nginx:nginx或www-data:www-data）。
• 防火墙与SELinux：放行80/443（以及PHP-FPM监听端口/套接字所在目录）；SELinux可用setsebool -P httpd_can_network_connect 1（按需）或临时setenforce 0排查。

四 日志位置与典型错误关键词

• 日志路径与用途
  • Nginx：/var/log/nginx/error.log（语法错误、端口占用、权限拒绝、上游不可用等）
  • PHP-FPM：/var/log/php-fpm/error.log或按版本如**/var/log/php7.x-fpm.log**（进程崩溃、连接被拒、脚本错误等）
  • MySQL/MariaDB：/var/log/mysql/error.log（启动失败、权限错误、崩溃恢复等），慢查询日志用于性能排查
• 典型关键词
  • Nginx：bind() to 0.0.0.0:80 failed (98: Address already in use)、permission denied、no such file、upstream prematurely closed connection while reading response header from upstream
  • PHP-FPM：connect() to 127.0.0.1:9000 failed (111: Connection refused)、File not found、Allowed memory size exhausted
  • MySQL：Can’t connect to MySQL server on ‘localhost’ (111)、Access denied for user、InnoDB: Operating system error

五 性能与稳定性优化

• PHP-FPM进程模型：根据内存与并发调pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers；高峰期可适当提高，避免OOM或进程饥饿。
• 静态资源与缓存：开启gzip；对图片/CSS/JS使用浏览器缓存与CDN；启用Nginx FastCGI缓存或OPcache提升PHP执行效率。
• 数据库：开启慢查询日志定位瓶颈；合理设置innodb_buffer_pool_size等关键参数；按需建立索引与优化SQL。
• 连接与超时：在Nginx与PHP-FPM中设置合理的fastcgi_read_timeout/fastcgi_send_timeout、request_terminate_timeout，避免长请求拖垮进程池。