CNB 文档

简体中文

English

简体中文

English

外观

Nuget 制品库

复制页面

1884 字约 6 分钟

前置准备

  1. 创建制品库

  2. 获取制品库的地址

  3. 创建令牌

本地使用

客户端说明

客户端/工具dotnet CLInuget.exe
适用场景.NET Core/.NET 5+ 项目传统 .NET Framework 项目
跨平台支持原生支持需 Mono
安装随 .NET SDK自动安装，无需单独配置需要下载nuget.exe安装

凭据管理命令

您可以使用 CNB 的访问令牌作为登录凭据，配置命令：

dotnet CLI

替换 <YOUR_TOKEN> 为访问令牌，<SOURCE_NAME> 为自定义源名称，<REPO_URL> 为制品库地址

dotnet nuget add source <REPO_URL> --name <SOURCE_NAME> --username cnb --password <YOUR_TOKEN> --store-password-in-clear-text
# 示例: 添加凭据cnb-nuget-repo
# dotnet nuget add source https://nuget.cnb.cool/cnb/nuget-repo/-/packages/v3/index.json --name cnb-nuget-repo --username cnb --password <YOUR_TOKEN> --store-password-in-clear-text

dotnet nuget list source

替换 <SOURCE_NAME> 为自定义源名称

dotnet nuget remove source <SOURCE_NAME>
# 示例: 删除cnb-nuget-repo源的凭据
# dotnet nuget remove source cnb-nuget-repo

客户端/工具
Windows%AppData%\NuGet\NuGet.Config
Linux/macOS~/.config/NuGet/NuGet.Config or ~/.nuget/NuGet/NuGet.Config

制品管理命令

执行制品管理命令前请先配置好制品库凭据

dotnet CLI

替换 <PACKAGE_NAME> 为包名，<VERSION> 为版本号，<SOURCE_NAME> 为自定义源名称

dotnet add package <PACKAGE_NAME> --version <VERSION> --source <SOURCE_NAME>
# 示例: 从 cnb-nuget-repo 对应的制品仓库拉取 mynupkg 包的 1.0.0 版本
# dotnet add package test --version 1.0.0 --source cnb-nuget-repo

替换 <CSPROJ_PATH> 为 .csproj 文件路径， <PKG_PATH> 为 nupkg 包输出路径，<VERSION> 为版本号

dotnet pack <CSPROJ_PATH> -p:PackageVersion=<VERSION>  --configuration Release --output <PKG_PATH>
# 示例: 构建制品
# dotnet pack mynupkg.csproj --configuration Release --output nupkgs 
# 或 构建指定版本制品
# dotnet pack mynupkg.csproj -p:PackageVersion=1.0.0 --configuration Release --output nupkgs

替换 <NUPKG_PATH> 为 nupkg 包路径，<SOURCE_NAME> 为自定义源名称，<YOUR_TOKEN> 为访问令牌

dotnet nuget push <NUPKG_PATH> --source <SOURCE_NAME> -k <YOUR_TOKEN>
# 示例: 推送 mynupkg 包的 1.0.0 版本
# dotnet nuget push ./mynupkg.1.0.0.nupkg --source cnb-nuget-repo -k <YOUR_TOKEN>

替换 <PACKAGE_NAME> 为包名，<VERSION> 为版本号，<SOURCE_NAME> 为自定义源名称

dotnet nuget delete <PACKAGE_NAME> <VERSION> --source <SOURCE_NAME>
# 示例: 删除cnb-nuget-repo源 mynupkg 包的 1.0.0版本
# dotnet nuget delete mynupkg 1.0.0 --source cnb-nuget-repo

替换 <PACKAGE_NAME> 为包名，<SOURCE_NAME> 为自定义源名称

dotnet package search <PACKAGE_NAME> --source <SOURCE_NAME>
# 示例: 从凭据名为 cnb-nuget-repo 对应的制品仓库查询包名包含 mynuget 的包
# dotnet package search mynuget --source cnb-nuget-repo

dotnet nuget locals http-cache --clear

dotnet nuget locals all --clear

云原生构建中使用

流水中构建nupkg包,并推送到制品库

替换 <REPO_URL> 为制品库地址，<SOURCE_NAME> 为自定义源名称，<CSPROJ_PATH> 为 .csproj 文件路径， <PKG_PATH> 为 nupkg 包输出路径，<NUPKG_NAME> 为 nupkg 包名

.cnb.yml
main:
  push:
    - docker:
        image: mcr.microsoft.com/dotnet/sdk:9.0
      stages:
        - name: 配置 nuget 仓库的地址、账号、密码
          script: dotnet nuget add source <REPO_URL> --name <SOURCE_NAME> --username ${CNB_TOKEN_USER_NAME} --password ${CNB_TOKEN} --store-password-in-clear-text
        - name: 打包 nuget 制品 
          script: dotnet pack <CSPROJ_PATH> --configuration Release --output <PKG_PATH>  
        - name: 推送 nuget 制品到 CNB
          script: dotnet nuget push <PKG_PATH>/<NUPKG_NAME> --source <SOURCE_NAME> -k ${CNB_TOKEN}
  • 示例:
.cnb.yml
main: 
  push: 
    - docker: 
        image: mcr.microsoft.com/dotnet/sdk:9.0 
      stages: 
        - name: 配置 nuget 仓库的地址、账号、密码
          script: dotnet nuget add source https://nuget.cnb.cool/cnb/nuget-repo/-/packages/v3/index.json --name cnb-nuget-repo --username ${CNB_TOKEN_USER_NAME} --password ${CNB_TOKEN} --store-password-in-clear-text
        - name: 打包 nuget 制品
          script: dotnet pack mynupkg.csproj --configuration Release --output nupkgs 
        - name: 推送 nuget 制品到 CNB 
          script: dotnet nuget push nupkgs/*.nupkg --source cnb-nuget-repo -k ${CNB_TOKEN}

云原生开发中使用

1. 在.cnb.yml中配置dotnet开发环境

.cnb.yml
$: 
  vscode:
    - docker:
        image: mcr.microsoft.com/dotnet/sdk:9.0

2. 配置 nuget 仓库的地址、账号、密码

替换 <REPO_URL> 为制品库地址，<SOURCE_NAME>为自定义源名称

dotnet nuget add source <REPO_URL> --name <SOURCE_NAME> --username cnb --password <YOUR_TOKEN> --store-password-in-clear-text
dotnet pack xxx.csproj --configuration Release --output nupkgs
dotnet nuget push "nupkgs/*.nupkg" --source <SOURCE_NAME> -k ${CNB_TOKEN}
  • 示例: 打包 nuget 制品并推送 nuget 制品到 CNB
dotnet nuget add source https://nuget.cnb.cool/cnb/nuget-repo/-/packages/v3/index.json --name cnb-nuget-repo --username cnb --password <YOUR_TOKEN> --store-password-in-clear-text
dotnet pack mynupkg.csproj --configuration Release --output nupkgs
dotnet nuget push "nupkgs/*.nupkg" --source cnb-nuget-repo -k ${CNB_TOKEN}

FAQ 常见问题

Q1：遇到 401 Forbidden 错误

可能原因:
凭据缺少权限

解决方案:
重新配置有操作权限的制品库访问令牌
token获取: 个人设置 -> 访问令牌 -> 添加访问令牌 -> 授权范围选择对应的制品库操作权限

Q2：遇到 403 Forbidden 错误

可能原因:
凭据配置错误

解决方案:
配置正确的制品库访问令牌
token获取: 个人设置 -> 访问令牌 -> 添加访问令牌 -> 授权范围选择对应的制品库操作权限

Q3：遇到 409 Forbidden 错误

可能原因:
包已存在且不允许覆盖

解决方案:
如需覆盖包，请进入对应制品仓库->制品库设置->策略管理->选择允许覆盖已有版本

Q4：如何支持HTTP

可能原因:
客户端默认只支持https

解决方案:

客户端/工具http支持
dotnet CLI添加制品库凭据时指定: --allow-insecure-connections
nuget.exe添加制品库凭据时指定: -AllowInsecureConnections

更多用法

更多 nuget 用法，请查阅官方文档

© 2026 cnb.cool