NSIS安装包如何添加Windows特殊服务？

Question

在使用NSIS（Nullsoft Scriptable Install System）打包应用程序时，如何正确添加并注册Windows特殊服务（如自启动服务或高权限后台服务）是一个常见技术难点。开发者常遇到服务无法自动安装、启动失败或权限不足等问题。问题通常源于服务安装脚本编写不当、缺少管理员权限声明、或未正确调用Windows Service Control Manager（SCM）。如何通过nsExec或ExecWait调用sc.exe命令行工具，或使用插件如NSIS Service Plugin来可靠地安装、启动和卸载服务？同时，如何确保服务可跨Windows版本兼容运行，并处理依赖项与延迟启动配置？

Answer 1

NSIS中Windows服务的安装与管理：从基础到高级实践

1. 引言：NSIS与Windows服务集成的挑战

在使用NSIS（Nullsoft Scriptable Install System）进行应用程序打包时，集成Windows服务是实现后台运行、系统级功能或自启动逻辑的关键步骤。然而，开发者常面临服务无法注册、启动失败、权限不足等问题。这些问题通常源于对Windows Service Control Manager（SCM）机制理解不深、脚本编写不当或未正确请求管理员权限。

本文将从权限配置入手，逐步深入至服务注册、启动控制、跨平台兼容性及高级配置（如依赖项和延迟启动），结合nsExec、ExecWait与NSIS Service Plugin等工具，提供一套完整、可靠的解决方案。

2. 权限基础：确保管理员权限执行安装

Windows服务属于系统级资源，其安装必须以管理员身份运行。NSIS提供了RequestExecutionLevel指令来声明执行级别：

        RequestExecutionLevel admin
        !include "LogicLib.nsh"
        Function .onInit
            UserInfo::GetAccountType
            StrCmp $R0 "admin" 0 +2
            Goto done
            MessageBox MB_OK|MB_ICONSTOP "此安装程序需要管理员权限运行。"
            SetErrorLevel 1
            Quit
        done:
        FunctionEnd
    

该段代码确保安装程序仅在管理员权限下运行，否则退出并提示用户。这是所有服务操作的前提。

3. 方法一：通过sc.exe命令行工具注册服务

Windows自带的sc.exe是操作服务的标准工具。NSIS可通过ExecWait或nsExec::Exec调用它完成服务安装。

示例如下：

        ExecWait 'sc create MyService binPath= "$INSTDIR\MyService.exe" start= auto'
        ExecWait 'sc description MyService "这是一个高权限后台服务"'
        ExecWait 'sc start MyService'
    

其中参数说明如下：

参数	含义
binPath=	指定服务可执行文件路径
start= auto	设置为开机自启
start= delayed-auto	延迟自动启动
start= demand	手动启动
depend=	指定依赖服务（如：NetTcpPortSharing）
obj= LocalSystem	运行账户（默认）
DisplayName=	服务显示名称

4. 方法二：使用NSIS Service Plugin增强控制能力

NSIS Service Plugin（nsis-service-plugin）提供更安全、结构化的服务管理接口，支持错误检测和服务状态查询。

首先需下载插件并放入Plugins\x86-ansi\目录，然后调用：

        !include "nsis-service-plugin.nsh"
        ${service_create} "MyService" \
            "DisplayName=My Background Service" \
            "Binary=$INSTDIR\MyService.exe" \
            "StartType=AUTO" \
            "Depend=RPCSS;Dnscache" \
            "Description=High-privilege service for data sync"
        ${If} ${Errors}
            MessageBox MB_OK "服务创建失败: $^Name"
        ${EndIf}
        ${service_start} "MyService"
    

该插件自动处理引号转义、路径空格等问题，并返回详细错误码。

5. 卸载阶段：停止并删除服务

卸载时应先停止服务，再删除注册信息：

        ExecWait 'sc stop MyService'
        Sleep 1000
        ExecWait 'sc delete MyService'
    

或使用插件方式：

        ${service_stop} "MyService"
        ${service_delete} "MyService"
    

注意添加延时等待服务完全终止，避免“服务正忙”错误。

6. 跨Windows版本兼容性处理

不同Windows版本对服务参数支持略有差异。例如delayed-auto仅支持Vista及以上系统。

可通过版本检测动态选择启动类型：

        GetVersion::GetWindowsVersion
        Pop $R0 ; OS major
        Pop $R1 ; OS minor
        StrCmp $R0 "6" 0 +2
        StrCmp $R1 "0" skip_delayed ; Vista or later
        ExecWait 'sc config MyService start= delayed-auto'
        Goto done_delayed
        skip_delayed:
        ExecWait 'sc config MyService start= auto'
        done_delayed:
    

7. 高级配置：依赖项与延迟启动

某些服务需依赖其他系统服务（如网络、RPC）。可通过以下方式设置：

        ExecWait 'sc config MyService depend= RPCSS/Dnscache/Tcpip'
    

延迟启动可减少开机负载：

        ExecWait 'sc config MyService start= delayed-auto'
    

注意：延迟启动需目标系统支持（Windows Vista+）。

8. 故障排查与日志记录

服务安装失败常见原因包括：

• 未以管理员权限运行
• 可执行路径包含空格但未正确引用
• 服务已存在但未先卸载
• 依赖服务缺失
• 防病毒软件拦截
• SCM数据库锁死（罕见）

建议在安装过程中启用日志：

        DetailPrint "正在安装服务..."
        nsExec::ExecToLog 'sc create MyService binPath= "$INSTDIR\MyService.exe"'
    

9. 流程图：服务安装与卸载逻辑

graph TD
            A[开始安装] --> B{是否管理员?}
            B -- 否 --> C[提示权限不足,退出]
            B -- 是 --> D[复制服务文件]
            D --> E[调用sc.exe创建服务]
            E --> F[设置描述与依赖]
            F --> G[启动服务]
            G --> H[完成安装]

            I[开始卸载] --> J[停止服务]
            J --> K[等待1秒]
            K --> L[删除服务]
            L --> M[删除文件]
            M --> N[完成卸载]

10. 最佳实践总结与扩展思考

综合以上内容，推荐的最佳实践包括：

1. 始终使用RequestExecutionLevel admin
2. 优先使用NSIS Service Plugin而非原始sc.exe调用
3. 在安装前检查服务是否已存在
4. 合理设置依赖项与启动类型
5. 在卸载时优雅停止服务
6. 记录详细安装日志便于调试
7. 测试覆盖Win7/Win10/Win11等主流版本
8. 考虑数字签名防止UAC拦截
9. 使用$PLUGINSDIR临时部署服务文件
10. 支持静默安装模式（/S参数）