如何将Linux下的ASP.NET Core应用日志输出到指定文件？

嘿，这个需求太常见了！我来一步步教你怎么配置，让你的ASP.NET Core应用把日志稳稳写到指定的永久文件里，不用再依赖/var/log/messages啦。

Serilog是.NET生态里口碑超好的日志库，配置灵活，不仅能写到指定文件，还能按日期、大小自动分割日志，完美满足你永久存储的需求。

第一步：装NuGet包 #

先给你的项目装上Serilog的必要包，在终端里跑这俩命令：

dotnet add package Serilog.AspNetCore
dotnet add package Serilog.Sinks.File

第二步：配置Serilog #

打开Program.cs，咱们先把Serilog配置好，再启动Web应用。代码大概是这样的：

using Serilog;

var builder = WebApplication.CreateBuilder(args);

// 先搭Serilog的配置
Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Information() // 日志最低级别设为Info，按需调整
    .WriteTo.File(
        path: "/var/log/yourapp/your-app.log", // 这里填你想要的日志文件路径
        rollingInterval: RollingInterval.Day, // 按天分割日志，避免单个文件太大
        retainedFileCountLimit: null, // 不限制保留的日志文件数量（实现永久存储）
        fileSizeLimitBytes: 10485760, // 单个日志文件最大10MB（可选，嫌大就调小）
        rollOnFileSizeLimit: true, // 达到大小上限自动分割新文件
        shared: true // 如果应用是多进程的，这个能保证写入安全
    )
    .CreateLogger();

// 把默认的日志提供器换成Serilog
builder.Host.UseSerilog();

// 剩下的就是你原来的常规配置了
builder.Services.AddControllersWithViews();

var app = builder.Build();

// ... 中间件那些代码该咋写咋写 ...

app.Run();

第三步：搞定目录权限 #

Linux下得确保日志目录存在，而且应用的运行用户（比如systemd用的www-data或者你专门建的用户）能读写它：

sudo mkdir -p /var/log/yourapp
sudo chown your-app-user:your-app-group /var/log/yourapp
sudo chmod 755 /var/log/yourapp

要是你不想用第三方库，也可以试试官方的File日志提供器——不过注意哈，这个方案在.NET 8里还是预览版，但已经能用了。

第一步：装预览版NuGet包 #

dotnet add package Microsoft.Extensions.Logging.File --prerelease

第二步：在appsettings.json里配置 #

打开appsettings.json，加一段Logging的配置：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    },
    "File": {
      "Path": "/var/log/yourapp/your-app.log",
      "Append": true, // 追加写入，不会覆盖旧日志
      "FileSizeLimitBytes": 10485760, // 单个文件10MB上限
      "RetainedFileCountLimit": null, // 不限制保留数量，实现永久存储
      "RollingInterval": "Day" // 按天分割日志
    }
  }
}

第三步：在Program.cs里注册提供器 #

var builder = WebApplication.CreateBuilder(args);

// 把官方的File日志提供器加进去
builder.Logging.AddFile(builder.Configuration.GetSection("Logging:File"));

// ... 其他常规配置 ...

var app = builder.Build();

// ... 中间件代码 ...

app.Run();

同样，别忘了创建目录并设置权限，和方法一的第三步一样哈。

• 如果你用systemd管理守护进程，别在.service文件里设置StandardOutput或StandardError重定向到其他地方，不然会和应用自己的日志配置冲突。
• 虽说设置了永久存储，但日志文件堆多了会占满磁盘！建议用Linux的logrotate工具自动清理旧日志。比如创建/etc/logrotate.d/yourapp文件，内容如下：

  /var/log/yourapp/*.log {
      daily
      rotate 30
      compress
      missingok
      notifempty
      create 640 your-app-user your-app-group
  }
  

  这样每天自动轮换日志，保留30天的压缩日志，既满足你永久存储的需求（想存更久就改rotate后面的数字），又不会把磁盘撑爆。

内容的提问来源于stack exchange，提问作者Mikhail