lhstack/nacos

nacos Docker镜像文档

镜像概述

本镜像是基于Alpine系统构建的nacos轻量化Docker镜像，旨在提供更高效的资源利用和灵活的配置方式。支持nacos 2.2.x及之后版本的新配置模式，同时兼容2.2.x之前版本的官方标准配置，适用于单机开发测试和生产环境集群部署。

核心功能与特性

环境变量配置机制（2.2.x及之后版本）

镜像通过以下环境变量实现灵活配置，支持JVM参数、应用参数及集群设置：

兼容性支持（

• 2.2.x及之后版本：采用上述环境变量配置机制
• 2.2.x之前版本：兼容nacos官方Docker配置方式，具体参考nacos官方文档

使用场景

• 单机部署：开发测试环境，快速启动nacos服务
• 集群部署：生产环境，通过NACOS_SERVERS配置实现高可用集群
• 数据库持久化：支持MySQL作为后端存储，适用于数据持久化需求

使用方法

2.2.x及之后版本配置

1. 环境变量文件（.env）

创建.env文件定义集群配置：

shell
# 集群模式（false为集群集群，true为单机机）
JVM_nacoscos_standalone="false"
# 数据库类型
JVM_spring_datasource_platform="mysql"
# 集群节点地址
NACOS_SERVERS="182.100.100.101 182.100.100.100"
# 开启身份验证
JVM_nacos_core_auth_enabled='"true"'
# 应用参数：暴露所有监控端点
ARG_management_endpoints_web_exposure_include='"*"'
# 数据库连接配置
ARG_db_url_0='"jdbc:mysql://10.43.33.6:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC"'
ARG_db_num='"1"'
# JVM参数
JVM_OPTS="-Xmx512m -Xms512m -XX:+UseG1GC"
# 数据库账号密码
JVM_db_user_0="root"
JVM_db_password_0="123456"

2. Docker Compose集群配置（docker-compose.yml）

yaml
version: '3'
services:
  nacos:
    container_name: nacos
    image: lhstack/nacos:2.2.0
    restart: always
    ports:
      - '8848:8848'  # 主端口
      - '9848:9848'  # gRPC端口（2.x版本必需）
    healthcheck:
      test: ["CMD-SHELL","wget --no-cache --spider 'http://localhost:8848/nacos/actuator/health' || exit 1"]
      timeout: 2s
      interval: 10s
      retries: 5
      start_period: 15s
    env_file: .env
    logging:
      options:
        max-file: '1'
        max-size: '16k'
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 384M
    networks:
      nacos:
        ipv4_address: 182.100.100.100
  nacos1:
    container_name: nacos1
    image: lhstack/nacos:2.2.0
    restart: always
    ports:
      - '8849:8848'
      - '9849:9848'
    healthcheck:
      test: ["CMD-SHELL","wget --no-cache --spider 'http://localhost:8848/nacos/actuator/health' || exit 1"]
      timeout: 2s
      interval: 10s
      retries: 5
      start_period: 15s
    env_file: .env
    logging:
      options:
        max-file: '1'
        max-size: '16k'
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 384M
    networks:
      nacos:
        ipv4_address: 182.100.100.101
networks:
  nacos:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: 182.100.0.0/16

启动集群：

shell
docker-compose up -d

2.2.x之前版本配置

1. 单机启动命令

纯内存模式：

shell
docker run --name nacos -p 8848:8848 -p 9848:9848 \
  -e MODE=standalone \
  -e JVM_XMS="512m" -e JVM_XMX="512m" \
  -e JVM_MS="168m" -e JVM_MMS="168m" -e JVM_XMN="288m" \
  -d lhstack/nacos

MySQL持久化模式：

shell
docker run --name nacos -p 8848:8848 -p 9848:9848 \
  -e MODE=standalone \
  -e SPRING_DATASOURCE_PLATFORM="mysql" \
  -e MYSQL_SERVICE_HOST="10.43.33.6" \
  -e MYSQL_SERVICE_USER="root" \
  -e MYSQL_SERVICE_PASSWORD="123456" \
  -e MYSQL_SERVICE_DB_NAME="nacos" \
  -e JVM_XMS="512m" -e JVM_XMX="512m" \
  -e JVM_MS="168m" -e JVM_MMS="168m" -e JVM_XMN="288m" \
  -d lhstack/nacos

2. Docker Compose集群配置（含MySQL）

创建init目录并放入nacos.sql，初始化脚本需包含：

sql
CREATE DATABASE `nacos` CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
USE `nacos`;

docker-compose.yml配置：

yaml
version: '3'
services:
  mysql:
    container_name: mysql
    image: mysql:8.0.28
    restart: always
    ports:
      - '3306:3306'
    environment:
      MYSQL_ROOT_PASSWORD: "123456"
      TZ: Asia/Shanghai
    volumes:
      - ./data:/var/lib/mysql
      - ./init:/docker-entrypoint-initdb.d/ 
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: '512M'
    healthcheck:
      test: ["CMD","mysqladmin","-uroot","-p123456","ping","-h","localhost"]
      timeout: 20s
      retries: 10
    networks:
      nacos:
        ipv4_address: 182.100.36.36
  nacos:
    container_name: nacos
    image: lhstack/nacos:1.4.4
    restart: always
    ports:
      - '8848:8848'
      - '9848:9848'
    environment:
      MYSQL_SERVICE_DB_PARAM: "allowPublicKeyRetrieval=true&rewriteBatchedStatements=true&characterEncoding=UTF8&serverTimezone=UTC&connectTimeout=10000&socketTimeout=30000&autoReconnect=true&useSSL=false"
      NACOS_SERVERS: "182.100.100.101 182.100.100.100"
      TZ: Asia/Shanghai
      MYSQL_SERVICE_HOST: '182.100.36.36'
      MYSQL_SERVICE_USER: 'root'
      MYSQL_SERVICE_PASSWORD: '123456'
      MYSQL_SERVICE_DB_NAME: 'nacos'
      SPRING_DATASOURCE_PLATFORM: 'mysql'
      JVM_XMX: '384m'
      JVM_XMS: '384m'
      JVM_XMN: '192m'
      JVM_MS: '128m'
      JVM_MMS: '128m'
    logging:
      options:
        max-file: '1'
        max-size: '16k'
    depends_on:
      mysql:
        condition: service_healthy
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 384M
    networks:
      nacos:
        ipv4_address: 182.100.100.100
  nacos1:
    container_name: nacos1
    image: lhstack/nacos:1.4.4
    restart: always
    ports:
      - '8849:8848'
      - '9849:9848'
    environment:
      MYSQL_SERVICE_DB_PARAM: "allowPublicKeyRetrieval=true&rewriteBatchedStatements=true&characterEncoding=UTF8&serverTimezone=UTC&connectTimeout=10000&socketTimeout=30000&autoReconnect=true&useSSL=false"
      TZ: Asia/Shanghai
      NACOS_SERVERS: "182.100.100.101 182.100.100.100"
      MYSQL_SERVICE_HOST: '182.100.36.36'
      MYSQL_SERVICE_USER: 'root'
      MYSQL_SERVICE_PASSWORD: '123456'
      MYSQL_SERVICE_DB_NAME: 'nacos'
      SPRING_DATASOURCE_PLATFORM: 'mysql'
      JVM_XMX: '384m'
      JVM_XMS: '384m'
      JVM_XMN: '192m'
      JVM_MS: '128m'
      JVM_MMS: '128m'
    logging:
      options:
        max-file: '1'
        max-size: '16k'
    depends_on:
      mysql:
        condition: service_healthy
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 384M
    networks:
      nacos:
        ipv4_address: 182.100.100.101
networks:
  nacos:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: 182.100.0.0/16

启动集群：

shell
docker-compose up -d