让 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 自带的任务计划程序即可。
-
按下
Win键,搜索并打开"任务计划程序"。 -
右侧点击"创建基本任务"。
- 名称:
Nginx Auto Start - 触发器:选择"当计算机启动时"
- 操作:选择"启动程序"
- 程序或脚本:浏览选择
nginx.exe
- 名称:
-
完成创建后,重启电脑验证。
注意:请确保 Nginx 所在目录路径不包含空格或中文,否则可能导致任务执行失败。
Linux 系统
现代 Linux 发行版(Ubuntu 16.04+、CentOS 7+、Debian 8+ 等)统一使用 systemd 管理服务。
方法一:systemd(通用推荐)
如果你通过包管理器(apt、yum、dnf)安装 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,它们最稳定、最符合各平台的最佳实践。
如果在配置过程中遇到其他问题,欢迎留言讨论。