Windows 服务包装器之WinSW

一、WinSW简介

WinSW可以将应用打包成Windows服务的方式运行。

WinSW可以在安装了.NET Framework 4.6.1 或更高版本的Windows 平台上运行。对于没有 .NET Framework 的系统，该项目提供基于 .NET 7 的本机 64 位和 32 位可执行文件。

二、GitHub地址

最新版本和预发布的 WinSW 二进制文件可在GitHub Releases上找到。

根据.Net Framework版本下载即可，如：WinSW.NET4.exe
sample-minimal.xml 是一个最小配置的列子。
sample-allOptions.xml 是一个全部可配置参数的例子。

三、查看.NET Framework版本

1、在地址栏上输入“C:\Windows\Microsoft.NET\Framework”，按回车键
2、可以看到.NET Framework版本。可以看到最高版本为4.0

四、修改及设置

• 1、把winsw.exe改名为有意义名称，比如apiServer.exe。
  因为注册后服务启动的exe就是这个exe，所以修改后便于管理和识别。
  修改sample-minimal.xml 为和exe同名文件，如apiServer.xml
  把apiServer.exe和apiServer.xml放在和jar相同目录即可。

• 2、xml设置
  官方文档

<service>
  <id>apiServer</id>
  <name>apiServer</name>
  <description>Api 服务</description>
  <startmode>Automatic</startmode>
  <executable>java</executable>
  <arguments>-jar api-proj.jar</arguments>
  <autoRefresh>true</autoRefresh>
</service>

相关参数说明如下：

• id：安装windows服务后的服务ID，必须是唯一的。
• name：服务名称，也必须是唯一的。一般和id一致即可。
• description：服务说明，可以使用中文，可做备注使用。
• executable：执行的命令，比如启动springboot应用的命令java。
• arguments：命令执行参数，比如 包路径，类路径等。
• autoRefresh：当服务启动或执行以下命令时自动刷新服务属性。

五、安装服务

以管理员身份执行cmd，切换到exe所在目录，执行如下命令即可。

apiServer.exe install

除install之外，还有如下命令：

install 安装服务
uninstall   卸载服务
start   启动服务
stop    停止服务
restart 重启服务
status  查看服务状态