Docker安装Nacos 2.2.4图文详解

一、Nacos简介

Nacos是阿里巴巴开源的一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。它提供以下核心功能： - 服务发现与服务健康监测 - 动态配置服务 - 动态DNS服务 - 服务及其元数据管理

二、Docker安装Nacos 2.2.4

1. 拉取Nacos镜像

docker pull nacos/nacos-server:2.2.4

2. 单机模式运行Nacos容器

docker run -d \
--name nacos \
-p 8848:8848 \
-p 9848:9848 \
-p 9849:9849 \
--env MODE=standalone \
--restart=always \
nacos/nacos-server:2.2.4

3. 集群模式运行Nacos容器（示例3节点）

# 节点1
docker run -d \
--name nacos1 \
-p 8848:8848 \
-p 9848:9848 \
-p 9849:9849 \
--env MODE=cluster \
--env NACOS_SERVERS="nacos1:8848 nacos2:8848 nacos3:8848" \
--env PREFER_HOST_MODE=hostname \
--env NACOS_SERVER_PORT=8848 \
--env NACOS_APPLICATION_PORT=8848 \
--restart=always \
nacos/nacos-server:2.2.4

# 节点2和节点3类似，修改name和端口映射即可

三、Nacos容器启动参数详解

1. 端口说明

• 8848: Nacos主端口，用于HTTP API和UI访问
• 9848: Nacos客户端gRPC请求服务端端口，用于客户端与服务端通信
• 9849: Nacos服务端gRPC请求服务端端口，用于集群间通信

2. 常用环境变量

3. 持久化配置示例

docker run -d \
--name nacos \
-p 8848:8848 \
-p 9848:9848 \
-p 9849:9849 \
--env MODE=standalone \
--env SPRING_DATASOURCE_PLATFORM=mysql \
--env MYSQL_SERVICE_HOST=your_mysql_host \
--env MYSQL_SERVICE_PORT=3306 \
--env MYSQL_SERVICE_DB_NAME=nacos \
--env MYSQL_SERVICE_USER=nacos \
--env MYSQL_SERVICE_PASSWORD=nacos \
-v /your_path/nacos/logs:/home/nacos/logs \
--restart=always \
nacos/nacos-server:2.2.4

四、访问Nacos控制台

1. 打开浏览器访问：http://你的服务器IP:8848/nacos
2. 默认用户名/密码：nacos/nacos

五、常见问题整理

1. 容器启动失败

问题现象：容器启动后立即退出

解决方案： - 检查日志：docker logs nacos - 常见原因：内存不足，尝试增加JVM内存参数： bash --env JVM_XMS=1g --env JVM_XMX=1g --env JVM_XMN=512m

2. 无法访问Nacos控制台

问题现象：浏览器无法打开8848端口

解决方案： - 检查防火墙是否开放8848、9848、9849端口 - 检查容器是否正常运行：docker ps -a - 检查端口映射是否正确：docker port nacos

3. 集群模式节点无法互相发现

问题现象：集群节点日志显示无法连接其他节点

解决方案： - 确保NACOS_SERVERS配置正确 - 确保PREFER_HOST_MODE=hostname时，容器名称能解析为正确IP - 检查网络是否互通，尝试使用--network host模式

4. MySQL连接问题

问题现象：日志显示数据库连接失败

解决方案： - 检查MySQL服务是否正常运行 - 检查数据库用户名密码是否正确 - 确保MySQL用户有远程连接权限 - 初始化数据库表结构（Nacos提供SQL脚本）

5. 版本兼容性问题

问题现象：客户端无法连接服务端

解决方案： - Nacos 2.x版本客户端与服务端必须版本匹配 - 确保客户端SDK版本与服务端版本一致

六、最佳实践建议

1. 生产环境：务必使用集群模式+MySQL持久化
2. 资源分配：根据业务规模合理分配JVM内存
3. 备份：定期备份MySQL中的Nacos数据
4. 监控：配置Nacos健康检查和监控
5. 升级：升级前做好备份和测试

七、卸载Nacos

# 停止并删除容器
docker stop nacos && docker rm nacos

# 删除镜像(可选)
docker rmi nacos/nacos-server:2.2.4

# 删除数据卷(如果有)
docker volume prune

通过以上步骤，您应该已经成功在Docker中部署了Nacos 2.2.4。如有其他问题，可以参考Nacos官方文档或社区讨论。