使用NSSM将Java应用注册为Windows服务的完整指南

1. 为什么需要将Jar包注册为Windows服务？

在Java开发中，我们经常需要将Spring Boot或其他Java应用打包成可执行的Jar文件。虽然可以通过java -jar命令直接运行，但在Windows服务器环境下，这种方式存在几个明显的痛点：

• 命令行窗口一旦关闭，服务就会终止
• 服务器重启后需要手动重新启动应用
• 无法像系统服务那样设置自动恢复策略
• 缺乏标准化的服务管理接口（启动/停止/状态查询）

NSSM（Non-Sucking Service Manager）正是为解决这些问题而生。它是一款轻量级的Windows服务封装工具，可以将任何可执行程序（包括Java应用）注册为系统服务。与手动编写Windows服务包装器相比，NSSM具有以下优势：

1. 零代码侵入：不需要修改Java应用本身
2. 配置简单：通过命令行即可完成服务注册
3. 资源监控：内置进程监控和自动重启功能
4. 日志集成：自动捕获标准输出到系统事件日志

提示：对于生产环境部署的Java应用，建议都通过服务化方式运行，这比直接运行Jar包或使用批处理脚本可靠得多。

2. NSSM的安装与环境准备

2.1 获取NSSM工具

NSSM是开源工具，可以从官网直接下载预编译版本：

1. 访问 nssm.cc 下载页面
2. 选择最新稳定版（当前为2.24）
3. 根据系统架构下载32位或64位版本

下载后解压到任意目录，建议放在系统PATH包含的路径（如C:\Windows\System32）以便全局调用。

2.2 验证Java环境

确保目标服务器已正确安装Java运行时：

bash复制java -version

输出应显示Java 8或更高版本。如果使用JDK而非JRE，建议设置JAVA_HOME环境变量指向JDK安装目录。

2.3 准备Jar包

确保你的应用Jar包满足：

• 必须是可执行Jar（包含Main-Class清单属性）
• 建议使用Spring Boot的spring-boot-maven-plugin打包
• 测试能否通过java -jar your-app.jar正常运行

3. 使用NSSM注册Jar服务

3.1 基本服务注册

以管理员身份打开CMD，执行以下命令：

bash复制nssm install YourServiceName

这会打开NSSM的GUI配置界面。填写关键参数：

• Path: java.exe的完整路径（如C:\Program Files\Java\jdk1.8.0_291\bin\java.exe）
• Startup directory: Jar包所在目录
• Arguments: -jar your-app.jar

点击"Install service"完成注册。

3.2 命令行方式注册

如果需要在脚本中自动化执行，可以使用纯命令行方式：

bash复制nssm install YourServiceName "C:\Program Files\Java\jdk1.8.0_291\bin\java.exe" "-jar C:\apps\your-app.jar"
nssm set YourServiceName AppDirectory "C:\apps"
nssm set YourServiceName AppStdout "C:\logs\your-app.log"
nssm set YourServiceName AppStderr "C:\logs\your-app-error.log"

3.3 高级配置项

通过NSSM可以配置许多服务属性：

bash复制# 设置服务描述
nssm set YourServiceName Description "您的服务描述"

# 配置自动重启策略（崩溃后5秒重启，最多3次）
nssm set YourServiceName AppRestartDelay 5000
nssm set YourServiceName AppThrottle 5000
nssm set YourServiceName AppExit Default Restart

# 设置JVM内存参数
nssm set YourServiceName AppParameters "-Xms512m -Xmx1024m -jar your-app.jar"

# 指定运行账户（建议使用专用服务账户）
nssm set YourServiceName ObjectName "DOMAIN\user" "password"

4. 服务管理与运维

4.1 基本服务操作

bash复制# 启动服务
net start YourServiceName
# 或
sc start YourServiceName

# 停止服务
net stop YourServiceName

# 删除服务
nssm remove YourServiceName confirm

4.2 服务状态监控

NSSM会监控托管进程的状态。如果进程意外退出，会根据配置自动重启。可以通过以下方式查看服务状态：

1. Windows服务管理器（services.msc）
2. 命令行：

   bash复制sc query YourServiceName
   

3. 查看NSSM事件日志：

   bash复制nssm eventlog YourServiceName
   

4.3 日志管理

建议配置日志轮转防止日志文件过大：

bash复制nssm set YourServiceName AppRotateFiles 1
nssm set YourServiceName AppRotateOnline 1
nssm set YourServiceName AppRotateSeconds 86400
nssm set YourServiceName AppRotateBytes 1048576

这会每天或日志超过1MB时轮转日志文件。

5. 常见问题排查

5.1 服务启动失败

如果服务无法启动，按以下步骤排查：

1. 检查事件查看器（eventvwr.msc）中的系统日志
2. 尝试手动运行命令：

   bash复制java -jar your-app.jar
   

3. 检查Jar包是否损坏：

   bash复制jar -tf your-app.jar
   

4. 确认Java版本兼容性

5.2 权限问题

服务账户可能没有足够的权限：

• 确保服务账户对Jar目录有读取权限
• 对日志目录有写入权限
• 如果访问网络资源，需要配置相应权限

5.3 内存泄漏处理

如果服务因内存不足崩溃：

1. 调整JVM参数：

   bash复制nssm set YourServiceName AppParameters "-Xms256m -Xmx2048m -jar your-app.jar"
   

2. 配置内存溢出时生成堆转储：

   bash复制nssm set YourServiceName AppParameters "-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=C:\dumps -jar your-app.jar"
   

5.4 服务删除失败

有时直接删除服务可能失败，可以强制删除：

bash复制sc delete YourServiceName

6. 生产环境最佳实践

6.1 服务隔离原则

• 每个Java应用应作为独立服务运行
• 使用专用服务账户运行关键服务
• 为不同服务分配适当的系统资源

6.2 资源限制

通过NSSM可以限制服务资源使用：

bash复制# 限制CPU使用（百分比）
nssm set YourServiceName AppAffinity 0,1  # 只使用CPU0和CPU1

# 限制内存使用（MB）
nssm set YourServiceName AppLimit 2048  # 限制2GB内存

6.3 启动依赖

如果服务依赖其他服务（如数据库），可以设置启动依赖：

bash复制nssm set YourServiceName DependOnService "MySQL"

6.4 服务恢复策略

配置完善的服务恢复策略：

bash复制nssm set YourServiceName AppExit Default Restart  # 第一次失败时重启
nssm set YourServiceName AppExit 1 Restart  # 第二次失败时重启
nssm set YourServiceName AppExit 2 Restart  # 第三次失败时重启
nssm set YourServiceName AppRestartDelay 60000  # 60秒后重启

7. 替代方案比较

除了NSSM，还有其他几种将Jar包注册为服务的方法：

对于大多数Java应用，NSSM仍然是平衡功能和易用性的最佳选择。

8. 实际案例：Spring Boot应用服务化

以一个典型的Spring Boot应用为例，完整服务化流程如下：

1. 使用Maven打包：

   bash复制mvn clean package
   

2. 注册服务：

   bash复制nssm install MySpringBootApp "C:\Program Files\Java\jdk11\bin\java.exe" "-jar C:\apps\myapp.jar"
   nssm set MySpringBootApp AppDirectory "C:\apps"
   nssm set MySpringBootApp AppStdout "C:\logs\myapp.log"
   nssm set MySpringBootApp AppStderr "C:\logs\myapp-error.log"
   nssm set MySpringBootApp AppParameters "-Xms512m -Xmx1024m -Dspring.profiles.active=prod -jar myapp.jar"
   

3. 配置服务自动启动：

   bash复制sc config MySpringBootApp start= auto
   

4. 启动服务：

   bash复制net start MySpringBootApp
   

我在实际部署中发现，Spring Boot应用作为服务运行时，有几个关键点需要注意：

• 确保关闭命令行界面（如SSH）后服务仍能运行
• 生产环境务必配置足够大的堆内存
• 使用-Dserver.tomcat.basedir指定临时目录，避免使用系统临时目录
• 对于Web应用，设置合理的超时时间：

  bash复制nssm set MySpringBootApp AppParameters "-Dserver.connection-timeout=5000 -jar myapp.jar"
  

通过NSSM将Java应用服务化后，运维团队可以通过标准的Windows服务管理接口来监控和维护应用，大大提高了生产环境的稳定性和可维护性。