laosijiddd/nacos

Nacos 2.1.1 Docker镜像文档

镜像概述

Nacos 2.1.1 Docker镜像是基于阿里巴巴开源项目Nacos的容器化部署方案。Nacos作为动态服务发现、配置管理和服务管理平台，主要用于微服务架构中实现服务注册、发现、配置集中管理及服务治理等核心功能。

核心功能与特性

• 动态服务发现：支持服务注册与发现机制，实时感知服务实例上下线状态
• 配置管理：提供集中式配置管理能力，支持配置动态更新与版本控制
• 服务健康检查：内置服务健康状态监控，自动剔除不健康服务实例
• 多协议支持：兼容HTTP、gRPC等多种通信协议，满足不同场景需求
• 持久化存储：支持配置数据持久化，通过挂载卷实现配置文件持久化管理

使用场景与适用范围

• 微服务架构中的服务注册与发现中心部署
• 分布式系统的配置集中管理与动态更新
• 云原生应用的服务治理与流量管理
• 开发、测试及生产环境的服务生命周期管理

使用方法与配置说明

基本部署（docker run命令）

通过以下命令快速部署Nacos 2.1.1容器：

bash
docker run --name nacos \
  -d \
  -p 8848:8848 \
  -p 9848:9848 \
  -p 9849:9849 \
  --restart always \
  -v /root/docker_volume/nacos/conf:/nacos/conf \
  --add-host=host.docker.internal:host-gateway \
  laosijiddd/nacos:2.1.1

参数说明：

• --name nacos：指定容器名称为nacos
• -d：以守护进程模式运行容器
• -p 8848:8848：映射Nacos主端口（HTTP API与控制台访问端口）
• -p 9848:9848：映射Nacos客户端gRPC通信端口
• -p 9849:9849：映射Nacos服务端gRPC通信端口
• --restart always：配置容器退出时自动重启策略
• -v /root/docker_volume/nacos/conf:/nacos/conf：挂载宿主机目录到容器内，实现配置文件持久化
• --add-host=host.docker.internal:host-gateway：添加主机映射，解决容器内访问宿主机服务的网络问题

Docker Compose配置示例

创建docker-compose.yml文件，实现更便捷的部署与管理：

yaml
version: '3'
services:
  nacos:
    image: laosijiddd/nacos:2.1.1
    container_name: nacos
    restart: always
    ports:
      - "8848:8848"   # 主服务端口
      - "9848:9848"   # 客户端gRPC端口
      - "9849:9849"   # 服务端gRPC端口
    volumes:
      - /root/docker_volume/nacos/conf:/nacos/conf  # 配置文件持久化
    extra_hosts:
      - "host.docker.internal:host-gateway"  # 宿主机网络映射

启动命令：docker-compose up -d

配置说明

• 持久化配置：通过挂载/nacos/conf目录，可修改容器内application.properties等核心配置文件，实现自定义配置（如数据库连接、集群配置等）
• 端口用途：8848端口用于Web控制台访问及HTTP API调用；9848和9849端口用于服务间gRPC通信，确保服务发现与配置同步的高效性
• 网络配置：--add-host参数用于容器内访问宿主机上的服务（如数据库、其他微服务等），避免网络隔离问题