NSSM 完全指南：如何将任意程序部署为 Windows 服务
NSSM 完全指南：将任意程序部署为 Windows 服务
目录
- 什么是 NSSM？
- 安装与基础使用
- 高级配置（GUI 模式）
- 实战案例
- 常见问题排查
- 替代方案对比
- 总结
1. 什么是 NSSM？
NSSM（Non-Sucking Service Manager）是一个轻量级工具，可将命令行程序注册为 Windows 服务，实现：
- ✅ 后台静默运行（不依赖 CMD）
- ✅ 开机自启动
- ✅ 崩溃自动恢复
- ✅ 日志集中管理
典型应用场景
| 场景 | 示例 |
|---|---|
| Java 应用部署 | Spring Boot Jar 包后台运行 |
| 脚本守护进程 | Python/Node.js 长期运行 |
| 游戏服务器 | 崩溃后自动重启 |
2. 安装与基础使用
安装步骤
# 下载 nssm.exe 并放入系统路径
copy nssm.exe C:\Windows
核心命令
| 命令 | 作用 |
|---|---|
nssm install <服务名> | 注册新服务 |
nssm start/stop/restart | 服务启停管理 |
nssm remove <服务名> | 删除服务 |
示例：部署 Java 应用
nssm install MyApp "C:\jdk\bin\java.exe" -jar "D:\app.jar"
nssm set MyApp AppDirectory "D:\"
nssm set MyApp AppStdout "D:\logs\app.log"
3. 高级配置（GUI 模式）
运行 nssm edit <服务名> 打开配置界面：
1. **Path**: 程序绝对路径（如 `java.exe`）
2. **Arguments**: 启动参数（如 `-jar app.jar`）
3. **Startup Directory**: 工作目录
4. **Logging**: - Stdout/Stderr 重定向到文件
5. **Recovery**: - 设置崩溃后重启策略（推荐首次延迟 1000ms）
4. 实战案例
案例 1：Spring Boot 服务化
nssm install MySpringBoot "C:\jdk\bin\java.exe" -jar "D:\app.jar"
nssm set MySpringBoot AppStdout "D:\logs\spring.log"
nssm set MySpringBoot Start SERVICE_AUTO_START
案例 2：Python 脚本守护进程
nssm install MyPyScript "C:\Python\python.exe" "D:\script.py"
nssm set MyPyScript AppThrottle 2000 # 2秒后自动重启
5. 常见问题排查
服务启动后立即停止
# 检查日志
type "D:\logs\service_error.log"# 验证路径（特别注意空格）
where java
端口冲突
netstat -ano | findstr 8080
taskkill /PID 1234 /F
6. 替代方案对比
| 工具 | 优势 | 劣势 |
|---|---|---|
| NSSM | 零编码，支持任意程序 | 需手动安装 |
| SC | 系统原生 | 配置复杂 |
| WinSW | 支持 XML 配置 | 依赖 .NET 环境 |
7. 总结
最佳实践清单：
- 始终配置
AppStdout记录日志 - 使用完整路径（避免
Program Files空格问题） - 设置
Start SERVICE_AUTO_START实现开机自启 - 复杂环境建议先用
nssm edit图形界面调试
官方文档：nssm.cc
进阶技巧：Windows 服务管理指南