minstonehub/nacos-server Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

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

　　镜像内置了多数据库初始化脚本, 通过下面的命令将镜像中的配置文件和数据库脚本拷贝到 /path/to/nacos 目录中!

注意: 请将本文档中的 /path/to/nacos 修改为你本地持久化 nacos 数据的绝对路径

sh
# 通过命令复制出镜像中的配置文件和数据库脚本
docker run --rm --entrypoint "" -v "/path/to/nacos:/data" minstonehub/nacos-server:2.2.3 cp -r /home/nacos/conf/ /data/

文件描述

　　通过下面的命令可以查看本次部署中使用到的文件:

sh
# 进入 /path/to/nacos/conf 目录中
cd /path/to/nacos/conf && ls
# 配置文件
application.properties
# 所有的配置项目和描述
application.properties.example
# 日志配置
nacos-logback.xml
# 内置的 derby 数据库脚本
derby-schema.sql
# MySQL 脚本
mysql-schema.sql
# 达梦脚本
nacos-dm.sql
# 翰高脚本
nacos-highgo.sql
# 人大金仓脚本
nacos-kingbase.sql
# Oracle 脚本
nacos-oracle.sql
# 神州通用脚本
nacos-oscar.sql

多数据源部署

　　镜像内置多数据源插件, 部署的方法如下:

基础设施配置

• 创建对应的数据库
• 将 /path/to/nacos/conf/nacos-*.sql 导入相应的数据库脚本到目标数据库中

注意: 由于人大金仓和 Oracle 默认将空字符串设置为 NULL, 导致默认的命名空间失效, 需要参考下面的配置进行修改!

人大金仓数据库配置

　　当前版本 nacos 默认的命名空间为空字符串, 人大金仓数据库存储时会默认将空字符串设置为 NULL, 导致默认的命名空间失效, 处理方法如下:

• 修改人大金仓数据库配置 kdb/data/kingbase.conf
• 查找 ora_input_emptystr_isnull 项配置
• 如果配置为 true 则修改为 false, 如果没有配置, 需要新增 ora_input_emptystr_isnull = false
• 重启数据库

Oracle 数据库配置

　　当前版本 nacos 默认的命名空间为空字符串, Oracle 数据库存储时会默认将空字符串设置为 NULL, 导致默认的命名空间失效, 处理方法如下:

• 修改 Oracle 数据库配置 init<数据库实例名称>.ora
• 查找 ora_input_emptystr_isnull 项配置
• 如果配置为 true 则修改为 false, 如果没有配置, 需要新增 ora_input_emptystr_isnull = false
• 重启数据库

配置和数据的挂载路径

• 需要自定义配置时配置文件挂载路径:
  • nacos/conf/application.properties: 应用配置
  • nacos/conf/cluster.properties: 集群配置
• 可选的挂载文件夹路径:
  • /home/nacos/data: nacos 的数据目录
  • /home/nacos/logs: nacos 的日志目录

暴露端口

注意: 使用 VIP/nginx 请求时, 需要配置成 TCP 转发, 不能配置 http2 转发, 否则连接会被 nginx 断开! 9849 和 7848 端口为服务端之间的通信端口, 请勿暴露到外部网络环境和客户端侧!

部署模式

　　使用环境变量 MODE 配置, 可选配置如下:

集群部署配置

　　集群部署可以通过指定 NACOS_SERVERS 参数来配置, 填写的集群地址需要符合如下格式

p1:port1空格ip2:port2空格ip3:port3

　　也可以通过挂载配置文件 nacos/conf/cluster.properties 来指定服务, 参考如下的配置:

conf
#it is ip
#example
192.168.16.101:8847
192.168.16.102
192.168.16.103

　　使用环境变量 PREFER_HOST_MODE 来指定 nacos 注册节点时使用 IP 或者主机名, 可以在集群管理 -> 节点列表中查看, 具体值如下:

服务端鉴权

　　nacos-server 提供简单的鉴权实现, 可以通过下面的环境变量配置设置客户端鉴权:

　　开启客户端鉴权后, 需要配置客户端使用 nacos 用户登录, 可以参考下面的示例:

yaml
nacos:
  config:
    server-addr: 127.0.0.1:8848
    # 使用自定义身份的 key 和 value, 或者是有权限的 nacos 账号
    username: 2222
    password: 2xxx

多数据源参数配置

　　外置数据库配置的参数, 可以通过以下设置环境变量值或者修改配置文件传值:

其他参数配置

　　更多参数请参考 nacos 官网

使用 docker run

部署单节点的 nacos 并使用内嵌数据源:

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

部署单节点的 nacos 并使用外置数据源:

• 人大金仓

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

部署单节点的 nacos 并使用内嵌数据源:

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

部署单节点的 nacos 并使用外置数据源:

• 人大金仓

yaml
nacos:
  image: minstonehub/nacos-server:2.2.3
  container_name: nacos
  environment:
    - MODE=standalone
    - PREFER_HOST_MODE=hostname
    - SPRING_DATASOURCE_PLATFORM=base
    - DATASOURCE_URL="jdbc:kingbase8://IP:PORT/DATABASE?useUnicode=true&characterEncoding=utf-8"
    - DATASOURCE_USER=USER
    - DATASOURCE_PASSWORD=PASSWORD
    - DATASOURCE_DRIVER=com.kingbase8.Driver
  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

• 达梦

yaml
nacos:
  image: minstonehub/nacos-server:2.2.3
  container_name: nacos
  environment:
    - MODE=standalone
    - PREFER_HOST_MODE=hostname
    - SPRING_DATASOURCE_PLATFORM=base
    - DATASOURCE_URL="jdbc:dm://IP:PORT/DATABASE"
    - DATASOURCE_USER=USER
    - DATASOURCE_PASSWORD=PASSWORD
    - DATASOURCE_DRIVER=dm.jdbc.driver.DmDriver
  volumes:
    - /path/to/nacos/data:/home/nacos/data
    - /path/to/nacos/logs:/home/nacos/logs
  ports:
    - 8848:8848
    - 9848:9848
  networks:
    - myHost

• Oracle

yaml
nacos:
  image: minstonehub/nacos-server:2.2.3
  container_name: nacos
  environment:
    - MODE=standalone
    - PREFER_HOST_MODE=hostname
    - SPRING_DATASOURCE_PLATFORM=base
    - DATASOURCE_URL="jdbc:oracle:thin://IP:PORT/DATABASE"
    - DATASOURCE_USER=USER
    - DATASOURCE_PASSWORD=PASSWORD
    - DATASOURCE_DRIVER=oracle.jdbc.OracleDriver
  volumes:
    - /path/to/nacos/data:/home/nacos/data
    - /path/to/nacos/logs:/home/nacos/logs
  ports:
    - 8848:8848
    - 9848:9848
  networks:
    - myHost

使用自定义配置文件

　　可以通过自定义配置文件进行数据库参数配置, 或者新增其他配置:

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

　　使用 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
    - /path/to/nacos/conf/application.properties:/home/nacos/conf/application.properties
  ports:
    - 8848:8848
    - 9848:9848
  networks:
    - myHost

错误排查

　　启动错误时需要查看日志 /path/to/nacos/logs/config-fatal.log 进行排查!

• 出现编码问题需要定义环境变量 JAVA_OPT="-Dfile.encoding=UTF8" 再启动 nacos