使用NSSM将Python脚本转为Windows后台服务的方案咨询

1. 打包Python脚本为无控制台可执行文件 #

用PyInstaller将脚本打包成单文件exe，确保后台运行不弹出命令行窗口：

• 安装PyInstaller：pip install pyinstaller
• 执行打包命令：

  pyinstaller --onefile --noconsole your_script.py
  

  • --onefile：生成单个exe文件，方便分发
  • --noconsole：禁用控制台窗口，实现后台运行
• 注意：脚本中如果涉及文件路径，要使用绝对路径，或者在打包时通过--add-data参数嵌入依赖资源，避免运行时找不到文件。

2. 注册为Windows自动启动服务 #

推荐使用NSSM（Non-Sucking Service Manager），它是一款轻量工具，无需修改脚本即可将exe注册为服务，支持图形化配置和命令行自动化，比原生sc命令更易用。

一键自动化部署步骤： #

1. 下载对应系统位数的NSSM，将nssm.exe放到打包好的exe同一目录下。
2. 编写自动化批处理脚本（install_service.bat），实现一键安装、设置自动启动并启动服务：

   @echo off
   :: 检查管理员权限
   net session >nul 2>&1
   if %errorLevel% neq 0 (
       echo 请右键点击脚本，选择「以管理员身份运行」
       pause
       exit /b 1
   )
   
   :: 配置参数
   set SERVICE_NAME=SocketDataSender
   set EXE_PATH=%~dp0your_script.exe
   set NSSM_PATH=%~dp0nssm.exe
   
   :: 创建日志目录（可选，用于排查问题）
   mkdir "%~dp0logs" 2>nul
   
   :: 安装服务
   "%NSSM_PATH%" install "%SERVICE_NAME%" "%EXE_PATH%"
   :: 设置服务为自动启动（系统重启后自动运行）
   "%NSSM_PATH%" set "%SERVICE_NAME%" Start SERVICE_AUTO_START
   :: 配置日志输出
   "%NSSM_PATH%" set "%SERVICE_NAME%" AppStdout "%~dp0logs\stdout.log"
   "%NSSM_PATH%" set "%SERVICE_NAME%" AppStderr "%~dp0logs\stderr.log"
   :: 设置服务运行账户为Local System（解决权限问题）
   "%NSSM_PATH%" set "%SERVICE_NAME%" ObjectName LocalSystem
   
   :: 启动服务
   "%NSSM_PATH%" start "%SERVICE_NAME%"
   
   echo 服务安装并启动成功！
   pause
   

3. 将打包好的your_script.exe、nssm.exe、install_service.bat打包成压缩包，用户下载后只需右键以管理员身份运行install_service.bat，即可完成全部配置。

3. 权限问题解决 #

• 服务默认使用Local System账户运行，拥有系统级权限，可避免多数权限不足问题。
• 若脚本需要访问特定网络共享或数据库，可通过NSSM的图形界面修改服务的登录账户（运行nssm edit SERVICE_NAME打开配置窗口）。

4. 调试与维护 #

• 查看服务状态：按下Win+R输入services.msc，找到SocketDataSender服务，查看运行状态。
• 排查问题：查看logs目录下的stdout.log和stderr.log，获取脚本运行日志。
• 卸载服务：创建uninstall_service.bat，内容如下：

  @echo off
  net session >nul 2>&1
  if %errorLevel% neq 0 (
      echo 请以管理员身份运行
      pause
      exit /b 1
  )
  set SERVICE_NAME=SocketDataSender
  set NSSM_PATH=%~dp0nssm.exe
  "%NSSM_PATH%" stop "%SERVICE_NAME%"
  "%NSSM_PATH%" remove "%SERVICE_NAME%" confirm
  echo 服务已卸载
  pause
  

内容的提问来源于stack exchange，提问作者Shahzaib Nasir