nacos/nacos-server

Nacos Docker 镜像文档

!Docker Pulls

该项目提供用于简化https://github.com/alibaba/nacos%E9%83%A8%E7%BD%B2%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8CNacos%E6%98%AF%E9%98%BF%E9%87%8C%E5%B7%B4%E5%B7%B4%E5%BC%80%E6%BA%90%E7%9A%84%E5%8A%A8%E6%80%81%E6%9C%8D%E5%8A%A1%E5%8F%91%E7%8E%B0%E3%80%81%E9%85%8D%E7%BD%AE%E7%AE%A1%E7%90%86%E5%92%8C%E6%9C%8D%E5%8A%A1%E7%AE%A1%E7%90%86%E5%B9%B3%E5%8F%B0%E3%80%82

项目目录

• build：Nacos Docker镜像的构建源代码
• env：Docker Compose的环境变量配置文件
• example：Nacos服务的Docker Compose示例配置

注意事项

• 最新的nacos/nacos-server:latest镜像已移除数据库主从镜像，具体原因参考https://github.com/nacos-group/nacos-docker/wiki/%E7%A7%BB%E9%99%A4%E6%95%B0%E6%8D%AE%E5%BA%93%E4%B8%BB%E4%BB%8E%E9%95%9C%E5%83%8F%E9%85%8D%E7%BD%AE
• 自Nacos 1.3.1版本起，数据库存储升级至8.0，且保持向下兼容
• 若使用自定义数据库，首次部署需手动初始化https://github.com/alibaba/nacos/blob/develop/distribution/conf/nacos-mysql.sql

镜像概述与主要用途

Nacos Docker镜像旨在提供便捷的Nacos服务部署方式，支持单机模式和集群模式，适用于开发、测试及生产环境。通过环境变量配置即可快速调整服务参数，无需复杂的手动配置，简化微服务架构中的服务发现与配置管理基础设施搭建。

核心功能与特性

• 支持单机（standalone）和集群（cluster）两种部署模式
• 兼容MySQL 5.7及8.0数据库，支持自定义数据库配置
• 提供丰富的环境变量配置，覆盖服务端口、JVM参数、认证授权等核心参数
• 支持挂载自定义配置文件，满足高级配置需求
• 集成健康检查与监控指标，可对接Prometheus+Grafana监控体系

使用场景

• 开发环境快速部署：通过单机模式快速启动Nacos服务，用于本地开发调试
• 测试环境集群验证：通过Docker Compose快速搭建Nacos集群，验证分布式服务发现与配置同步
• 生产环境基础架构：结合自定义数据库和持久化存储，构建稳定的服务注册与配置中心

快速启动

通过以下命令可快速启动单机模式的Nacos服务：

shell
docker run --name nacos-quick -e MODE=standalone -p 8849:8848 -d nacos/nacos-server:2.0.2

• 参数说明：
  • --name nacos-quick：容器名称
  • -e MODE=standalone：指定单机模式
  • -p 8849:8848：端口映射（主机端口:容器端口）
  • -d：后台运行
  • nacos/nacos-server:2.0.2：镜像名称及版本

高级用法

版本调整

可通过修改Compose文件中的环境变量调整Nacos镜像版本，配置文件路径：example/.env

dotenv
NACOS_VERSION=2.0.2  # 修改为目标版本号

部署步骤

1. 克隆项目

powershell
git clone --depth 1 https://github.com/nacos-group/nacos-docker.git
cd nacos-docker

2. 单机模式（内置Derby数据库）

适用于快速测试，无需外部数据库：

powershell
docker-compose -f example/standalone-derby.yaml up

3. 单机模式（MySQL数据库）

使用MySQL 5.7：

powershell
docker-compose -f example/standalone-mysql-5.7.yaml up

使用MySQL 8：

powershell
docker-compose -f example/standalone-mysql-8.yaml up

4. 集群模式

基于主机名的集群部署：

powershell
docker-compose -f example/cluster-hostname.yaml up

基本操作示例

服务注册

powershell
curl -X PUT 'http://127.0.0.1:8848/nacos/v1/ns/instance?serviceName=nacos.naming.serviceName&ip=20.18.7.10&port=8080'

服务发现

powershell
curl -X GET 'http://127.0.0.1:8848/nacos/v1/ns/instances?serviceName=nacos.naming.serviceName'

发布配置

powershell
curl -X POST "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test&content=helloWorld"

获取配置

powershell
curl -X GET "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=nacos.cfg.dataId&group=test"

访问控制台

浏览器访问：[***]

常见配置参数

高级配置

若上述环境变量配置无法满足需求，可将自定义配置文件custom.properties挂载至容器的/home/nacos/init.d/目录，该文件中的Spring属性配置优先级高于镜像内置的application.properties。

示例参考：cluster-hostname.yaml

Nacos + Grafana + Prometheus

监控配置参考：Nacos监控指南

注意：Grafana添加数据源时，数据源地址必须为**[***]