升级至ASP.NET Core 2.1后UNIX套接字失效，如何实现监听？

这个问题我之前也碰到过，ASP.NET Core 2.1在默认的WebHost配置逻辑里，只支持ListenType.IPEndPoint类型的监听地址，直接用常规方式配置Unix套接字就会抛出你遇到的System.ArgumentException。要解决这个问题，得绕开WebHost的默认地址解析，直接通过Kestrel的专属配置来设置Unix套接字监听，具体操作如下：

1. 修改Program.cs，使用ConfigureKestrel配置Unix套接字 #

打开你的Program.cs文件，在构建WebHost的时候，添加ConfigureKestrel方法，用Kestrel自带的ListenUnixSocket方法指定套接字路径。示例代码如下：

using System.IO;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Server.Kestrel.Core;

namespace YourAppNamespace
{
    public class Program
    {
        public static void Main(string[] args)
        {
            // 启动前检查并删除已存在的套接字文件，避免启动失败
            var socketPath = "/tmp/aspnetcore.sock";
            if (File.Exists(socketPath))
            {
                File.Delete(socketPath);
            }

            BuildWebHost(args).Run();
        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .ConfigureKestrel(options =>
                {
                    // 配置Unix套接字监听
                    options.ListenUnixSocket("/tmp/aspnetcore.sock");

                    // 可选：设置套接字的访问权限，比如允许所有用户读写
                    // options.ListenUnixSocket("/tmp/aspnetcore.sock", listenOptions =>
                    // {
                    //     listenOptions.UnixSocketCreatePermissions = new UnixSocketPermissions(0666);
                    // });

                    // 如果需要同时监听IP端口，可添加以下配置
                    // options.ListenAnyIP(5000);
                })
                .Build();
        }
    }
}

2. 关键注意事项 #

• 套接字文件清理：Kestrel启动时不会自动删除已存在的套接字文件，如果路径上已有同名文件，会直接启动失败，所以建议在启动前检查并删除（如代码中所示）。
• 权限配置：如果你的应用运行用户和访问套接字的用户不是同一个，可能会遇到权限问题。通过UnixSocketCreatePermissions可以设置套接字的权限位，比如0666允许所有用户读写，根据你的部署场景调整即可。
• 混合监听：如果需要同时监听IP端口和Unix套接字，只需在ConfigureKestrel里同时添加ListenAnyIP/ListenLocalhost和ListenUnixSocket的配置即可。

为什么原来的方式不行？ #

ASP.NET Core 2.1的WebHost.CreateDefaultBuilder默认会解析UseUrls里的地址，但当时的解析逻辑只支持HTTP/HTTPS的IP端口格式，不识别unix://开头的地址。而Kestrel本身从更早的版本就已经支持Unix套接字，所以直接通过ConfigureKestrel配置就能绕过这个限制。

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