nginx在centos7上热升级步骤

nginx官网地址:https://nginx.org/en/

Nginx在CentOS 7上平滑升级的详细步骤

Nginx的平滑升级（也称为热升级）允许在不中断服务的情况下更新到新版本。这通常通过替换二进制文件并使用信号来实现新进程逐步接管旧进程。以下步骤假设你当前Nginx是通过源代码或YUM从官方仓库安装的（CentOS 7默认使用YUM+EPEL仓库）。整个过程需在root权限下操作，预计时间30-60分钟，取决于服务器配置。

前提准备：

• 当前Nginx版本至少1.0+（检查命令：nginx -V）。
• 备份当前Nginx：cp -r /etc/nginx /etc/nginx.bak 和 cp -r /usr/sbin/nginx /usr/sbin/nginx.bak。
• 确保系统已更新：yum update -y。
• 关闭SELinux以避免权限问题（临时）：setenforce 0（永久编辑/etc/selinux/config将SELINUX=enforcing改为disabled，然后重启）。
• 潜在错误：如果YUM仓库不可达，运行yum clean all清理缓存，或检查网络/防火墙（systemctl status firewalld）。

步骤1: 检查当前Nginx配置和模块

• 运行nginx -V 查看当前版本、编译参数和模块（如--with-http_ssl_module等）。记录这些参数，因为新版本编译时需一致，以避免兼容问题。
• 测试当前配置：nginx -t。如果报错如"syntax error"，检查/etc/nginx/nginx.conf中的语法（如缺少分号或括号），修复后重试。
• 潜在错误与解决：
  • "nginx: command not found"：Nginx未安装或路径不对，添加/usr/sbin到PATH：export PATH=$PATH:/usr/sbin。
  • "Permission denied"：确保nginx.conf权限为644（chmod 644 /etc/nginx/nginx.conf），所属用户为root或nginx。

步骤2: 添加或更新Nginx仓库（如果使用YUM升级）

如果当前Nginx是从EPEL仓库安装的，先添加/更新仓库

  yum install -y epel-release
  yum clean all

创建或编辑/etc/yum.repos.d/nginx.repo：

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/7/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

• 潜在错误与解决：
  • "No package nginx available"或"repodata/repomd.xml Error"：仓库不可达，检查网络/代理，或手动下载RPM包（从nginx.org/packages/centos/7/x86_64/RPMS/下载最新nginx-*.rpm），然后yum localinstall nginx-*.rpm -y。
  • "GPG key retrieval failed"：手动导入密钥rpm --import https://nginx.org/keys/nginx_signing.key。
  • 如果仓库镜像失败：临时使用Vault仓库（CentOS 7 EOL后）：编辑repo文件，将mirror.centos.org替换为vault.centos.org。

步骤3: 下载和编译新版本Nginx（推荐源代码方式，确保模块一致）

• 下载最新稳定版（例如1.26.x，从nginx.org下载）：wget https://nginx.org/download/nginx-1.26.2.tar.gz（替换为最新版本）。

• 解压：tar -zxvf nginx-1.26.2.tar.gz。

• 进入目录：cd nginx-1.26.2。

• 配置编译（使用步骤1记录的参数，例如）

  ./configure --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --user=nginx --group=nginx --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_addition_module --with-http_sub_module --with-http_dav_module --with-http_flv_module --with-http_mp4_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_random_index_module --with-http_secure_link_module --with-http_stub_status_module --with-http_auth_request_module --with-http_image_filter_module=dynamic --with-http_geoip_module=dynamic --with-threads --with-stream --with-stream_ssl_module --with-stream_ssl_preread_module --with-stream_realip_module --with-stream_geoip_module=dynamic --with-http_slice_module --with-mail --with-mail_ssl_module --with-compat --with-file-aio --with-http_v3_module

• 编译和安装：make && make install（这会覆盖二进制，但不覆盖配置）。

• 潜在错误与解决：

  • "Missing dependencies"：安装缺失包，如yum install -y gcc pcre-devel zlib-devel openssl-devel gd-devel perl-ExtUtils-Embed GeoIP-devel。
  • "Configure: error: SSL modules require the OpenSSL library"：安装yum install -y openssl-devel。
  • "Make: command not found"：安装yum groupinstall -y "Development Tools"。
  • 如果YUM升级：直接yum update nginx -y，但需检查仓库。

步骤4: 测试新配置

• 测试新Nginx：/usr/sbin/nginx -t -c /etc/nginx/nginx.conf。
• 如果服务未运行，启动：systemctl start nginx。
• 潜在错误与解决：
  • "Job for nginx.service failed"：检查日志journalctl -xe或/var/log/nginx/error.log，常见如端口80/443被占（netstat -tuln | grep 80杀掉进程），或防火墙阻塞（firewall-cmd --permanent --add-service=http --add-service=https然后firewall-cmd --reload）。
  • "Nginx isn't running"：systemctl enable nginx设置开机自启。

步骤5: 执行平滑升级

• 获取当前master进程PID：cat /var/run/nginx.pid（假设为1234）。
• 启动新master进程（不停止旧的）：kill -USR2 1234（新进程会监听端口，但旧进程继续处理请求）。
• 检查新进程：ps -ef | grep nginx（看到新master和旧master）。
• 优雅停止旧worker进程：kill -WINCH 1234（旧workers处理完当前连接后退出，新workers接管）。
• 关闭旧master：kill -QUIT 1234。
• 验证：访问网站，确保无中断；检查日志无错误。
• 潜在错误与解决：
  • "No such process"：PID文件错误，检查/var/run/nginx.pid或用ps aux | grep nginx找master PID。
  • 服务中断：如果USR2失败，可能是新二进制不兼容，rollback到备份mv /usr/sbin/nginx.bak /usr/sbin/nginx然后重启。
  • 高负载下失败：监控CPU/内存（top），如果worker不退出，等待几分钟或手动kill worker PID（但不推荐）。
  • 模块不匹配：如果新版缺少模块，报错如"unknown directive"，需重新编译添加缺失模块。

步骤6: 清理和监控

• 移除旧文件：rm nginx-*.tar.gz。
• 重启服务（可选，非必须）：systemctl restart nginx。
• 监控日志：tail -f /var/log/nginx/error.log 观察1-2小时。
• 潜在错误与解决：
  • "Too many open files"：编辑/etc/security/limits.conf添加nginx soft nofile 65535和nginx hard nofile 65535，然后重启。
  • 更新失败后回滚：恢复备份配置和服务重启。