freemanlau/nacos

Nacos Docker镜像文档

镜像概述

本镜像为Nacos服务的Docker化部署版本，支持arm64和amd64两种架构，基于官方Nacos镜像制作，功能和使用方式与官方镜像完全一致。Nacos是一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。

核心功能与特性

• 多架构支持：同时支持arm64和amd64架构，可在不同硬件平台（如x86服务器和ARM服务器）上部署
• 功能一致性：与官方Nacos镜像功能完全一致，包含服务发现、配置管理、动态配置、服务元数据管理等核心功能
• 使用兼容性：保持与官方镜像相同的启动方式、配置参数和目录结构，降低迁移和使用成本

使用场景与适用范围

• 微服务架构中的服务注册与发现
• 分布式系统的配置集中管理与动态更新
• 需要在arm64和amd64混合架构环境中部署Nacos的场景
• 开发、测试和生产环境的Nacos服务快速部署

使用方法与配置说明

基本使用

本镜像使用方式与官方Nacos镜像完全一致，可直接参考官方文档进行操作。

单机模式运行

bash
docker run -d -p 8848:8848 --name nacos-server \
  -e MODE=standalone \
  your-image-name:tag

集群模式运行（需配置数据库）

bash
docker run -d -p 8848:8848 --name nacos-server \
  -e MODE=cluster \
  -e SPRING_DATASOURCE_PLATFORM=mysql \
  -e MYSQL_SERVICE_HOST=mysql-host \
  -e MYSQL_SERVICE_PORT=3306 \
  -e MYSQL_SERVICE_DB_NAME=nacos \
  -e MYSQL_SERVICE_USER=root \
  -e MYSQL_SERVICE_PASSWORD=password \
  your-image-name:tag

docker-compose部署示例

yaml
version: '3'
services:
  nacos:
    image: your-image-name:tag
    container_name: nacos-server
    ports:
      - "8848:8848"
      - "9848:9848"
      - "9849:9849"
    environment:
      - MODE=standalone
      - JVM_XMS=512m
      - JVM_XMX=512m
      - JVM_XMN=256m
    volumes:
      - ./nacos/logs:/home/nacos/logs
    restart: always

环境变量配置

支持官方Nacos镜像的所有环境变量配置，常用配置参数如下：

注意事项

• 首次启动后，可通过http://localhost:8848/nacos访问Web控制台（默认用户名/密码：nacos/nacos）
• 生产环境建议使用集群模式，并配置外部数据库以确保数据持久化
• 如需自定义配置，可通过挂载配置文件到容器内/home/nacos/conf目录实现
• 详细使用说明请参考Nacos官方Docker文档