Docker Compose 快速部署单机版 Nacos 指南

一、引言

在微服务架构日益普及的今天，服务发现与配置管理成为系统运行的关键环节。Nacos 作为阿里巴巴开源的动态服务发现、配置和服务管理平台，提供了高效、稳定的服务治理能力。对于开发者和企业用户而言，快速搭建一个单机版的 Nacos 服务是验证功能、进行本地开发或测试的首选方案。本文将详细介绍如何使用 Docker Compose 这一轻量级容器编排工具，快速部署单机版 Nacos 服务，帮助读者高效完成环境搭建。

二、环境准备

1. Docker 与 Docker Compose 安装

在开始部署之前，确保您的系统已安装 Docker 和 Docker Compose。Docker 提供了容器化的基础环境，而 Docker Compose 则简化了多容器应用的定义和运行。

Docker 安装：根据您的操作系统（如 Ubuntu、CentOS、macOS 或 Windows），访问 Docker 官方文档下载并安装 Docker。
Docker Compose 安装：Docker Compose 通常随 Docker 一起安装，但也可以通过官方文档单独安装最新版本。

2. 确认系统资源

单机版 Nacos 对系统资源的要求不高，但为了确保稳定运行，建议至少分配 2GB 内存给 Docker 容器。您可以通过 Docker 的资源限制设置来调整。

三、编写 Docker Compose 配置文件

1. 创建项目目录

首先，创建一个新的项目目录，用于存放 Docker Compose 配置文件和相关资源。

mkdir nacos-docker-compose
cd nacos-docker-compose

2. 编写 `docker-compose.yml`

在项目目录中，创建 docker-compose.yml 文件，内容如下：

version: '3'
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
    restart: on-failure

配置说明：

image：指定使用的 Nacos 镜像版本，这里使用最新版。
container_name：为容器指定一个名称，便于管理。
environment：设置环境变量，MODE=standalone 表示以单机模式运行，其他变量用于调整 JVM 内存参数。
ports：将容器内的 8848 端口映射到宿主机的 8848 端口，这是 Nacos 的默认服务端口。
volumes：将容器内的 /home/nacos/data 目录挂载到宿主机的 ./nacos-data 目录，用于持久化数据。
restart：设置容器失败时的重启策略。

四、启动 Nacos 服务

1. 启动容器

在项目目录中，执行以下命令启动 Nacos 服务：

docker-compose up -d

-d 参数表示以守护进程模式运行，即后台运行。

2. 验证服务状态

使用 docker-compose ps 命令查看服务运行状态：

docker-compose ps

正常情况下，您应该看到 nacos-standalone 容器处于 Up 状态。

3. 访问 Nacos 控制台

打开浏览器，访问 http://localhost:8848/nacos，您将看到 Nacos 的登录页面。默认的用户名和密码均为 nacos。

五、配置与优化

1. 修改默认配置

Nacos 的默认配置可能不适合所有场景。您可以通过修改 application.properties 文件（位于挂载的数据目录 ./nacos-data 中）来自定义配置，如数据库连接、日志级别等。

2. 调整 JVM 参数

根据您的系统资源，适当调整 JVM_XMS、JVM_XMX 和 JVM_XMN 等 JVM 参数，以优化 Nacos 的性能。这些参数已在 docker-compose.yml 中设置，但可以根据需要修改。

3. 备份与恢复

定期备份 ./nacos-data 目录下的数据，以防数据丢失。恢复时，只需将备份的数据复制回该目录，并重启 Nacos 服务即可。

六、常见问题与解决方案

1. 端口冲突

如果宿主机的 8848 端口已被占用，您需要修改 docker-compose.yml 中的 ports 配置，将宿主机的端口改为其他未被占用的端口。

2. 内存不足

如果 Nacos 服务因内存不足而频繁重启，请增加 JVM 的内存参数（JVM_XMS、JVM_XMX），并确保宿主机的内存足够。

3. 数据持久化问题

确保 ./nacos-data 目录存在且具有正确的读写权限。如果数据未持久化，请检查挂载配置是否正确。

七、总结

通过 Docker Compose 部署单机版 Nacos 服务，不仅简化了部署流程，还提高了环境的可移植性和一致性。本文详细介绍了从环境准备、配置文件编写到服务启动和验证的全过程，并提供了配置优化和常见问题解决方案。希望本文能帮助读者快速搭建起一个稳定、高效的 Nacos 服务环境，为微服务架构的开发和测试提供有力支持。

标题：Docker Compose 快速部署单机版 Nacos 指南