构建Docker镜像时连接私有Azure DevOps NuGet源执行dotnet restore失败

针对error NU1301: Unable to load the service index for source https://.../nuget/v3/index.json错误，结合你的场景（Windows本地正常、Docker基于WSL），可以尝试以下排查和解决步骤：

• 验证WSL与私有源的网络连通性
  直接在WSL终端执行curl命令测试源地址是否可达：

  curl -v https://<你的私有NuGet源地址>/nuget/v3/index.json
  

  如果请求失败，说明WSL无法访问本地部署的Azure DevOps服务：

  • 检查Azure DevOps服务是否绑定了0.0.0.0（而非仅localhost），确保WSL能通过Windows主机IP访问；
  • 关闭Windows防火墙对该服务端口的限制，或者添加允许WSL访问的规则；
  • 切换WSL网络模式为桥接模式，避免NAT模式下的端口映射问题。

• 确保NuGet凭据在容器中正确生效
  Windows本地的NuGet凭据不会自动同步到WSL容器环境，需手动处理：

  1. 修改Dockerfile，通过构建参数传递PAT并添加私有源：

     ARG NUGET_PAT
     RUN dotnet nuget add source https://<私有源地址>/nuget/v3/index.json \
         --name AzureDevOpsPrivateSource \
         --username dummy \
         --password $NUGET_PAT \
         --store-password-in-clear-text
     

  2. 执行构建时传入PAT参数：

     docker build --build-arg NUGET_PAT=<你的Azure DevOps PAT> .
     

  注：--store-password-in-clear-text是Linux容器的必需参数，因为Linux下NuGet的凭据存储机制与Windows不同。

• 检查Docker构建上下文与NuGet.config

  • 确认NuGet.config在Docker构建上下文范围内（与Dockerfile同目录或子目录），并复制到容器中：

    COPY NuGet.config ./
    

  • 转换NuGet.config的换行符为LF（Linux格式），避免Windows的CRLF格式导致解析异常。

• 调整dotnet restore命令参数

  • 尝试移除-r linux-x64参数先测试基础还原是否正常，再添加运行时参数：

    RUN dotnet restore "HttpApi.csproj" --no-cache
    

  • 显式指定NuGet配置文件路径，确保使用项目中的配置：

    RUN dotnet restore "HttpApi.csproj" --configfile NuGet.config -r linux-x64
    

• 排查WSL代理配置
  如果本地使用代理，需确保WSL容器能正确访问代理：

  • 构建时传递的HTTP_PROXY/HTTPS_PROXY参数应指向Windows主机的IP（而非localhost），例如http://192.168.x.x:8080；
  • 在WSL终端中执行echo $HTTP_PROXY验证代理配置是否生效，若未生效需手动配置WSL的系统代理。

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