Docker 安装 Nacos v1.4.4 踩坑实录

背景

在 Linux 环境下使用 Docker 部署 Nacos v1.4.4 单机模式时，容器虽然创建成功，但服务实际并未正常启动，访问 Web 控制台无响应。本文记录了完整的安装过程及问题排查解决步骤。

环境信息

操作系统：Linux (Ubuntu)
Nacos 版本：v1.4.4
部署方式：Docker standalone 模式

初始安装命令

按照常规方式执行以下命令：

bash 复制代码

docker run -d \
  --name nacos \
  --restart=always \
  -p 8848:8848 \
  -e MODE=standalone \
  -v /data/nacos/init.d:/home/nacos/init.d \
  -v /data/nacos/logs:/home/nacos/logs \
  nacos/nacos-server:v1.4.4

容器启动了，但访问 http://<IP>:8848/nacos 无任何响应。

问题排查

通过 docker logs nacos --tail 100 查看容器日志，发现关键报错：

arduino 复制代码

Failed to bind properties under 'server.tomcat.basedir' to java.io.File:

根因分析 ：nacos/nacos-server:v1.4.4 镜像内置的 application.properties 配置文件中，server.tomcat.basedir 的值为空字符串，而 Spring Boot 无法将空字符串转换为 java.io.File 类型，导致 Tomcat 启动失败，Nacos 服务随之无法运行。

解决方案

第一步：从镜像中提取配置文件

bash 复制代码

# 创建临时容器
docker create --name nacos-temp nacos/nacos-server:v1.4.4

# 将配置文件拷贝到宿主机
docker cp nacos-temp:/home/nacos/conf/application.properties /data/nacos/application.properties

# 删除临时容器
docker rm nacos-temp

第二步：修复配置文件

查看问题所在：

bash 复制代码

grep "tomcat.basedir" /data/nacos/application.properties
# 输出: server.tomcat.basedir=

将空值替换为有效路径：

bash 复制代码

sed -i 's|server.tomcat.basedir=|server.tomcat.basedir=/home/nacos/data/tomcat|' /data/nacos/application.properties

验证修改结果：

bash 复制代码

grep "tomcat.basedir" /data/nacos/application.properties
# 输出: server.tomcat.basedir=/home/nacos/data/tomcat

第三步：删除旧容器，用修复后的配置重新创建

bash 复制代码

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

# 确保数据目录存在
mkdir -p /data/nacos/init.d /data/nacos/logs

# 重新创建容器，额外挂载修复后的配置文件
docker run -d \
  --name nacos \
  --restart=always \
  -p 8848:8848 \
  -e MODE=standalone \
  -v /data/nacos/application.properties:/home/nacos/conf/application.properties \
  -v /data/nacos/init.d:/home/nacos/init.d \
  -v /data/nacos/logs:/home/nacos/logs \
  nacos/nacos-server:v1.4.4

第四步：验证启动

等待约 20 秒后查看日志：

bash 复制代码

docker logs nacos --tail 20

看到以下输出即表示启动成功：

scss 复制代码

Nacos started successfully in stand alone mode. use embedded storage
Tomcat started on port(s): 8848 (http) with context path '/nacos'

访问信息

控制台地址 ：http://<服务器IP>:8848/nacos
默认账号：nacos
默认密码：nacos

目录结构

bash 复制代码

/data/nacos/
├── application.properties   # Nacos 配置文件（已修复）
├── init.d/                  # 自定义初始化脚本目录
└── logs/                    # Nacos 运行日志目录

总结

nacos/nacos-server:v1.4.4 镜像存在一个已知缺陷：application.properties 中 server.tomcat.basedir 配置项值为空，导致在某些环境下 Tomcat 无法初始化。解决方案是从容器中提取配置文件，补全该配置项的值，然后以挂载方式覆盖容器内原有配置文件，即可正常启动。