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 就是重新启动。”
七、总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
相关文章
本文主要介绍了nginx location/区别详解，主要介绍了8中不同的方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2022-04-04
这篇文章主要介绍了详解如何修改nginx的默认端口，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2021-03-03
这种方法并非以前所流行的apache 加 php_module 的方式运行，我是采用nginx 作为web服务器，以fastcgi的方式运行php2011-05-05
对于Web开发者来说,Nginx是一个强大且灵活的Web服务器和反向代理服务器,下面这篇文章主要介绍了Nginx中指令server_name详细使用的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下2025-07-07
今天小编就为大家分享一篇关于使用nginx进行金丝雀发布，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧2018-12-12
这篇文章主要介绍了Nginx对某个目录设置密码保护例子,使用htpasswd 生成用户名和密码,并解决了打开PHP文件变成文件下载的问题,需要的朋友可以参考下2014-06-06
这篇文章主要介绍了在nginx中设置三级域名的方法示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2018-12-12
这篇文章主要为大家介绍了Nginx转发需求querystring转写示例解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2023-08-08
这篇文章主要给大家介绍了关于nginx配置报404问题排查解决的相关资料,当我们在访问网站时常常会遇到一些我们没能想到的问题或者其他错误,此时我们访问的是无法路由的页面,也就是404页面,需要的朋友可以参考下2023-08-08
本文主要介绍了Nginx配置请求头携带原始请求信息的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2023-12-12
最新评论