Apple Silicon Mac构建linux/amd64的.NET Docker镜像时dotnet restore卡顿如何解决？

问题原因 #

Apple Silicon为arm64架构，构建linux/amd64镜像依赖QEMU做指令集模拟，模拟环境下网络请求性能受限，叠加NuGet包下载的网络延迟，导致dotnet restore步骤长时间卡住。

可行解决方案 #

1. 更换NuGet国内加速源 #

在项目根目录创建NuGet.Config文件，添加国内镜像源以降低下载延迟：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    <add key="NuGet国内源" value="https://nuget.cdn.azure.cn/v3/index.json" />
  </packageSources>
</configuration>

修改Dockerfile，将配置文件同步复制到镜像中：

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /app

COPY *.csproj ./
COPY NuGet.Config ./  # 新增复制配置文件的步骤
ENV DOTNET_NUGET_SIGNATURE_VERIFICATION=false
RUN dotnet restore --verbosity detailed

COPY . .
RUN dotnet publish -c Release -o out

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime
WORKDIR /app
COPY --from=build /app/out ./

EXPOSE 5241
ENTRYPOINT ["dotnet", "AuthAPI.dll"]

2. 挂载宿主NuGet缓存到容器 #

构建时直接复用宿主机器已下载的NuGet包，避免在模拟环境中重复下载：

docker buildx build --platform linux/amd64 -t my-hub/solid:auth-api \
  --mount type=bind,source=$HOME/.nuget/packages,target=/root/.nuget/packages .

3. 宿主提前完成restore，镜像内跳过该步骤 #

先在宿主机器执行restore，再将项目文件和依赖一并复制到镜像：

# 宿主终端执行
dotnet restore --runtime linux-x64

修改Dockerfile，使用--no-restore跳过镜像内的restore步骤：

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /app

COPY . .  # 复制已完成restore的全部文件
ENV DOTNET_NUGET_SIGNATURE_VERIFICATION=false
RUN dotnet publish -c Release -o out --no-restore

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS runtime
WORKDIR /app
COPY --from=build /app/out ./

EXPOSE 5241
ENTRYPOINT ["dotnet", "AuthAPI.dll"]

4. 优化QEMU模拟性能 #

确保Docker Desktop的虚拟化配置开启硬件加速：

• 打开Docker Desktop设置 → Features in development → 勾选"Use the new Virtualization framework"
• 执行以下命令重置QEMU配置：

docker run --rm --privileged multiarch/qemu-user-static --reset -p yes

重启Docker Desktop后再尝试构建。

内容的提问来源于stack exchange，提问作者Halil Bulent Orhon