如何为Docker创建本地NuGet包并解决路径识别错误与本地源配置问题

容器内部的工作目录默认为/src，你在NuGet.config中填写的Windows本地绝对路径，在容器的Linux文件系统中会被识别为相对路径，因此自动拼接了/src前缀，导致路径无效。

步骤1：在宿主机部署HTTP协议NuGet源 #

使用轻量的dotnet-serve工具搭建静态文件源即可：

• 全局安装dotnet-serve工具：
  dotnet tool install --global dotnet-serve
• 新建专门的本地NuGet包存放目录，例如C:\LocalNuGet\Packages，将所有需要用到的本地nupkg包放入该目录
• 命令行进入上述目录，执行启动命令：
  dotnet serve -p 8000 --directory .
  启动后宿主机的8000端口就提供NuGet源服务了，构建镜像过程中请保持该进程运行。

步骤2：修改NuGet.config适配容器访问 #

容器内的localhost指向容器本身而非宿主机，Docker Desktop环境下可使用host.docker.internal域名映射宿主机IP，NuGet.config修改为如下配置：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <!-- 保留官方NuGet源 -->
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    <!-- 新增本地HTTP源，使用host.docker.internal代替localhost -->
    <add key="LocalNuGet" value="http://host.docker.internal:8000/v3/index.json" />
  </packageSources>
  <config>
    <!-- 允许HTTP协议的本地源，否则NuGet默认仅允许HTTPS源 -->
    <add key="allowInsecureConnections" value="LocalNuGet" />
  </config>
</configuration>

步骤3：修正Dockerfile并执行构建 #

• 先修正你当前Dockerfile中的错误：复制WebHost.Customization.csproj的行内容不完整，补全路径后再进行构建
• 如果你使用Linux系统运行Docker，构建命令需要添加host映射参数：
  docker build --add-host=host.docker.internal:host-gateway -t <你的镜像名> .
• Windows/macOS的Docker Desktop默认支持host.docker.internal域名，直接执行普通build命令即可

验证注意事项 #

• 宿主机防火墙开放8000端口的入站规则，避免容器访问被拦截
• 可临时在Dockerfile的RUN dotnet restore行前添加RUN curl http://host.docker.internal:8000，如果构建时能正常返回内容说明网络连通，验证后删除该行即可

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