引言

Nacos 作为阿里巴巴开源的动态服务发现、配置和服务管理平台，已成为微服务架构中不可或缺的组件。对于开发测试环境或小型项目，单机部署 Nacos 既能满足需求，又能降低资源消耗。本文将详细介绍如何使用 Docker Compose 快速部署单机版 Nacos，覆盖从配置文件编写到运维管理的全流程。

一、Docker Compose 部署 Nacos 的核心优势

1. 快速部署：通过 YAML 配置文件定义服务，一键启动完整环境
   相比手动安装 Java 环境、配置数据库等步骤，Docker Compose 将部署时间从小时级缩短至分钟级。例如，手动安装需要配置 MySQL、调整 JVM 参数、设置集群节点等，而 Docker Compose 只需一个 docker-compose.yml 文件。

2. 环境隔离：避免与宿主系统环境冲突
   通过容器化技术，Nacos 运行在独立环境中，与宿主系统的 Java 版本、端口占用等完全隔离。例如，宿主系统可能已安装 Java 8，但 Nacos 需要 Java 11，容器化可完美解决此类冲突。

3. 可复用性：配置文件可跨环境复用
   同一份 docker-compose.yml 可在开发、测试、预发环境快速复用，仅需调整少量参数（如数据库连接）。例如，开发环境使用嵌入式数据库，生产环境连接外部 MySQL。

4. 易于维护：日志、数据持久化集中管理
   通过卷挂载（Volumes）实现配置文件和数据持久化，升级或重启容器时数据不丢失。例如，nacos-data 卷可保存注册的服务实例信息。

二、Docker Compose 配置文件详解

1. 基础配置示例

version: '3.8'
services:
  nacos:
    image: nacos/nacos-server:latest
    container_name: nacos-standalone
    environment:
      - MODE=standalone
      - PREFER_HOST_MODE=hostname
      - JVM_XMS=512m
      - JVM_XMX=512m
      - JVM_XMN=256m
    ports:
      - "8848:8848"
    volumes:
      - ./nacos-data:/home/nacos/data
      - ./nacos-logs:/home/nacos/logs
      - ./custom.properties:/home/nacos/conf/application.properties
    restart: unless-stopped

关键参数解析：

• MODE=standalone：强制以单机模式运行，避免误启动集群模式。
• JVM_XMS/XMX/XMN：调整 JVM 内存参数，512MB 适合开发环境，生产环境建议 2GB 以上。
• 卷挂载：
  • nacos-data：持久化存储注册中心数据（如服务实例元数据）。
  • nacos-logs：集中管理日志，便于问题排查。
  • custom.properties：覆盖默认配置，例如调整 nacos.core.auth.enabled=true 开启认证。

2. 高级配置场景

场景 1：连接外部 MySQL 数据库

services:
  nacos:
    image: nacos/nacos-server:latest
    environment:
      - MODE=standalone
      - SPRING_DATASOURCE_PLATFORM=mysql
      - MYSQL_SERVICE_HOST=mysql-host
      - MYSQL_SERVICE_PORT=3306
      - MYSQL_SERVICE_DB_NAME=nacos
      - MYSQL_SERVICE_USER=root
      - MYSQL_SERVICE_PASSWORD=123456
    depends_on:
      - mysql
  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=123456
      - MYSQL_DATABASE=nacos
    volumes:
      - ./mysql-data:/var/lib/mysql

适用场景：需要持久化存储配置和服务实例信息，避免容器重启后数据丢失。

场景 2：多环境配置管理

通过 docker-compose.override.yml 实现环境差异配置：

# docker-compose.override.yml（开发环境）
services:
  nacos:
    environment:
      - JVM_XMS=256m
      - JVM_XMX=256m
    ports:
      - "8848:8848"
      - "9848:9848"  # 调试端口

操作命令：

docker-compose -f docker-compose.yml -f docker-compose.override.yml up

三、部署与运维实战

1. 部署流程

1. 准备目录结构：

   /nacos-deploy/
     ├── docker-compose.yml
     ├── custom.properties  # 可选
     └── init.sql           # MySQL 初始化脚本（如需）

2. 启动服务：

   docker-compose up -d

3. 验证状态：

   docker ps | grep nacos
   curl http://localhost:8848/nacos/v1/ns/service/list

2. 常见问题处理

问题 1：端口冲突

现象：8848 端口被占用。
解决方案：修改 ports 映射或终止占用进程：

sudo lsof -i :8848  # 查找进程
kill <PID>          # 终止进程

问题 2：数据持久化失败

现象：重启容器后数据丢失。
原因：未正确配置卷挂载或卷路径权限不足。
解决方案：

volumes:
  - ./nacos-data:/home/nacos/data  # 确保 ./nacos-data 目录存在且可写

问题 3：JVM 内存不足

现象：容器频繁重启，日志中出现 OutOfMemoryError。
解决方案：调整 JVM_XMS/XMX 参数，建议设置为物理内存的 50%~70%。

3. 运维命令速查

命令	用途
docker-compose logs -f nacos	实时查看日志
docker-compose exec nacos bash	进入容器内部
docker-compose down	停止并删除容器
docker-compose up -d --scale nacos=1	强制单机模式（防止误启动集群）

四、性能调优建议

1. JVM 参数优化：

   • 开发环境：-Xms256m -Xmx256m -Xmn128m
   • 生产环境：-Xms2g -Xmx2g -Xmn1g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m

2. 网络优化：

   • 使用 host 网络模式（network_mode: host）减少 NAT 开销，但会暴露所有端口。

3. 资源限制：

   deploy:
     resources:
       limits:
         cpus: '1.0'
         memory: 1G

五、总结与扩展

通过 Docker Compose 部署单机版 Nacos，开发者可快速构建轻量级服务注册与配置中心。本文覆盖了从基础配置到高级场景的完整流程，并提供了实用的运维命令和调优建议。对于生产环境，建议进一步考虑：

1. 高可用部署：使用集群模式（至少 3 个节点）并配置外部存储（如 MySQL）。
2. 监控集成：通过 Prometheus + Grafana 监控 Nacos 指标。
3. 安全加固：开启认证（nacos.core.auth.enabled=true）并配置 HTTPS。

下一步行动：

1. 根据本文配置 docker-compose.yml 并启动服务。
2. 通过 curl 或 Nacos 控制台（http://localhost:8848/nacos）验证功能。
3. 结合 Spring Cloud Alibaba 等框架测试服务注册与发现。