一文搞定 Nginx 开机自启:Windows / Linux / macOS 全平台指南

让 Nginx 跟随系统启动,从此告别每次重启电脑后手动敲命令的烦恼。

无论是开发环境还是生产服务器,Nginx 作为高性能的 Web 服务器和反向代理,常常需要 7×24 小时运行。如果每次电脑或服务器重启后都要手动启动它,既繁琐又容易遗忘。本文将详细讲解在 Windows、Linux、macOS 三大主流操作系统上,如何将 Nginx 配置为系统服务,实现开机自动启动。

目录

  • Windows 系统

    • 方法一:WinSW 注册为系统服务(推荐)
    • 方法二:任务计划程序
  • Linux 系统

    • 方法一:systemd(通用推荐)
    • 方法二:手动创建 systemd 服务文件(源码编译安装)
  • macOS 系统

    • 方法一:Homebrew(最简单)
    • 方法二:手动创建 launchd 服务文件
  • 常见问题与故障排查

    • 如何卸载已存在的 Nginx 服务
    • 端口冲突
    • 路径错误
    • 脚本权限不足

Windows 系统

方法一:WinSW 注册为系统服务(推荐)

WinSW 是一个轻量级的开源工具,可以将任何可执行程序包装成 Windows 系统服务。

1. 下载 WinSW

前往 GitHub Releases 下载 WinSW-net4.exe(.NET 4 环境)或最新版。将其放入 Nginx 根目录,并重命名为 nginx-service.exe

2. 创建配置文件

在同目录下新建 nginx-service.xml,写入以下内容(请将路径替换为你的实际路径):

xml 复制代码
<service>
  <id>nginx</id>
  <name>Nginx Web Server</name>
  <description>Nginx HTTP Server</description>
  <executable>C:\path\to\your\nginx\nginx.exe</executable>
  <logpath>C:\path\to\your\nginx\logs</logpath>
  <startmode>Automatic</startmode>
  <stopexecutable>C:\path\to\your\nginx\nginx.exe</stopexecutable>
  <stopargument>-s</stopargument>
  <stopargument>stop</stopargument>
</service>

3. 安装服务
以管理员身份打开命令提示符,进入 Nginx 目录,执行:

复制代码
nginx-service.exe install

4. 验证

按下 Win + R,输入 services.msc 打开"服务",找到 Nginx Web Server,确认其"启动类型"为 自动。你也可以右键手动启动一次测试。

方法二:任务计划程序

无需第三方工具,利用 Windows 自带的任务计划程序即可。

  1. 按下 Win 键,搜索并打开"任务计划程序"。

  2. 右侧点击"创建基本任务"。

    • 名称:Nginx Auto Start
    • 触发器:选择"当计算机启动时"
    • 操作:选择"启动程序"
    • 程序或脚本:浏览选择 nginx.exe
  3. 完成创建后,重启电脑验证。

注意:请确保 Nginx 所在目录路径不包含空格或中文,否则可能导致任务执行失败。

Linux 系统

现代 Linux 发行版(Ubuntu 16.04+、CentOS 7+、Debian 8+ 等)统一使用 systemd 管理服务。

方法一:systemd(通用推荐)

如果你通过包管理器(aptyumdnf)安装 Nginx,systemd 服务文件通常已经自动生成,只需执行以下命令:

bash 复制代码
# 设置开机自启
sudo systemctl enable nginx

# 立即启动服务
sudo systemctl start nginx

检查状态:

lua 复制代码
sudo systemctl status nginx

输出中若包含 enabled,则表示开机自启已配置成功。

方法二:手动创建 systemd 服务文件(源码编译安装)

如果你通过源码编译安装 Nginx,需要手动创建服务文件。

1. 创建服务文件

bash 复制代码
sudo nano /etc/systemd/system/nginx.service

2. 粘贴以下配置 (根据你的实际安装路径修改 ExecStart 等参数):

ini 复制代码
[Unit]
Description=nginx - high performance web server
After=network.target

[Service]
Type=forking
ExecStartPre=/usr/local/nginx/sbin/nginx -t
ExecStart=/usr/local/nginx/sbin/nginx
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

3. 重载并启用服务

bash 复制代码
sudo systemctl daemon-reload
sudo systemctl enable --now nginx

macOS 系统

macOS 使用 launchd 管理后台服务。

方法一:Homebrew(最简单)

如果你通过 Homebrew 安装了 Nginx,只需一条命令:

sql 复制代码
brew services start nginx

该命令会自动将 Nginx 配置为开机自启并立即启动。若要停止或重启:

arduino 复制代码
brew services stop nginx
brew services restart nginx

方法二:手动创建 launchd 服务文件

适合不使用 Homebrew 或需要精细控制的场景。

1. 创建 plist 文件

bash 复制代码
sudo nano /Library/LaunchDaemons/com.nginx.plist

2. 填写配置(修改 Nginx 实际路径):

xml 复制代码
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.nginx</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/nginx/sbin/nginx</string>
        <string>-g</string>
        <string>daemon off;</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

3. 加载并启动

bash 复制代码
sudo launchctl load /Library/LaunchDaemons/com.nginx.plist
sudo launchctl start com.nginx

常见问题与故障排查

如何卸载已存在的 Nginx 服务

如果你在安装时遇到"服务已存在"的提示,可以按以下方法卸载旧服务(以 Windows 为例,其他系统类似):

方法一:使用 WinSW 的 uninstall 命令

在有 nginx-service.exe 的目录下,以管理员身份运行:

复制代码
nginx-service.exe uninstall

方法二:使用 sc 命令

arduino 复制代码
sc delete "你的服务名称"

例如 sc delete "Nginx Web Server"

方法三:PowerShell(版本 6+)

arduino 复制代码
Remove-Service -Name "你的服务名称"

方法四:注册表删除(高级)

打开 regedit,导航到 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services,找到对应的服务文件夹,右键删除。

端口冲突

Nginx 默认监听 80 端口(HTTP)和 443 端口(HTTPS)。如果这些端口被其他程序(如 Skype、Apache、IIS)占用,Nginx 启动会失败。 排查方法

  • Windows:netstat -ano | findstr :80
  • Linux/macOS:sudo lsof -i :80

找到占用进程后,停止对应程序或修改 Nginx 监听端口。

路径错误

无论是 WinSW 的 XML 配置,还是 systemd/launchd 的脚本中,务必使用 Nginx 的绝对路径。建议路径中不要含有空格或特殊字符。

脚本权限不足(Linux)

如果使用自定义 init 脚本,确保脚本具有可执行权限:

bash 复制代码
sudo chmod +x /etc/init.d/nginx

对于 systemd 服务文件,通常不需要额外权限,但需要保证 ExecStart 指向的二进制文件可执行。

结语

通过以上任一方法,即可让 Nginx 在系统启动时自动运行。推荐 Windows 用户使用 WinSW ,Linux 用户使用 systemd ,macOS 用户使用 Homebrew,它们最稳定、最符合各平台的最佳实践。

如果在配置过程中遇到其他问题,欢迎留言讨论。

相关推荐
fred_kang18 小时前
Windows 下 Nginx 启动报错 10013 / OpenEvent 完整排查指南
运维·windows·nginx
imuliuliang1 天前
五大编程语言核心对比:特性与应用全解析
运维·spring boot·nginx
天草二十六_简村人1 天前
对接AI大模型之nginx代理配置SSE接口
运维·网络·nginx·http·阿里云·ai·云计算
小趴菜克鲁里1 天前
Cocos Creator 进阶:打造灵活可控的进度条动画组件(循环与分段)
运维·nginx
heimeiyingwang1 天前
【架构实战】Nginx七层负载均衡:从配置到原理,从入门到精通
nginx·架构·负载均衡
Qt程序员1 天前
从协议到实战:HTTP 反向代理
linux·c++·websocket·nginx·http·反向代理·正向代理
遇见火星1 天前
Nginx 缓存配置:动静分离,快如闪电
运维·nginx·缓存
江上清风山间明月2 天前
Nginx基于域名区分的多网站部署
运维·nginx·部署·php·多个网站
随风,奔跑2 天前
Nginx
服务器·后端·nginx·web