nssm详解
nssm是什么？用它来做windows服务的原理是什么？
NSSM 是什么？
NSSM（Non-Sucking Service Manager，意为“不烂的服务管理器”）是一个开源工具，专门用于在 Windows 操作系统上将普通的应用程序（例如可执行文件 .exe 或脚本）转换为 Windows 服务。它最初是为了解决一些传统工具（如 srvany）的不足而开发的，比如无法很好地处理服务应用程序崩溃或退出后的问题。NSSM 的设计目标是简单、可靠，能够监控服务的运行状态，并在服务失败时采取相应的措施（如自动重启）。
NSSM 的主要特点包括：
- 将任何可执行文件包装为 Windows 服务。
- 监控服务的运行状态，如果应用程序意外退出，可以自动重启。
- 支持配置服务的启动参数、工作目录、环境变量等。
- 提供日志功能，通过 Windows 事件日志记录服务的运行情况。
- 支持图形界面（GUI）和命令行操作，方便配置和管理。
官方网站是 nssm.cc，可以从中下载最新版本。 - *
用 NSSM 创建 Windows 服务的原理
Windows 服务是一种特殊类型的应用程序，能够在系统启动时自动运行，且通常无需用户登录即可在后台运行。普通的应用程序（如 .exe 文件）本身并没有内置的服务特性，无法直接被 Windows 服务控制管理器（Service Control Manager, SCM）识别和管理。而 NSSM 的作用就是充当一个“中间人”，将普通应用程序包装成符合 Windows 服务规范的形式。
以下是 NSSM 创建 Windows 服务的核心原理和工作机制：
- 充当服务代理：
NSSM 本身是一个可执行文件（nssm.exe），它会被注册为 Windows 服务。当你使用 NSSM 创建服务时，实际上是将 nssm.exe 配置为服务的入口点，而不是直接运行目标应用程序。
NSSM 通过读取配置（可以是注册表或命令行参数），启动并管理你指定的应用程序。
2. 与 Windows 服务控制管理器交互：
Windows 服务需要响应 SCM 的控制信号（如启动、停止、暂停等）。NSSM 实现了这些接口，能够接收 SCM 的指令，并将这些指令翻译成对目标应用程序的操作。
例如，当你通过 services.msc 或 sc start 启动服务时，SCM 调用 NSSM，NSSM 再启动目标应用程序。
3. 监控和重启机制：
- NSSM 会持续监控目标应用程序的运行状态。如果应用程序意外退出（例如崩溃或手动关闭），NSSM 可以根据配置决定采取什么行动，默认情况下是重启应用程序。
- 它通过检查进程的退出码来判断应用程序的状态，并支持自定义退出码的行为（例如，退出码为 0 时停止服务，其他情况下重启）。
- 配置存储在注册表中：
NSSM 将服务的配置信息存储在 Windows 注册表中，具体路径通常是HKLM\System\CurrentControlSet\Services\<服务名>\Parameters
这些配置包括目标应用程序的路径（Application）、工作目录（AppDirectory）、启动参数（AppParameters）等。NSSM 在启动时会读取这些信息来运行目标程序。
- I/O 重定向和日志记录：
NSSM 可以将目标应用程序的标准输入输出（stdin/stdout/stderr）重定向到文件，或者通过 Windows 事件日志记录服务的运行情况。这对于调试和管理非常有用。
- 启动流程：
- 当服务启动时，SCM 调用 nssm.exe，NSSM 根据配置加载并运行目标应用程序。
- NSSM 会创建一个子进程来运行目标程序，并保持对该进程的监控。如果子进程退出，NSSM 会根据配置决定是否重启或停止服务。
使用 NSSM 创建服务的简单示例
假设你有一个程序 myapp.exe，想让它作为 Windows 服务运行，可以按照以下步骤使用 NSSM：
- 下载并解压 NSSM：
从 nssm.cc 下载 NSSM，选择适合你系统的版本（32 位或 64 位）。
- 安装服务（GUI 方式）：
打开命令提示符（需管理员权限），运行：
nssm install MyService
这会弹出一个图形界面：
- Path: 输入 myapp.exe 的完整路径（例如 C:\path\to\myapp.exe）。
- Startup directory: 输入工作目录（通常是 myapp.exe 所在的目录）。
- Arguments: 输入启动参数（如果有）。
- 点击“Install service”按钮完成安装。
- 安装服务（命令行方式）：
或者直接用命令行：
nssm install MyService "C:\path\to\myapp.exe"
nssm set MyService AppDirectory "C:\path\to"安装完成后，服务会出现在 Windows 的服务管理器（services.msc）中。
- 启动服务：
通过命令行启动：
nssm start MyService
或在 services.msc 中右键点击服务，选择“启动”。
其他管理命令：
停止服务：nssm stop MyService
删除服务：nssm remove MyService confirm
优点与局限性
- 优点：
- 简单易用： 无需修改目标程序的代码即可创建服务。
- 灵活性： 支持任何可执行文件，包括脚本（通过调用解释器如 cmd.exe 或 python.exe）。
- 可靠性： 能监控并自动重启服务，弥补了传统工具（如 srvany）的不足。
- 局限性：
额外依赖：需要 NSSM 的二进制文件存在，如果 nssm.exe 被删除或移动，服务将无法运行。
权限问题：服务默认以 LocalSystem 账户运行，若需访问网络资源，可能需要调整账户配置。
调试复杂性：由于服务运行在后台，可能需要额外的日志配置来排查问题。
总结
NSSM 的核心原理是通过充当服务代理，将普通应用程序包装成 Windows 服务，并负责与 SCM 交互、监控进程状态以及执行重启等操作。它是一个轻量但功能强大的工具，非常适合需要快速部署后台任务的用户。无论是开发测试还是生产环境，NSSM 都提供了一种简单高效的解决方案。
NSSM 高级配置选项
NSSM 提供了许多高级配置选项，允许用户对服务的行为进行精细化调整。这些选项可以通过 NSSM 的图形界面（GUI）、命令行，或直接编辑注册表来设置。以下是 NSSM 的一些高级配置选项及其功能说明，涵盖了常见的用例和细节。
1. 服务启动类型
配置方式：
GUI：Startup 标签中的 "Startup type"。
命令行：nssm set <服务名> Start <值>。
选项：
SERVICE_AUTO_START：系统启动时自动启动服务（默认）。
SERVICE_DELAYED_START：系统启动后延迟启动服务。
SERVICE_DEMAND_START：手动启动服务。
SERVICE_DISABLED：禁用服务。
示例：
nssm set MyService Start SERVICE_DELAYED_START
用途： 控制服务在系统启动时的行为，例如延迟启动以避免资源竞争。
2. 依赖关系
配置方式：
GUI：Dependencies 标签。
命令行：nssm set <服务名> DependOnService <服务名>。
说明：
指定服务启动前必须运行的其他服务。例如，如果你的应用依赖数据库服务（如 MSSQL），可以设置依赖。
示例：
nssm set MyService DependOnService MSSQLSERVER
用途：确保依赖的服务已经运行，避免因依赖不可用导致启动失败。
3. 重启策略
配置方式：
GUI：Restart 标签。
命令行：nssm set <服务名> AppThrottle <毫秒> 或 AppNoConsole。
选项：
AppThrottle：设置应用程序退出后重启的延迟时间（单位：毫秒）。默认是 1500ms。
nssm set MyService AppThrottle 5000
Restart action：应用程序退出时的行为，包括：
Restart：重启应用程序（默认）。
Ignore：忽略退出。
Exit：停止服务。
Reconfigure：重新加载配置。
nssm set MyService AppExit Default Restart
Exit codes：自定义退出码的行为。例如，退出码 0 表示正常退出，不重启：
nssm set MyService AppExit 0 Exit
用途： 调整重启频率，避免因应用程序快速退出导致的无限重启循环。
4. 环境变量
配置方式：
GUI：Environment 标签。
命令行：nssm set <服务名> AppEnvironmentExtra <变量>。
说明：
为目标应用程序设置额外的环境变量，格式为 KEY=VALUE，多个变量用换行符分隔。
示例：
nssm set MyService AppEnvironmentExtra "PATH=C:\\myapp\\bin" "DEBUG=1"
用途： 为应用程序提供运行所需的特定环境变量，例如路径或调试标志。
5. I/O 重定向
配置方式：
GUI：I/O 标签。
命令行：nssm set <服务名> AppStdout <路径> 等。
选项：
AppStdout：标准输出重定向文件。
AppStderr：标准错误重定向文件。
AppStdin：标准输入文件（较少使用）。
nssm set MyService AppStdout C:\\logs\\myapp.log
nssm set MyService AppStderr C:\\logs\\myapp_err.log附加选项：
AppRotateFiles：启用日志轮转（1 表示启用）。
AppRotateBytes：日志文件大小达到指定字节数时轮转。
AppRotateSeconds：按时间间隔轮转（单位：秒）。
nssm set MyService AppRotateFiles 1
nssm set MyService AppRotateBytes 1048576 # 1MB用途： 捕获应用程序的输出，便于调试和日志记录。
6. 运行账户
配置方式：
GUI：Log on 标签。
命令行：`nssm set <服务名> ObjectName <账户> <密码>。
说明：
默认以 LocalSystem 账户运行，可以指定其他用户账户（需提供密码）。
示例：
nssm set MyService ObjectName ".\MyUser" "MyPassword"
用途： 为服务指定特定的权限，例如访问网络共享或特定文件。
7. 优先级和 CPU 亲和性
配置方式：
GUI：Process 标签。
命令行：nssm set <服务名> AppPriority <值> 或 AppAffinity <值>。
选项：
AppPriority：进程优先级。
值：IDLE_PRIORITY_CLASS, BELOW_NORMAL_PRIORITY_CLASS, NORMAL_PRIORITY_CLASS（默认）, ABOVE_NORMAL_PRIORITY_CLASS, HIGH_PRIORITY_CLASS, REALTIME_PRIORITY_CLASS。
nssm set MyService AppPriority ABOVE_NORMAL_PRIORITY_CLASS
AppAffinity：CPU 亲和性，使用位掩码指定使用的 CPU 核心。例如，3 表示使用 CPU0 和 CPU1。
nssm set MyService AppAffinity 3
用途：优化服务的性能或限制资源使用。
8. 停止方式
配置方式：
GUI：Shutdown 标签。
命令行：nssm set <服务名> AppStopMethod* <值>。
选项：
AppStopMethodSkip：跳过某些停止方法（位掩码）。
AppStopMethodConsole：通过 Ctrl+C 停止（需指定超时时间）。
AppStopMethodWindow：向窗口发送 WM_CLOSE。
AppStopMethodThreads：终止线程。
AppStopMethodTerminate：强制终止进程。
nssm set MyService AppStopMethodConsole 1500 # 1500ms 超时用途： 控制服务停止时的行为，确保应用程序优雅退出。
9. 事件日志
配置方式：
GUI：Details 标签中的 "Display name" 和日志选项。
命令行：nssm set <服务名> DisplayName <名称>。
说明：
NSSM 默认将服务状态写入 Windows 事件日志，可以通过 Event Viewer 查看。
示例：
nssm set MyService DisplayName "My Custom Service"用途： 自定义服务在事件日志中的显示名称，便于识别。
10. 其他高级选项
AppNoConsole：
值： 0（默认，有控制台）或 1（无控制台）。
用途： 隐藏应用程序的控制台窗口。
nssm set MyService AppNoConsole 1
AppTimestamp：
值： 0（默认，不记录）或 1（记录时间戳）。
用途： 在日志中添加时间戳。
nssm set MyService AppTimestamp 1
配置查看与修改
查看配置：
nssm get MyService <参数>
示例：nssm get MyService AppStdout
编辑服务：
nssm edit MyService
这会打开 GUI 界面编辑现有服务。
高级用例示例
假设你有一个需要日志轮转、特定账户运行、延迟启动的 Python 脚本服务：
nssm install PythonService "C:\Python39\python.exe" "C:\scripts\my_script.py"
nssm set PythonService Start SERVICE_DELAYED_START
nssm set PythonService ObjectName ".\MyUser" "MyPassword"
nssm set PythonService AppStdout C:\logs\python.log
nssm set PythonService AppRotateFiles 1
nssm set PythonService AppRotateBytes 5242880 # 5MB
nssm start PythonService总结
NSSM 的高级配置选项非常灵活，涵盖了服务的启动、重启、日志、权限、资源管理等多个方面。通过合理配置，可以满足各种复杂场景的需求，例如运行需要网络访问的脚本、优化性能、或确保服务的高可用性。如果需要更深入的定制，可以参考 NSSM 官方文档（nssm.cc/usage）或直接查看注册表中的配置项。