WinSW

创建日期:2024-06-21
更新日期:2024-12-18

WinSW是一个把可执行文件封装为Windows服务的包装器。

项目地址:https://github.com/winsw/winsw

常用命令

查看帮助:.\WinSW -h

安装服务:.\WinSW install /path/to/config

卸载服务:.\WinSW uninstall /path/to/config

启动服务:.\WinSW start /path/to/config

停止服务:.\WinSW stop /path/to/config

重启服务:.\WinSW restart /path/to/config

自重启:.\WinSW restart! /path/to/config

查看状态:.\WinSW status /path/to/config

刷新配置:.\WinSW refresh /path/to/config

自定义:.\WinSW customize

实验命令:.\WinSW dev

配置文件

配置文件应该和WinSW.exe放在一起,文件名应该和可执行文件名一致。例如:myapp.exe的配置文件是myapp.xml。

常用配置:

1、必需配置。

id:服务名称

executable:可执行文件

name:服务显示名称(可选)

description:服务描述(可选)

2、安装配置,需要重启服务生效。(可选)

serviceaccount.domain:域名

serviceaccount.user:用户名

serviceaccount.password:密码

serviceaccount.allowservicelogon:允许服务登录

onfailure:失败策略。(支持多个,可选)

resetfailure:多久后重置失败标志。(可选)

securityDescriptor:安全描述。(可选)

3、可执行文件配置。

arguments:向可执行文件传递参数。

startarguments:启动参数,设置后会覆盖arguments。

workingdirectory:可执行文件工作目录。

priority:可执行文件优先级,例如:Normal, Idle, High, RealTime, BelowNormal, AboveNormal。

stoptimeout:停止服务等待时间。

stopexecutable:停止服务执行的文件。

stoparguments:停止服务参数。

4、服务管理配置。

startmode:启动模式,例如:Automatic, Manual, Boot, System。

delayedAutoStart:延迟自动启动。

depend:该服务依赖的服务。(支持多个)

interactive:是否可与桌面交互。

5、日志配置。

logpath:日志文件。

log:日志模式。

6、环境配置。

env:设置环境变量。

download:启动前下载配置。

7、其他选项。

beeponshutdown:服务停止轰鸣。

8、扩展配置。

extensions. extension:添加自定义扩展。