包管理器安装最稳妥，源码编译仅用于自定义模块或旧系统无包；ubuntu/debian用apt安装后需手动启动并设开机自启，centos/rhel 8+用dnf安装并配置firewalld放行端口，修改配置必先nginx -t校验再reload。
Ubuntu/Debian 用 apt 安装并立即验证
系统自带源通常已包含稳定版 nginx，无需添加第三方仓库。执行后默认不启动，必须手动启用：
sudo apt update && sudo apt install nginx -y- 检查状态：
sudo systemctl status nginx—— 若显示inactive (dead)，说明没运行 - 启动并设开机自启：
sudo systemctl start nginx && sudo systemctl enable nginx - 验证监听：浏览器访问
http://localhost或服务器 IP，看到 “Welcome to nginx!” 即成功
常见错误：Failed to start nginx.service: Unit nginx.service not found，大概率是拼错命令（比如输成 ngnix）或安装中途失败但未报错，重试安装并确认输出里有 Setting up nginx 字样。
CentOS/RHEL 8+ 用 dnf 并处理 firewalld 放行
CentOS 8+ 默认用 dnf，且 firewalld 默认拦截 80/443 端口，不配置就无法从外部访问：
- 安装：
sudo dnf install nginx -y - 启动并检查：
sudo systemctl start nginx && sudo systemctl status nginx - 放行 HTTP：
sudo firewall-cmd --permanent --add-service=http，再sudo firewall-cmd --reload - 若需 HTTPS，补加：
sudo firewall-cmd --permanent --add-service=https
--permanent 参数不可省略，否则重启后规则丢失；不 reload 就不生效。
源码编译安装：仅当必须启用特定模块或系统太老
新手不建议，容易因依赖缺失、权限问题或路径混乱导致 ./configure 报错。真要编译，注意三点：
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 先装全依赖：
sudo apt install build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev libssl-dev -y（Ubuntu）或sudo yum install gcc pcre-devel zlib-devel openssl-devel -y（CentOS 7） -
./configure时明确指定模块和路径，例如：./configure --prefix=/usr/local/nginx --with-http_ssl_module --with-http_stub_status_module - 编译后别直接用
./nginx启动，先校验配置：/usr/local/nginx/sbin/nginx -t，再/usr/local/nginx/sbin/nginx
典型报错 ./configure: error: C compiler cc is not found，就是缺 gcc，补装即可。
修改网站根目录：别动主配置，用站点文件拆分
Nginx 主配置固定为 /etc/nginx/nginx.conf，但站点配置应单独管理：
- Ubuntu/Debian：新建
/etc/nginx/sites-enabled/myapp.conf - CentOS/RHEL：新建
/etc/nginx/conf.d/myapp.conf - 内容示例：
server {
listen 80;
server_name example.com;
root /var/www/myapp;
index index.html;
}
改完必须执行 sudo nginx -t 校验语法，再 sudo systemctl reload nginx 生效。403 错误多因 root 路径权限不对或 SELinux 启用，502 多见于反向代理后端没起来。
真正麻烦的不是安装步骤，而是改配置后忘了 nginx -t 校验，或者防火墙规则漏 reload —— 这两点几乎占了线上排查的七成。
