需添加 Nginx 官方 YUM 仓库(推荐 stable)后安装最新稳定版,命令包括安装 yum-utils、添加仓库、启用 nginx-stable;安装后验证版本、语法、启动服务并放行防火墙 80 端口,注意卸载旧版、备份配置及重载生效。

CentOS 默认源中提供的 Nginx 版本较旧(如 CentOS 7 自带的是 1.12.x),若需安装官方维护的最新稳定版(如 1.24.x 或 1.26.x),必须添加 Nginx 官方 YUM 仓库,再通过 yum 安装。
添加 Nginx 官方 YUM 仓库
官方提供两种仓库配置:stable(稳定版) 和 mainline(主线版)。生产环境推荐使用 stable 仓库。
执行以下命令下载并安装官方仓库配置(适用于 CentOS 7/8;CentOS 8 请先确认已启用 powertools 或 CRB 仓库):
sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://nginx.org/packages/centos/$releasever/x86_64/ sudo yum-config-manager --enable nginx-stable
说明:
-
$releasever会被自动替换为系统版本号(如 7 或 8) -
nginx-stable是默认启用的仓库名,无需额外操作;若误禁用,可用--enable恢复 - 安装后可查看仓库状态:
yum repolist enabled | grep nginx
安装并验证 Nginx
添加仓库后,直接安装即可获取官方稳定版:
sudo yum install -y nginx
安装完成后检查版本和配置:
- 查看版本:
nginx -v(应显示类似nginx version: nginx/1.24.0) - 检查配置语法:
sudo nginx -t - 启动服务:
sudo systemctl start nginx - 设为开机自启:
sudo systemctl enable nginx
防火墙需放行 HTTP(80)端口(CentOS 7 使用 firewalld):
sudo firewall-cmd --permanent --add-service=http sudo firewall-cmd --reload
注意事项与常见问题
安装过程可能遇到的问题及处理方式:
-
提示 GPG key 导入失败:首次安装时会提示导入 Nginx 签名密钥,按
y确认即可;若手动导入,运行sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-nginx -
与系统自带 nginx 冲突:若之前装过 epel 或其他源的 nginx,请先卸载:
yum remove nginx*,再清理缓存:yum clean all -
配置文件路径:官方包默认配置在
/etc/nginx/nginx.conf,站点配置在/etc/nginx/conf.d/,日志在/var/log/nginx/ - SELinux 影响:如启用 SELinux,确保其处于 enforcing 模式且策略允许 Web 服务运行(通常默认支持,无需额外配置)
后续建议
安装完成后建议立即做三件事:
- 修改默认欢迎页或部署应用前,先备份原始配置:
sudo cp /etc/nginx/nginx.conf{,.bak} - 编辑
/etc/nginx/conf.d/default.conf调整 root 目录、server_name 等参数 - 每次修改配置后务必执行
sudo nginx -t && sudo nginx -s reload生效
不复杂但容易忽略。










