以Windows服务方式运行ASP.NET Core程序

我们对ASP.NET Core的使用已经进行了相当一段时间了,大多数时候,我们的Web程序都是发布到Linux主机上的,当然了,偶尔也有需求要发布到Windows主机上,这样问题就来了,难道直接以控制台形式运行这个Web程序吗?

直接以控制台形式运行程序当然是可以的,但有以下问题:

  1. 需要敲命令行(这个可以通过制作一个快捷方式解决)
  2. 用户也许会说有一个“黑黑的DOS窗口”,很奇怪
  3. 用户可能会随手把这个“黑黑的DOS窗口”关掉导致程序结束
  4. 不能够自动地随系统启动,得用户登录后再跑程序

如果我们把程序以Windows服务的方式来运行,那以上这些问题都没有了。

微软官方有篇文章,关于如何做这个事情的:https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/windows-service?view=aspnetcore-2.1

我也主要是参考了这篇文章,但其中还有些小小的坑,本文将会提到。OK,Let's get down to work.

包与生成目标

生成目标当然选择最新的.NET Core 2.1了,包则需要引入Microsoft.AspNetCore.Hosting.WindowsServices,最新版是2.1.1(2018/6/19更新,不就是今天嘛),如果你尝试使用最新的2.1.1版,那会出问题,报依赖冲突,你根据报错内容把ASP.NET 2.1.0升级到ASP.NET 2.1.1去,但依旧会出现问题:

It was not possible to find any compatible framework version
The specified framework 'Microsoft.AspNetCore.All', version '2.1.1' was not found.

看来需要安装新的SDK才行,但微软官网最新的正式版SDK就是2.1.300啊,这个还是等等吧,好,果断把版本降回2.1.0,这回没问题了。

修改Main入口

简单,非常简单,把Run改为RunAsService即可。

但这样会导致新的问题,你在开发过程中调试程序的时候会出现这样的错误:Cannot start service from the command line or a debugger. A Windows Service must first be installed and then started with the ServerExplorer, Windows Services Administrative tool or the NET START command. 程序跑不起来,意思显而易见,所以我们在调试中还是要以普通的Run方式。所以改成这样:

    IWebHost host = WebHost.CreateDefaultBuilder(args)
        .UseKestrel(options => { options.Listen(IPAddress.Any, 5201); }) //5201是我用的端口,你改成自己的
        .UseStartup<Startup>() //使用Startup配置类
        .Build();
    bool isService = !(Debugger.IsAttached || args.Contains("--console")); //Debug状态或者程序参数中带有--console都表示普通运行方式而不是Windows服务运行方式
    if (isService) {
        host.RunAsService();
    }
    else {
        host.Run();
    }

配置服务

ASP.NET Core publish生成的目标中并不包含exe文件,所以按照官网文档去弄的话可能会卡住,这是正确的姿势:

sc create MyService binPath= "\"C:\program files\dotnet\dotnet.exe\" \"D:\Services\MyService.dll\"" DisplayName= "MyService" start= auto

注意1:必须以管理员身份运行上面命令
注意2:binPath参数、DisplayName参数及start参数的等号后面必须带一个空格(官网文档也特别提起了这点)

启动服务:

sc run MyService

停止服务:

sc stop MyService

卸载服务:

sc delete MyService

其它

默认情况下,Windows系统服务是以system用户身份运行的,如果你需要切换身份运行,可以在“控制面板 - 管理工具 - 服务”中找到MyService,打开属性面板,在“登录”Tab中指定特定身份。

posted @ 2018-06-19 12:27  guogangj  阅读(...)  评论(...编辑  收藏