系统参数

本文整理 Nacos 3.3.x 常用服务端参数。主要来源是发行包中的 ${nacos.home}/conf/application.properties，并结合当前代码中的配置读取逻辑补充说明。

如果你正在部署生产集群，建议先阅读部署最佳实践，再回到本文确认具体参数。

配置放在哪里

Nacos Server 的主要配置文件是 ${nacos.home}/conf/application.properties。启动脚本会额外带上：

--spring.config.additional-location=file:${BASE_DIR}/conf/

同一个参数可以来自配置文件、JVM -D 参数或启动脚本。一般情况下，JVM 参数优先级高于配置文件。带 (-D) 标识的参数通常需要通过启动脚本或 JVM 参数设置。

基础启动参数

参数名	说明	默认值
`nacos.home(-D)`	Nacos 根目录。	安装目录
`nacos.standalone(-D)`	是否以单机模式启动。`startup.sh -m standalone` 会设置该参数。	`false`
`nacos.functionMode(-D)`	启动功能模式。`all` 表示启动全部可用模块；`config`、`naming` 分别只启动配置中心、服务发现；`microservice` 仅启动 Config 和 Naming，不加载 AI 模块；`ai` 启动 AI 及其依赖的 Config 和 Naming。	`all`
`nacos.deployment.type(-D)`	部署形态。启动脚本默认设置为 `merged`；独立控制台部署时会使用控制台相关配置。	`merged`
`nacos.server.main.port`	Nacos Server 主端口。	`8848`
`nacos.server.contextPath`	Nacos Server HTTP 上下文路径。	`/nacos`
`spring.config.additional-location`	额外配置文件路径。多个路径用逗号分隔。	`${nacos.home}/conf/`
`server.error.include-message`	Spring Boot 错误响应是否包含 message。	`ALWAYS`
`server.max-http-request-header-size`	HTTP 请求头大小上限，启动脚本默认设置。	`524288`

网络与节点地址

参数名	说明	默认值
`nacos.server.ip(-D)`	指定本机 IP。优先级高于自动探测和 `nacos.inetutils.ip-address`。	空
`nacos.inetutils.ip-address`	指定本机 IP，通常用于多网卡或容器网络。	空
`nacos.inetutils.prefer-hostname-over-ip`	节点地址优先使用 hostname。开启后，`cluster.conf` 也应使用可解析的 hostname。	`false`
`nacos.remote.grpc.listen.ip(-D)`	gRPC 端口监听 IP。未设置时通常监听所有网卡。	空

数据库

Nacos 通过数据源方言插件支持 Derby、MySQL、PostgreSQL、Oracle 和自定义数据库类型。更多安装方式、社区插件和 Oracle 版本要求见多数据源插件。

参数名	说明	默认值
`nacos.plugin.datasource-dialect.type`	启动时选择 `derby`、`mysql`、`postgresql`、`oracle` 或自定义方言。	单机/embedded 为 `derby`，普通集群为 `mysql`
`nacos.plugin.datasource.db.num`	外置数据库连接地址数量。	`0`
`nacos.plugin.datasource.db.url.{index}`	逐下标 JDBC URL。	空
`nacos.plugin.datasource.db.user[.{index}]`	公共或逐连接用户名。	空
`nacos.plugin.datasource.db.password[.{index}]`	公共或逐连接密码。	空
`nacos.plugin.datasource.db.pool.config.*`	HikariCP 参数；稳定键使用 kebab-case，例如 `maximum-pool-size`。	各项默认值见数据源插件文档
`nacos.plugin.datasource.db.pool.config.driver-class-name`	显式 JDBC 驱动类，优先于历史 `db.pool.config.driverClassName`；未配置时读取所选方言的默认驱动。	方言默认值；未提供时为 `com.mysql.cj.jdbc.Driver`
`nacos.plugin.datasource.db.query-timeout`	JDBC query timeout，单位秒。	`3`
`nacos.plugin.datasource.log.enabled`	是否输出数据源插件相关日志。	`true`

Web 与控制台

Nacos 3.x 默认将 Server 和 Console 分成两个端口。Server API 默认是 8848，新控制台默认是 8080。控制台使用方式见控制台手册。

参数名	说明	默认值
`nacos.console.port`	控制台端口。	`8080`
`nacos.console.contextPath`	控制台上下文路径。	空
`nacos.console.remote.server.context-path`	独立控制台访问远端 Nacos Server 时使用的 Server 上下文路径。	`/nacos`
`nacos.console.ui.enabled`	是否启用控制台 UI。	`true`
`nacos.console.ui.default`	默认控制台 UI。可选 `next` 或 `legacy`。	`next`
`spring.servlet.multipart.max-file-size`	控制台上传单文件大小上限，例如 Skill zip。	`10MB`
`spring.servlet.multipart.max-request-size`	控制台上传请求总大小上限。	`10MB`
`server.servlet.encoding.charset`	Servlet 编码。	`UTF-8`

控制台 CORS

参数名	说明	默认值
`nacos.console.cors.allow-credentials`	是否允许携带 Cookie、Authorization header、TLS client certificate 等凭据。	`true`
`nacos.console.cors.allowed-headers`	允许的请求头。留空表示允许所有请求头。	空
`nacos.console.cors.max-age`	CORS 预检请求缓存时间，单位秒。	`18000`
`nacos.console.cors.allowed-methods`	允许的 HTTP 方法。留空表示允许所有方法。	空
`nacos.console.cors.allowed-origins`	允许的来源。留空表示允许所有来源模式。	空

访问日志与监控

监控指标暴露和告警建议见监控手册。

参数名	说明	默认值
`server.tomcat.accesslog.enabled`	是否开启访问日志。	`true`
`server.tomcat.accesslog.max-days`	访问日志保留天数。	`30`
`server.tomcat.accesslog.pattern`	访问日志格式。	发行包默认格式
`server.tomcat.basedir`	Tomcat 工作目录和访问日志基准目录。	`file:.`
`management.endpoints.web.exposure.include`	Actuator 暴露的 endpoint。开启 Prometheus 指标时加入 `prometheus`。	空
`management.metrics.export.elastic.enabled`	是否启用 Elastic metrics exporter。	`false`
`management.metrics.export.influx.enabled`	是否启用 Influx metrics exporter。	`false`
`nacos.core.monitor.topn.enabled`	是否开启 TopN 监控统计。	`true`
`nacos.core.monitor.topn.count`	TopN 统计数量。	`10`
`nacos.core.monitor.topn.internalMs`	TopN 统计周期，单位毫秒。	`60000`

集群成员发现

参数名	说明	默认值
`nacos.member.list(-D)`	集群成员列表。启动脚本 `-c` 参数会写入该 JVM 参数；当 `cluster.conf` 不存在时可使用。	空
`nacos.member-change-event.queue.size`	集群成员变更事件队列大小。	`128`
`nacos.core.member.lookup.type`	成员发现方式。可选 `file` 或 `address-server`。	`file`
`nacos.core.address-server.retry`	地址服务器初始化重试次数。	`5`
`address.server.domain`	地址服务器域名。	`jmenv.tbsite.net`
`address.server.port`	地址服务器端口。	`8080`
`address.server.url`	地址服务器请求路径。	`/nacos/serverlist`
`nacos.core.member.meta.site`	节点站点元数据。	空
`nacos.core.member.meta.adweight`	节点权重元数据。	空
`nacos.core.member.meta.weight`	节点权重元数据。	空

gRPC

参数名	说明	默认值
`nacos.remote.server.grpc.sdk.max-inbound-message-size`	SDK gRPC 请求最大接收大小，单位 byte。	`10485760`
`nacos.remote.server.grpc.sdk.keep-alive-time`	SDK gRPC keepalive 间隔，单位毫秒。	`7200000`
`nacos.remote.server.grpc.sdk.keep-alive-timeout`	SDK gRPC keepalive 超时，单位毫秒。	`20000`
`nacos.remote.server.grpc.sdk.permit-keep-alive-time`	允许客户端配置的最小 keepalive 间隔，单位毫秒。	`300000`
`nacos.remote.server.grpc.cluster.max-inbound-message-size`	集群间 gRPC 请求最大接收大小，单位 byte。	`10485760`
`nacos.remote.server.grpc.cluster.keep-alive-time`	集群间 gRPC keepalive 间隔，单位毫秒。	`7200000`
`nacos.remote.server.grpc.cluster.keep-alive-timeout`	集群间 gRPC keepalive 超时，单位毫秒。	`20000`
`nacos.remote.server.grpc.cluster.permit-keep-alive-time`	集群间 gRPC 允许的最小 keepalive 间隔，单位毫秒。	`300000`
`remote.executor.times.of.processors(-D)`	服务端请求处理线程数相对 CPU 核数的倍数。	`16`
`remote.executor.queue.size(-D)`	服务端请求处理线程池队列大小。	`16384`

Distro 与 Raft

Distro 和 Raft 是 Nacos 内部一致性协议参数。除非已经定位到协议层瓶颈或由维护者建议，生产环境不建议随意调整。

Distro

参数名	说明	默认值
`nacos.core.protocol.distro.data.sync.delayMs`	数据同步延迟，单位毫秒。相同数据在延迟窗口内会合并同步。	`1000`
`nacos.core.protocol.distro.data.sync.timeoutMs`	单次数据同步超时，单位毫秒。	`3000`
`nacos.core.protocol.distro.data.sync.retryDelayMs`	同步失败后的重试延迟，单位毫秒。	`3000`
`nacos.core.protocol.distro.data.verify.intervalMs`	已同步数据校验间隔，单位毫秒。	`5000`
`nacos.core.protocol.distro.data.verify.timeoutMs`	单次数据校验超时，单位毫秒。	`3000`
`nacos.core.protocol.distro.data.load.retryDelayMs`	启动加载快照失败后的重试延迟，单位毫秒。	`30000`

Raft

Raft 参数通过 nacos.core.protocol.raft.data.* 配置。data 是当前代码中 RaftConfig 的配置映射字段，不应省略。

参数名	说明	默认值
`nacos.core.protocol.raft.data.election_timeout_ms`	选举超时时间，单位毫秒。	`5000`
`nacos.core.protocol.raft.data.snapshot_interval_secs`	快照执行周期，单位秒。	`1800`
`nacos.core.protocol.raft.data.core_thread_num`	Raft 内部工作线程数。	`8`
`nacos.core.protocol.raft.data.cli_service_thread_num`	Raft 业务请求处理线程数。	`4`
`nacos.core.protocol.raft.data.read_index_type`	线性读策略。	`ReadOnlySafe`
`nacos.core.protocol.raft.data.rpc_request_timeout_ms`	Raft RPC 请求超时，单位毫秒。	`5000`
`nacos.core.protocol.raft.data.max_byte_count_per_rpc`	单次 snapshot copy RPC 最大字节数。	`131072`
`nacos.core.protocol.raft.data.max_entries_size`	Leader 向 Follower 单次发送的最大日志条数。	`1024`
`nacos.core.protocol.raft.data.max_body_size`	发送日志的最大 body 大小。	`524288`
`nacos.core.protocol.raft.data.max_append_buffer_size`	日志写入缓冲区大小。	`262144`
`nacos.core.protocol.raft.data.max_election_delay_ms`	选举随机延迟最大值，单位毫秒。	`1000`
`nacos.core.protocol.raft.strict-mode`	Raft 启动校验严格模式。开启后，Raft 无法选举时 readiness 会返回失败。	`false`

配置中心

配置中心的日常使用见配置中心手册。

参数名	说明	默认值
`nacos.config.push.maxRetryTime`	配置变更推送最大重试次数。	`50`
`nacos.config.retention.days`	配置历史保留天数。	`30`
`nacos.config.search.max_capacity`	内容搜索任务队列容量上限。	`4`
`nacos.config.search.max_thread`	内容搜索线程数上限。	`2`
`nacos.config.search.wait_timeout`	内容搜索等待超时，单位毫秒。	`8000`
`nacos.config.derby.ops.enabled`	使用 Derby 时是否开启 Derby 运维接口。	`false`
`nacos.persistence.sql.derby.limit.enabled`	使用 Derby 时是否限制可执行 SQL 范围。	`true`
`nacos.config.cache.type`	配置缓存实现类型。	`nacos`
`nacos.config.history.clear.name`	配置历史清理实现名称。	`nacos`

服务发现

服务发现的日常使用见注册中心手册。

参数名	说明	默认值
`nacos.naming.data.warmup`	是否在启动时等待服务发现数据预热。开启后 readiness 可能在预热完成前失败。	`false`
`nacos.naming.expireInstance`	是否自动摘除过期临时实例。	`true`
`nacos.naming.empty-service.auto-clean`	是否自动清理空服务。	`true`
`nacos.naming.empty-service.clean.initial-delay-ms`	空服务清理首次延迟，单位毫秒。	`50000`
`nacos.naming.empty-service.clean.period-time-ms`	空服务清理周期，单位毫秒。	`30000`
`nacos.naming.clean.empty-service.interval`	空服务清理间隔，单位毫秒。	`60000`
`nacos.naming.clean.empty-service.expired-time`	空服务过期时间，单位毫秒。	`60000`
`nacos.naming.clean.expired-metadata.interval`	过期元数据清理间隔，单位毫秒。	`5000`
`nacos.naming.clean.expired-metadata.expired-time`	过期元数据保留时间，单位毫秒。	`60000`
`nacos.naming.client.expired.time`	临时 Client 数据过期时间，单位毫秒。	`180000`
`nacos.naming.push.pushTaskDelay`	服务推送延迟，单位毫秒。	`500`
`nacos.naming.push.pushTaskTimeout`	服务推送执行超时，单位毫秒。	`5000`
`nacos.naming.push.pushTaskRetryDelay`	服务推送失败重试延迟，单位毫秒。	`1000`
`nacos.naming.service.metadata.length`	服务元数据总长度限制。	`1024`

内置 DNS

Nacos 3.3.0 支持通过内置 DNS 查询服务实例的 A/AAAA/SRV 记录，默认关闭。修改以下配置后重启 Nacos Server 生效，接入和验证步骤见内置 DNS 服务发现。

参数名	说明	默认值
`nacos.naming.dns.enabled`	是否启用内置 DNS。	`false`
`nacos.naming.dns.bind-address`	UDP/TCP 监听地址。远程或容器网络访问需显式配置，并限制网络来源。	`127.0.0.1`
`nacos.naming.dns.port`	DNS 监听端口，同时使用 UDP 和 TCP，独立于 HTTP/gRPC 端口。	`5353`
`nacos.naming.dns.domain-suffix`	查询域名后缀，不带开头和末尾的点号。	`nacos`
`nacos.naming.dns.default-group`	查询域名未指定分组时使用的 Nacos 分组。	`DEFAULT_GROUP`
`nacos.naming.dns.namespace`	查询的命名空间 ID。查询 `public` 时应显式设置为 `public`。	空字符串
`nacos.naming.dns.ttl`	A/AAAA/SRV 记录的 TTL，单位秒。	`60`
`nacos.naming.dns.forward-enabled`	是否将非 Nacos 后缀查询转发到上游 DNS。	`false`
`nacos.naming.dns.forward-servers`	上游 DNS 地址列表。启用转发时配置可达的上游地址。	空列表
`nacos.naming.dns.forward-timeout-ms`	上游转发超时，单位毫秒。	`3000`
`nacos.naming.dns.forward-refresh-interval-seconds`	上游主机名重新解析间隔，单位秒，至少为 `10`。	`300`

DNS 查询不经过 HTTP API 鉴权，需单独通过网络访问控制限制调用来源。

参数校验

参数名	说明	默认值
`nacos.core.param.check.enabled`	是否开启服务端参数校验。规则见参数校验。	`true`
`nacos.core.param.check.checker`	参数校验器名称。默认使用内置校验器。	`default`

鉴权与可见性

鉴权配置应优先阅读权限校验和OIDC/OAuth2 认证。可见性插件见可见性插件。

参数名	说明	默认值
`nacos.plugin.auth.type`	启动时选择鉴权插件；`nacos.core.auth.system.type` 是历史 alias。	`nacos`
`nacos.core.auth.enabled`	是否开启通用鉴权系统和 Open API 鉴权，包括 Client/Open HTTP API 及 SDK/gRPC 请求。Nacos 3.3 起默认开启；显式 `false` 仅作为临时兼容覆盖。	`true`
`nacos.core.auth.admin.enabled`	是否开启 Admin API scope 鉴权；除 `/v3/admin/*` 外，也包括标记为 `ADMIN_API` 的插件自有端点。	`true`
`nacos.core.auth.console.enabled`	是否开启 `/v3/console/*` Console API 和登录鉴权。	`true`
`nacos.plugin.auth.nacos.caching.enabled`	是否缓存鉴权信息；`nacos.core.auth.caching.enabled` 是历史 alias。开启后权限变更会有短暂延迟。	`true`
`nacos.core.auth.server.identity.key`	Server 间内部请求的身份标识 key。Nacos 3.2.4 起也用于 JRaft 原生 gRPC；集群所有节点必须配置相同的非空值。	空
`nacos.core.auth.server.identity.value`	Server 间内部请求的身份标识 value。Nacos 3.2.4 起也用于 JRaft 原生 gRPC；集群所有节点必须配置相同的非空值。	空
`nacos.security.ignore.urls`	鉴权忽略路径。该参数属于历史兼容项，未来可能废弃。	发行包默认值
`nacos.plugin.auth.nacos.token.cache.enable`	默认鉴权插件 token 缓存；旧 `nacos.core.auth.plugin.nacos.token.cache.enable` 是 alias。	`false`
`nacos.plugin.auth.nacos.token.expire.seconds`	默认鉴权插件 token 过期秒数；`nacos.core.auth.plugin.nacos.token.expire.seconds` 是历史 alias。	`18000`
`nacos.plugin.auth.nacos.token.secret.key`	JWT 签名密钥，敏感且 RESTART；`nacos.core.auth.plugin.nacos.token.secret.key` 是历史 alias。	空
`nacos.plugin.auth.nacos.anonymous.ai.enabled`	是否允许显式 opt-in 的 AI 端点接受匿名读取；`nacos.core.auth.nacos.anonymous.ai.enabled` 是历史 alias。显式携带空或无效凭据不会回退为匿名。	`false`
`nacos.plugin.visibility.enabled`	是否开启可见性插件。	`true`
`nacos.plugin.visibility.type`	废弃的 `RESTART` selector，仍决定 AI 领域请求的实现，并在没有持久化状态时参与初始化实现状态。	`nacos`
`nacos.plugin.visibility.{pluginName}.enabled`	实现的静态初始状态；持久化插件状态优先。默认 `nacos` 实现会复用默认鉴权插件用户信息。	`nacos` 为 `true`

LDAP、OIDC 与 OAuth2

LDAP 与 OIDC/OAuth2 是可选插件。下表列出标准前缀，具体 definitions、alias、默认值和 effectMode 见鉴权插件。

参数名	说明	默认值
`nacos.plugin.auth.ldap.{itemKey}`	LDAP definitions：`url`、`base-dn`、`timeout`、`user-dn`、`password`、`filter-prefix`、`case-sensitive`、`ignore-partial-result-exception`。	见鉴权插件文档
`nacos.plugin.auth.oidc.{itemKey}`	OIDC definitions，包括 issuer/client、JWT/JWKS、claim、外部授权和严格校验选项。当前只实现 `jwt`/JWKS，不支持 introspection。	见鉴权插件文档

插件参数

插件体系说明见插件化概览。

参数名	说明	默认值
`nacos.custom.environment.enabled`	是否启用自定义环境变量插件。	`false`
`nacos.plugin.control.type`	启动时选择流量防护实现；`nacos.plugin.control.manager.type` 是历史 alias。	空（no-limit）
`nacos.plugin.control.rule.local.basedir`	本地流量防护规则目录。	`${nacos.home}`
`nacos.plugin.control.rule.external.storage`	外部规则存储类型，需要自行实现。	空
`nacos.plugin.{pluginType}.{pluginName}.enabled`	非互斥实现的启动初始状态；持久化/本地 state 可覆盖。`auth`、`datasource-dialect`、`control` 等互斥类型应使用 selector 选择实现。	由实现和类型策略决定
`nacos.plugin.{pluginType}.{pluginName}.{itemKey}`	实现 definitions 的标准配置键。	由 definition 决定

配置变更插件的历史 nacos.core.config.plugin.{pluginName}.* 只用于旧二进制兼容；Nacos Server 不内置 webhook、whitelist 或 fileformatcheck 实现。新实现使用 nacos.plugin.config-change.{pluginName}.{itemKey}。

Istio 与 Prometheus 服务发现

这两类能力属于长期存在的生态融合能力，使用方式见生态融合概览。

参数名	说明	默认值
`nacos.extension.naming.istio.enabled`	是否加载 Istio 模块。	`false`
`nacos.istio.mcp.server.enabled`	是否开启 Istio MCP server。	`false`
`nacos.istio.mcp.server.port`	Istio MCP server 端口。	`18848`
`nacos.istio.server.full`	是否使用全量推送。	`true`
`nacos.istio.debounce.max`	Istio 推送防抖最大等待时间，单位毫秒。	`5000`
`nacos.istio.debounce.after`	Istio 推送防抖等待时间，单位毫秒。	`100`
`nacos.istio.domain.suffix`	Istio 域名后缀。	`nacos`
`nacos.prometheus.metrics.enabled`	是否开启 Prometheus 服务发现辅助接口。	`false`

AI 管理中心

AI 管理中心的使用方式见AI 管理中心概述。下面参数只负责模块开关、协议适配、导入和发布 Pipeline。

参数名	说明	默认值
`nacos.extension.ai.enabled`	是否启用 AI 模块。设为 `false` 时不加载 AI 模块及其控制台入口，Config 和 Naming 不受影响；`microservice` 功能模式下无论该值为何都不会加载 AI 模块。	`true`
`nacos.ai.resource.search.enabled`	是否启用 AI 资源检索。关闭后检索功能不可用，依赖该功能的 ARD 也无法启用。升级时若已明确关闭检索，MCP 自动迁移不会等待检索索引初始化。	`true`
`nacos.ai.resource.search.index.backfill.enabled`	启用 AI 资源检索后，是否为历史数据初始化索引并进行周期检查。通常保持开启；初次升级期间关闭它，可能使 MCP 自动迁移一直等待索引准备完成。	`true`
`nacos.ai.resource.search.vector.provider`	资源发现使用的向量索引 Provider；修改后重启。接入见 AI 向量插件。	`postgresql`
`nacos.plugin.ai-vector.postgresql.enabled`	PostgreSQL 向量实现的初始状态；默认随 Provider 选择，持久化插件状态优先。	由 Provider 选择决定
`nacos.ai.resource.search.vector.postgresql.url`	独立向量库的 JDBC URL；未配置时尝试使用 PostgreSQL 主数据源。	空
`nacos.ai.resource.search.vector.postgresql.user`	独立向量库的用户名。	空
`nacos.ai.resource.search.vector.postgresql.password`	独立向量库的密码。	空
`nacos.ai.resource.search.vector.postgresql.driver-class-name`	独立向量库的 JDBC 驱动类。	`org.postgresql.Driver`
`nacos.ai.mcp.resource.reconciliation.enabled`	是否在服务端就绪后自动迁移已有 MCP 数据并启用新版管理接口。通常保持开启；迁移完成前设为 `false` 会停止自动迁移，使新版 MCP 管理接口继续不可用。启动时读取，修改后需重启服务端。	`true`
`nacos.ai.mcp.resource.reconciliation.interval-seconds`	MCP 自动迁移的检查间隔，单位为秒，从上一轮结束后开始计时。只接受正整数；非法、非数字或小于等于 0 的值回退到 `300`。调小会增加配置中心和数据库扫描负载，只建议在测试或受控排障时谨慎调整。启动时读取，修改后需重启服务端。	`300`
`nacos.ai.mcp.registry.enabled`	是否启用官方 MCP Registry 协议适配。开启后会使用 `nacos.ai.registry.port` 暴露独立端口。	`false`
`nacos.ai.skill.registry.enabled`	是否启用 Skill Registry 协议适配。开启后会使用 `nacos.ai.registry.port` 暴露独立端口。	`false`
`nacos.ai.registry.port`	AI Registry 协议适配端口。	`9080`
`nacos.ai.mcp.registry.port`	旧参数名，已废弃。请改用 `nacos.ai.registry.port`。	`9080`
`nacos.plugin.ai-pipeline.enabled`	AI Pipeline 动态模块总开关；关闭时延迟加载类型。	`true`
`nacos.plugin.ai-pipeline.type`	历史启动链，仅用于没有持久化状态时初始化节点状态。	空
`nacos.plugin.ai-pipeline.skill-scanner.{itemKey}`	`skill-scanner` definitions；只有 `order` 为 RUNTIME。	见 AI Pipeline 插件文档
`nacos.plugin.ai-pipeline.skill-spector.{itemKey}`	`skill-spector` definitions；只有 `order` 为 RUNTIME。	见 AI Pipeline 插件文档
`nacos.ai.skill.auto-publish-after-review.enabled`	Skill 审核通过后是否自动发布版本。	`false`
`nacos.plugin.ai-resource-import.enabled`	AI Resource Import 模块总开关；标准 key 和 alias 都未配置时仍默认开启，只有显式 `false` 才关闭。发行包也显式将标准 key 设为 `true`。	`true`
`nacos.plugin.ai-resource-import.{pluginName}.enabled`	每个固定来源的启动初始状态。	`mcp-official`/`skills-sh` 开启，其余关闭
`nacos.plugin.ai-resource-import.{pluginName}.{itemKey}`	来源 definitions；endpoint/网络开关为 RESTART，其余展示和限制为 RUNTIME。	见 AI 资源导入插件文档
`nacos.ai.resource.import.legacy-mcp-api-enabled`	旧 MCP 导入 API 兼容开关；Nacos 3.2.4 起不再识别，请改用 `nacos.core.api.compatibility.enabled`。	不适用
`nacos.ai.resource.import.allow-user-url`	通过共享兼容开关重新开启旧 MCP 直接 URL 导入后，是否允许抓取用户提供的 URL。	`false`
`nacos.console.ai.mcp.import.enabled`	是否允许 Console 的 `GET /v3/console/ai/mcp/importToolsFromMcp` 发起出站 MCP 连接。设为 `false` 会关闭全部此类 tools 导入。	`true`
`nacos.console.ai.mcp.import.allowed-private-addresses`	Console MCP tools 导入允许访问的私网或本地 IP/CIDR 白名单，多个条目用逗号分隔；公网地址不需要加入。	空

向量库连接配置修改后需重启服务端。pgvector 及其表仅在使用 PostgreSQL 向量能力时需要，初始化方法和注意事项见 AI 向量插件，不属于普通 ARD 接入的前置条件。

上表中的 MCP 自动迁移项使用服务端实际参数名。当前发行包没有为它们定义专用启动参数；请优先在 application.properties 中使用完整参数名，或按部署规范使用 JVM -D 参数。容器部署不要自行推导未由镜像脚本声明的环境变量名。

旧 nacos.plugin.ai.importer.*、nacos.ai.resource.import.sources[N].*、preset 和复制 endpoint 模型已移除或只保留明确列出的迁移 alias，不能用于新部署。详见 AI 资源导入插件。

实验性功能

实验性功能不承诺长期稳定行为。使用前请阅读实验性功能概览。

参数名	说明	默认值
`nacos.k8s.sync.enabled`	是否开启内置 K8s sync 实验能力。	`false`
`nacos.k8s.sync.outsideCluster`	是否从 Kubernetes 集群外访问 API Server。	`false`
`nacos.k8s.sync.kubeConfig`	集群外访问时使用的 kubeconfig 路径。	`/.kube/config`

兼容与迁移参数

这些参数用于升级、迁移或兼容旧行为。它们不代表新系统推荐模型。更多背景见兼容与废弃。

参数名	说明	默认值
`nacos.core.api.compatibility.enabled`	是否在迁移窗口内临时重新开启显式接入兼容门禁的废弃 v3 Pipeline 和 MCP 导入 API。	`false`
`nacos.core.api.compatibility.client.enabled`	是否开启客户端 API 兼容能力。	`true`
`nacos.core.api.compatibility.admin.enabled`	是否开启 Admin API 兼容能力。	`false`
`nacos.core.api.compatibility.console.enabled`	是否开启 Console API 兼容能力。	`false`

启动脚本和镜像变量

发行包 startup.sh 支持以下常用启动参数：

启动参数	说明	对应配置
`-m standalone`	单机模式启动。	`nacos.standalone=true`
`-m cluster`	集群模式启动。	`nacos.standalone=false`
`-f config`	只启动配置中心相关模块。	`nacos.functionMode=config`
`-f naming`	只启动服务发现相关模块。	`nacos.functionMode=naming`
`-f microservice`	仅启动配置中心和服务发现模块，不加载 AI 模块（Nacos 3.2.2+）。	`nacos.functionMode=microservice`
`-f ai`	启动 AI 相关模块。	`nacos.functionMode=ai`
`-c`	设置集群成员列表。	`nacos.member.list`
`-p embedded`	集群模式下使用嵌入式存储。	`embeddedStorage=true`
`-d`	设置部署形态。	`nacos.deployment.type`

使用官方容器镜像时，常见环境变量包括 MODE、NACOS_SERVERS、PREFER_HOST_MODE、NACOS_AUTH_ENABLE、NACOS_AUTH_ADMIN_ENABLE、NACOS_AUTH_CONSOLE_ENABLE、NACOS_AUTH_TOKEN、NACOS_AUTH_IDENTITY_KEY、NACOS_AUTH_IDENTITY_VALUE、NACOS_CONSOLE_PORT 等。不同镜像版本的转换脚本可能不同，生产部署建议挂载完整 application.properties，并以镜像仓库或 Helm Chart 的说明为准。