Docker 安装 Nacos v1.4.4 踩坑实录
背景
在 Linux 环境下使用 Docker 部署 Nacos v1.4.4 单机模式时，容器虽然创建成功，但服务实际并未正常启动，访问 Web 控制台无响应。本文记录了完整的安装过程及问题排查解决步骤。
环境信息
- 操作系统：Linux (Ubuntu)
- Nacos 版本：v1.4.4
- 部署方式：Docker standalone 模式
初始安装命令
按照常规方式执行以下命令：
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 查看容器日志，发现关键报错：
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 服务随之无法运行。
解决方案
第一步：从镜像中提取配置文件
# 创建临时容器
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
第二步：修复配置文件
查看问题所在：
grep "tomcat.basedir" /data/nacos/application.properties
# 输出: server.tomcat.basedir=
将空值替换为有效路径：
sed -i 's|server.tomcat.basedir=|server.tomcat.basedir=/home/nacos/data/tomcat|' /data/nacos/application.properties
验证修改结果：
grep "tomcat.basedir" /data/nacos/application.properties
# 输出: server.tomcat.basedir=/home/nacos/data/tomcat
第三步：删除旧容器，用修复后的配置重新创建
# 停止并删除旧容器
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 秒后查看日志：
docker logs nacos --tail 20
看到以下输出即表示启动成功：
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
目录结构
/data/nacos/
├── application.properties # Nacos 配置文件（已修复）
├── init.d/ # 自定义初始化脚本目录
└── logs/ # Nacos 运行日志目录
总结
nacos/nacos-server:v1.4.4 镜像存在一个已知缺陷：application.properties 中 server.tomcat.basedir 配置项值为空，导致在某些环境下 Tomcat 无法初始化。解决方案是从容器中提取配置文件，补全该配置项的值，然后以挂载方式覆盖容器内原有配置文件，即可正常启动。
