LNMP手动搭建全攻略：从零部署网站到故障排查

1. 从零到一：为什么选择LNMP栈搭建你的第一个网站？

如果你刚拿到一台云服务器，看着黑漆漆的命令行界面，想在上面放点自己的东西，比如一个博客、一个工具站，或者一个简单的展示页面，那么“LNMP”这个组合几乎是你绕不开的起点。LNMP，即 Linux + Nginx + MySQL + PHP，是构建动态网站最经典、最稳定的技术栈之一。它不是什么高深莫测的黑科技，而是经过无数网站验证过的、可靠的生产力工具包。我之所以推荐新手从这里开始，是因为它结构清晰，每一步都有迹可循，能让你在搭建过程中，真正理解一个网站从代码到能被用户访问，中间到底发生了什么。

很多人可能会被“宝塔面板”这类一键管理工具吸引，这当然没问题，它能极大提升效率。但如果你跳过了手动搭建这一步，就像学开车只学会了用自动驾驶，一旦遇到路面湿滑或者系统报错，你可能会完全不知所措。手动搭建一次LNMP，你收获的将不仅仅是一个能运行的网站，更是对Web服务器、应用运行时、数据库这三个核心组件如何协同工作的深刻理解。当你的网站出现“502 Bad Gateway”或者数据库连接失败时，这份理解能帮你快速定位问题，而不是在搜索引擎里漫无目的地翻找。

从网络热词来看，大家的问题非常具体：“-bash: nginx: command not found”、“nginx配置”、“php warning: unable to load dynamic library”，这些都是搭建过程中必然会遇到的“坑”。这篇文章，我就以一个老运维的视角，带你走一遍完整的、基于CentOS 7/8或Ubuntu 20.04/22.04的LNMP手动搭建流程。我会重点解释每个命令背后的意图，以及遇到上述典型问题时，你应该如何思考和解决。我们的目标不是仅仅复制粘贴命令，而是让你能自信地说：“我知道我的网站在我的服务器上是如何运行的。”

2. 基石准备：Linux系统初始化与核心组件安装

在开始安装任何服务之前，我们需要一个干净、稳定的操作系统环境。这里我以CentOS 8 Stream为例（其包管理命令与RHEL/CentOS 7的yum略有不同，使用了dnf，但逻辑相通），Ubuntu用户可以将dnf命令替换为apt-get即可。

2.1 系统更新与基础工具安装

拿到一台新服务器，第一件事永远是更新系统并安装必要的管理工具。这能确保我们从一个已知的、最新的基础开始，并拥有排错的能力。

# 1. 更新系统软件包列表和已安装的包 sudo dnf update -y # 2. 安装常用的基础工具，如网络工具、压缩解压、编辑器等 sudo dnf install -y wget curl vim net-tools tar unzip git

为什么这么做？update操作会同步远程仓库的软件包索引，并升级所有可升级的包，修复已知的安全漏洞。安装wget/curl是为了从网络下载文件；vim是一个高效的文本编辑器（如果你不熟悉，可以用nano替代）；net-tools包含了ifconfig等老牌网络诊断工具；tar和unzip用于处理压缩包；git则便于从代码仓库拉取项目。

2.2 配置防火墙与SELinux（关键避坑点）

这是新手最容易卡住的地方。Linux系统默认有防火墙（firewalld）和SELinux安全模块，它们会阻止未经授权的网络访问和文件操作。我们需要正确配置，而不是简单粗暴地关闭它们（生产环境严禁直接关闭）。

配置Firewalld开放端口：

# 开放HTTP(80)和HTTPS(443)端口 sudo firewall-cmd --permanent --add-service=http sudo firewall-cmd --permanent --add-service=https # 如果你需要远程连接MySQL（通常不建议，仅限本地），开放3306端口 # sudo firewall-cmd --permanent --add-port=3306/tcp # 重新加载防火墙配置使其生效 sudo firewall-cmd --reload # 查看当前开放的端口和服务 sudo firewall-cmd --list-all

处理SELinux：SELinux的严格模式可能会阻止Nginx访问网站目录，或阻止PHP连接MySQL。对于学习环境，我们可以将其模式调整为“宽容”模式，这样它会记录违规但不阻止，方便我们排查问题。

# 查看当前SELinux状态 getenforce # 临时设置为宽容模式（重启后失效） sudo setenforce 0 # 永久设置为宽容模式，需编辑配置文件 sudo vim /etc/selinux/config # 找到 SELINUX=enforcing 这一行，将其改为： # SELINUX=permissive # 保存退出，重启后生效。

注意：生产环境更推荐的做法是，保持SELinux为enforcing模式，但为Nginx、PHP-FPM等进程设置正确的安全上下文（context），使用chcon或semanage命令。但对于初次搭建，permissive模式能让你更专注于核心流程，后续再深入安全优化。

3. 核心组件安装与配置：Nginx, PHP, MySQL

现在，我们开始安装三位主角。安装顺序没有严格要求，但通常先安装数据库和PHP，最后配置Nginx，这样在配置Nginx时，相关的服务都已经就绪。

3.1 MySQL 8.0 数据库安装与安全加固

MySQL是存储网站数据的地方，如用户信息、文章内容等。

# 1. 启用MySQL官方社区版仓库并安装 sudo dnf install -y https://dev.mysql.com/get/mysql80-community-release-el8-4.noarch.rpm sudo dnf module disable mysql # 禁用系统自带的旧版模块 sudo dnf install -y mysql-community-server # 2. 启动MySQL服务并设置开机自启 sudo systemctl start mysqld sudo systemctl enable mysqld # 3. 获取初始随机密码 sudo grep 'temporary password' /var/log/mysqld.log

安装完成后，MySQL会生成一个随机的root用户密码，记录在日志文件中。使用上述命令查看。

安全初始化（非常重要！）：

# 运行安全配置脚本 sudo mysql_secure_installation

执行这个脚本后，它会引导你完成以下步骤：

1. 输入刚才查到的临时密码。
2. 设置新密码：MySQL 8.0默认有较强的密码策略，新密码必须包含大小写字母、数字和特殊字符，长度至少8位。
3. 移除匿名用户：输入Y，删除任何匿名账户。
4. 禁止root远程登录：输入Y（强烈建议）。这样root用户只能从本地服务器登录，提高安全性。
5. 删除测试数据库：输入Y，移除名为test的公开访问数据库。
6. 立即重载权限表：输入Y，使更改生效。

创建专用数据库用户（最佳实践）：永远不要用root用户直接连接网站应用。我们应该为每个网站创建一个独立的数据库和用户。

# 使用root登录MySQL mysql -u root -p

输入你刚设置的新密码，进入MySQL命令行。

-- 创建一个名为`mywebsite`的数据库 CREATE DATABASE mywebsite CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 创建一个名为`webuser`的用户，并设置一个强密码（请替换`YourStrongPassword123!`） CREATE USER 'webuser'@'localhost' IDENTIFIED BY 'YourStrongPassword123!'; -- 授予`webuser`用户对`mywebsite`数据库的所有权限 GRANT ALL PRIVILEGES ON mywebsite.* TO 'webuser'@'localhost'; -- 刷新权限，使授权生效 FLUSH PRIVILEGES; -- 退出MySQL EXIT;

实操心得：这里的utf8mb4字符集比传统的utf8更完整，支持存储所有的Unicode字符（如emoji），是现在的标准选择。@'localhost'限制该用户只能从本机连接，进一步提升了安全性。

3.2 PHP 7.4/8.x 与 PHP-FPM 安装

PHP是处理网站动态逻辑的脚本语言。Nginx本身不能直接解析PHP，它需要通过一个叫做PHP-FPM（FastCGI Process Manager）的进程管理器来协作。

# 1. 启用EPEL和Remi仓库（提供更新的PHP版本） sudo dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm sudo dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm # 2. 重置PHP模块并启用Remi提供的PHP 7.4（或8.x）仓库 sudo dnf module reset php sudo dnf module enable php:remi-7.4 -y # 如需PHP 8.1，则使用 php:remi-8.1 # 3. 安装PHP核心、FPM及常用扩展 sudo dnf install -y php php-fpm php-mysqlnd php-curl php-gd php-mbstring php-xml php-zip php-opcache

关键扩展说明：

• php-fpm: PHP的FastCGI进程管理器，与Nginx通信的桥梁。
• php-mysqlnd: MySQL原生驱动，用于PHP连接MySQL数据库。
• php-gd: 图像处理库，很多CMS（如WordPress）的缩略图功能依赖它。
• php-mbstring: 多字节字符串处理，对中文等非ASCII字符支持至关重要。
• php-xml: XML解析，许多现代PHP框架和插件需要。
• php-opcache: PHP字节码缓存，能显著提升PHP脚本执行速度。

配置PHP-FPM：主要配置位于/etc/php-fpm.d/www.conf。我们需要确保其监听方式与Nginx匹配。

sudo vim /etc/php-fpm.d/www.conf

找到以下关键行并进行修改：

; 将监听方式改为通过Unix Socket通信（比TCP Socket更快、更安全） ; listen = 127.0.0.1:9000 listen = /run/php-fpm/www.sock ; 确保socket文件的所有者和组被正确设置，以便Nginx有权限读写 listen.owner = nginx listen.group = nginx listen.mode = 0660 ; 运行进程的用户和组（保持为apache或改为nginx，需与系统用户一致） user = nginx group = nginx

保存退出后，启动PHP-FPM并设置开机自启：

sudo systemctl start php-fpm sudo systemctl enable php-fpm

3.3 Nginx 高性能Web服务器安装与基础配置

Nginx负责处理HTTP请求，返回静态文件（如图片、CSS），并将PHP动态请求转发给后端的PHP-FPM处理。

# 安装Nginx sudo dnf install -y nginx # 启动Nginx并设置开机自启 sudo systemctl start nginx sudo systemctl enable nginx

安装完成后，打开浏览器，输入你的服务器IP地址，你应该能看到Nginx的默认欢迎页面。这说明Nginx已经成功运行。

核心配置：创建你的第一个网站配置文件Nginx的主配置文件是/etc/nginx/nginx.conf，但最佳实践是为每个网站在/etc/nginx/conf.d/目录下创建一个独立的.conf文件。

sudo vim /etc/nginx/conf.d/mywebsite.conf

将以下配置粘贴进去（请将your_domain_or_IP替换为你的域名或服务器IP）：

server { listen 80; server_name your_domain_or_IP; # 例如 www.yourdomain.com 或 192.168.1.100 # 网站根目录，我们将网站文件放在这里 root /usr/share/nginx/html/mywebsite; index index.php index.html index.htm; # 日志文件路径 access_log /var/log/nginx/mywebsite_access.log; error_log /var/log/nginx/mywebsite_error.log; location / { try_files $uri $uri/ =404; } # 关键配置：将所有PHP文件的请求转发给PHP-FPM处理 location ~ \.php$ { try_files $uri =404; # 防止直接访问不存在的PHP文件导致的安全问题 fastcgi_pass unix:/run/php-fpm/www.sock; # 与php-fpm配置中的listen一致 fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } # 禁止访问隐藏文件（如.htaccess） location ~ /\. { deny all; } }

配置详解与避坑：

1. root /usr/share/nginx/html/mywebsite;: 指定了网站文件的存放目录。你需要手动创建这个目录：sudo mkdir -p /usr/share/nginx/html/mywebsite。
2. fastcgi_pass unix:/run/php-fpm/www.sock;: 这是连接PHP-FPM的关键。必须与之前www.conf中设置的listen = /run/php-fpm/www.sock路径完全一致。如果这里填错（比如用了127.0.0.1:9000而PHP-FPM用的是socket），就会导致经典的“502 Bad Gateway”错误。
3. fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;: 这一行告诉PHP-FPM要执行的脚本文件的具体路径。这是另一个常见错误点，如果缺失或错误，Nginx会返回“File not found.”即使文件确实存在。

创建网站目录并设置权限：

sudo mkdir -p /usr/share/nginx/html/mywebsite sudo chown -R nginx:nginx /usr/share/nginx/html/mywebsite sudo chmod -R 755 /usr/share/nginx/html/mywebsite

测试配置并重载Nginx：在每次修改Nginx配置后，都必须测试语法是否正确，然后再重载服务。

# 测试配置文件语法 sudo nginx -t # 如果显示 `syntax is ok` 和 `test is successful`，则重载配置 sudo systemctl reload nginx

4. 联调测试与故障排查实战

所有服务都安装配置好了，现在我们来验证整个LNMP栈是否协同工作正常。

4.1 创建PHP测试文件

在网站根目录下创建一个info.php文件，用于展示PHP信息和验证数据库连接。

sudo vim /usr/share/nginx/html/mywebsite/info.php

输入以下内容：

<?php // 1. 显示PHP信息 phpinfo(); // 2. 测试MySQL连接（可选，测试后建议删除或重命名此文件） echo "<h2>MySQL Connection Test</h2>"; $host = 'localhost'; $dbname = 'mywebsite'; $user = 'webuser'; $pass = 'YourStrongPassword123!'; // 替换为你的实际密码 try { $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $user, $pass); $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); echo "MySQL连接成功！"; } catch (PDOException $e) { echo "MySQL连接失败: " . $e->getMessage(); } ?>

4.2 访问测试与结果分析

打开浏览器，访问http://你的服务器IP/info.php。

预期成功结果：

1. 你会看到一个详细的PHP信息页面，列出了已安装的扩展、配置参数等。这说明Nginx成功接收了请求，并将其传递给了PHP-FPM，PHP-FPM也成功执行了脚本。
2. 页面下方会显示“MySQL连接成功！”。这说明PHP的pdo_mysql扩展工作正常，并且能够用我们创建的webuser账号连接到mywebsite数据库。

常见故障与排查链路：

如果页面无法访问或显示错误，请按照以下链路排查：

问题1：浏览器显示“403 Forbidden”或“404 Not Found”

• 检查文件路径与权限：确认info.php文件是否在正确的/usr/share/nginx/html/mywebsite目录下。使用ls -la /usr/share/nginx/html/mywebsite查看。
• 检查目录权限：确保目录的所有者和组是nginx，并且有读取和执行权限（755）。使用ls -ld /usr/share/nginx/html/mywebsite查看。
• 检查SELinux：如果权限正确，可能是SELinux阻止了Nginx访问。可以暂时将SELinux设为宽容模式sudo setenforce 0再测试。如果问题解决，则需要为网站目录添加正确的SELinux上下文：sudo chcon -Rt httpd_sys_content_t /usr/share/nginx/html/mywebsite。

问题2：浏览器显示“502 Bad Gateway”这是Nginx和PHP-FPM通信失败的最典型错误。

• 第一步：检查PHP-FPM服务状态。sudo systemctl status php-fpm。确保它是active (running)。
• 第二步：核对Socket文件路径。检查Nginx配置fastcgi_pass和PHP-FPM配置listen的路径是否一字不差。使用sudo ls -l /run/php-fpm/查看sock文件是否存在，其权限是否为nginx:nginx和660。
• 第三步：检查Nginx错误日志。sudo tail -f /var/log/nginx/mywebsite_error.log，然后刷新浏览器，查看实时日志输出，通常会有更具体的错误信息。

问题3：浏览器显示“File not found.”，但文件确实存在

• 检查SCRIPT_FILENAME参数：这几乎100%是因为Nginx配置中fastcgi_param SCRIPT_FILENAME设置错误。确保它指向了正确的$document_root。可以在Nginx配置中临时添加一行fastcgi_param PHP_VALUE "error_log=/var/log/nginx/php_errors.log";，然后去指定的日志文件查看PHP自身的错误信息。

问题4：PHP页面显示空白

• 检查PHP语法错误：在PHP脚本开头添加error_reporting(E_ALL); ini_set('display_errors', 1);以显示所有错误。
• 检查PHP-FPM日志：sudo tail -f /var/log/php-fpm/www-error.log。

4.3 压力测试后的性能初调

当基础功能跑通后，我们可以进行一些简单的性能优化，让你的网站在面对访问时更从容。

调整PHP-FPM进程池：编辑/etc/php-fpm.d/www.conf，根据你服务器的内存大小调整以下参数（以下配置适用于1GB内存的服务器）：

pm = dynamic ; 进程管理方式，dynamic是动态调整 pm.max_children = 50 ; 最大子进程数 pm.start_servers = 5 ; 启动时的进程数 pm.min_spare_servers = 5 ; 最小空闲进程数 pm.max_spare_servers = 35 ; 最大空闲进程数 pm.max_requests = 500 ; 每个进程处理一定请求后重启，防止内存泄漏

修改后重启PHP-FPM：sudo systemctl restart php-fpm。

启用Nginx和PHP的缓存：

• Nginx静态资源缓存：在你的网站配置文件mywebsite.conf中，为图片、CSS、JS等静态文件添加缓存规则，可以显著减少重复请求。

  location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ { expires 30d; add_header Cache-Control "public, immutable"; }

• PHP Opcache：安装时已包含php-opcache，确保它在php.ini中启用（默认是开启的）。你可以查看phpinfo()页面中的“Zend OPcache”部分来确认。

5. 进阶部署：以WordPress为例部署真实应用

测试通过后，我们来部署一个真实的PHP应用——WordPress，这是最流行的博客/CMS系统，能检验LNMP环境的完整兼容性。

5.1 下载与配置WordPress

# 进入网站根目录 cd /usr/share/nginx/html/mywebsite # 删除之前的测试文件（可选） sudo rm -f index.html info.php # 下载最新版WordPress并解压 sudo wget https://wordpress.org/latest.tar.gz sudo tar -xzvf latest.tar.gz --strip-components=1 sudo rm latest.tar.gz # 再次确保目录权限正确 sudo chown -R nginx:nginx /usr/share/nginx/html/mywebsite

5.2 为WordPress创建数据库

使用之前创建的webuser账号，为WordPress单独创建一个数据库（当然，你也可以使用之前测试用的mywebsite库）。

mysql -u root -p

CREATE DATABASE wordpress CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; GRANT ALL PRIVILEGES ON wordpress.* TO 'webuser'@'localhost'; FLUSH PRIVILEGES; EXIT;

5.3 完成WordPress网页安装

1. 在浏览器中再次访问你的服务器IP。
2. 你会看到WordPress著名的“五分钟安装”界面。选择语言后点击“继续”。
3. 在“数据库连接信息”页面填写：
   • 数据库名：wordpress
   • 用户名：webuser
   • 密码：你之前为webuser设置的密码
   • 数据库主机：localhost
   • 表前缀：保持默认wp_或改为其他（增强安全性）
4. 点击“提交”。如果一切正常，WordPress会提示“可以开始安装了”。
5. 接下来设置站点标题、管理员用户名、密码和邮箱，点击“安装WordPress”。
6. 安装成功后，用你设置的管理员账号登录，你就进入了WordPress后台管理界面。

5.4 部署后的必要安全与优化检查

1. 文件权限加固：WordPress需要向wp-content/uploads目录上传文件，但过宽的权限是安全隐患。

# 设置网站根目录所有文件为644，目录为755 sudo find /usr/share/nginx/html/mywebsite -type f -exec chmod 644 {} \; sudo find /usr/share/nginx/html/mywebsite -type d -exec chmod 755 {} \; # 单独给上传目录写权限 sudo chmod -R 775 /usr/share/nginx/html/mywebsite/wp-content/uploads # 如果使用SELinux enforcing模式，还需要设置上传目录的上下文 sudo chcon -Rt httpd_sys_rw_content_t /usr/share/nginx/html/mywebsite/wp-content/uploads

2. 配置Nginx防止直接访问敏感文件：在mywebsite.conf的server块中，添加以下规则：

location ~* /(wp-config\.php|readme\.html|license\.txt) { deny all; }

3. 禁用PHP错误信息对外暴露：编辑/etc/php.ini，找到以下行并修改：

display_errors = Off log_errors = On error_log = /var/log/php_errors.log

生产环境务必关闭display_errors，防止敏感信息泄露。

走到这一步，你已经拥有了一个完全由自己手动搭建、配置、并部署了真实应用的LNMP网站环境。这个过程里遇到的每一个错误提示，解决的每一个权限问题，调整的每一个配置参数，都会成为你运维能力实实在在的积累。下次当你再看到“502 Bad Gateway”时，你脑子里会立刻浮现出检查Socket路径和进程状态的排查链路，而不是感到茫然。这才是手动搭建最大的价值——知其然，更知其所以然。