Visual Studio 2019启动Docker运行ASP.NET应用提示用户名或密码错误

根因定位 #

你遇到的0x52E错误本质是：Docker Desktop默认尝试以Administrator身份在Windows容器内执行修改hosts文件的操作，但Windows Server Core镜像内的Administrator账户默认处于禁用状态、或未设置密码，导致操作认证失败，连带IIS服务启动异常触发500错误。

排查步骤 #

• 首先验证容器基础镜像和宿主机系统兼容性：Windows 10 2019及以上版本才兼容ltsc2019标签的镜像，低于该版本需要替换对应系统版本的基础镜像
• 检查Docker Desktop Windows容器运行模式是否正常开启：托盘右键Docker Desktop确认「Switch to Linux containers」选项存在，说明当前是Windows容器模式
• 验证容器构建产物是否完整：进入obj/Docker/publish目录，确认站点所有发布文件都已正常生成，不存在缺失

解决方案 #

方案1：修改Dockerfile启用容器Administrator账户 #

在你的Dockerfile的FROM语句之后添加以下内容，主动设置Administrator密码并启用账户：

# 启用Administrator账户并设置密码
RUN net user Administrator /active:yes
RUN net user Administrator YourStrongPassw0rd!
# 指定后续操作使用Administrator账户
USER Administrator

修改后重新构建镜像启动即可。

方案2：关闭Docker Desktop自动写入hosts的特性 #

如果不需要容器内解析host.docker.internal和gateway.docker.internal地址，可以直接关闭该特性避免触发权限校验：

1. 打开Docker Desktop设置
2. 找到「Docker Engine」配置项
3. 在配置JSON中添加"hosts": []字段，保存并重启Docker Desktop

方案3：修改VS Docker运行配置，指定端口映射 #

自动打开容器IP而非localhost的问题，是因为VS默认没有配置端口映射，你可以在项目的「Properties -> launchSettings.json」中找到Docker配置节点，添加端口映射配置：

"Docker": {
  "commandName": "Docker",
  "launchBrowser": true,
  "launchUrl": "{Scheme}://localhost:{ServicePort}",
  "publishAllPorts": true,
  "useSSL": true
}

修改后重新启动项目，就会自动打开localhost加端口的地址。

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