一、前言最近部署 Nacos 2.1.0 踩了超多坑Docker 拉取镜像超时、Nacos 启动报No DataSource set、本地 Nacos 连不上 Docker 里的 MySQL、默认集群模式启动卡死等问题。本文整理两套可直接落地的部署方案优先使用Docker 容器部署 NacosDocker 拉取镜像超时 / 失败时用Linux 本地解压部署兜底全程适配Docker 运行的 MySQL所有命令复制即用新手也能一次部署成功。简洁流程省流前置必做启动 Docker 中的 MySQL 容器在 MySQL 中创建nacos库并导入 Nacos 自带nacos-mysql.sql表结构。方案一Docker 部署 Nacos优先推荐国内镜像源拉取nacos/nacos-server:v2.1.0编写custom.env配置单机模式 Docker MySQL 连接信息挂载配置、映射 8848/9848/9849 端口执行docker run启动查看日志浏览器访问 Nacos 控制台。方案二Docker 拉取超时兜底本地解压版下载 Nacos 2.1.0解压到/usr/local/nacos修改application.properties数据库地址填宿主机 IP:3306指向 Docker MySQL执行startup.sh -m standalone单机启动放行防火墙 8848 端口直接浏览器访问使用。【下载地址】Nacos2.1.0安装包下载https://gitcode.com/open-source-toolkit/55608二、环境准备服务器CentOS 7容器环境Docker 已安装并配置国内镜像加速器数据库MySQL 运行在 Docker 容器中映射端口3306账号xxx密码xxxNacos 版本2.1.0服务器内网 IP192.168.100.xxx三、前置准备 Docker MySQL1. 查看并启动 MySQL 容器# 查看所有容器找到mysql docker ps -a | grep mysql # 启动mysql容器替换为你的容器名/ID docker start mysql2. 创建 Nacos 数据库 导入官方表结构90% 启动失败都是没建库、没导表导致No DataSource set# 1. 创建nacos数据库 docker exec -it mysql mysql -uroot -p123 -e CREATE DATABASE IF NOT EXISTS nacos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; # 2. 后续本地部署会用到提前把nacos建库导表准备好四、方案一Docker 部署 Nacos 2.1.0推荐1. 解决 Docker 拉取镜像超时已配置国内镜像加速器中科大、网易、清华源若仍超时手动拉取国内镜像bash运行# 拉取中科大同步镜像 docker pull docker.mirrors.ustc.edu.cn/nacos/nacos-server:v2.1.0 # 重命名标签兼容原生命令 docker tag docker.mirrors.ustc.edu.cn/nacos/nacos-server:v2.1.0 nacos/nacos-server:v2.1.02. 编写 nacos 环境配置文件新建目录并创建custom.envbash运行mkdir -p /root/nacos vim /root/nacos/custom.env写入配置env# 单机模式 MODEstandalone # 数据库配置 SPRING_DATASOURCE_PLATFORMmysql MYSQL_SERVICE_HOST192.168.100.128 MYSQL_SERVICE_PORT3306 MYSQL_SERVICE_DB_NAMEnacos MYSQL_SERVICE_USERroot MYSQL_SERVICE_PASSWORD123 MYSQL_SERVICE_DB_PARAMcharacterEncodingutf8connectTimeout1000socketTimeout3000autoReconnecttrueuseSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai # 安全认证配置高版本Nacos必备 NACOS_AUTH_IDENTITY_KEYnacos NACOS_AUTH_IDENTITY_VALUEnacos NACOS_AUTH_TOKENSecretKey0123456789012345678901234567890123456789012345678901234567893. 启动 Nacos 容器docker run -d \ --name nacos \ --env-file /root/nacos/custom.env \ -p 8848:8848 \ -p 9848:9848 \ -p 9849:9849 \ --restartalways \ nacos/nacos-server:v2.1.04. 查看启动日志docker logs -f nacos出现以下日志代表启动成功Nacos started successfully in stand alone mode.五、方案二本地解压部署 NacosDocker 拉取失败兜底1. 下载并解压 Nacos 安装包下载 Nacos 2.1.0 安装包解压到 Linux 标准软件目录/usr/local# 解压命令 tar -zxvf nacos-server-2.1.0.tar.gz -C /usr/local/最终路径/usr/local/nacos2. 修改数据库配置核心避坑重点本地 Nacos 不能用 127.0.0.1 连 Docker MySQL必须用服务器内网 IPcat /usr/local/nacos/conf/application.properties EOF server.port8848 spring.datasource.platformmysql db.num1 db.url.0jdbc:mysql://192.168.100.128:3306/nacos?characterEncodingutf8connectTimeout1000socketTimeout3000autoReconnecttrueuseSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai db.userroot db.password123 EOF3. 单机模式启动 Nacos# 进入启动脚本目录 cd /usr/local/nacos/bin # 单机模式启动必加 -m standalone否则集群模式启动失败 sh startup.sh -m standalone4. 查看启动日志tail -f /usr/local/nacos/logs/start.out5. Nacos 日常启停# 停止 cd /usr/local/nacos/bin sh shutdown.sh # 重启 sh startup.sh -m standalone六、访问 Nacos 控制台浏览器输入地址http://192.168.100.128:8848/nacos默认账号密码用户名nacos密码nacos
【避坑】Nacos 2.1.0 两种部署方案（Docker 部署 + 本地解压部署）
发布时间：2026/8/1 21:57:49
一、前言最近部署 Nacos 2.1.0 踩了超多坑Docker 拉取镜像超时、Nacos 启动报No DataSource set、本地 Nacos 连不上 Docker 里的 MySQL、默认集群模式启动卡死等问题。本文整理两套可直接落地的部署方案优先使用Docker 容器部署 NacosDocker 拉取镜像超时 / 失败时用Linux 本地解压部署兜底全程适配Docker 运行的 MySQL所有命令复制即用新手也能一次部署成功。简洁流程省流前置必做启动 Docker 中的 MySQL 容器在 MySQL 中创建nacos库并导入 Nacos 自带nacos-mysql.sql表结构。方案一Docker 部署 Nacos优先推荐国内镜像源拉取nacos/nacos-server:v2.1.0编写custom.env配置单机模式 Docker MySQL 连接信息挂载配置、映射 8848/9848/9849 端口执行docker run启动查看日志浏览器访问 Nacos 控制台。方案二Docker 拉取超时兜底本地解压版下载 Nacos 2.1.0解压到/usr/local/nacos修改application.properties数据库地址填宿主机 IP:3306指向 Docker MySQL执行startup.sh -m standalone单机启动放行防火墙 8848 端口直接浏览器访问使用。【下载地址】Nacos2.1.0安装包下载https://gitcode.com/open-source-toolkit/55608二、环境准备服务器CentOS 7容器环境Docker 已安装并配置国内镜像加速器数据库MySQL 运行在 Docker 容器中映射端口3306账号xxx密码xxxNacos 版本2.1.0服务器内网 IP192.168.100.xxx三、前置准备 Docker MySQL1. 查看并启动 MySQL 容器# 查看所有容器找到mysql docker ps -a | grep mysql # 启动mysql容器替换为你的容器名/ID docker start mysql2. 创建 Nacos 数据库 导入官方表结构90% 启动失败都是没建库、没导表导致No DataSource set# 1. 创建nacos数据库 docker exec -it mysql mysql -uroot -p123 -e CREATE DATABASE IF NOT EXISTS nacos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; # 2. 后续本地部署会用到提前把nacos建库导表准备好四、方案一Docker 部署 Nacos 2.1.0推荐1. 解决 Docker 拉取镜像超时已配置国内镜像加速器中科大、网易、清华源若仍超时手动拉取国内镜像bash运行# 拉取中科大同步镜像 docker pull docker.mirrors.ustc.edu.cn/nacos/nacos-server:v2.1.0 # 重命名标签兼容原生命令 docker tag docker.mirrors.ustc.edu.cn/nacos/nacos-server:v2.1.0 nacos/nacos-server:v2.1.02. 编写 nacos 环境配置文件新建目录并创建custom.envbash运行mkdir -p /root/nacos vim /root/nacos/custom.env写入配置env# 单机模式 MODEstandalone # 数据库配置 SPRING_DATASOURCE_PLATFORMmysql MYSQL_SERVICE_HOST192.168.100.128 MYSQL_SERVICE_PORT3306 MYSQL_SERVICE_DB_NAMEnacos MYSQL_SERVICE_USERroot MYSQL_SERVICE_PASSWORD123 MYSQL_SERVICE_DB_PARAMcharacterEncodingutf8connectTimeout1000socketTimeout3000autoReconnecttrueuseSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai # 安全认证配置高版本Nacos必备 NACOS_AUTH_IDENTITY_KEYnacos NACOS_AUTH_IDENTITY_VALUEnacos NACOS_AUTH_TOKENSecretKey0123456789012345678901234567890123456789012345678901234567893. 启动 Nacos 容器docker run -d \ --name nacos \ --env-file /root/nacos/custom.env \ -p 8848:8848 \ -p 9848:9848 \ -p 9849:9849 \ --restartalways \ nacos/nacos-server:v2.1.04. 查看启动日志docker logs -f nacos出现以下日志代表启动成功Nacos started successfully in stand alone mode.五、方案二本地解压部署 NacosDocker 拉取失败兜底1. 下载并解压 Nacos 安装包下载 Nacos 2.1.0 安装包解压到 Linux 标准软件目录/usr/local# 解压命令 tar -zxvf nacos-server-2.1.0.tar.gz -C /usr/local/最终路径/usr/local/nacos2. 修改数据库配置核心避坑重点本地 Nacos 不能用 127.0.0.1 连 Docker MySQL必须用服务器内网 IPcat /usr/local/nacos/conf/application.properties EOF server.port8848 spring.datasource.platformmysql db.num1 db.url.0jdbc:mysql://192.168.100.128:3306/nacos?characterEncodingutf8connectTimeout1000socketTimeout3000autoReconnecttrueuseSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai db.userroot db.password123 EOF3. 单机模式启动 Nacos# 进入启动脚本目录 cd /usr/local/nacos/bin # 单机模式启动必加 -m standalone否则集群模式启动失败 sh startup.sh -m standalone4. 查看启动日志tail -f /usr/local/nacos/logs/start.out5. Nacos 日常启停# 停止 cd /usr/local/nacos/bin sh shutdown.sh # 重启 sh startup.sh -m standalone六、访问 Nacos 控制台浏览器输入地址http://192.168.100.128:8848/nacos默认账号密码用户名nacos密码nacos
