Windows版Nginx常用命令
下面完全针对 Windows 版 Nginx（官方 zip 包，解压即用）讲解，假设你把它解压到
C:\nginx（路径随意，下文用 %NGINX_HOME% 指代）。
一、启动 Nginx（3 种常见办法）
-
双击图标（最简单，但看不到日志）
进入%NGINX_HOME%，双击nginx.exe，黑框一闪即退，
实际上已后台运行。
浏览器访问http://127.0.0.1出现 “Welcome to nginx!” 即成功。 -
命令行启动（推荐，能看到报错）
打开 管理员 CMD 或 PowerShell
cd C:\nginx
start nginx # 不带参数，后台守护进程或
nginx # 会占住当前窗口，Ctrl+C 即停（调试时方便）
-
注册成 Windows 服务（开机自启，生产常用）
用 “WinSW” 或 “NSSM” 把 nginx.exe 包一层即可，
例如 NSSM 一条命令：
nssm install nginx “C:\nginx\nginx.exe”
二、关闭 Nginx（对应 3 种启动方式）
-
任务管理器图形关
进程名nginx.exe，通常有两条：一条 master，一条或多条 worker，
全选 → 结束任务。 -
命令行优雅关 / 快速关
优雅（等待连接处理完）
nginx -s quit # 必须在 原目录 下执行，否则找不到 pid
立即
nginx -s stop # 发 Terminate 信号
如果以上提示 “找不到 logs/nginx.pid”，就手动杀：
taskkill /f /im nginx.exe -
服务方式
net stop nginx # 假设你刚才注册的服务名就是 nginx
sc delete nginx # 彻底卸载服务
三、Windows 下最常用的 Nginx 命令
检查配置文件写得对不对（改完 conf 必做）
nginx -t
重载配置（热更，不断连接）
nginx -s reload
重新打开日志文件（日志切割后用）
nginx -s reopen
指定配置文件启动（调试多实例时）
nginx -c C:\nginx\conf\nginx.conf
查看版本 / 编译参数
nginx -v
nginx -V
帮助
nginx -h
四、路径 / 权限易错点
-
必须在 含有 nginx.exe 的目录 执行
否则nginx -s reload会报
“could not open error log file: CreateFile() … failed” -
80/443 端口占用
通常是被 IIS、SQL Server Reporting、Skype 抢掉。
解决：
netstat -ano | findstr :80
taskkill /PID <占用PID> /F
或把 listen 改成 8080 等高端口。 -
防火墙弹窗
首次启动 Windows Defender 会提示 “是否允许 nginx 通信”，点“允许”。 -
中文路径 / 空格
解压路径不要带空格或中文，否则nginx -t可能异常。
五、一条完整日常流程（记忆版）
-
改配置
用 VS Code 打开C:\nginx\conf\nginx.conf编辑。 -
检查
nginx -t # 出现 “successful” 才继续。 -
热加载
nginx -s reload # 不断服务更新。 -
想停服
nginx -s quit # 优雅关。 -
万一卡死
taskkill /f /im nginx.exe # 强制清场。
六、快速查询表（复制即可用）
| 操作 | 命令 |
|---|---|
| 启动 | start nginx 或 nginx |
| 停止 | nginx -s quit（优雅）/ nginx -s stop（强制） |
| 重载配置 | nginx -s reload |
| 验证配置 | nginx -t |
| 重新打开日志 | nginx -s reopen |
| 查版本 | nginx -V |
| 杀进程 | taskkill /f /im nginx.exe |
把上面 7 句记住，Windows 下使用 Nginx 就够用了。
-s是什么，为什么要-s
-s 是 nginx 在 Windows／Linux 上共有的“信号（signal）”参数，用来 向“正在运行的 nginx 主进程”发命令，而不是再启一个新进程。
没有 -s 时，你敲 nginx 会尝试 重新启动一个 master，这显然关不掉、也重载不了旧进程，所以必须靠 -s。
- 语法
nginx -s <signal>
signal 只能取 4 个值：
stop | quit | reload | reopen
- 四个信号分别干什么
| 信号 | 作用 | 对应 Unix 信号 |
|---|---|---|
-s stop | 立即终止 主进程及其所有 worker（相当于 kill -TERM） | SIGTERM |
-s quit | 优雅退出——等现有连接处理完再关机 | SIGQUIT |
-s reload | 热重载配置——不丢连接、不重启 worker，只重新加载 nginx.conf | SIGHUP |
-s reopen | 重新打开日志文件（日志切割后用） | SIGUSR1 |
- 为什么“必须”带 -s
- 不带
-s时，nginx 认为你要 “启动” 一个新实例； - 带
-s时，nginx 会读取logs/nginx.pid里的 PID，把对应信号发给 那个已经运行的 master 进程，自己立即退出，不占用新端口。
换句话说：
“-s 让 nginx 变成‘遥控器’，而不是‘新实例’。”
- Windows 上同样适用
虽然 Windows 没有 Unix 信号机制，但 nginx.exe 内部用 命名事件/线程通信 模拟了这四条命令，用法完全一致：
nginx -s stop # 关
nginx -s reload # 热更
一句话记住
“想控制已运行的 nginx，就加 -s；不加 -s 就是重新启动。”