minstonehub/nacos-server

nacos-server 多数据源镜像文档

镜像概述

本镜像基于nacos-server 2.2.3版本构建，内置多数据库初始化脚本及多数据源插件，支持内嵌Derby数据库及MySQL、达梦、人大金仓、Oracle、翰高、神州通用等外置数据源。提供单服务(standalone)和集群(cluster)两种部署模式，适用于各类微服务架构中的服务发现与配置管理场景。

核心功能与特性

• 多数据源支持：内置Derby、MySQL、达梦、人大金仓、Oracle等数据库脚本及驱动
• 灵活部署模式：支持单服务独立部署和多节点集群部署
• 完整配置管理：提供应用配置、集群配置、日志配置等完整配置文件
• 安全鉴权机制：支持服务端鉴权配置，保障服务访问安全
• 数据持久化：支持数据目录和日志目录挂载，确保数据持久化存储

获取配置文件和数据库脚本

镜像内置配置文件和多数据库初始化脚本，可通过以下命令将其拷贝到本地持久化目录（请将/path/to/nacos替换为实际绝对路径）：

sh
docker run --rm --entrypoint "" -v "/path/to/nacos:/data" minstonehub/nacos-server:2.2.3 cp -r /home/nacos/conf/ /data/

文件描述

进入/path/to/nacos/conf目录可查看以下关键文件：

sh
cd /path/to/nacos/conf && ls

• application.properties：应用配置文件
• application.properties.example：配置项及描述示例
• nacos-logback.xml：日志配置文件
• 数据库脚本：
  • derby-schema.sql：内嵌Derby数据库脚本
  • mysql-schema.sql：MySQL数据库脚本
  • nacos-dm.sql：达梦数据库脚本
  • nacos-highgo.sql：翰高数据库脚本
  • nacos-kingbase.sql：人大金仓数据库脚本
  • nacos-oracle.sql：Oracle数据库脚本
  • nacos-oscar.sql：神州通用数据库脚本

多数据源部署

基础设施配置

1. 数据库准备：

   • 创建目标数据库实例
   • 导入对应数据库脚本（/path/to/nacos/conf/nacos-*.sql）

2. 特殊数据库配置：

   • 人大金仓数据库： 因默认将空字符串设为NULL导致默认命名空间失效，需修改配置：

     1. 编辑kdb/data/kingbase.conf
     2. 查找或新增ora_input_emptystr_isnull = false
     3. 重启数据库

   • Oracle数据库： 因默认将空字符串设为NULL导致默认命名空间失效，需修改配置：

     1. 编辑init<数据库实例名称>.ora
     2. 查找或新增ora_input_emptystr_isnull = false
     3. 重启数据库

挂载路径

暴露端口

注意：使用VIP/nginx转发时需配置TCP转发，不可用http2转发；9849和7848端口为服务端内部通信端口，禁止暴露到外部网络。

部署模式

通过环境变量MODE配置：

集群部署配置

方式一：环境变量配置

通过NACOS_SERVERS参数指定集群节点，格式：ip1:port1 ip2:port2 ip3:port3

方式二：配置文件挂载

挂载cluster.properties文件，格式示例：

conf
# 集群节点列表（IP[:端口]，默认端口8848）
192.168.16.101:8847
192.168.16.102
192.168.16.103

节点注册模式

通过PREFER_HOST_MODE指定节点注册时使用IP或主机名：

服务端鉴权

通过环境变量配置客户端鉴权：

客户端配置示例：

yaml
nacos:
  config:
    server-addr: 127.0.0.1:8848
    username: 2222  # 鉴权账号
    password: 2xxx  # 鉴权密码

多数据源参数配置

通过环境变量或配置文件设置外置数据源参数：

使用方法

使用docker run部署

单节点内嵌数据源

sh
docker run -d \
  --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  -e MODE=standalone \
  -e PREFER_HOST_MODE=hostname \
  minstonehub/nacos-server:2.2.3

单节点外置数据源

• 人大金仓

sh
docker run -d \
  --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  -e MODE=standalone \
  -e PREFER_HOST_MODE=hostname \
  -e NACOS_AUTH_IDENTITY_KEY=2222 \
  -e NACOS_AUTH_IDENTITY_VALUE=2xxx \
  -e NACOS_AUTH_TOKEN=SecretKey012345678901234567890123456789012345678901234567890123456789 \
  -e SPRING_DATASOURCE_PLATFORM=base \
  -e DATASOURCE_URL="jdbc:kingbase8://IP:PORT/DATABASE?useUnicode=true&characterEncoding=utf-8" \
  -e DATASOURCE_USER=USER \
  -e DATASOURCE_PASSWORD=PASSWORD \
  -e DATASOURCE_DRIVER=com.kingbase8.Driver \
  -v /path/to/nacos/data:/home/nacos/data \
  -v /path/to/nacos/logs:/home/nacos/logs \
  minstonehub/nacos-server:2.2.3

• MySQL

sh
docker run -d \
  --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  -e MODE=standalone \
  -e PREFER_HOST_MODE=hostname \
  -e SPRING_DATASOURCE_PLATFORM=mysql \
  -e DATASOURCE_URL="jdbc:mysql://IP:PORT/DATABASE?useUnicode=true&characterEncoding=utf8&useSSL=false" \
  -e DATASOURCE_USER=USER \
  -e DATASOURCE_PASSWORD=PASSWORD \
  -e DATASOURCE_DRIVER=com.mysql.jdbc.Driver \
  -v /path/to/nacos/data:/home/nacos/data \
  -v /path/to/nacos/logs:/home/nacos/logs \
  minstonehub/nacos-server:2.2.3

• 达梦

sh
docker run -d \
  --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  -e MODE=standalone \
  -e PREFER_HOST_MODE=hostname \
  -e SPRING_DATASOURCE_PLATFORM=base \
  -e DATASOURCE_URL="jdbc:dm://IP:PORT/DATABASE" \
  -e DATASOURCE_USER=USER \
  -e DATASOURCE_PASSWORD=PASSWORD \
  -e DATASOURCE_DRIVER=dm.jdbc.driver.DmDriver \
  -v /path/to/nacos/data:/home/nacos/data \
  -v /path/to/nacos/logs:/home/nacos/logs \
  minstonehub/nacos-server:2.2.3

• Oracle

sh
docker run -d \
  --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  -e MODE=standalone \
  -e PREFER_HOST_MODE=hostname \
  -e SPRING_DATASOURCE_PLATFORM=base \
  -e DATASOURCE_URL="jdbc:oracle:thin://IP:PORT/DATABASE" \
  -e DATASOURCE_USER=USER \
  -e DATASOURCE_PASSWORD=PASSWORD \
  -e DATASOURCE_DRIVER=oracle.jdbc.OracleDriver \
  -v /path/to/nacos/data:/home/nacos/data \
  -v /path/to/nacos/logs:/home/nacos/logs \
  minstonehub/nacos-server:2.2.3

使用docker-compose部署

单节点内嵌数据源

yaml
nacos:
  image: minstonehub/nacos-server:2.2.3
  container_name: nacos
  environment:
    - MODE=standalone
    - PREFER_HOST_MODE=hostname
  volumes:
    - /path/to/nacos/data:/home/nacos/data
    - /path/to/nacos/logs:/home/nacos/logs
  ports:
    - 8848:8848
    - 9848:9848
  networks:
    - myHost

单节点外置数据源（以MySQL为例）

yaml
nacos:
  image: minstonehub/nacos-server:2.2.3
  container_name: nacos
  environment:
    - MODE=standalone
    - PREFER_HOST_MODE=hostname
    - SPRING_DATASOURCE_PLATFORM=mysql
    - DATASOURCE_URL="jdbc:mysql://IP:PORT/DATABASE?useUnicode=true&characterEncoding=utf8&useSSL=false"
    - DATASOURCE_USER=USER
    - DATASOURCE_PASSWORD=PASSWORD
    - DATASOURCE_DRIVER=com.mysql.jdbc.Driver
  volumes:
    - /path/to/nacos/data:/home/nacos/data
    - /path/to/nacos/logs:/home/nacos/logs
  ports:
    - 8848:8848
    - 9848:9848
  networks:
    - myHost

自定义配置文件

通过挂载自定义application.properties配置数据库参数：

conf
# 单数据库配置
db.num=1
# 人大金仓数据库示例
db.url.0=jdbc:kingbase8://IP:PORT/DATABASE?useUnicode=true&characterEncoding=utf-8
db.user.0=USER
db.password.0=PASSWORD
# 数据库驱动配置
db.pool.config.driverClassName=com.kingbase8.Driver
db.pool.config.connectionTestQuery=SELECT 1

docker run挂载示例：

sh
docker run -d \
  --name nacos \
  -p 8848:8848 \
  -p 9848:9848 \
  -e MODE=standalone \
  -e PREFER_HOST_MODE=hostname \
  -v /path/to/nacos/data:/home/nacos/data \
  -v /path/to/nacos/logs:/home/nacos/logs \
  -v /path/to/nacos/conf/application.properties:/home/nacos/conf/application.properties \
  minstonehub/nacos-server:2.2.3

错误排查

• 日志位置：启动错误时查看/path/to/nacos/logs/config-fatal.log
• 编码问题：若出现编码错误，添加环境变量JAVA_OPT="-Dfile.encoding=UTF8"启动容器

更多配置详情请参考nacos官网