部署ASP.NET应用至Azure容器实例遇镜像OS版本不兼容及403问题

一、"OS版本不支持"错误的原因与解决方案 #

你遇到的The OS version of image 'xxx' is not supported错误，核心原因是Azure容器实例（ACI）不再支持Windows Server Core 1709版本的镜像。

微软对Windows Server版本分为半年度频道（SAC）和长期服务频道（LTSC）：

• windowsservercore-1709属于SAC版本，这类版本的支持周期较短，微软已经停止对其的维护，ACI也随之移除了对该版本的兼容性。
• 你需要切换到LTSC版本的基础镜像，比如microsoft/aspnet:4.7.1-windowsservercore-ltsc2019或者microsoft/aspnet:4.7.2-windowsservercore-ltsc2022（根据你的.NET Framework版本选择匹配的）。

修改后的Dockerfile基础镜像行应该是：

FROM microsoft/aspnet:4.7.1-windowsservercore-ltsc2019

二、更换基础镜像后出现403错误的排查与解决 #

当你切换到兼容的LTSC镜像后出现403 Forbidden，通常是应用部署不完整或者IIS配置问题导致的，以下是几个常见的排查方向：

1. 确认应用文件是否正确复制到容器中 #

VS自动生成的Dockerfile使用${source:-obj/Docker/publish}作为复制源，但这个路径可能没有包含完整的发布文件。你可以：

• 手动在本地执行发布命令：在项目目录下运行msbuild /t:Publish /p:PublishDir=./publish，生成完整的发布文件到publish目录。
• 修改Dockerfile的COPY命令，指向正确的发布路径：

  COPY ./publish .
  

2. 检查IIS默认文档配置 #

ASP.NET MVC应用需要设置正确的默认文档（比如default.aspx或index.aspx）才能正常访问。如果容器内的IIS没有配置默认文档，就会返回403。你可以在Dockerfile中添加命令来配置：

RUN powershell -Command \
    Add-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' \
    -filter "system.webServer/defaultDocument/files" \
    -name "." -value @{value='default.aspx'}

3. 验证容器内的文件权限 #

确保IIS应用池用户（IIS_IUSRS）对C:\inetpub\wwwroot目录有读取权限。可以在Dockerfile中添加权限设置：

RUN icacls 'C:\inetpub\wwwroot' /grant IIS_IUSRS:(OI)(CI)F /T

4. 本地验证镜像的正确性 #

在部署到ACI之前，先本地运行修改后的镜像，确认应用能正常访问：

docker build -t azurecontainertest:v2 .
docker run -d -p 8080:80 azurecontainertest:v2

然后访问http://localhost:8080，如果本地也出现403，说明问题出在镜像构建环节，而非ACI部署。此时可以进入容器内部检查文件：

docker exec -it <你的容器ID> powershell
cd C:\inetpub\wwwroot
dir

确认是否存在web.config、Views、bin等必要文件。

总结 #

先替换为ACI支持的LTSC版本基础镜像，再排查应用文件复制、IIS配置和权限问题，就能解决这两个部署错误。

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