microsoft/dotnet-nightly-reverse-proxy

重要提示：dotnet/nightly仓库的镜像包含https://github.com/dotnet/core%E4%B8%8B%E4%B8%80%E4%B8%AA%E7%89%88%E6%9C%AC%E7%9A%84last-known-good (LKG)构建。

有关https://github.com/dotnet/core%E5%AE%98%E6%96%B9%E5%8F%91%E5%B8%83%E7%89%88%E6%9C%AC%E7%9A%84%E9%95%9C%E5%83%8F%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81https://hub.docker.com/r/microsoft/dotnet/%E3%80%82

特色标签

• 2.3-preview
  • docker pull mcr.microsoft.com/dotnet/nightly/reverse-proxy:2.3-preview

关于

此镜像包含YARP的实现，YARP是.NET中的反向代理框架。

可关注https://github.com/dotnet/dotnet-docker/discussions/categories/announcements%E8%8E%B7%E5%8F%96Docker%E7%9B%B8%E5%85%B3%E7%9A%84.NET%E5%85%AC%E5%91%8A%E3%80%82

使用

https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md%E5%B1%95%E7%A4%BA%E4%BA%86.NET%E4%B8%8EDocker%E7%BB%93%E5%90%88%E4%BD%BF%E7%94%A8%E7%9A%84%E5%A4%9A%E7%A7%8D%E6%96%B9%E5%BC%8F%E3%80%82%E6%9C%89%E5%85%B3%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81%E4%B8%BA.NET%E5%BA%94%E7%94%A8%E6%9E%84%E5%BB%BADocker%E9%95%9C%E5%83%8F%E3%80%82

您可以运行此镜像以启动YARP实例。

YARP期望配置文件位于/etc/reverse-proxy.config，默认监听端口5000。

配置示例：

json
{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ReverseProxy": {
    "Routes": {
      "route1": {
        "ClusterId": "cluster1",
        "Match": {
          "Path": "/aspnetapp/{**catch-all}"
        },
        "Transforms": [
            { "PathRemovePrefix": "/aspnetapp" }
        ]
      }
    },
    "Clusters": {
      "cluster1": {
        "Destinations": {
          "destination1": {
            "Address": "http://aspnetapp1:8080"
          }
        }
      }
    }
  }
}

可使用以下命令（其中my-config.config是包含上述配置的文件）：

bash
docker run --rm --name myaspnetapp -d -t  mcr.microsoft.com/dotnet/samples:aspnetapp 
docker run --rm -v $(pwd)/my-config.config:/etc/reverse-proxy.config -p 5000:5000 --link myaspnetapp:aspnetapp1 mcr.microsoft.com/dotnet/reverse-proxy:latest

此示例会将所有来自http://localhost:5000/aspnetapp的请求代理到部署的mcr.microsoft.com/dotnet/samples:aspnetapp容器。

https://github.com/microsoft/reverse-proxy/tree/main/samples/%E5%8C%85%E5%90%AB%E6%9B%B4%E5%A4%9A%E9%85%8D%E7%BD%AE%E7%A4%BA%E4%BE%8B%E3%80%82

有关配置镜像的详细信息，请参见https://microsoft.github.io/reverse-proxy/articles/index.html%E5%8F%8A%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E9%85%8D%E7%BD%AE%E6%96%87%E6%A1%A3%E3%80%82

相关仓库

.NET：

• https://hub.docker.com/r/microsoft/dotnet/: .NET
• https://hub.docker.com/r/microsoft/dotnet-nightly-sdk/: .NET SDK（预览版）
• https://hub.docker.com/r/microsoft/dotnet-nightly-aspnet/: ASP.NET Core运行时（预览版）
• https://hub.docker.com/r/microsoft/dotnet-nightly-runtime/: .NET运行时（预览版）
• https://hub.docker.com/r/microsoft/dotnet-nightly-runtime-deps/: .NET运行时依赖项（预览版）
• https://hub.docker.com/r/microsoft/dotnet-nightly-monitor/: .NET监控工具（预览版）
• https://hub.docker.com/r/microsoft/dotnet-nightly-aspire-dashboard/: .NET Aspire仪表板（预览版）
• https://hub.docker.com/r/microsoft/dotnet-samples/: .NET示例

.NET Framework：

• https://hub.docker.com/r/microsoft/dotnet-framework/: .NET Framework、ASP.NET和WCF
• https://hub.docker.com/r/microsoft/dotnet-framework-samples/: .NET Framework、ASP.NET和WCF示例

完整标签列表

可在Microsoft Artifact Registry门户或https://github.com/dotnet/dotnet-docker/blob/nightly/README.reverse-proxy.md#full-tag-listing%E6%9F%A5%E7%9C%8B%E5%BD%93%E5%89%8D%E6%A0%87%E7%AD%BE%E3%80%82

支持

生命周期

• https://github.com/microsoft/reverse-proxy/blob/main/docs/roadmap.md
• https://github.com/dotnet/core/blob/main/support.md
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md

镜像更新策略

• 基础镜像更新：基础镜像（如debian:bookworm-slim、windows/nanoserver:ltsc2022等）有任何更新后，镜像会在12小时内重新构建。
• .NET版本发布：作为发布新.NET版本的一部分，镜像会重新构建。包括新的主要版本、次要版本和服务版本。
• 严重CVE：如以下CVE更新策略所述，镜像会重新构建以获取严重CVE修复。
• 月度重新构建：镜像每月重新构建一次，通常在每月第二个星期二，以获取低严重性CVE修复。
• 紧急更新：有时可能需要重新构建镜像以解决紧急问题。如有此情况，新的修复版本标签将根据https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md#fixed-version-tags%E6%9B%B4%E6%96%B0%E3%80%82

CVE更新策略

.NET容器镜像会定期监控CVE的存在。当满足以下条件时，会重新构建镜像以获取CVE修复：

• 我们检测到镜像包含CVSS评分为“严重”的CVE
• 且该CVE位于Dockerfile层中添加的包中（即CVE位于我们显式安装的包或这些包的任何传递依赖中）
• 且受影响基础镜像的包仓库中存在该包的CVE修复。

有关在.NET镜像中遇到CVE时的处理方法，请参见https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md%E5%92%8Chttps://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md%E3%80%82

反馈

• https://github.com/dotnet/dotnet-docker/issues/new/choose
• 联系微软支持

许可

• ***声明：容器许可信息
• https://github.com/dotnet/dotnet-docker/blob/main/LICENSE
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-artifact-details.md
• Windows基础镜像许可（仅适用于Windows容器）
• Windows Server定价和许可