Linux 服务器环境部署：如何源码编译安装 Nginx-安全-PHP中文网

源码编译安装 nginx 的核心在于可控性——能精确选择模块、指定路径、适配系统特性，并为平滑升级奠基；关键在依赖完备、configure 参数合理、编译安装正确及 systemd 托管规范。

linux 服务器环境部署：如何源码编译安装 nginx

源码编译安装 Nginx 的核心在于可控性——你能精确选择模块、指定路径、适配系统特性，还能为后续平滑升级打下基础。关键不是“能不能装”，而是“装得对不对、稳不稳、好不好维护”。

一、先装好底座：系统依赖和编译工具

缺依赖会导致 configure 失败或运行时报错，别跳过这步。

CentOS/RHEL/Rocky Linux（如 8/9/10.1）：
yum groupinstall "Development Tools"
yum install -y pcre pcre-devel zlib zlib-devel openssl openssl-devel
Ubuntu/Debian：
apt update && apt install -y build-essential libpcre3-dev zlib1g-dev libssl-dev

验证 gcc 和 make 是否就绪：gcc --version、make --version，有输出即正常。

二、下载解压，进入源码目录

推荐使用稳定版，当前主流生产环境常用 1.26.x 或 1.28.x（如 1.28.1）。官网地址：https://www.php.cn/link/9926b3ed9e0bc20b2ed7f32711b8b45f

下载并解压（以 1.28.1 为例）：
wget https://www.php.cn/link/9926b3ed9e0bc20b2ed7f32711b8b45fnginx-1.28.1.tar.gz
tar -zxvf nginx-1.28.1.tar.gz
cd nginx-1.28.1

三、configure 配置：按需启用模块

这是最关键的一步。默认配置极简，多数功能需显式开启。常见实用组合：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

基础 + SSL + 状态页 + Gzip：
./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_stub_status_module --with-http_gzip_static_module
加第三方模块（如 echo 模块）：
先下载模块源码（如 git clone https://github.com/openresty/echo-nginx-module.git），再在 configure 中追加：
--add-dynamic-module=../echo-nginx-module
若要支持 HTTP/3（需 OpenSSL 3.0+ 和 quiche）：
需额外添加 --with-http_v3_module 并确保底层依赖已就位

执行后检查末尾是否显示 "Configuration summary" 且无 error 提示，再继续。

四、编译安装与初始化服务

两步到位，但注意权限和路径一致性：

编译：make（耗时取决于 CPU，通常 1–3 分钟）
安装：sudo make install（默认装到 --prefix 指定路径）
创建软链或加入 PATH（可选）：
sudo ln -sf /usr/local/nginx/sbin/nginx /usr/local/bin/nginx
首次启动前检查配置：/usr/local/nginx/sbin/nginx -t
启动：/usr/local/nginx/sbin/nginx