GitLab CI流水线还原NuGet包时遇“Unable to connect to remote server”错误

问题核心 #

GitLab CI是全新的隔离运行环境，没有本地C:\Users\myuser\.nuget\packages的缓存包，同时当前NuGet配置指向了无法访问的远程仓库（nexus.macrix.eu），导致还原命令执行失败。

可行解决方案 #

1. 改用本地包源并将依赖包纳入代码仓库 #

• 在项目根目录创建nuget-packages文件夹，把本地C:\Users\myuser\.nuget\packages中项目依赖的所有包完整复制到这个文件夹里。
• 修改项目的nuget.config，添加本地包源并移除不可达的远程源：

<configuration>
  <packageSources>
    <!-- 移除原有不可达的远程源 -->
    <remove key="NexusPCT2022" />
    <!-- 添加本地包源 -->
    <add key="LocalProjectPackages" value="./nuget-packages" />
  </packageSources>
</configuration>

• 将nuget-packages文件夹和修改后的nuget.config提交到Git仓库。
• CI中的restore任务直接执行C:\tools\NuGet\nuget.exe restore，此时NuGet会优先从本地仓库获取依赖，不会再尝试连接不可达的远程源。

2. 迁移依赖到GitLab私有NuGet仓库 #

• 如果不想把包文件提交到代码仓库（避免仓库体积过大），可以将本地的NuGet包上传到GitLab的私有NuGet仓库。
• 在项目的nuget.config中添加GitLab NuGet源，并配置CI可用的访问令牌（确保Runner有仓库访问权限）：

<configuration>
  <packageSources>
    <remove key="NexusPCT2022" />
    <add key="GitLabNuGet" value="https://gitlab.example.com/api/v4/projects/[你的项目ID]/packages/nuget/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <GitLabNuGet>
      <add key="Username" value="gitlab-ci-token" />
      <add key="ClearTextPassword" value="$CI_JOB_TOKEN" />
    </GitLabNuGet>
  </packageSourceCredentials>
</configuration>

• 调整CI的restore命令，确保从GitLab源拉取依赖。

3. 修复CI环境的网络连通性（若必须使用原远程源） #

• 如果nexus.macrix.eu是内部私有仓库，需要确认GitLab Runner所在环境能访问该仓库的IP和端口：
  • 在CI流水线中添加前置测试步骤，验证网络连通性：

    ping nexus.macrix.eu
    curl https://nexus.macrix.eu/repository/pct2022/
    

  • 若Runner在外部网络，需配置代理或者将Runner部署到内部网络环境中，确保能访问该私有仓库。

4. 临时调整NuGet源（CI任务内动态修改） #

如果不想修改项目的nuget.config，可以在CI的restore任务前动态调整NuGet源：

restore:
  script:
    # 列出当前所有源
    - C:\tools\NuGet\nuget.exe sources list
    # 移除不可达的远程源
    - C:\tools\NuGet\nuget.exe sources remove -name "NexusPCT2022"
    # 添加本地包源（前提是包已纳入仓库）
    - C:\tools\NuGet\nuget.exe sources add -name "LocalPackages" -source "./nuget-packages"
    # 执行还原
    - C:\tools\NuGet\nuget.exe restore

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