NewLife.Agent 10.9.2024.601

NewLife.Agent - 守护服务管理组件

GitHub top language GitHub License Nuget Downloads Nuget Nuget (with prereleases) Nuget Downloads Nuget Nuget (with prereleases)

使用教程:https://newlifex.com/core/agent

功能特点

NewLife.Agent是一个服务管理框架,用于开发随系统自动启动的长时间运行后台应用程序,支持Windows/Linux。
在Windows上注册为Windows服务,在Linux上注册为Systemd守护进程。
Agent支持netstandard2.0/net45/net40/mono,旧版本还支持net20(已不再维护)。
源码库:https://github.com/NewLifeX/NewLife.Agent

Agent常用于各种后台应用,如aspnetcore应用、RPC网络服务器、MQTT服务器、数据处理应用、数据消费应用(Redis/RocketMQ)等。同类软件有 NSSM、srvany,但并不一样,Agent是框架,而它们是具体软件,更像星尘代理 StarAgent。

NewLife.Agent主要功能:

  1. 注册应用为系统服务或守护进程,随系统自动启动
  2. 支持控制台菜单控制安装、卸载、启动、停止,以及查看状态
  3. 支持控制台调试应用,解决Windows服务难以调试的问题
  4. 支持健康检测,限制内存、线程数、句柄数,超限时重启应用服务
  5. 支持应用服务定时重启,通过配置指定
  6. 支持看门狗WatchDog,通过配置指定要守护的目标应用服务,如果目标停止则启动
  7. 支持配置文件修改服务名,一个应用程序可在多个目录上部署为不同的系统服务

服务控制

一个服务代理示例跑起来的样子
image.png
image.png
这是Agent的标准控制台(Windows和Centos)。上面是该服务的状态信息,下面是控制菜单。
示例分析:

  • 服务名 XAgent/StarAgent,可以命令启动停止,Windows是net start XAgent/net stop XAgent,Linux是systemctl start StarAgent/systemctl stop StarAgent
  • 显示名“新生命服务代理”是在windows服务控制板里面看到的名字
  • 下一段信息给出了NewLife.Agent和当前应用的版本信息和编译时间
  • 黄色菜单可通过按键选择相应操作,内置012345,可自定义其它按键操作
  • 菜单1,显示状态,按下1后刷新状态信息
  • 菜单2,安装服务或卸载服务,安装成功后,显示信息变为卸载服务,反之亦然
  • 菜单3,启动服务或停止服务,安装后才可以看见
  • 菜单4,重启服务,安装且运行后可以看见
  • 菜单5,模拟运行,在当前进程启动应用主逻辑,用于业务逻辑调试,等同于Windows服务调用
  • 菜单0,退出应用服务

!!!注意,服务安装、卸载、启动、停止,在Windows/Linux上需要管理员权限运行

服务应用在Windows上以本地用户权限运行,有最高权限;
服务应用在Linux上以root权限运行,有最高权限;
该设计尽管带来了一定安全风险,但能够避免绝大部分初级用户的简单问题,优先易用性。

新生命项目矩阵

各项目默认支持net8.0/net7.0/netstandard2.1/netstandard2.0/net4.61,旧版(2022.1225)支持net4.5/net4.0/net2.0

项目 年份 说明
基础组件 支撑其它中间件以及产品项目
NewLife.Core 2002 核心库,日志、配置、缓存、网络、序列化、APM性能追踪
NewLife.XCode 2005 大数据中间件,单表百亿级,MySql/SQLite/SqlServer/Oracle/TDengine/达梦,自动分表
NewLife.Net 2005 网络库,单机千万级吞吐率(2266万tps),单机百万级连接(400万Tcp)
NewLife.Remoting 2011 RPC通信框架,内网高吞吐或物联网硬件设备场景
NewLife.Cube 2010 魔方快速开发平台,集成了用户权限、SSO登录、OAuth服务端等,单表100亿级项目验证
NewLife.Agent 2008 服务管理组件,把应用安装成为操作系统守护进程,Windows服务、Linux的Systemd
NewLife.Zero 2020 Zero零代脚手架,基于NewLife组件生态的项目模板,Web、WebApi、Service
中间件 对接知名中间件平台
NewLife.Redis 2017 Redis客户端,微秒级延迟,百万级吞吐,丰富的消息队列,百亿级数据量项目验证
NewLife.RocketMQ 2018 RocketMQ纯托管客户端,支持Apache RocketMQ和阿里云消息队列,十亿级项目验
NewLife.MQTT 2019 物联网消息协议,MqttClient/MqttServer,客户端支持阿里云物联网
NewLife.IoT 2022 IoT标准库,定义物联网领域的各种通信协议标准规范
NewLife.Modbus 2022 ModbusTcp/ModbusRTU/ModbusASCII,基于IoT标准库实现,支持IoT平台和IoTEdge
NewLife.Siemens 2022 西门子PLC协议,基于IoT标准库实现,支持IoT平台和IoTEdge
NewLife.Map 2022 地图组件库,封装百度地图、高德地图和腾讯地图
NewLife.IP 2022 IP地址库,IP地址转物理地址
产品平台 产品平台级,编译部署即用,个性化自定义
AntJob 2019 蚂蚁调度,分布式大数据计算平台(实时/离线),蚂蚁搬家分片思想,万亿级数据量项目验证
Stardust 2018 星尘,分布式服务平台,节点管理、APM监控中心、配置中心、注册中心、发布中心
NewLife.ERP 2021 企业ERP,产品管理、客户管理、销售管理、供应商管理
CrazyCoder 2006 码神工具,众多开发者工具,网络、串口、加解密、正则表达式、Modbus
XProxy 2005 产品级反向代理,NAT代理、Http代理
HttpMeter 2022 Http压力测试工具
GitCandy 2015 Git源代码管理系统
SmartOS 2014 嵌入式操作系统,完全独立自主,支持ARM Cortex-M芯片架构
SmartA2 2019 嵌入式工业计算机,物联网边缘网关,高性能.NET6主机,应用于工业、农业、交通、医疗
菲凡物联FIoT 2020 物联网整体解决方案,建筑、环保、农业,软硬件及大数据分析一体化,单机十万级点位项目验证
NewLife.UWB 2020 厘米级(10~20cm)高精度室内定位,软硬件一体化,与其它系统联动,大型展厅项目验证

新生命开发团队

XCode

新生命团队(NewLife)成立于2002年,是新时代物联网行业解决方案提供者,致力于提供软硬件应用方案咨询、系统架构规划与开发服务。
团队主导的开源NewLife系列组件已被广泛应用于各行业,Nuget累计下载量高达60余万次。
团队开发的大数据核心组件NewLife.XCode、蚂蚁调度计算平台AntJob、星尘分布式平台Stardust、缓存队列组件NewLife.Redis以及物联网平台NewLife.IoT,均成功应用于电力、高校、互联网、电信、交通、物流、工控、医疗、文博等行业,为客户提供了大量先进、可靠、安全、高质量、易扩展的产品和系统集成服务。

我们将不断通过服务的持续改进,成为客户长期信赖的合作伙伴,通过不断的创新和发展,成为国内优秀的IT服务供应商。

新生命团队始于2002年,部分开源项目具有20年以上漫长历史,源码库保留有2010年以来所有修改记录
网站:https://newlifex.com
开源:https://github.com/newlifex
QQ群:1600800/1600838
微信公众号:
智能大石头

Showing the top 20 packages that depend on NewLife.Agent.

Packages Downloads
NewLife.Extensions.Hosting.AgentService
应用程序注册为系统服务,支持Windows/Linux
1

重构菜单架构;增强Systemd支持更多参数设置

.NET Framework 4.0

.NET Framework 4.5

.NET Framework 4.6.1

.NET 6.0

.NET 7.0

.NET 8.0

.NET Standard 2.0

.NET Standard 2.1

Version Downloads Last updated
10.14.2025.1113 3 2025/11/18
10.14.2025.1113-beta0106 1 2025/11/19
10.13.2025.1001 5 2025/10/14
10.13.2025.1001-beta1728 0 2025/10/1
10.13.2025.901 2 2025/10/4
10.13.2025.901-beta0240 0 2025/9/1
10.13.2025.824-beta1223 0 2025/8/24
10.13.2025.604 9 2025/6/6
10.13.2025.602-beta1643 0 2025/6/2
10.12.2025.401 1 2025/12/4
10.12.2025.401-beta0712 1 2025/11/19
10.12.2025.329-beta1223 1 2025/8/23
10.11.2025.311-beta0002 0 2025/3/11
10.11.2025.201 1 2025/11/19
10.11.2025.201-beta1619 0 2025/2/1
10.11.2025.109-beta1236 0 2025/1/9
10.11.2025.101 0 2025/1/1
10.10.2024.1225-beta1450 0 2024/12/25
10.10.2024.1224-beta0713 0 2024/12/24
10.10.2024.1223 0 2024/12/23
10.10.2024.1202 0 2024/12/2
10.10.2024.1129-beta0118 0 2024/11/29
10.10.2024.1116 0 2024/11/16
10.9.2024.902 0 2024/9/2
10.9.2024.801 0 2024/8/1
10.9.2024.801-beta0700 0 2024/8/1
10.9.2024.728-beta1649 0 2024/7/28
10.9.2024.701 0 2024/7/1
10.9.2024.701-beta1516 0 2024/7/1
10.9.2024.629-beta0804 0 2024/6/29
10.9.2024.626-beta1734 0 2024/6/26
10.9.2024.626-beta1613 0 2024/6/26
10.9.2024.624-beta1712 0 2024/6/24
10.9.2024.624-beta0623 0 2024/6/24
10.9.2024.621-beta0040 0 2024/6/21
10.9.2024.620-beta0006 0 2024/6/20
10.9.2024.619-beta0922 0 2024/6/19
10.9.2024.609-beta1644 0 2024/6/9
10.9.2024.609-beta1438 0 2024/6/9
10.9.2024.602-beta1628 0 2024/6/2
10.9.2024.601 1 2025/7/15
10.9.2024.601-beta0355 0 2024/6/1
10.8.2024.529-beta1039 0 2024/5/29
10.8.2024.527-beta0909 0 2024/5/27
10.8.2024.527-beta0743 0 2024/5/27
10.8.2024.526-beta1649 0 2024/5/26
10.8.2024.526-beta1557 0 2024/5/26
10.8.2024.526-beta1549 0 2024/5/26
10.8.2024.521-beta0014 0 2024/5/21
10.8.2024.520-beta0606 0 2024/5/20
10.8.2024.519-beta0654 0 2024/5/19
10.8.2024.518-beta1641 0 2024/5/18
10.8.2024.518-beta1617 0 2024/5/18
10.7.2024.518-beta1030 0 2024/5/18
10.7.2024.515 0 2024/5/15
10.7.2024.515-beta0213 0 2024/5/15
10.7.2024.423-beta0032 0 2024/4/23
10.7.2024.402 0 2024/4/2
10.7.2024.402-beta1636 0 2024/4/2
10.7.2024.331-beta0602 0 2024/3/31
10.7.2024.330-beta0952 0 2024/3/30
10.7.2024.320-beta1230 0 2024/3/20
10.7.2024.303 0 2024/3/3
10.7.2024.303-beta1433 0 2024/3/3
10.6.2024.228-beta1451 0 2024/2/28
10.6.2024.203 0 2024/2/3
10.6.2024.203-beta0307 0 2024/2/3
10.6.2024.101 0 2024/1/1
10.6.2024.101-beta0504 0 2024/1/1
10.6.2023.1224-beta1607 0 2023/12/24
10.6.2023.1212-beta0405 0 2023/12/12
10.6.2023.1210-beta1341 0 2023/12/10
10.6.2023.1201 0 2023/12/1
10.6.2023.1201-beta0552 0 2023/12/1
10.6.2023.1128-beta0010 1 2025/8/23
10.6.2023.1120-beta0220 1 2025/8/23
10.6.2023.1102 0 2023/11/2
10.6.2023.1102-beta0640 0 2023/11/2
10.6.2023.1016-beta1607 0 2023/10/16
10.6.2023.1001 0 2023/10/1
10.5.2023.927-beta1518 0 2023/9/27
10.5.2023.912-beta1050 0 2023/9/12
10.5.2023.910-beta0910 0 2023/9/10
10.5.2023.909-beta0003 0 2023/9/9
10.5.2023.812-beta0824 0 2023/8/12
10.5.2023.801 0 2023/8/1
10.5.2023.801-beta0306 0 2023/8/1
10.4.2023.801-beta0301 0 2023/8/1
10.4.2023.729-beta0002 0 2023/7/29
10.4.2023.725-beta0222 0 2023/7/25
10.4.2023.601 0 2023/6/1
10.4.2023.601-beta1428 0 2023/6/1
10.4.2023.512-beta1512 0 2023/5/12
10.4.2023.505 0 2023/5/5
10.4.2023.505-beta1611 0 2023/5/5
10.4.2023.504-beta0114 0 2023/5/4
10.4.2023.416-beta1214 0 2023/4/16
10.4.2023.401 0 2023/4/1
10.4.2023.401-beta1724 0 2023/4/1
10.4.2023.331-beta0844 0 2023/3/31
10.3.2023.318-beta0213 1 2025/8/23
10.3.2023.301 0 2023/3/1
10.3.2023.301-beta0447 0 2023/3/1
10.2.2023.218-beta0229 1 2025/8/23
10.2.2023.214-beta1542 0 2023/2/14
10.2.2023.214-beta0206 1 2025/8/23
10.2.2023.203 0 2023/2/3
10.2.2023.203-beta1429 0 2023/2/3
10.2.2023.101-beta1647 0 2023/1/1
10.1.2023.101 0 2023/1/1
10.1.2023.101-beta0227 1 2025/8/23
10.1.2022.1225-beta1424 1 2025/8/23
10.1.2022.1221-beta1657 1 2025/11/19
10.1.2022.1220-beta0114 1 2025/8/23
10.1.2022.1217-beta0142 1 2025/8/23
10.1.2022.1201 1 2025/11/19
10.1.2022.1201-beta1238 1 2025/8/23
10.0.2022.1201-beta0631 1 2025/8/23
10.0.2022.1108-beta0052 1 2025/8/23
10.0.2022.1106-beta0431 1 2025/8/23
10.0.2022.1104 0 2022/11/4
10.0.2022.1104-beta0629 1 2025/11/19
10.0.2022.1003 0 2022/10/3
10.0.2022.1003-beta1306 2 2025/8/23
10.0.2022.1003-beta1216 2 2025/8/23
9.4.2022.1003 0 2022/10/3
9.4.2022.1003-beta1215 0 2022/10/3
9.4.2022.1003-beta1149 0 2022/10/3
9.4.2022.1003-beta0057 0 2022/10/3
9.3.2022.901 0 2022/9/1
9.3.2022.901-beta0350 0 2022/9/1
9.3.2022.822-beta1114 0 2022/8/22
9.3.2022.814-beta0223 0 2022/8/14
9.3.2022.810-beta1048 0 2022/8/10
9.2.2022.701 1 2025/9/29
9.2.2022.701-beta1340 0 2022/7/1
9.1.2022.622-beta1235 0 2022/6/22
9.1.2022.501 0 2022/5/1
9.1.2022.501-beta0208 0 2022/5/1
9.0.2022.406 0 2022/4/6
9.0.2022.406-beta1209 0 2022/4/6
9.0.2022.320-beta1415 0 2022/3/20
9.0.2022.315-beta0816 0 2022/3/15
9.0.2022.312-beta1041 0 2022/3/12
9.0.2022.101 0 2022/1/1
8.8.2021.1204 0 2021/12/4
8.8.2021.1109 0 2021/11/9
8.7.2021.1001 0 2021/10/1
8.7.2021.708 0 2021/7/8
8.7.2021.204 0 2021/2/4
8.7.2021.101 0 2021/1/1
8.7.2020.1201 0 2020/12/1
8.7.2020.1101 0 2020/11/1
8.7.2020.1002 0 2020/10/3
8.7.2020.918-beta3 0 2020/9/18
8.7.2020.914-beta 0 2020/9/14
8.7.2020.912-beta 0 2020/9/12
8.7.2020.802 0 2020/8/2
8.7.2020.718-beta 0 2020/7/17
8.7.2020.601 0 2020/5/31
8.7.2020.525-rc 0 2020/5/25
8.7.2020.510-beta 0 2020/5/10
8.7.2020.501 0 2020/5/1
8.7.2020.421-beta2 0 2020/4/21
8.7.2020.403 0 2020/4/2
8.7.2020.329-beta 0 2020/3/29
8.7.2020.322-beta 0 2020/3/22
8.6.2020.204 0 2020/2/4
8.5.2020.101 0 2020/1/1
8.4.2019.1212 0 2019/12/12
8.4.2019.1203 0 2019/12/3
8.4.2019.1109 0 2019/11/9
8.3.2019.923 0 2019/9/24
8.3.2019.822 0 2019/8/22
8.2.2019.706 0 2019/7/6
8.1.2019.618 0 2019/6/23
8.1.2019.602 0 2019/6/2
8.1.2019.510 0 2019/5/10
8.1.2019.406 0 2019/4/6
8.1.2019.320 0 2019/3/20
8.1.2019.310 0 2019/3/10
8.0.2019.101 0 2019/1/1