星尘代理

StarAgent部署在每台应用服务器，作为系统服务，通过配置拉起并守护业务应用进程，同时用于收集监控各服务器性能，支持Windows/Linux/macOS/IoT（包括各种国产系统）。

功能特点

自身注册为系统服务，随系统自动启动，支持指定服务名
读取配置文件，拉起目标进程。autostart=true
守护目标进程，如有退出，依据策略或退出码决定是否重新拉起。autorestart=true/false/existcodes
支持单个应用的启动、停止和重启命令，应用名为all时控制所有应用。start app/stop app/restart app
代理退出时，不会关闭应用，代理重新启动后，继续守护应用进程。代理需要更新重启时，不应该影响被守护应用
代理运行过程中，根据配置的变化自动启动和停止应用，无需人工干涉。

下载星尘代理

源码：https://github.com/NewLifeX/Stardust

国内：https://gitee.com/NewLifeX/Stardust

可以下载源码，编译StarAgent并得到net40/net45/netcore3.1/net50/net60/net70多个输出，支持win-x64/linux-x64/linux-arm，根据需要选用。

也可以下载编译好的版本：

http://x.newlifex.com/star/staragent45.zip

http://x.newlifex.com/star/staragent31.zip

http://x.newlifex.com/star/staragent50.zip

http://x.newlifex.com/star/staragent60.zip

http://x.newlifex.com/star/staragent70.zip

内含windows启动的StarAgent.exe和Linux启动的StarAgent

Windows安装

（前置条件是安装好.NET运行时，下面使用net5.0为例，其它版本相同）

下载压缩包http://x.newlifex.com/star/staragent50.zip，并解压缩到独立目录，使用管理员权限（文件上点击右键选以管理员身份运行）启动StarAgent.exe，按下按键2即可把StarAgent安装为Windows服务，此时出现菜单3，用于启动服务。我们先不启动服务，还需要做一个配置。

按键s，使用星尘，配置星尘服务端地址

这里我们输入星尘服务端地址：http://star.newlifex.com:6600，（什么都不填直接回车也是这个地址），使用者在这里输入自己部署的星尘服务端StarServer地址，默认是6600端口。

最后按键3，启动服务

启动后按0退出控制台窗口。在该窗口退出之前，StarAgent实际上存在两个进程，一个是上面的控制台窗口，另一个是Windows服务进程。这里只需要退出控制台窗口即可。

也可以在任务管理器的服务栏启动和停止服务，快速按下st，选择行定位到StarAgent，然后右键控制服务。

Linux安装

（前置条件是安装好.NET运行时，下面使用net5.0为例，其它版本相同）

Linux安装稍微复杂一点，下载压缩包 http://x.newlifex.com/staragent50.zip，并解压到独立目录

wget http://x.newlifex.com/staragent50.zip
mkdir agent
unzip staragent50.zip -d agent
cd agent
chmod +x StarAgent

此时，可以运行 ./StarAgent 跑起来。某些版本没有StarAgent文件，可用以下命令启动：

dotnet StarAgent.dll

按键s，设置星尘服务端地址为 http://star.newlifex.com:6600，使用者在这里输入自己部署的星尘服务端StarServer地址，默认是6600端口。

设置完成后按0退出。

此时，StarAgent的启动有两种方式：

1，直接nohup启动

nohup ./StarAgent -run &
或
nohup dotnet StarAgent.dll -run &

带上-run参数，直接以当前用户身份启动。

该方案简单易用，唯一缺点就是，服务器重启后，StarAgent不会自动启动。

2，安装为systemd守护进程

sudo ./StarAgent -install
或
sudo dotnet StarAgent.dll -install

后面加上-server参数即可在安装时指定服务端地址：

sudo ./StarAgent -install -server http://star.newlifex.com:6600
或
sudo dotnet StarAgent.dll -install -server http://star.newlifex.com:6600

（20230713注：图片可能比较旧，文字会及时更新，可能会导致部分对应不上）

也可以像Windows那样，启动StarAgent后通过按键菜单来操作安装。

特别注意，必须要sudo权限才能安装为守护进程，否则报错

节点管理

所有安装了StarAgent的服务器或桌面电脑，或IOT设备，统称星尘节点，定时（默认60s）向星尘服务端StarServer上报硬件信息和资源状态信息。

打开星尘控制台 http://star.newlifex.com 查看节点管理，即可看到。

点击数据链接，还可以查看该节点最近24小时的资源状态数据。

[StarAgent]星尘代理安装与设置