XiHan.Framework.Configuration.Nacos 5.0.0-preview.2

Prefix Reserved

This is a prerelease version of XiHan.Framework.Configuration.Nacos.

dotnet add package XiHan.Framework.Configuration.Nacos --version 5.0.0-preview.2

NuGet\Install-Package XiHan.Framework.Configuration.Nacos -Version 5.0.0-preview.2

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="XiHan.Framework.Configuration.Nacos" Version="5.0.0-preview.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="XiHan.Framework.Configuration.Nacos" Version="5.0.0-preview.2" />
                    

                            Directory.Packages.props

<PackageReference Include="XiHan.Framework.Configuration.Nacos" />
                    

                            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 XiHan.Framework.Configuration.Nacos --version 5.0.0-preview.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: XiHan.Framework.Configuration.Nacos, 5.0.0-preview.2"

#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 XiHan.Framework.Configuration.Nacos@5.0.0-preview.2

#: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=XiHan.Framework.Configuration.Nacos&version=5.0.0-preview.2&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=XiHan.Framework.Configuration.Nacos&version=5.0.0-preview.2&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

XiHan.Framework.Configuration.Nacos

关于

XiHan.Framework.Configuration.Nacos 是远程配置的 Nacos 提供程序，直接使用 Nacos 的 HTTP 配置接口（v1，Nacos 2.x 兼容），不依赖 SDK。把 Nacos 的 dataId 挂到配置树上，变化时自动重载。

主要特性

长轮询感知变化，整份配置替换并触发重载
支持 Json 与 Properties 格式
支持用户名密码登录与多个服务地址按序尝试
地址与凭据可来自资源绑定 nacos

如何使用

安装

dotnet add package XiHan.Framework.Configuration.Nacos --prerelease

使用

在构建配置时挂接；dataId 为 orders 的内容出现在 Orders 节下：

builder.Configuration.AddXiHanNacos(
    new NacosOptions { ServerAddresses = ["http://localhost:8848"], Username = "nacos", Password = "<password>" },
    new RemoteConfigurationOptions("orders") { Prefix = "Orders", PollInterval = TimeSpan.FromSeconds(15) });

// 需要在容器里取用 IRemoteConfigurationClient 时
builder.AddXiHan(x => x.UseFeature<NacosConfigurationFeature>());

{ "XiHan": { "Configuration": { "Nacos": { "ServerAddresses": "http://nacos-a:8848,http://nacos-b:8848", "Group": "DEFAULT_GROUP", "Format": "Json" } } } }

主要类型

此库提供的主要类型：

AddXiHanNacos：配置源扩展方法
NacosOptions：服务地址、分组、命名空间、格式、凭据与超时
NacosConfigurationFeature：登记 IRemoteConfigurationClient

反馈与贡献

XiHan.Framework.Configuration.Nacos 以 MIT 许可证开源。欢迎到 GitHub 仓库提交问题和贡献。

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.

net10.0
- Microsoft.Extensions.Configuration (>= 10.0.14)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.14)
- Microsoft.Extensions.DependencyInjection (>= 10.0.14)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Diagnostics.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Http (>= 10.0.14)
- Microsoft.Extensions.Logging (>= 10.0.14)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Options (>= 10.0.14)
- System.Threading.RateLimiting (>= 10.0.14)
- XiHan.Framework.Configuration.Abstractions (>= 5.0.0-preview.2)
- XiHan.Framework.Kernel (>= 5.0.0-preview.2)

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
5.0.0-preview.2	0	11/6/2026
5.0.0-preview.1	42	11/4/2026

https://framework.docs.xihanfun.com/changelog