Windows 系统 Nginx 1.24 → 1.28 完整升级指南

Windows 下 Nginx 为绿色免安装程序，升级核心是备份现有文件→停止服务→替换新版程序→验证配置→重启服务，全程操作简单、风险可控，以下是分步详细流程。

以管理员身份打开 CMD/PowerShell，进入 Nginx 安装目录（示例：C:\nginx），执行命令查看版本：

bash 复制代码

nginx -v
# 预期输出：nginx/1.24.x

记录安装路径，避免后续文件替换错误。

这是升级失败快速回滚的关键，必须执行：

复制整个 Nginx 安装目录，重命名为 nginx_1.24_backup（如 C:\nginx_1.24_backup）
单独备份核心配置与数据目录：
- 配置文件：conf/nginx.conf 及所有自定义 .conf 文件
- 网页文件：html/ 目录
- 日志文件：logs/ 目录（可选，建议保留）

访问 Nginx 官方下载页，获取 Windows 稳定版压缩包，拒绝第三方修改包：

官方下载地址：https://nginx.org/en/download.html
下载文件：nginx/Windows-1.28.0（或最新 1.28.x 稳定版），对应链接：https://nginx.org/download/nginx-1.28.0.zip
校验文件完整性（可选，推荐）：
bash 复制代码
```
certutil -hashfile nginx-1.28.0.zip SHA256
```
核对结果与官网公布的 SHA256 值一致，确保文件未篡改。

将下载的 .zip 解压到临时目录 （如 C:\nginx_temp），不要直接覆盖旧目录，方便对比文件。

两种停止方式，二选一即可：

命令行停止（推荐）：

bash 复制代码

# 进入旧版安装目录
cd C:\nginx
# 优雅停止服务
nginx -s stop

执行后验证进程是否完全关闭：

bash 复制代码

tasklist /fi "imagename eq nginx.exe"

无输出则进程已停止，若残留进程，手动结束任务。

采用保留自定义配置、仅替换程序文件的方式，避免配置丢失：

从临时解压目录（C:\nginx_temp）复制以下核心程序文件：
- nginx.exe（主程序，必换）
- nginx.pdb（调试文件，可选）
粘贴到旧版 Nginx 安装目录，覆盖同名文件
保留原有 conf/、html/、logs/ 目录，不替换，直接沿用旧配置。

新版本可能存在配置指令微调，启动前必须校验配置语法：

bash 复制代码

cd C:\nginx
# 测试配置文件语法
nginx -t

出现 nginx: configuration file C:\nginx\conf\nginx.conf test is successful 即为正常；若报错，根据提示修改配置，或回退到备份的旧配置文件。

两种启动方式，二选一：

若新版运行异常，立即回退到 1.24 版本：