windows使用WinSW注册服务

Windows 使用 WinSW 注册服务

WinSW(Windows Service Wrapper)是一个轻量级工具,可以将任意可执行程序(如 Nginx、Spring Boot 应用等)包装成 Windows 系统服务,实现开机自启动、异常自动重启、后台运行等功能。本文将详细介绍如何使用 WinSW 注册 Windows 服务。

一、下载 WinSW.exe

前往 WinSW 官方 GitHub Releases 页面 下载最新版本的 WinSW-x64.exe(根据系统架构选择对应版本)。

二、修改 WinSW-x64.exe 名字为服务名

将下载好的 WinSW-x64.exe 重命名为你想要的服务名称,例如 nginx-service.exe。注意: 重命名后的 exe 文件名将作为服务注册时的标识,后续所有操作命令都需要使用这个文件名。

三、配置服务 xml

WinSW 通过一个同名的 XML 配置文件来定义服务的各项参数。注意: exe 的名字要和 xml 的一样,比如:WinSW-x64.exe 改成 nginx-service.exe,xml 就要命名为 nginx-service.xml,并放在与 exe 相同的目录下。

案例一:注册 nginx 服务

以下配置将 Nginx 注册为 Windows 服务,支持开机自启动、优雅停止和日志记录:

xml 复制代码
<service>
    <id>nginx</id>
    <name>Nginx</name>
    <description>Nginx Web Server</description>

    <!-- 工作目录 -->
    <workingdirectory>%BASE%</workingdirectory>

    <!-- 启动服务 -->
    <executable>%BASE%\nginx.exe</executable>
    <arguments>-c "%BASE%\conf\nginx.conf"</arguments>

    <!-- 系统自启动 -->
    <startmode>Automatic</startmode>
    <delayedAutoStart>true</delayedAutoStart>

    <!-- 停止服务 -->
    <stopexecutable>%BASE%\nginx.exe</stopexecutable>
    <stoparguments>-s stop</stoparguments>

    <!-- 失败重启(按需启用) -->
    <!-- <onfailure action="restart" delay="10 sec" /> -->

    <!-- WinSW 自身日志(非应用日志) -->
    <logpath>%BASE%\logs</logpath>
    <log mode="roll" />
</service>
案例二:注册 Spring Boot 服务

以下配置将 Spring Boot 应用注册为 Windows 服务,包含 JVM 内存参数、开机自启动和优雅停机设置:

xml 复制代码
<service>
    <id>myTranslation</id>
    <name>myTranslation</name>
    <description>Spring Boot Translation Service</description>

    <workingdirectory>%BASE%</workingdirectory>

    <!-- 修改成服务器实际的 Java 路径 -->
    <executable>D:\tools\jdk\jdk-21_windows-x64_bin\jdk-21.0.10\bin\java.exe</executable>

    <!-- 修改成服务器实际的 Spring Boot JAR 路径 -->
    <arguments>
        -Xms512m
        -Xmx1024m
        -jar "%BASE%\my-Spring-Boot-service-1.0.0.jar"
    </arguments>

    <!-- Windows 开机自动启动 -->
    <startmode>Automatic</startmode>

    <!-- Spring Boot 停止超时时间 -->
    <stoptimeout>180sec</stoptimeout>

    <!-- Spring Boot 异常退出后,10 秒自动重启(按需启用) -->
    <!-- <onfailure action="restart" delay="10 sec" /> -->

    <!-- WinSW 自身日志 -->
    <logpath>%BASE%\logs</logpath>
    <log mode="roll" />
</service>

四、安装服务

配置完成后,在 exe 所在目录打开命令行,依次执行以下命令管理服务:

安装服务
bash 复制代码
nginx-service.exe install
启动服务
bash 复制代码
nginx-service.exe start
停止服务
bash 复制代码
nginx-service.exe stop
重启服务
bash 复制代码
nginx-service.exe restart
卸载服务
bash 复制代码
nginx-service.exe uninstall
刷新服务 xml 配置
bash 复制代码
nginx-service.exe refresh
相关推荐
xx z21 小时前
directx修复工具下载(DirectX Repair 增强版 使用说明)
windows·系统·工具·软件
xx z1 天前
pcl2启动器下载(Minecraft PCL2 启动器 最新版 安装与使用说明)
windows·游戏·工具·软件
凯瑟琳.奥古斯特1 天前
我开源了一个 Windows 截图取字工具:全局热键 + 离线 OCR + 标注打码,不上传任何数据
windows·ocr
Funlang2 天前
在 Windows 95 上跑 Fun
windows
ö Constancy2 天前
一台电脑的硬件组成与作用:按功能分类详解(Windows 与 Linux 视角)
linux·windows·电脑
雪落漂泊3 天前
Liunux进程(七):程序控制篇(中)
linux·运维·windows
承渊政道4 天前
Fooocus本地AI绘图教程:Windows部署、低门槛生图与远程访问
人工智能·windows·cpolar·fooocus·生图
陈工大模型4 天前
收到乱码压缩包之后,我重新测了 7-Zip、Bandizip 和win解压缩
windows·电脑·软件工程·软件需求·7-zip
谙弆悕博士4 天前
在文件夹右键直接打开 Kali WSL:一条 `wsl --cd` 注册表脚本
windows·脚本·wsl·右击·ksli
陈工大模型4 天前
解压工具的三个技术分水岭:编码、分卷、容器格式
人工智能·windows·安全·解压工具·免费国内办公软件