Nacos 系統參數介紹

Nacos Server

對于Server端來說，一般是設定在

{nacos.home}/conf/application.properties

裡，如果參數名後标注了(-D)的，則表示是 JVM 的參數，需要在

{nacos.home}/bin/startup.sh

裡進行相應的設定。例如像設定 nacos.home 的值，可以在

{nacos.home}/bin/startup.sh

進行如下設定：

JAVA_OPT="${JAVA_OPT} -Dnacos.home=${BASE_DIR}"
           

全局參數

參數名	含義	可選值	預設值	支援版本
nacos.home(-D)	Nacos的根目錄	目錄路徑	Nacos安裝的目錄	>= 0.1.0
nacos.standalone(-D)	是否在單機模式	true/false	false	>= 0.1.0
nacos.functionMode(-D)	啟動模式，支援隻啟動某一個子產品，不設定時所有子產品都會啟動	config/naming/空	空	>= 0.9.0
nacos.inetutils.prefer-hostname-over-ip	cluster.conf 裡是否應該填 hostname	true/false	false	>= 0.3.0
nacos.inetutils.ip-address	本機IP，該參數設定後，将會使用這個IP去 cluster.conf 裡進行比對，請確定這個IP的值在 cluster.conf 裡是存在的	本機IP	null	>= 0.3.0
nacos.security.ignore.urls	控制台鑒權跳過的接口	需要跳過控制台鑒權的接口清單	空	>= 0.9.0

Naming子產品

參數名	含義	可選值	預設值	支援版本
nacos.naming.data.warmup	是否在Server啟動時進行資料預熱	true/false	false	>= 1.0.2
nacos.naming.expireInstance	是否自動摘除臨時執行個體	true/false	true	>= 1.0.2
nacos.naming.distro.taskDispatchPeriod	同步任務生成的周期，機關為毫秒	正整數	200	>= 1.0.2
nacos.naming.distro.batchSyncKeyCount	同步任務每批的key的數目	正整數	1000	>= 1.0.2
nacos.naming.distro.syncRetryDelay	同步任務失敗的重試間隔，機關為毫秒	正整數	5000	>= 1.0.2

除了上面列到的在

application.properties

裡配置的屬性，還有一些可以在運作時調用接口來進行調節，這些參數都在Open API裡的

檢視系統目前資料名額

這個API裡有聲明。

Config子產品

參數名	含義	可選值	預設值	支援版本
db.num	資料庫數目	正整數	>= 0.1.0
db.url.0	第一個資料庫的URL	字元串	空	>= 0.1.0
db.url.1	第二個資料庫的URL	字元串	空	>= 0.1.0
db.user	資料庫連接配接的使用者名	字元串	空	>= 0.1.0
db.password	資料庫連接配接的密碼	字元串	空	>= 0.1.0

CMDB子產品

參數名	含義	可選值	預設值	支援版本
nacos.cmdb.loadDataAtStart	是否打開CMDB	true/false	false	>= 0.7.0
nacos.cmdb.dumpTaskInterval	全量dump的間隔，機關為秒	正整數	3600	>= 0.7.0
nacos.cmdb.eventTaskInterval	變更事件的拉取間隔，機關為秒	正整數	10	>= 0.7.0
nacos.cmdb.labelTaskInterval	标簽集合的拉取間隔，機關為秒	正整數	300	>= 0.7.0

Nacos Java Client

用戶端的參數分為兩種，一種是通過-D參數進行指定的配置，一種是構造用戶端時，通過

Properties

對象指定的配置，以下沒有帶-D标注的都是通過

Properties

注入的配置。

通用參數

參數名	含義	可選值	預設值	支援版本
endpoint	連接配接Nacos Server指定的連接配接點，可以參考文檔	域名	空	>= 0.1.0
endpointPort	連接配接Nacos Server指定的連接配接點端口，可以參考文檔	合法端口号	空	>= 0.1.0
namespace	命名空間的ID	命名空間的ID	config子產品為空，naming子產品為public	>= 0.8.0
serverAddr	Nacos Server的位址清單，這個值的優先級比endpoint高	ip:port,ip:port,...	空	>= 0.1.0
nacos.logging.path(-D)	用戶端日志的目錄	目錄路徑	使用者根目錄	>= 0.1.0

Naming用戶端

參數名	含義	可選值	預設值	支援版本
namingLoadCacheAtStart	啟動時是否優先讀取本地緩存	true/false	false	>= 1.0.0
namingClientBeatThreadCount	用戶端心跳的線程池大小	正整數	機器的CPU數的一半	>= 1.0.0
namingPollingThreadCount	用戶端定時輪詢資料更新的線程池大小	正整數	機器的CPU數的一半	>= 1.0.0
com.alibaba.nacos.naming.cache.dir(-D)	用戶端緩存目錄	目錄路徑	{user.home}/nacos/naming	>= 1.0.0
com.alibaba.nacos.naming.log.level(-D)	Naming用戶端的日志級别	info,error,warn等	info	>= 1.0.0
com.alibaba.nacos.client.naming.tls.enable(-D)	是否打開HTTPS	true/false	false	>= 1.0.0

Config用戶端

參數名	含義	可選值	預設值	支援版本
configLongPollTimeout(config.long-poll.timeout 1.0.1版本)	長輪詢的逾時時間，機關為毫秒	正整數	30000	>= 1.0.2
configRetryTime(config.retry.time 1.0.1版本)	長輪詢任務重試時間，機關為毫秒	正整數	2000	>= 1.0.2
maxRetry	長輪詢的重試次數	正整數	3	>= 1.0.2
enableRemoteSyncConfig	監聽器首次添加時拉取遠端配置	布爾值	false	>= 1.0.2
com.alibaba.nacos.config.log.level(-D)	Config用戶端的日志級别	info,error,warn等	info	>= 1.0.0
JM.SNAPSHOT.PATH(-D)	用戶端緩存目錄	目錄路徑	{user.home}/nacos/config	>= 1.0.0