.NET Core Web API部署Ubuntu时dotnet restore私有NuGet包失败求助

我来帮你梳理下这两个问题，都是.NET跨平台部署私有NuGet源时常见的坑：

一、Ubuntu系统中NuGet配置文件的位置 #

在Ubuntu下，NuGet的配置文件分三个层级，优先级从高到低：

• 项目级配置：你的.NET项目根目录下的nuget.config（如果存在，会覆盖全局配置）
• 用户级全局配置：~/.config/NuGet/NuGet.Config（这就是Windows下%APPDATA%\NuGet\NuGet.Config对应的跨平台位置）
• 系统级全局配置：/etc/opt/NuGet/NuGet.Config（对服务器上所有用户生效）

你可以用命令nuget config -list快速查看当前生效的所有配置，确认私有源是否已经被正确添加。

二、dotnet restore失败的可能遗漏配置 #

你已经添加了源地址，但restore失败，大概率是认证缺失或配置优先级问题，下面是几个最常见的遗漏点：

1. 私有源未配置身份验证（最常见） #

几乎所有私有NuGet仓库（比如自建的Azure Artifacts、Nexus、GitLab Packages等）都需要身份验证，只填源地址远远不够。你需要给这个源添加认证信息：

• 如果是用户名+密码认证：

  nuget config -Set RepoName.Username=你的私有仓库用户名
  nuget config -Set RepoName.Password=你的私有仓库密码
  

• 如果使用个人访问令牌（PAT）：
  直接把密码字段替换成你的PAT即可，部分仓库要求用户名留空或填任意值，具体看你的仓库规则。

2. 确认源是否被启用 #

偶尔添加源后会默认处于禁用状态，你可以手动开启：

nuget config -Set RepoName.Enabled=true

3. 项目级配置覆盖了全局设置 #

如果你的项目根目录下存在nuget.config，它的优先级会高于全局配置。你需要要么在这个文件中也添加私有源，要么删除项目级配置（如果不需要自定义项目源的话）。

4. 验证服务器网络连通性 #

虽然你确认了源有效，但要确保Ubuntu服务器能正常访问私有仓库地址——比如有没有防火墙拦截、是否需要配置代理？可以用curl http://sample-nuget-repo.net/api/odata测试是否能正常返回仓库的元数据。

5. 强制指定源执行restore #

如果全局配置没问题但restore仍失败，可以尝试在命令中明确指定源，避免配置优先级冲突：

dotnet restore --source http://sample-nuget-repo.net/api/odata --source https://api.nuget.org/v3/index.json

（第二个源是官方NuGet源，确保公共依赖也能正常拉取）

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