Nacos.NET.AspNetCore 1.0.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Nacos.NET.AspNetCore --version 1.0.0
                    


                    

                
NuGet\Install-Package Nacos.NET.AspNetCore -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Nacos.NET.AspNetCore" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Nacos.NET.AspNetCore" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Nacos.NET.AspNetCore" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Nacos.NET.AspNetCore --version 1.0.0
                    


                    

                
#r "nuget: Nacos.NET.AspNetCore, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Nacos.NET.AspNetCore@1.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Nacos.NET.AspNetCore&version=1.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Nacos.NET.AspNetCore&version=1.0.0
                    


                            Install as a Cake Tool

Nacos.NET.AspNetCore

将 ASP.NET Core 服务实例注册到 Nacos 命名服务，支持服务发现与健康检查。

引用此包后同时获得 Nacos.NET.Extensions.Configuration 的能力，可通过一句话同时注册配置中心和服务命名。

快速开始（推荐）

一键注册：配置中心 + 服务注册

在 Program.cs 中调用 builder.AddNacos()，一行完成所有配置：

var builder = WebApplication.CreateBuilder(args);

builder.AddNacos(); // 默认读取 appsettings.json 中的 "NacosConfig" 节

var app = builder.Build();
app.Run();

等价于手动调用：

builder.Host.UseNacosConfig("NacosConfig");          // 配置中心（热更新）
builder.Services.AddNacosAspNet(builder.Configuration, "NacosConfig"); // 服务注册

自定义配置节名：

builder.AddNacos("MyNacosSection");

仅注册服务命名（不含配置中心）

在 Program.cs 中调用 AddNacosAspNet：

builder.Services.AddNacosAspNet(x =>
{
    x.ServerAddresses = new List<string> { "http://localhost:8848/" };
    x.Namespace = "your-namespace";
    x.GroupName = "DEFAULT_GROUP";
    x.ServiceName = "my-service";
    x.Ip = "192.168.1.100";   // 注册到 Nacos 的 IP（留空则自动获取本机 IP）
    x.Port = 5000;             // 注册到 Nacos 的端口（留空则自动获取监听端口）
    x.Weight = 100;
    x.Ephemeral = true;        // 临时实例（服务下线后自动注销）
});

或从 appsettings.json 读取：

builder.Services.AddNacosAspNet(builder.Configuration, "NacosConfig");

appsettings.json 配置

{
  "NacosConfig": {
    "ServerAddresses": ["http://localhost:8848/"],
    "Namespace": "your-namespace",
    "GroupName": "DEFAULT_GROUP",
    "UserName": "nacos",
    "Password": "nacos",
    "ServiceName": "my-service",
    "Ip": "",
    "Port": 0
  }
}

Ip 和 Port 留空时，SDK 自动获取本机 IP 和应用监听端口。在 Docker/容器 环境中，容器内自动获取到的 IP 是容器内网地址，其他服务无法通过该地址访问，因此必须显式配置：

{
  "NacosConfig": {
    "ServiceName": "my-service",
    "Ip": "my-service",
    "Port": "8080"
  }
}

其中 Ip 填写 Docker 网络中该容器可被其他容器访问的主机名（通常是容器名）。

字段说明

字段 类型 说明
ServerAddresses List<string> Nacos 服务端地址列表
Namespace string 命名空间 ID（空字符串表示 public）
GroupName string 服务分组，默认 DEFAULT_GROUP
ServiceName string 注册的服务名，网关按此名称路由
Ip string 对外可达的 IP 或主机名，容器环境必须填写
Port int 对外可达的端口，容器环境必须填写
Weight float 负载权重，默认 100
Ephemeral bool 是否为临时实例，建议 true
RegisterEnabled bool 是否启用注册，默认 true

常见问题

现象 原因 解决
其他服务无法连接到该实例 Ip 注册为容器内网地址，外部不可达 在 appsettings.json 中显式配置可达的 Ip 和 Port
实例注册到错误的 Namespace Namespace 配置错误 检查与 Nacos 控制台中的命名空间 ID 是否一致
服务下线后实例仍显示 Ephemeral = false 且未手动注销 改为 Ephemeral = true 使 Nacos 自动清理
注册成功但服务发现找不到 GroupName 不一致 注册方和查询方的 GroupName 必须相同
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.1 134 6/8/2026
1.0.0 114 6/8/2026