# Nacos集群MySQL替代信创适配解决方案

# 1. 文档概述

# 1.1 文档目的

本文档旨在提供Nacos集群在信创环境下的数据库替代方案，解决因MySQL非信创组件导致的合规性问题，确保Nacos集群在信创环境下稳定、合规运行。安装包下载地址：https://frontend-project-dev.oss-cn-beijing.aliyuncs.com/software/nacos-server-2.4.2-xinchuang.zip

# 1.2 适用范围

本方案适用于所有采用Nacos集群架构且需通过信创审核的项目，涵盖方案评估、部署实施、版本升级及日常运维全流程。

# 2. 问题背景

# 2.1 现状分析

当前公司多个项目采用"Nacos集群+MySQL数据库"架构作为服务发现与配置管理的核心组件。由于MySQL属于第三方非国产组件，未纳入信创适配清单，无法满足客户信创审核要求，需对数据库组件进行国产化替换改造。

# 2.2 核心痛点

合规风险：默认架构依赖非信创组件MySQL，导致项目无法通过信创审核，影响项目交付与验收
兼容性挑战：直接替换数据库可能存在Nacos与国产数据库的兼容性问题，需确保替换后集群功能完整性
技术风险：数据迁移、配置调整过程中可能出现数据丢失或服务中断风险

# 2.3 目标要求

合规性：替换后的Nacos集群架构完全符合信创要求，核心组件具备信创资质认证
功能性：替换后Nacos集群的服务发现、配置管理等核心功能保持完整，性能不低于原架构
稳定性：部署替换过程可控，运行稳定可靠，支持日常维护与版本平滑升级

# 3. 解决方案

# 3.1 方案概述

针对信创审核要求，本方案通过对Nacos源码进行编译改造，增加对达梦数据库(DM)和人大金仓数据库(KingbaseES)的原生支持，替换原MySQL数据库，实现基于国产数据库的Nacos集群存储层构建，保障核心组件自主可控。

# 3.2 技术架构

支持的国产数据库：达梦DM 8、人大金仓KingbaseES（MySQL兼容模式）
兼容性保障：保持对原生MySQL和Derby的支持，确保方案灵活性
改造内容：数据库初始化脚本适配、JDBC驱动集成、配置文件扩展

# 4. 部署实施指南

# 4.1 前置准备

数据备份（必须执行）

备份Nacos配置中心所有配置数据
备份Nacos配置文件（cluster.conf、application.properties等）
对原MySQL数据库进行全量备份，确保数据可回滚

环境准备

确认信创环境已部署目标国产数据库（达梦或金仓）
准备编译后的Nacos安装包（已集成国产数据库支持）如何获取编译后的Nacos包 - 通过发起技术服务支持申请单获取
确认网络连通性及端口开放情况

# 4.2 部署步骤

# 4.2.1 目录结构说明

改造后的Nacos目录结构如下：

nacos/
├── bin/                          # 启动脚本目录
├── conf/                         # 配置文件目录
│   ├── application.properties    # Nacos主配置文件
│   ├── cluster.conf              # 集群节点配置文件
│   ├── derby-schema.sql          # Derby内嵌数据库初始化脚本
│   ├── dm-schema.sql             # 达梦数据库初始化脚本
│   ├── kingbase8-schema.sql      # 金仓数据库初始化脚本
│   └── mysql-schema.sql          # MySQL数据库初始化脚本
└── target/
    └── nacos-server.jar          # Nacos主程序

# 4.2.2 数据库初始化

步骤1：创建数据库

-- 达梦示例
CREATE SCHEMA NACOS;

-- 金仓示例
CREATE DATABASE nacos;

步骤2：执行初始化脚本

达梦：执行 dm-schema.sql
金仓：执行 kingbase8-schema.sql

# 4.2.3 配置文件修改

根据选用的国产数据库类型，修改 application.properties 文件：

人大金仓配置示例

# 人大金仓数据库配置
spring.datasource.platform=kingbase8
db.num=1
db.url.0=jdbc:kingbase8://116.63.9.20:54322/nacos
db.user=nacos
db.password=Seeyonopt@2025
db.pool.config.driver-class-name=com.kingbase8.Driver

达梦数据库配置示例

# 达梦数据库配置
db.pool.config.driverClassName=dm.jdbc.driver.DmDriver
db.num=1
spring.sql.init.platform=dm

# 单机模式
db.url.0=jdbc:dm://localhost:30236?schema=NACOS
db.user.0=SYSDBA
db.password.0=SYSDBA001

# 主备集群模式（可选）
# db.url.0=jdbc:dm://dwc?dwc=10.184.169.85:5236,10.184.169.76:5236&TIME_ZONE=(+480)&LOGIN_MODE=1&LANGUAGE=(cn)

MySQL配置示例（参考）

# MySQL数据库配置（仅供对比参考）
spring.datasource.platform=mysql
spring.sql.init.platform=mysql
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user.0=nacos
db.password.0=nacos

集群配置（cluster.conf）

# 配置集群节点IP和端口
192.168.1.101:8848
192.168.1.102:8848
192.168.1.103:8848

参考资料：Nacos集群部署详细步骤可参考 CSDN博客文章 (opens new window)

# 4.2.4 集群启动与验证

步骤1：启动集群

# 依次启动各节点
sh bin/startup.sh

步骤2：检查启动日志

# 查看启动日志，确认无数据库连接错误
tail -f logs/start.out

步骤3：数据迁移

若需迁移原有配置数据，可通过Nacos控制台导出原配置，在新集群中导入
服务注册信息无需迁移，由各微服务重新注册即可

步骤4：功能验证

访问Nacos控制台（http://节点IP:8848/nacos）
验证服务注册发现功能
验证配置管理功能
验证集群节点状态
进行性能基准测试

# 4.3 回滚方案

若部署过程中出现严重问题（数据丢失、集群无法启动、业务中断），立即执行回滚：

回滚步骤

停止所有Nacos节点服务
恢复原Nacos程序文件和配置文件
恢复MySQL数据库备份数据
重启原Nacos集群
验证业务恢复正常
分析问题原因，优化方案后重新实施

# 5. 运维管理指南

# 5.1 版本升级

升级前准备

确认目标Nacos版本与国产数据库的兼容性
全量备份配置文件和数据库数据
制定升级计划和回滚预案
在测试环境验证升级流程

升级流程

下载目标版本Nacos安装包（已集成国产数据库支持）
停止集群节点服务（建议逐个节点滚动升级）
替换程序文件，保留配置文件
检查数据库表结构变更，执行升级脚本（如有）
启动节点并验证功能
逐个完成所有节点升级

升级后验证

验证核心功能完整性
检查数据一致性
进行性能对比测试
观察运行日志，确保无异常

# 5.2 集群调整

说明：集群调整操作与原生Nacos保持一致，无特殊差异。

集群扩容

准备新节点服务器
部署Nacos程序，同步现有节点配置文件
确保数据库连接信息一致
更新所有节点的 cluster.conf 文件
启动新节点
通过控制台确认节点正常加入集群

集群缩容

确认待移除节点无关键服务注册
停止目标节点服务
从所有节点的 cluster.conf 中删除该节点信息
重启其他节点使配置生效
验证集群状态正常

数据库扩容

若国产数据库性能不足，可根据数据库官方方案进行扩容
- 达梦：支持主备架构、读写分离
- 金仓：支持主从复制、集群部署
扩容后更新Nacos数据库连接配置（如配置读写分离地址）
重启Nacos节点使配置生效

# 5.3 日常运维

说明：日常运维操作与原生Nacos保持一致，无特殊差异。

数据库维护

备份策略：建议每日全量备份+实时增量备份
监控指标：连接数、CPU使用率、内存使用率、磁盘空间、慢查询日志
性能优化：根据业务负载调整数据库参数（连接池大小、缓存配置等）
日志管理：定期归档或清理数据库日志文件

Nacos集群维护

监控指标：各节点内存、CPU、磁盘使用率、服务注册数、配置推送延迟
日志管理：定期清理 logs/ 目录下的历史日志文件
配置检查：定期检查各节点配置文件一致性
健康检查：通过API或控制台定期检查集群健康状态

故障排查

常见问题
- 数据库连接失败：检查网络连通性、账号密码、连接池配置
- 服务注册失败：检查客户端配置、网络策略、Nacos日志
- 配置同步异常：检查集群节点通信、数据库数据一致性
排查流程
1. 查看Nacos日志（logs/nacos.log）
2. 检查数据库连接状态
3. 验证网络连通性
4. 检查配置文件正确性
5. 必要时重启节点或回滚操作
日志留存：保留故障日志，定期总结优化，建立知识库

# 6. 附录

# 6.1 常见问题FAQ

Q1：是否支持从MySQL直接迁移到国产数据库？
A：支持。可通过数据导出导入方式迁移配置数据，服务注册信息由各微服务重新注册即可。

Q2：性能是否会受到影响？
A：在合理配置下，国产数据库性能与MySQL相当。建议根据业务负载进行性能测试和参数调优。

Q3：是否支持混合部署（部分节点MySQL，部分节点国产数据库）？
A：不支持。集群所有节点必须使用相同类型的数据库。

# 6.2 联系支持

如在部署或运维过程中遇到问题，请联系技术支持团队获取帮助。

编撰人：liujun

← V8移动端外网访问，PC端只能内网访问解决方案添加http头信息 →