在C#项目开发过程中，团队内部往往会积累大量可复用的私有类库，将这些类库发布到公共NuGet平台既不安全也不符合使用场景，搭建私有NuGet服务器成为管理内部依赖的最佳方案。Verdaccio和BaGet是两款主流的私有NuGet服务器工具，分别适配不同的技术栈需求，下面分别介绍它们的搭建和使用方法。
一、使用Verdaccio搭建私有NuGet服务器
Verdaccio是一款轻量级的Node.js实现的私有npm和NuGet代理服务器，配置简单，适合快速搭建场景。
1. 环境准备
首先需要安装Node.js环境，建议版本在12.0及以上，安装完成后打开命令行工具验证安装是否成功：
# 查看Node.js版本 node -v # 查看npm版本 npm -v
2. 安装并启动Verdaccio
全局安装Verdaccio后直接启动即可：
# 全局安装Verdaccio npm install -g verdaccio # 启动服务 verdaccio
启动成功后，命令行会输出服务监听的地址，默认是http://localhost:4873，打开浏览器访问该地址即可看到Verdaccio的管理界面。
3. 配置Verdaccio支持NuGet
Verdaccio默认支持npm，需要修改配置文件开启NuGet支持，配置文件路径会在启动时的命令行输出中提示，一般是用户目录下的verdaccio/config.yaml。在配置文件中添加以下内容：
# 开启NuGet支持
nuget: true
# 配置上游NuGet源，用于代理公共包
uplinks:
nuget.org:
url: https://api.nuget.org/v3/index.json
packages:
"**":
# 允许所有人访问
access: $all
# 允许认证用户发布包
publish: $authenticated
# 代理上游源
proxy: nuget.org
修改完成后重启Verdaccio服务即可生效。
二、使用BaGet搭建私有NuGet服务器
BaGet是基于.NET Core实现的轻量级NuGet服务器，完全贴合C#开发者的技术栈，部署和维护更友好。
1. 环境准备
需要安装.NET Core 3.1及以上版本的SDK，安装完成后验证环境：
dotnet --version
2. 下载并运行BaGet
可以从BaGet的官方发布页下载最新版本的编译包，解压后进入目录执行启动命令：
# 启动BaGet服务 dotnet BaGet.dll
默认服务监听地址是http://localhost:5000，浏览器访问该地址即可看到BaGet的界面。
3. 自定义BaGet配置
BaGet的配置文件是目录下的appsettings.json，可以根据需求修改端口、存储路径等配置：
{
"ApiKey": "your-custom-api-key", // 发布包需要的密钥
"Server": {
"Url": "http://localhost:5001" // 自定义服务端口
},
"Storage": {
"Type": "FileSystem", // 存储类型，可选FileSystem、AzureBlob等
"Path": "./packages" // 包存储路径
}
}
修改完成后重启服务即可应用配置。
三、C#项目中使用私有NuGet服务器
搭建完成私有服务器后，需要在C#项目中配置私有源，才能上传和引用私有包。
1. 配置私有NuGet源
在Visual Studio中，打开工具-选项-NuGet包管理器-包源，点击添加按钮，输入源名称和私有服务器的地址，比如Verdaccio的http://localhost:4873或者BaGet的http://localhost:5000/v3/index.json。
也可以通过命令行配置：
# 添加私有源 dotnet nuget add source "http://localhost:5000/v3/index.json" -n "MyPrivateNuGet"
2. 打包并上传私有NuGet包
首先需要将C#类库项目打包为NuGet包，在项目目录下执行命令：
# 打包项目，生成nupkg文件 dotnet pack -c Release
打包完成后，使用以下命令上传包到私有服务器，以BaGet为例：
# 上传NuGet包，需要替换包路径和API密钥 dotnet nuget push "./bin/Release/YourPackage.1.0.0.nupkg" --source "http://localhost:5000/v3/index.json" --api-key "your-custom-api-key"
3. 引用私有NuGet包
配置好私有源后，在C#项目中右键依赖项-管理NuGet包，切换到配置的私有源，即可搜索并安装上传的私有包，也可以直接通过命令行安装：
# 安装私有包 dotnet add package YourPackage --version 1.0.0
四、两种工具的选择建议
如果团队技术栈以Node.js为主，或者需要同时管理npm和NuGet包，优先选择Verdaccio；如果团队是纯C#开发栈，更推荐BaGet，它的部署、配置和问题排查都更符合C#开发者的习惯，性能也更适合.NET生态的包管理需求。
C#NuGet_serverVerdaccioBaGet私有包管理修改时间：2026-07-13 06:03:27