Nacos SDK Overview
Nacos SDKs let applications and tools access Nacos through typed interfaces. Before choosing a document, distinguish the two SDK roles:
| SDK Type | Use Case | Document Entry |
|---|---|---|
| Client SDK | Application runtime access, including reading and listening to configurations, registering instances, subscribing to services, and querying or subscribing to AI resources. | SDK Runtime Guide, language SDK manuals |
| Maintainer SDK | Operations tools, management platforms, consoles, or automation tasks that call Nacos management capabilities. | Maintainer SDK |
Business applications should prefer the Client SDK. The Client SDK manages connections, local cache, listeners, subscriptions, and reconnect recovery. To understand runtime behavior, read SDK Runtime Guide first.
Officially Maintained Client SDKs
| Language | Manual | Code Repository | Package Repository |
|---|---|---|---|
| Java | Java SDK Usage | alibaba/nacos | Maven Central |
| Go | Go SDK Usage | nacos-group/nacos-sdk-go | github.com/nacos-group/nacos-sdk-go/v2 |
| Python | Python SDK Usage | nacos-group/nacos-sdk-python | PyPI |
Java is the current reference implementation for Client SDK runtime semantics. Go, Python, and other language SDKs align their connection, cache, subscription, and recovery behavior as their language runtime capabilities evolve.
Community SDKs
The community also provides SDKs for other languages. Their maintenance status, protocol support, and Nacos version compatibility may differ. Before production adoption, confirm repository activity, supported Nacos versions, auth capabilities, and local cache behavior.
| Language | Code Repository | Package Repository |
|---|---|---|
| C++ | nacos-group/nacos-sdk-cpp | / |
| Node.js | nacos-group/nacos-sdk-nodejs | npm |
| C# | nacos-group/nacos-sdk-csharp | NuGet |
| Rust | nacos-group/nacos-sdk-rust | crates.io |
If your language does not have a suitable SDK, read OpenAPI Overview and Client API to understand the HTTP Client API boundary.