r-nacos Docker镜像文档

镜像概述

r-nacos是采用Rust语言重新实现的Nacos服务，旨在替代传统Java版本Nacos，提供相同的服务发现与配置管理功能，同时显著优化性能与资源效率。相较于Java Nacos，其核心优势包括：启动速度更快、系统资源占用更低（初始内存小于10M）、运行性能更高及稳定性更强，且完全兼容Nacos客户端SDK协议，支持现有Nacos应用平滑迁移。

核心功能与特性

1. 协议兼容性

• 全面兼容Nacos 1.x版本的HTTP OpenApi协议
• 原生支持Nacos 2.x版本的gRPC协议，确保与最新客户端SDK无缝对接

2. 性能与资源优化

• 快速启动：相比Java Nacos大幅缩短启动时间，实现秒级部署
• 低资源占用：初始内存消耗小于10M，远低于Java版本的百兆级占用
• 高性能处理：依托Rust语言的内存安全与并发优势，提供更高的请求处理吞吐量
• 稳定运行：减少运行时异常，提升长期运行稳定性

3. 应用迁移支持

• 无需修改现有Nacos客户端代码，即可实现从Java Nacos到r-nacos的平滑迁移
• 保持数据模型与API行为一致性，确保业务无感知切换

使用场景与适用范围

r-nacos适用于所有需要Nacos服务的场景，尤其推荐以下环境：

• 微服务架构：作为服务注册中心与配置中心，支撑微服务集群的服务发现与配置管理
• 资源受限环境：边缘计算节点、嵌入式系统等对内存/CPU资源敏感的场景
• 高性能需求场景：高并发服务集群，需要低延迟响应的业务场景
• Nacos存量用户：希望提升服务性能、降低资源成本，同时保持功能兼容性的用户

使用方法与配置说明

镜像拉取

bash
docker pull r-nacos:latest

基础启动命令（docker run）

bash
# 最简启动（默认内存存储，暴露HTTP与gRPC端口）
docker run -d -p 8848:8848 -p 9848:9848 --name r-nacos r-nacos:latest

端口说明：

• 8848：HTTP协议端口（对应Nacos 1.x OpenApi）
• 9848：gRPC协议端口（对应Nacos 2.x客户端通信）

Docker Compose配置示例

yaml
version: '3'
services:
  r-nacos:
    image: r-nacos:latest
    container_name: r-nacos
    ports:
      - "8848:8848"  # HTTP服务端口
      - "9848:9848"  # gRPC服务端口
    environment:
      - NACOS_SERVER_PORT=8848        # HTTP服务端口（默认8848）
      - NACOS_GRPC_PORT=9848          # gRPC服务端口（默认9848）
      - STORAGE_TYPE=memory           # 存储类型：memory/file/mysql（默认memory）
      - DATA_DIR=/app/data            # 数据存储目录（file存储时生效）
      - LOG_LEVEL=info                # 日志级别（debug/info/warn/error，默认info）
    volumes:
      - ./r-nacos-data:/app/data      # 挂载数据目录（持久化存储时使用）
    restart: always

配置参数说明

r-nacos支持通过环境变量配置核心参数，常用配置如下：

服务可用性验证

服务启动后，可通过以下方式验证：

1. 访问HTTP OpenApi（兼容Nacos 1.x）：

   bash
   curl http://localhost:8848/nacos/v1/ns/instance/list?serviceName=test-service
   

2. 检查gRPC端口监听状态：

   bash
   netstat -tuln | grep 9848  # 应显示端口处于LISTEN状态
   

注意事项

• 生产环境建议使用持久化存储（STORAGE_TYPE=file或mysql）并配置数据备份策略
• 迁移前建议在测试环境验证业务兼容性，确保核心功能正常运行
• 高级特性（如命名空间、权限控制）支持情况请参考官方最新文档