hvkcoder/nacos-server

nacos-server Docker镜像文档

镜像概述

nacos-server Docker镜像是阿里巴巴开源的服务发现与配置管理平台Nacos的容器化部署版本。该镜像提供了便捷的部署方式，默认采用derby数据库作为持久化存储方案，同时支持通过环境变量配置切换至MySQL数据库，满足不同场景下的数据存储需求。

核心功能和特性

• 默认存储方案：内置derby数据库，无需额外配置即可实现数据持久化
• MySQL支持：可通过环境变量配置切换至MySQL数据库，满足生产环境数据存储需求
• 数据持久化：支持挂载数据、日志和配置目录，确保容器重启后数据不丢失
• 独立模式部署：支持通过环境变量设置独立模式(standalone)，适合单机部署场景

使用场景和适用范围

• 开发测试环境：快速部署Nacos服务，进行服务发现和配置管理功能测试
• 单机生产环境：通过独立模式部署，配合MySQL存储实现稳定运行
• 数据持久化需求：需要确保配置数据、服务注册信息在容器重启后不丢失的场景

使用方法和配置说明

默认启动（derby存储）

使用默认derby数据库存储时，可通过以下命令快速启动：

bash
docker run -it --rm --name nacos -e MODE="standalone" -P hvkcoder/nacos-server:tag

参数说明：

• -e MODE="standalone": 设置为独立模式运行
• -P: 随机映射容器端口到主机
• --rm: 容器停止后自动删除
• tag: 镜像标签，需替换为具体版本号

使用MySQL存储

如需使用MySQL作为持久化存储，需设置以下环境变量：

bash
docker run -it --rm --name nacos \
  -e MODE="standalone" \
  -e SPRING_DATASOURCE_PLATFORM="mysql" \
  -e MYSQL_SERVICE_HOST="127.0.0.1" \
  -e MYSQL_SERVICE_PORT=3306 \
  -e MYSQL_SERVICE_DB_NAME="nacos_config" \
  -e MYSQL_SERVICE_USER="root" \
  -e MYSQL_SERVICE_PASSWORD="123456" \
  -P hvkcoder/nacos-server:tag

环境变量说明：

• SPRING_DATASOURCE_PLATFORM="mysql": 指定使用MySQL作为数据源
• MYSQL_SERVICE_HOST: MySQL服务器地址
• MYSQL_SERVICE_PORT: MySQL服务器端口，默认3306
• MYSQL_SERVICE_DB_NAME: Nacos使用的数据库名
• MYSQL_SERVICE_USER: MySQL登录用户名
• MYSQL_SERVICE_PASSWORD: MySQL登录密码

挂载目录

Nacos的工作目录为/opt/nacos，建议挂载以下目录以实现数据持久化：

• 数据目录：-v /opt/nacos/data:/opt/nacos/data，存储Nacos核心数据
• 日志目录：-v /opt/nacos/logs:/opt/nacos/logs，存储Nacos运行日志
• 配置目录：-v /opt/nacos/conf:/opt/nacos/conf，存储Nacos配置文件

完整挂载示例：

bash
docker run -it --name nacos \
  -e MODE="standalone" \
  -e SPRING_DATASOURCE_PLATFORM="mysql" \
  -e MYSQL_SERVICE_HOST="127.0.0.1" \
  -e MYSQL_SERVICE_PORT=3306 \
  -e MYSQL_SERVICE_DB_NAME="nacos_config" \
  -e MYSQL_SERVICE_USER="root" \
  -e MYSQL_SERVICE_PASSWORD="123456" \
  -v /opt/nacos/data:/opt/nacos/data \
  -v /opt/nacos/logs:/opt/nacos/logs \
  -v /opt/nacos/conf:/opt/nacos/conf \
  -p 8848:8848 \
  hvkcoder/nacos-server:tag

注意：生产环境中建议使用-d参数后台运行，并移除--rm参数以避免容器停止后数据丢失。