# r-nacos | Nacos Group | Knowledge Base | Instagit

Nacos server re-implemented in Rust.

GitHub Stars: 1.5k

Repository: https://github.com/nacos-group/r-nacos

---

## Articles

### [How to Integrate r-nacos with Spring Cloud Config and Dubbo Using the nacos-client SDK](/nacos-group/r-nacos/how-to-integrate-r-nacos-with-spring-cloud-config-and-dubbo-using-nacos-client-sdk)

Integrate r-nacos with Spring Cloud Config and Dubbo using nacos-client SDK. Use Rust-based r-nacos as a Nacos server replacement for seamless centralized configuration and service discovery in Java microservices.

- Tags: how-to-guide
- Published: 2026-03-07

### [Understanding the R-Nacos Loadtest Workspace Member for Performance Testing](/nacos-group/r-nacos/what-is-purpose-of-loadtest-workspace-member-and-how-is-it-utilized-for-performance-testing)

Discover the R-Nacos loadtest workspace member, a Rust sub-project for performance testing RNacos. Simulate thousands of concurrent users with the Goose framework against configuration and naming APIs.

- Tags: performance
- Published: 2026-03-07

### [How r-nacos Handles Concurrent Write Requests and Ensures Data Consistency in Cluster Mode](/nacos-group/r-nacos/how-does-r-nacos-handle-concurrent-write-requests-and-ensure-data-consistency-in-cluster-mode)

Discover how r-nacos handles concurrent writes and ensures data consistency in cluster mode using the Raft consensus algorithm. Learn about majority replication and commit.

- Tags: internals
- Published: 2026-03-07

### [r-Nacos Data Directory Structure: Complete Backup and Restore Guide](/nacos-group/r-nacos/what-is-data-directory-structure-in-r-nacos-and-how-can-i-backup-and-restore-data)

Explore the r-nacos data directory structure and master backup and restore procedures. Learn to protect your Nacos data with our complete guide.

- Tags: how-to-guide
- Published: 2026-03-07

### [How to Debug gRPC Connection Issues in r-nacos Using RNACOS_GRPC_DETECTION_TIMEOUT_SECOND](/nacos-group/r-nacos/how-to-debug-grpc-connection-issues-in-r-nacos-using-rnacos-grpc-detection-timeout-second)

Debug gRPC connection issues in r-nacos by adjusting RNACOS_GRPC_DETECTION_TIMEOUT_SECOND and enabling detailed logging. Resolve stream closure problems efficiently.

- Tags: how-to-guide
- Published: 2026-03-07

### [Differences Between r-nacos 1.x HTTP API and 2.x gRPC Protocol](/nacos-group/r-nacos/what-are-differences-between-1-x-http-api-and-2-x-grpc-protocol-supported-by-r-nacos)

Explore r-nacos 1.x HTTP API vs 2.x gRPC protocol. Understand the shift to protobuf, HTTP/2, and real-time streaming for enhanced performance in your Nacos implementations.

- Tags: deep-dive
- Published: 2026-03-07

### [How r-nacos Implements Namespace Isolation for Configurations and Service Registrations](/nacos-group/r-nacos/how-does-r-nacos-implement-namespace-isolation-for-configurations-and-service-registrations)

Discover how r-nacos enforces namespace isolation for configurations and service registrations. Learn about its unique approach to data access and privilege validation.

- Tags: deep-dive
- Published: 2026-03-07

### [RNACOS_RAFT_SNAPSHOT_LOG_SIZE: Tuning Raft Snapshot Frequency in r-nacos](/nacos-group/r-nacos/what-is-purpose-of-rnacos-raft-snapshot-log-size-and-how-does-it-affect-cluster-performance)

Tune r-nacos Raft snapshot frequency with RNACOS_RAFT_SNAPSHOT_LOG_SIZE. Balance recovery speed and runtime performance by adjusting log entry processing before snapshots. Learn how to optimize your cluster.

- Tags: internals
- Published: 2026-03-07

### [How r-nacos Implements Config Change Notifications to Subscribed Clients](/nacos-group/r-nacos/how-does-r-nacos-implement-config-change-notifications-to-subscribed-clients)

Discover how r-nacos enables real-time config change notifications using its Actix actor-based pub/sub system. Learn about gRPC subscriptions and BiStreamManage updates.

- Tags: internals
- Published: 2026-03-07

### [What Is the RNACOS_CLUSTER_TOKEN? Authenticating r-nacos Cluster Nodes](/nacos-group/r-nacos/what-is-cluster-token-rnacos-cluster-token-used-for-in-r-nacos-inter-node-communication)

Understand RNACOS_CLUSTER_TOKEN for r-nacos cluster node authentication. Learn how this secret token secures gRPC traffic and Raft consensus for authorized instances.

- Tags: internals
- Published: 2026-03-07

### [How to Configure OAuth2.0 Authentication in r-nacos: Complete Guide to Client ID, Secret, and Authorization URLs](/nacos-group/r-nacos/how-do-i-configure-oauth2-0-authentication-in-r-nacos-with-client-id-secret-and-authorization-urls)

Configure OAuth2.0 authentication in r-nacos easily. Learn to set client ID, secret, and authorization URLs with our complete guide. Integrate with any identity provider today.

- Tags: how-to-guide
- Published: 2026-03-07

### [How the Sled Database Powers r-nacos: Embedded Storage Architecture and Data Organization](/nacos-group/r-nacos/what-is-role-of-sled-database-in-r-nacos-and-how-is-data-organized-in-local-storage)

Discover how the sled database powers r-nacos with its embedded storage architecture. Learn about efficient local data organization for Raft state, config history, and more.

- Tags: internals
- Published: 2026-03-07

### [How r-nacos Handles Service Discovery Subscriptions and Push Notifications via gRPC Bi-Stream](/nacos-group/r-nacos/how-does-r-nacos-handle-service-discovery-subscriptions-and-push-notifications-via-grpc-bi-stream)

Discover how r-nacos leverages gRPC bi-stream for efficient service discovery subscriptions and push notifications. Learn about its active NamingActor and delay buffer for streamlined updates without client polling.

- Tags: how-to-guide
- Published: 2026-03-07

### [Differences Between GNU (Debian-Slim) and MUSL (Alpine) Docker Images for r-nacos](/nacos-group/r-nacos/what-are-differences-between-gnu-debian-slim-and-musl-alpine-docker-images-for-r-nacos)

Discover the differences between GNU Debian Slim and MUSL Alpine Docker images for r-nacos. Choose the best image for your needs, balancing runtime performance against smaller footprint.

- Tags: deep-dive
- Published: 2026-03-07

### [How r-nacos Implements MCP Server Functionality for Exposing HTTP Services as MCP Tools](/nacos-group/r-nacos/how-does-r-nacos-implement-mcp-server-functionality-for-exposing-http-services-as-mcp-tools)

Discover how r-nacos models HTTP services as versioned tools in Raft-backed servers, using REST APIs and import/export contexts for MCP server functionality.

- Tags: internals
- Published: 2026-03-07

### [How to Migrate Data from Java Nacos MySQL to r-nacos: A Complete Guide](/nacos-group/r-nacos/how-can-i-migrate-data-from-java-nacos-mysql-to-r-nacos-using-data-migration-tools)

Migrate Java Nacos MySQL data to r-nacos easily. Export MySQL data using rnacos mysql-to-data then import via the r-nacos import endpoint for a seamless transition.

- Tags: migration-guide
- Published: 2026-03-07

### [How r-nacos Achieves 80K QPS for Config Queries and 17.6K TPS for Config Writes](/nacos-group/r-nacos/how-does-r-nacos-achieve-high-performance-metrics-80k-qps-config-queries-17-6k-tps-config-writes)

Discover how r-nacos reaches 80K QPS for config queries and 17.6K TPS for writes using its lock-free cache, Actix actors, and asynchronous persistence. Learn about its high-performance architecture.

- Tags: performance
- Published: 2026-03-07

### [r-nacos Old Console vs New Console: Difference Between /rnacos/ and /rnacos/v2/](/nacos-group/r-nacos/what-is-difference-between-old-console-rnacos-and-new-console-rnacos-v2-in-r-nacos)

Explore the r-nacos old console /rnacos/ versus new console /rnacos/v2/. Discover differences in API, metrics, and error handling.

- Tags: deep-dive
- Published: 2026-03-07

### [How to Configure LDAP Authentication in r-nacos Using Environment Variables](/nacos-group/r-nacos/how-to-configure-ldap-authentication-in-r-nacos-using-environment-variables-like-rnacos-ldap-url)

Configure LDAP authentication in r-nacos using environment variables like RNACOS_LDAP_URL. Secure your r-nacos instance easily with step-by-step guidance.

- Tags: how-to-guide
- Published: 2026-03-07

### [r-nacos Architecture Explained: How ConfigActor and NamingActor Interact](/nacos-group/r-nacos/what-is-high-level-architecture-of-r-nacos-and-how-do-configactor-and-namingactor-interact)

Explore the r-nacos architecture, detailing how ConfigActor and NamingActor, independent Actix actors, manage configuration via Raft and service discovery, respectively, within a dual-plane design.

- Tags: architecture
- Published: 2026-03-07

### [How r-nacos Implements Service Health Checking and Instance Heartbeat Mechanisms](/nacos-group/r-nacos/how-does-r-nacos-implement-service-health-checking-and-instance-heartbeat-mechanisms)

Discover how r-nacos employs dual-layer service health checking with node pings and instance heartbeat to ensure reliable service discovery and instance availability.

- Tags: internals
- Published: 2026-03-07

### [R-Nacos Default Ports (8848, 9848, 10848): Configuration and Usage](/nacos-group/r-nacos/what-are-default-r-nacos-ports-8848-9848-10848-and-their-purposes)

Understand R-Nacos default ports including 8848 HTTP, 9848 gRPC, and 10848 console. Learn how to configure these essential ports for your R-Nacos setup.

- Tags: how-to-guide
- Published: 2026-03-07

### [How r-nacos Uses the Raft Consensus Protocol for Distributed Data Storage in Cluster Mode](/nacos-group/r-nacos/how-does-r-nacos-use-raft-consensus-protocol-for-distributed-data-storage-in-cluster-mode)

Discover how r-nacos leverages the Raft consensus protocol for strongly consistent distributed data storage. Learn about its log replication, persistent storage, and gRPC transport for cluster synchronization. Read now!

- Tags: deep-dive
- Published: 2026-03-07