.NET 6 Kestrel部署Amazon Linux时QUIC/HTTP3不支持异常求助

可能遗漏的配置与操作 #

1. 确认libmsquic版本兼容性 #

.NET 6要求libmsquic版本不低于1.0.2500.0，先检查当前安装版本：

rpm -q libmsquic

若版本过低，添加微软官方YUM源并更新：

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum update -y libmsquic

2. 安装完整的ASP.NET Core 6运行时 #

仅安装基础.NET运行时可能缺少QUIC依赖组件，需安装完整的ASP.NET Core运行时：

sudo yum install -y aspnetcore-runtime-6.0

3. 显式指定HTTPS证书 #

QUIC必须依赖HTTPS，Linux环境下Kestrel无法自动获取默认证书，需在代码中显式指定：

services.Configure<KestrelServerOptions>(serverOptions =>
{
    serverOptions.ListenAnyIP(900, o =>
    {
        o.Protocols = HttpProtocols.Http1AndHttp2AndHttp3;
        o.UseHttps("/path/to/your-cert.pfx", "cert-password");
    });
            
    serverOptions.ListenAnyIP(890, o =>
    {
        o.Protocols = HttpProtocols.Http3;
        o.UseHttps("/path/to/your-cert.pfx", "cert-password");
    });   
});

测试环境可通过OpenSSL生成自签证书：

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
openssl pkcs12 -export -out your-cert.pfx -inkey key.pem -in cert.pem

4. 检查系统内核与网络配置 #

• 确认Amazon Linux内核版本不低于4.14（QUIC依赖UDP多路复用支持），执行uname -r查看版本，过低则升级内核。
• 开放对应UDP端口（900、890）：QUIC基于UDP协议，仅开放TCP端口无法正常通信，需在安全组和防火墙中配置UDP规则。

5. 设置QUIC相关环境变量 #

启动应用前强制启用QUIC并指定libmsquic路径：

export DOTNET_SYSTEM_NET_QUIC_ENABLED=1
export DOTNET_SYSTEM_NET_QUIC_MSQUICPATH=/usr/lib64/libmsquic.so

可将上述命令写入应用启动脚本，避免每次手动输入。

6. 调整应用发布配置 #

若使用PublishSingleFile或PublishTrimmed发布，可能丢失QUIC依赖，建议使用以下命令发布：

dotnet publish -c Release -r linux-x64 --self-contained false

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