nginx
主页 > 服务器 > nginx >

Windows上启动停止Nginx服务器

2026-02-12 | 佚名 | 点击:

在 Windows 上开发 Django、Vue 或其他 Web 项目时,Nginx 往往是我们最常用的反向代理服务器。然而,不同于 Linux 系统上顺手的 systemctl 命令,Windows 上的 Nginx 管理总是让新手感到困惑:到底是用命令行?还是注册成服务?为什么我点了停止,进程还在后台“僵尸”般存在?

今天,我们就来彻底解决 Windows 上 Nginx 的启动与停止问题,并附赠一个“进程强杀”脚本。

一、 为什么 Windows 上的 Nginx 容易“关不掉”

首先要理解 Nginx 的多进程模型。

当你在 Linux 上执行 nginx -s stop 时,主进程会向所有子进程发送退出信号,优雅地关闭。但在 Windows 上,如果你直接在“服务”里点击停止,或者主进程异常崩溃,Worker 进程可能会变成孤儿进程,继续占用 80/443 端口,导致你下次启动时提示 bind() to 0.0.0.0:80 failed (10048: Unknown error)。

二、 推荐方案:命令行直接控制(最稳妥)

对于开发环境,强烈不建议直接去“计算机管理”里点停止。最可靠的方式是使用 Nginx 自带的命令行指令。

1. 启动 Nginx

打开 CMD 或 PowerShell,进入 Nginx 目录:

cd C:\nginx-1.24.0  # 替换为你的Nginx路径
start nginx

2. 停止 Nginx(两种模式)

Nginx 提供了两种停止方式,务必分清:

快速停止(强制):类似于 kill -9,直接断掉所有连接。

1

nginx -s stop

优雅停止(推荐):类似于 kill -15,等待 Worker 处理完当前请求再退出。

1

nginx -s quit

注意:在 Windows 服务模式下,有时 quit 命令不生效,这时只能用 stop。

3. 重载配置

修改 nginx.conf 后,不需要重启,直接重载:

1

nginx -s reload

4. 检查配置是否正确

在启动或重启前,务必先测试配置文件语法:

1

nginx -t

如果显示 nginx: configuration file ... test is successful,则可以放心启动。

三、 进阶方案:注册为 Windows 服务(开机自启)

如果你希望 Nginx 像 MySQL 一样开机自启,可以将其注册为服务。但千万不要直接用 sc.exe 命令硬注册,推荐使用 NSSM (Non-Sucking Service Manager) 工具,它能更好地管理进程树。

使用 NSSM 注册步骤:

1.下载 NSSM

2.管理员身份运行 CMD,执行安装:

1

nssm install Nginx

3.在弹出的 GUI 界面中设置:

4.点击“Install service”。

5.在“服务”列表中找到 Nginx,右键启动。

重要提示:关于 worker_processes

如果你注册为服务并使用了 worker_processes auto;,在停止服务时极易出现进程残留。

解决方案:在开发机上,建议将配置改为 worker_processes 1;。虽然牺牲了多核性能,但在本地开发环境下几乎无感知,却能极大减少进程管理的麻烦。

四、 急救方案:当进程“杀不死”时怎么办?

当你遇到以下情况:

这时候就需要强制清理所有 Nginx 进程。

方法 1:手动操作

打开任务管理器 -> 详细信息。

找到所有 nginx.exe(包括 master 和 worker)。

右键 -> 结束任务树。

方法 2:一键脚本(推荐)

为了避免每次都手动查找,我写了一个批处理脚本,以管理员身份运行即可一键清理所有后台 Nginx 进程。

创建 clean_nginx.bat 文件,复制以下代码:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

@echo off

title Nginx 进程强制清理工具

color 0b

 

echo ====================================================

echo           Nginx 进程强制清理工具

echo ====================================================

echo.

 

:: 检查管理员权限

net session >nul 2>&1

if %errorLevel% == 0 (

    echo [状态] 当前具有管理员权限

) else (

    echo [警告] 非管理员权限,可能无法清理系统进程

    echo [提示] 请右键点击此脚本,选择"以管理员身份运行"

    echo.

)

 

echo [步骤 1] 正在扫描 Nginx 进程...

tasklist /FI "IMAGENAME eq nginx.exe" 2>nul | find /I "nginx.exe" >nul

if %errorLevel% == 0 (

    echo [发现] 找到正在运行的 Nginx 进程

) else (

    echo [信息] 未找到 Nginx 进程,无需清理

    goto :end

)

 

echo.

echo [步骤 2] 正在强制终止所有 Nginx 进程...

taskkill /F /IM nginx.exe >nul 2>&1

if %errorLevel% == 0 (

    echo [成功] 已发送终止信号

) else (

    echo [错误] 终止失败,请检查权限

    goto :end

)

 

echo.

echo [步骤 3] 验证清理结果...

timeout /t 2 /nobreak >nul

tasklist /FI "IMAGENAME eq nginx.exe" 2>nul | find /I "nginx.exe" >nul

if %errorLevel% == 0 (

    echo [警告] 仍有残留进程,尝试二次清理...

    taskkill /F /FI "IMAGENAME eq nginx.exe" >nul 2>&1

) else (

    echo [成功] 所有 Nginx 进程已清理干净!

)

 

:end

echo.

echo ====================================================

echo 操作完成!

echo ====================================================

echo.

pause

使用方法:

五、 总结

场景 推荐操作 命令/工具
日常开发调试 命令行直接控制 start nginx / nginx -s quit
生产/长期运行 NSSM 注册服务 nssm install + 服务管理器
配置多核优化 修改配置文件 worker_processes auto; (需配合NSSM)
避免麻烦 开发机折中方案 worker_processes 1;
进程失控/端口占用 强制清理脚本 clean_nginx.bat (管理员运行)
原文链接:
相关文章
最新更新