預設 ASP.NET Core 連接埠已從 80 變更為 8080
在 .NET 容器映像中設定的預設 ASP.NET Core 連接埠已從 80 更新為 8080。
我們也新增 ASPNETCORE_HTTP_PORTS 環境變數，作為相較於 ASPNETCORE_URLS 而言更簡單的替代方案。 新的變數需要以分號分隔的連接埠號碼清單，而較舊的變數則使用較為複雜的語法。
使用舊版 WebHost.CreateDefaultBuilder() API 建置的應用程式不會遵守新的 ASPNETCORE_HTTP_PORTS 環境變數。 既然已不再自動設定 ASPNETCORE_URLS，它們會切換為使用預設 URL http://localhost:5000，而不是先前的 http://*:80。
先前的行為
在 .NET 8 之前，您可以執行預期連接埠 80 為預設連接埠的容器，並能夠存取執行中的應用程式。
例如，您可以執行下列命令並在本機連接埠 8000 存取應用程式，此連接埠在容器中對應到連接埠 80：
docker run --rm -it -p 8000:80 <my-app>
新的行為
從 .NET 8 開始，若您在容器中對應到連接埠 80，而未明確地將容器中使用的 ASP.NET Core 連接埠設定為 80，則任何連線到該對應連接埠的嘗試都會失敗。
例如，若執行下列命令，您將「無法」使用連接埠 8000 在本機連線到應用程式。
docker run --rm -it -p 8000:80 <my-app>
改為將命令變更為在容器內使用連接埠 8080：
docker run --rm -it -p 8000:8080 <my-app>
您可以在下列範例中看到行為的差異。
對應連接埠 80 (失敗案例)：
$ docker run --rm -d -p 8000:80 mcr.microsoft.com/dotnet/samples:aspnetapp
ba88b746bd7097e503f8ab6e5320c595640e242f6de4f734412944a0e2836acc
$ curl http://localhost:8000/Environment
curl: (56) Recv failure: Connection reset by peer
$ docker kill ba88b746bd7097e503f8ab6e5320c595640e242f6de4f734412944a0e2836acc
ba88b746bd7097e503f8ab6e5320c595640e242f6de4f734412944a0e2836acc
對應連接埠 8080：
$ docker run --rm -d -p 8000:8080 mcr.microsoft.com/dotnet/samples:aspnetapp
74d866bdaa8a5a09e4a347bba17ced321d77a2524a0853294a123640bcc7f21d
$ curl http://localhost:8000/Environment
{"runtimeVersion":".NET 8.0.0-rc.1.23419.4","osVersion":"Alpine Linux v3.18","osArchitecture":"Arm64","user":"root","processorCount":4,"totalAvailableMemoryBytes":4123820032,"memoryLimit":0,"memoryUsage":30081024,"hostName":"74d866bdaa8a"}
$ docker kill 74d866bdaa8a5a09e4a347bba17ced321d77a2524a0853294a123640bcc7f21d
74d866bdaa8a5a09e4a347bba17ced321d77a2524a0853294a123640bcc7f21d
在 ASPNETCORE_HTTP_PORTS 設定為連接埠 80 的情況下對應連接埠 80：
$ docker run --rm -d -p 8000:80 -e ASPNETCORE_HTTP_PORTS=80 mcr.microsoft.com/dotnet/samples:aspnetapp
3cc86b4b3ea1a7303d83171c132b0645d4adf61d80131152936b01661ae82a09
$ curl http://localhost:8000/Environment
{"runtimeVersion":".NET 8.0.0-rc.1.23419.4","osVersion":"Alpine Linux v3.18","osArchitecture":"Arm64","user":"root","processorCount":4,"totalAvailableMemoryBytes":4123820032,"memoryLimit":0,"memoryUsage":95383552,"hostName":"3cc86b4b3ea1"}
$ docker kill 3cc86b4b3ea1a7303d83171c132b0645d4adf61d80131152936b01661ae82a09
3cc86b4b3ea1a7303d83171c132b0645d4adf61d80131152936b01661ae82a09
導入的版本
.NET 8 Preview 1
變更類型
此變更為行為變更。
變更原因
進行連接埠號碼變更是因為必須在切換至 non-root 使用者時提供良好的可用性體驗。 以使用者身分 non-root 執行需要在某些環境中使用非特殊權限連接埠。 由於連接埠 80 是特殊權限連接埠，因此預設連接埠已更新為連接埠 8080，這是非特殊權限連接埠。
建議的動作
有兩種方式可以回應此中斷性變更：
- (建議動作)：明確地將
ASPNETCORE_HTTP_PORTS、ASPNETCORE_HTTPS_PORTS與ASPNETCORE_URLS環境變數設定為所需的連接埠。 範例:docker run --rm -it -p 8000:80 -e ASPNETCORE_HTTP_PORTS=80 <my-app> - 將仰賴預期之預設連接埠 80 的現有命令與設定更新為改為參考連接埠 8080。 範例:
docker run --rm -it -p 8000:8080 <my-app>
若您的應用程式是使用較舊的 WebHost.CreateDefaultBuilder() 方法所建置，請設定 ASPNETCORE_URLS (而非 ASPNETCORE_HTTP_PORTS)。 範例：docker run --rm -it -p 8000:80 -e ASPNETCORE_URLS=http://*:80 <my-app>。
如果您使用 Kubernetes 或 Docker Compose，則必須根據那些結構描述變更連接埠。 例如，請參閱搭配 Kubernetes 使用 .NET (英文)。
如果您使用 Azure 容器服務來裝載您的 ASP.NET Core 容器應用程式，則需要更新容器環境以設定所需的連接埠：
- 針對 Azure App Service，請使用 CLI 或在入口網站中設定
WEBSITES_PORT。 - 針對 Azure 容器應用程式，您可以在資源建立時變更連接埠。
- 針對 Azure 容器執行個體，您可以在資源建立時變更連接埠。
受影響的 API
無。
