DH.Extensions.Hosting.AgentService
4.13.2025.926-beta1153
.NET 5.0
This package targets .NET 5.0. The package is compatible with this framework or higher.
.NET Core 3.1
This package targets .NET Core 3.1. The package is compatible with this framework or higher.
This is a prerelease version of DH.Extensions.Hosting.AgentService.
dotnet add package DH.Extensions.Hosting.AgentService --version 4.13.2025.926-beta1153
NuGet\Install-Package DH.Extensions.Hosting.AgentService -Version 4.13.2025.926-beta1153
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DH.Extensions.Hosting.AgentService" Version="4.13.2025.926-beta1153" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DH.Extensions.Hosting.AgentService" Version="4.13.2025.926-beta1153" />
<PackageReference Include="DH.Extensions.Hosting.AgentService" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add DH.Extensions.Hosting.AgentService --version 4.13.2025.926-beta1153
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: DH.Extensions.Hosting.AgentService, 4.13.2025.926-beta1153"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package DH.Extensions.Hosting.AgentService@4.13.2025.926-beta1153
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=DH.Extensions.Hosting.AgentService&version=4.13.2025.926-beta1153&prerelease
#tool nuget:?package=DH.Extensions.Hosting.AgentService&version=4.13.2025.926-beta1153&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
DH.NAgent - 守护服务管理组件
功能特点
DH.NAgent是一个服务管理框架，用于开发随系统自动启动的长时间运行后台应用程序，支持Windows/Linux。
在Windows上注册为Windows服务，在Linux上注册为Systemd守护进程。
Agent支持netstandard2.0/net45/net40/mono，旧版本还支持net20（已不再维护）。
Agent常用于各种后台应用，如aspnetcore应用、RPC网络服务器、MQTT服务器、数据处理应用、数据消费应用（Redis/RocketMQ）等。同类软件有 NSSM、srvany，但并不一样，Agent是框架，而它们是具体软件，更像星尘代理 StarAgent。
DH.NAgent主要功能：
- 注册应用为系统服务或守护进程，随系统自动启动
- 支持控制台菜单控制安装、卸载、启动、停止，以及查看状态
- 支持控制台调试应用，解决Windows服务难以调试的问题
- 支持健康检测，限制内存、线程数、句柄数，超限时重启应用服务
- 支持应用服务定时重启，通过配置指定
- 支持看门狗WatchDog，通过配置指定要守护的目标应用服务，如果目标停止则启动
- 支持配置文件修改服务名，一个应用程序可在多个目录上部署为不同的系统服务
服务控制
一个服务代理示例跑起来的样子
这是Agent的标准控制台（Windows和Centos）。上面是该服务的状态信息，下面是控制菜单。
示例分析：
- 服务名 XAgent/StarAgent，可以命令启动停止，Windows是
net start XAgent/net stop XAgent，Linux是systemctl start StarAgent/systemctl stop StarAgent。 - 显示名“新生命服务代理”是在windows服务控制板里面看到的名字
- 下一段信息给出了DH.NAgent和当前应用的版本信息和编译时间
- 黄色菜单可通过按键选择相应操作，内置012345，可自定义其它按键操作
- 菜单1，显示状态，按下1后刷新状态信息
- 菜单2，安装服务或卸载服务，安装成功后，显示信息变为卸载服务，反之亦然
- 菜单3，启动服务或停止服务，安装后才可以看见
- 菜单4，重启服务，安装且运行后可以看见
- 菜单5，模拟运行，在当前进程启动应用主逻辑，用于业务逻辑调试，等同于Windows服务调用
- 菜单0，退出应用服务
！！！注意，服务安装、卸载、启动、停止，在Windows/Linux上需要管理员权限运行
服务应用在Windows上以本地用户权限运行，有最高权限；
服务应用在Linux上以root权限运行，有最高权限；
该设计尽管带来了一定安全风险，但能够避免绝大部分初级用户的简单问题，优先易用性。
多种守护体系实现
下面列出各平台对应的守护实现及其行为特征，便于按需选择或排障：
WindowsService（Windows 服务）
- 通过 Win32 服务控制管理器（SCM）注册和运行，内部使用
StartServiceCtrlDispatcher/RegisterServiceCtrlHandlerEx等 API。 - 支持电源事件、会话变更、时间变更等系统事件回调；安装时自动配置“失败重启”动作。
- 安装/启停：需要管理员；对应命令
sc/net start|stop。适合服务器长期托管。
- 通过 Win32 服务控制管理器（SCM）注册和运行，内部使用
WindowsAutorun（Windows 登录自启动）
- 将应用写入注册表
HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Run，随登录自动启动。 - 使用
.pid文件跟踪进程并实现停止；更适合桌面/开发环境或需要交互桌面的场景。 - 安装/卸载：写入 HKLM 需管理员；启停不依赖 SCM。
- 将应用写入注册表
Systemd（Linux systemd）
- 生成
<ServiceName>.service单元文件到常见目录（优先于/etc/systemd/system等），并执行daemon-reload/enable。 - 支持设置
WorkingDirectory、ExecStart、User/Group等；启动/停止/重启通过systemctl执行。 - 适用大多数现代 Linux 发行版，是 Linux 优先选择的托管方式。
- 生成
RcInit（Linux SysV init 兼容）
- 生成
ServiceName.sh控制脚本（当前应用目录），并在/etc/rc*.d/或/etc/rc.d/创建S50/K50级别的软链接。 - 以
sh ServiceName.sh start|stop|restart方式管理；用.pid文件跟踪进程。 - 适合仍使用 SysV init 或 BusyBox 的传统/裁剪系统。
- 生成
Procd（OpenWrt 专用）
- 运行时探测 PID 1 是否为
procd判定环境；生成ServiceName.sh并在/etc/rc.d/创建S50链接。 - 以
nohup启动，.pid文件跟踪，kill停止；贴合 OpenWrt 生态的守护方式。
- 运行时探测 PID 1 是否为
OSXLaunch（macOS launchd）
- 在
~/Library/LaunchAgents/写入ServiceName.plist，设定ProgramArguments与RunAtLoad，通过launchctl管理。 - 适合用户级代理（LaunchAgents）；如需系统级可按需调整到 LaunchDaemons。
- 在
DefaultHost（默认主机）
- 无平台集成能力，仅作为兜底执行
Run/Stop循环；通常只有在无法检测到任何平台守护体系时才会落到此实现。
- 无平台集成能力，仅作为兜底执行
WatchDog 在
Systemd主机中守护其它服务时，会智能探测被守护服务实际托管方式（Systemd/SysV），避免“已安装但未检测到”的误判。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 is compatible. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp3.1 is compatible. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETCoreApp 3.1
- DH.NAgent (>= 4.13.2025.926-beta1153)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.8)
- Microsoft.Extensions.Options (>= 9.0.8)
-
net10.0
- DH.NAgent (>= 4.13.2025.926-beta1153)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.0-rc.1.25451.107)
- Microsoft.Extensions.Options (>= 10.0.0-rc.1.25451.107)
-
net5.0
- DH.NAgent (>= 4.13.2025.926-beta1153)
- Microsoft.Extensions.Hosting.Abstractions (>= 5.0.0)
- Microsoft.Extensions.Options (>= 5.0.0)
-
net6.0
- DH.NAgent (>= 4.13.2025.926-beta1153)
- Microsoft.Extensions.Hosting.Abstractions (>= 6.0.1)
- Microsoft.Extensions.Options (>= 6.0.1)
-
net7.0
- DH.NAgent (>= 4.13.2025.926-beta1153)
- Microsoft.Extensions.Hosting.Abstractions (>= 7.0.0)
- Microsoft.Extensions.Options (>= 7.0.1)
-
net8.0
- DH.NAgent (>= 4.13.2025.926-beta1153)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Options (>= 8.0.2)
-
net9.0
- DH.NAgent (>= 4.13.2025.926-beta1153)
- Microsoft.Extensions.Hosting.Abstractions (>= 9.0.9)
- Microsoft.Extensions.Options (>= 9.0.9)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
支持Web、WebApi和Worker等现代化项目