NET Core 启动域名及端口配置

原创

mb66d9851066cf4 2024-09-10 12:40:53 ©著作权

©著作权归作者所有：来自51CTO博客作者mb66d9851066cf4的原创作品，请联系作者获取转载授权，否则将追究法律责任

# .NET Core 启动域名及端口配置

在现代的Web应用程序开发中，配置应用程序的启动域名和端口是非常重要的一步。.NET Core 作为一个跨平台的开发框架，提供了灵活的配置方式来满足不同环境下的需求。本文将详细介绍如何在 .NET Core 应用程序中配置启动域名和端口，并探讨一些常见的配置场景和最佳实践。

1. 默认配置

在 .NET Core 应用程序中，默认情况下，应用程序会 ** http://localhost:5000 和 https://localhost:5001。这是通过 Kestrel 服务器实现的，Kestrel 是 .NET Core 的默认 Web 服务器。

如果你不进行任何配置，应用程序启动时会自动使用这些默认端口。这对于开发环境来说是非常方便的，但在生产环境中，你可能需要配置不同的域名和端口。

2. 配置文件中的端口配置

.NET Core 应用程序的配置可以通过多种方式进行，其中最常见的方式是通过 appsettings.json 文件进行配置。你可以在 appsettings.json 文件中添加 Kestrel 配置来指定应用程序 ** 的端口和域名。

{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://localhost:5000"
      },
      "Https": {
        "Url": "https://localhost:5001"
      },
      "Custom": {
        "Url": "http://*:5002"
      }
    }
  }
}

在这个配置文件中，我们定义了三个端点：

Http 端点 ** http://localhost:5000。
Https 端点 ** https://localhost:5001。
Custom 端点 ** http://*:5002，这里的 * 表示 ** 所有 IP 地址。

通过这种方式，你可以灵活地配置应用程序 ** 的端口和域名。

3. 通过代码配置端口

除了通过配置文件进行配置外，你还可以在代码中直接配置 Kestrel 服务器的端口和域名。这种方式通常用于需要在运行时动态配置端口的场景。

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseKestrel(options =>
                {
                    options.ListenAnyIP(5000); //  ** 所有 IP 地址的 5000 端口
                    options.ListenAnyIP(5001, listenOptions =>
                    {
                        listenOptions.UseHttps("certificate.pfx", "password"); // 配置 HTTPS
                    });
                });
                webBuilder.UseStartup<Startup>();
            });
}

在这个示例中，我们通过 UseKestrel 方法配置了 Kestrel 服务器，使其 ** 所有 IP 地址的 5000 端口和 5001 端口，并在 5001 端口上启用 HTTPS。

4. 环境变量配置

在生产环境中，使用环境变量来配置应用程序的端口和域名是一种常见的做法。.NET Core 支持通过环境变量来覆盖配置文件中的设置。

你可以在 appsettings.json 文件中使用环境变量占位符：

{
  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "http://localhost:${PORT:5000}"
      },
      "Https": {
        "Url": "https://localhost:${HTTPS_PORT:5001}"
      }
    }
  }
}

在这个配置文件中，${PORT:5000} 表示如果环境变量 PORT 存在，则使用该值作为端口号；否则，使用默认值 5000。同样，${HTTPS_PORT:5001} 表示如果环境变量 HTTPS_PORT 存在，则使用该值作为 HTTPS 端口号；否则，使用默认值 5001。

通过这种方式，你可以在不同的环境中使用不同的端口配置，而无需修改配置文件。

5. 使用反向代理

在生产环境中，通常会使用反向代理（如 Nginx 或 Apache）来处理外部请求，并将请求转发到 .NET Core 应用程序。在这种情况下，你可以配置反向代理来 ** 特定的端口和域名，并将请求转发到 .NET Core 应用程序的内部端口。

例如，假设你的 .NET Core 应用程序运行在 http://localhost:5000，你可以配置 Nginx 来 ** http://example.com，并将请求转发到 http://localhost:5000。

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://localhost:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

通过这种方式，你可以将外部请求路由到 .NET Core 应用程序，并对外部用户隐藏应用程序的内部端口和域名。