# ServiceSelf

**Repository Path**: hzy17z/ServiceSelf

## Basic Information

- **Project Name**: ServiceSelf
- **Description**: 为.NET 泛型主机的应用程序提供自安装为服务进程的能力
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-06-14
- **Last Updated**: 2025-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ServiceSelf
为[.NET 泛型主机](https://learn.microsoft.com/zh-cn/dotnet/core/extensions/generic-host)的应用程序提供自安装为服务进程的能力，支持windows和linux平台。

> 功能

* 自我服务安装
* 自我服务卸载
* 自我服务日志监听

### 1 nuget
https://www.nuget.org/packages/ServiceSelf/

### 2 使用示例
```csharp
static void Main(string[] args)
{
    // 创建Host之前调用Service.UseServiceSelf(args)
    if (Service.UseServiceSelf(args))
    {
        var builder = WebApplication.CreateBuilder(args);

        // 为Host配置UseServiceSelf()
        builder.Host.UseServiceSelf();

        var app = builder.Build();
        app.MapGet("/", context => context.Response.WriteAsync("ServiceSelf"));
        app.Run();
    }
}
```

```csharp
static void Main(string[] args)
{
    var serviceName = "app";
    var serviceOptions = new ServiceOptions
    {
        Arguments = new[] { new Argument("key", "value") },
        Description = "这是演示示例应用",
    };
    serviceOptions.Linux.Service.Restart = "always";
    serviceOptions.Linux.Service.RestartSec = "10";
    serviceOptions.Windows.DisplayName = "演示示例";
    serviceOptions.Windows.FailureActionType = WindowsServiceActionType.Restart;

    if (Service.UseServiceSelf(args, serviceName, serviceOptions))
    {
        var host = Host.CreateDefaultBuilder(args)
            // 为Host配置UseServiceSelf()
            .UseServiceSelf()
            .ConfigureServices(service =>
            {
                service.AddHostedService<AppHostedService>();
            })
            .Build();

        host.Run();
    }
}
```

### 3 服务控制
当yourapp集成ServiceSelf之后，在管理员或root下使用如下命令控制yourapp服务

> windows平台

```bat
yourapp.exe start // 安装并启动服务
```

```bat
yourapp.exe stop // 停止并删除服务
```

```bat
yourapp.exe logs // 控制台输出服务的日志
yourapp.exe logs filter="key words" // 控制台输出服务的日志
```

> linux平台

```bash
sudo ./yourapp start // 安装并启动服务
```

```bash
sudo ./yourapp stop // 停止并删除服务
```

```bash
sudo ./yourapp logs // 控制台输出服务的日志
sudo ./yourapp logs filter="key words" // 控制台输出服务的日志
```