如何指定托管 ASP.NET Core 应用程序的端口？

在 ASP.NET Core 3.1 中，有 4 种主要方法可以指定自定义端口：

使用命令行参数，通过使用 --urls=[url] 启动您的 .NET 应用程序：

dotnet run --urls=http://localhost:5001/

使用 appsettings.json，通过添加 Urls 节点：

{
  "Urls": "http://localhost:5001"
}

使用环境变量，ASPNETCORE_URLS=http://localhost:5001/。

使用 UseUrls()，如果您更喜欢以编程方式执行此操作：

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

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(builder =>
            {
                builder.UseStartup<Startup>();
                builder.UseUrls("http://localhost:5001/");
            });
}

或者，如果您仍在使用 Web 主机构建器而不是通用主机构建器：

public class Program
{
    public static void Main(string[] args) =>
        new WebHostBuilder()
            .UseKestrel()
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseIISIntegration()
            .UseStartup<Startup>()
            .UseUrls("http://localhost:5001/")
            .Build()
            .Run();
}

---

您可以在 asp.net core 2.1+ appsettings.json 文件中插入 Kestrel 部分。

  "Kestrel": {
    "EndPoints": {
      "Http": {
        "Url": "http://0.0.0.0:5002"
      }
    }
  },

如果你没有红隼部分，你可以使用“urls”：

{
    "urls":"http://*.6001;https://*.6002"
}

但如果您在 appsettings.json 中有红隼，则 urls 部分将失败。

---

跟进答案以帮助任何使用 VS docker 集成执行此操作的人。我需要更改为端口 8080 才能使用 google appengine 中的“灵活”环境运行。

您的 Dockerfile 中需要以下内容：

ENV ASPNETCORE_URLS=http://+:8080
EXPOSE 8080

您还需要修改 docker-compose.yml 中的端口：

    ports:
      - "8080"

---

您可以指定托管 URL，而无需对您的应用程序进行任何更改。

在您的项目目录中创建一个 Properties/launchSettings.json 文件，并用以下内容填充它：

{
  "profiles": {
    "MyApp1-Dev": {
        "commandName": "Project",
        "environmentVariables": {
            "ASPNETCORE_ENVIRONMENT": "Development"
        },
        "applicationUrl": "http://localhost:5001/"
    }
  }
}

dotnet run 命令应选择您的 launchSettings.json 文件并将其显示在控制台中：

C:\ProjectPath [master ≡]
λ  dotnet run
Using launch settings from C:\ProjectPath\Properties\launchSettings.json...
Hosting environment: Development
Content root path: C:\ProjectPath
Now listening on: http://localhost:5001
Application started. Press Ctrl+C to shut down. 

更多详情：https://docs.microsoft.com/en-us/aspnet/core/fundamentals/environments

---

替代解决方案是在项目的根目录中使用 hosting.json。

{
  "urls": "http://localhost:60000"
}

然后在 Program.cs

public static void Main(string[] args)
{
    var config = new ConfigurationBuilder()
        .SetBasePath(Directory.GetCurrentDirectory())
        .AddJsonFile("hosting.json", true)
        .Build();

    var host = new WebHostBuilder()
        .UseKestrel(options => options.AddServerHeader = false)
        .UseConfiguration(config)
        .UseContentRoot(Directory.GetCurrentDirectory())
        .UseIISIntegration()
        .UseStartup<Startup>()
        .Build();

    host.Run();
}

---

如果使用 dotnet run

dotnet run --urls="http://localhost:5001"

---

以上 .net core 2.2 方法 Main 支持 args 和 WebHost.CreateDefaultBuilder(args)

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

    public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
        WebHost.CreateDefaultBuilder(args)
            .UseStartup<Startup>();
}

您可以构建您的项目并像这样转到 bin 运行命令

dotnet <yours>.dll --urls=http://0.0.0.0:5001

或使用多个网址

dotnet <yours>.dll --urls="http://0.0.0.0:5001;https://0.0.0.0:5002"

编辑 2021/09/14

在 .net core 3.1 之后，您可以更改项目中的文件 appsettings.json，Config 部分 Urls 和 Kestrel 都可以正常工作。你可以使用任何一个。 Urls 会更容易。

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "MicrosoftHostingLifetime": "Information"
    }
  },
  "Urls": "http://0.0.0.0:5002",
  //"Kestrel": {
  //  "EndPoints": {
  //    "Http": {
  //      "Url": "http://0.0.0.0:5000"
  //    },
  //    "Https": {
  //      "Url": "https://0.0.0.0:5001"
  //    }
  //  }
  //},
  "AllowedHosts": "*"
}

使用 http://0.0.0.0:5000 可以从远程连接访问网络服务器，如果您设置为 http://localhost:5000 则只能在您的计算机中访问。

要使 Kestrel 设置生效，您应该在项目中更改 Program.cs 中的代码。

        public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.ConfigureServices((context, services) =>
                 {
                     services.Configure<Microsoft.AspNetCore.Server.Kestrel.Core.KestrelServerOptions>(context.Configuration.GetSection("Kestrel"));
                 });
                webBuilder.UseStartup<Startup>();
            });

---

当托管在 docker 容器（我的 Linux 版本）中时，您可能会收到“连接被拒绝”消息。在这种情况下，您可以使用 IP 地址 0.0.0.0 ，这意味着“这台机器上的所有 IP 地址”而不是 localhost 环回来修复端口转发。

public class Program
{
    public static void Main(string[] args)
    {
        var host = new WebHostBuilder()
            .UseKestrel()
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseIISIntegration()
            .UseStartup<Startup>()
            .UseUrls("http://0.0.0.0:5000/")
            .Build();

        host.Run();
    }
}

---

在 .Net Core 3.1 上，只需遵循 Microsoft Doc 即可，它非常简单：kestrel-aspnetcore-3.1

总结一下：

将以下 ConfigureServices 部分添加到 Program.cs 上的 CreateDefaultBuilder： // 使用 Microsoft.Extensions.DependencyInjection;公共静态 IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureServices((context, services) => { services.Configure( context.Configuration.GetSection("Kestrel")); }) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup(); });将以下基本配置添加到 appsettings.json 文件（Microsoft 文章中的更多配置选项）： "Kestrel": { "EndPoints": { "Http": { "Url": "http://0.0.0.0:5002" }在您的项目中打开 CMD 或控制台 Publish/Debug/Release binaries 文件夹并运行： dotnet YourProject.dll 享受在 http://localhost:5002 上探索您的站点/api

---

或者，您可以通过命令行运行 app 来指定端口。

只需运行命令：

dotnet run --server.urls http://localhost:5001

注意：其中 5001 是您要运行的端口。

---

转到 properties/launchSettings.json 并找到您的应用程序名称，然后在此找到 applicationUrl。您会看到，它正在运行 localhost:5000，将其更改为您想要的任何内容。然后运行 dotnet run……欢呼

---

我使用以下方法修复了 Net core 3.1 中的端口问题

在 Program.cs 中

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

    public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args)
        .ConfigureWebHost(x => x.UseUrls("https://localhost:4000", "http://localhost:4001"))
        .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });
}

您可以使用访问应用程序

http://localhost:4000

https://localhost:4001

---