nacos/nacos-server Docker 镜像 - 轩辕镜像
镜像简介
用于简化Nacos服务部署的Docker镜像，支持单机和集群模式，提供便捷的环境变量配置、快速启动及自定义数据库集成，适用于服务发现与配置管理场景。
镜像统计信息
收藏数: 554
下载次数: 32944010
状态: active
发布者: nacos
类型: 镜像
nacos/nacos-server自动构建
用于简化Nacos服务部署的Docker镜像，支持单机和集群模式，提供便捷的环境变量配置、快速启动及自定义数据库集成，适用于服务发现与配置管理场景。
554 收藏0 次下载activenacos镜像
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服务：
shelldocker 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
dotenvNACOS_VERSION=2.0.2 # 修改为目标版本号
部署步骤
1. 克隆项目
powershellgit clone --depth 1 [***] cd nacos-docker
2. 单机模式（内置Derby数据库）
适用于快速测试，无需外部数据库：
powershelldocker-compose -f example/standalone-derby.yaml up
3. 单机模式（MySQL数据库）
使用MySQL 5.7：
powershelldocker-compose -f example/standalone-mysql-5.7.yaml up
使用MySQL 8：
powershelldocker-compose -f example/standalone-mysql-8.yaml up
4. 集群模式
基于主机名的集群部署：
powershelldocker-compose -f example/cluster-hostname.yaml up
基本操作示例
服务注册
powershellcurl -X PUT '[***]
服务发现
powershellcurl -X GET '[***]
发布配置
powershellcurl -X POST "[***]"
获取配置
powershellcurl -X GET "[***]"
访问控制台
浏览器访问：[***]
常见配置参数
| 参数名称 | 描述 | 可选值及默认值 |
|---|---|---|
| MODE | 部署模式 | cluster/standalone，默认cluster |
| NACOS_SERVERS | 集群节点地址 | 示例：ip1:port1 ip2:port2 ip3:port3 |
| PREFER_HOST_MODE | 是否支持主机名 | hostname/ip，默认ip |
| NACOS_APPLICATION_PORT | 服务端口 | 默认8848 |
| NACOS_SERVER_IP | 自定义服务器IP（多网卡场景） | - |
| SPRING_DATASOURCE_PLATFORM | 数据库平台（单机模式支持） | mysql/empty，默认empty |
| MYSQL_SERVICE_HOST | MySQL主机地址 | - |
| MYSQL_SERVICE_PORT | MySQL端口 | 默认3306 |
| MYSQL_SERVICE_DB_NAME | MySQL数据库名 | - |
| MYSQL_SERVICE_USER | MySQL用户名 | - |
| MYSQL_SERVICE_PASSWORD | MySQL密码 | - |
| MYSQL_DATABASE_NUM | 数据库数量 | 默认1 |
| MYSQL_SERVICE_DB_PARAM | 数据库连接参数 | 默认：characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useSSL=false |
| JVM_XMS | JVM初始堆内存 | 默认1g |
| JVM_XMX | JVM最大堆内存 | 默认1g |
| JVM_XMN | JVM新生代内存 | 默认512m |
| JVM_MS | 元空间初始大小 | 默认128m |
| JVM_MMS | 元空间最大大小 | 默认320m |
| NACOS_DEBUG | 是否启用远程调试 | y/n，默认n |
| TOMCAT_ACCESSLOG_ENABLED | 是否启用Tomcat访问日志 | 默认false |
| NACOS_AUTH_SYSTEM_TYPE | 认证系统类型 | 仅支持'nacos'，默认nacos |
| NACOS_AUTH_ENABLE | 是否启用认证 | 默认false |
| NACOS_AUTH_TOKEN_EXPIRE_SECONDS | 令牌过期时间（秒） | 默认******* |
| NACOS_AUTH_TOKEN | 默认令牌密钥 | 默认：SecretKey012345678901234567890123456789012345678901234567890123456789 |
| NACOS_AUTH_CACHE_ENABLE | 是否启用认证信息缓存 | 默认false |
| MEMBER_LIST | 集群节点列表（配置文件/命令行参数） | 示例：192.168.16.101:8847?raft_port=8807,... |
| EMBEDDED_STORAGE | 集群模式嵌入式存储（无需MySQL） | embedded，默认none |
| NACOS_SECURITY_IGNORE_URLS | 安全忽略URL列表 | 默认：/,/error,/**/*.css,/**/*.js,/**/*.html,/**/*.map,/**/*.svg,/**/*.png,/**/*.ico,/console-fe/public/**,/v1/auth/**,/v1/console/health/**,/actuator/**,/v1/console/server/** |
高级配置
若上述环境变量配置无法满足需求，可将自定义配置文件custom.properties挂载至容器的/home/nacos/init.d/目录，该文件中的Spring属性配置优先级高于镜像内置的application.properties。
示例参考：cluster-hostname.yaml
Nacos + Grafana + Prometheus
监控配置参考：Nacos监控指南
注意：Grafana添加数据源时，数据源地址必须为**[***]
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 版本下载页面。
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录仓库拉取
通过 Docker 登录认证访问私有仓库
Linux
在 Linux 系统配置镜像服务
Windows/Mac
在 Docker Desktop 配置镜像
Docker Compose
Docker Compose 项目配置
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
宝塔面板
在宝塔面板一键配置镜像
群晖
Synology 群晖 NAS 配置
飞牛
飞牛 fnOS 系统配置镜像
极空间
极空间 NAS 系统配置服务
爱快路由
爱快 iKuai 路由系统配置
绿联
绿联 NAS 系统配置镜像
威联通
QNAP 威联通 NAS 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
专属域名拉取
无需登录使用专属域名
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
轩辕镜像支持哪些镜像仓库？
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。
流量耗尽错误提示
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"