hsl-cloud/script/config/nacos/README.md

Nacos 配置说明

本目录存放 seewis-cloud-plus 各服务的 Nacos 配置种子文件，并提供一键导入脚本（支持 dev / prod 双命名空间）。

文件清单

文件	说明	导入前通常需要修改
application-common.yml	所有服务共享的公共配置	spring.data.redis（host/port/password）、spring.rabbitmq、sa-token.jwt-secret-key（务必换成自己的随机串）、监控账号（nacos discovery metadata）
datasource.yml	数据库连接	各库 jdbc 地址/账号/密码（system / job / ai / workflow）
seewis-auth.yml	认证服务	security.captcha（验证码开关与类型）、security.xcx.apps（小程序 appid/密钥兜底配置，正式建议用参数管理 sys.account.xcxApps）、justauth（三方登录密钥）
seewis-gateway.yml	网关	security.ignore.whites（放行白名单）、路由规则
seewis-system.yml	系统模块	spring.liquibase.enabled：全新空库首次启动改为 true 初始化表结构和种子数据，初始化完成后建议改回 false
seewis-resource.yml / seewis-job.yml / seewis-workflow.yml / seewis-gen.yml / seewis-ai.yml / seewis-snailai-server.yml / seewis-snailjob-server.yml	对应模块	各自的 liquibase 开关、第三方参数，按需修改
seewis-monitor.yml	SpringBoot Admin 监控	监控服务账号密码，按需修改
seata-server.properties	Seata 服务端配置	脚本只导入 *.yml，此文件需手动在 Nacos 控制台创建（dataId seata-server.properties，group DEFAULT_GROUP，类型 properties）

注意：导入会覆盖服务器上 dataId 相同的同名配置（按 dataId 全量覆盖），服务器上已有个性化修改的配置请先备份或在控制台核对差异。

命名空间

• 默认导入到 dev 和 prod 两个命名空间，不会导入 public。
• 需要先在 Nacos 控制台创建命名空间，命名空间 ID 必须为 dev / prod；如使用其他 ID，通过环境变量 NACOS_NAMESPACES 指定（如 NACOS_NAMESPACES=dev-id-1,prod-id-2）。
• 服务的注册与配置拉取必须使用相同命名空间：各服务 application.yml / maven profile 中的 spring.cloud.nacos.discovery.namespace 与 spring.cloud.nacos.config.namespace 需与目标命名空间 ID 一致，否则服务找不到配置。

导入脚本

脚本与本目录的 yml 放在一起，自动导入当前目录下所有 *.yml。

Linux / macOS

chmod +x import-nacos-config.sh
./import-nacos-config.sh

Windows（PowerShell 5.1+，Win10 1803+ 自带 curl.exe）

powershell -ExecutionPolicy Bypass -File .\import-nacos-config.ps1

环境变量（两个脚本通用）

变量	说明	默认值
NACOS_ADDR	Nacos 地址	http://localhost:8848
NACOS_USER	用户名	nacos
NACOS_PASS	密码	未设置时交互输入（避免密码进 shell 历史）
NACOS_NAMESPACES	目标命名空间 ID，逗号分隔	dev,prod

示例：只导入到 dev，指向本地 Nacos：

NACOS_ADDR=http://127.0.0.1:8848 NACOS_NAMESPACES=dev ./import-nacos-config.sh

脚本使用 Nacos 3.x 的 v3 admin API（v1/v2 写接口在 3.x 已移除）；密码输入优先走环境变量 NACOS_PASS，否则交互式输入。