Nacos Docker 镜像文档

!Docker Pulls

该项目提供用于简化Nacos部署的Docker镜像，Nacos是阿里巴巴开源的动态服务发现、配置管理和服务管理平台。

项目目录

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

注意事项

• 最新的nacos/nacos-server:latest镜像已移除数据库主从镜像，具体原因参考移除数据库主从镜像配置
• 自Nacos 1.3.1版本起，数据库存储升级至8.0，且保持向下兼容
• 若使用自定义数据库，首次部署需手动初始化数据库脚本

镜像概述与主要用途

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 [***]
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 '[***]

服务发现

powershell
curl -X GET '[***]

发布配置

powershell
curl -X POST "[***]"

获取配置

powershell
curl -X GET "[***]"

访问控制台

浏览器访问：[***]

常见配置参数

高级配置

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

示例参考：cluster-hostname.yaml

Nacos + Grafana + Prometheus

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

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