安装包中的配置文件

王金城大约 4 分钟

安装包指的是安装包部署中的安装包。通常为 basic-paper-cloud-${版本号}.tar.gz 文件。配置文件位于安装包内 conf 目录中。

引导配置文件（bootstrap.properties）

警告

spring.cloud.nacos.namespace 应填写命名空间 ID，不是命名空间名称。不是名称！不是名称！不是名称！如果不知道什么是命名空间 ID，那么请先移步至新建命名空间查看如何新建命名空间。

这个配置文件是所有模块都会读取的。下面是默认内容：

# nacos 访问地址（必填）。配置多个，用逗号分隔开。如：127.0.0.1:8848,127.0.0.2:8848
spring.cloud.nacos.server-addr=
# 命名空间（必填），用于注册中心、配置中心的数据隔离（在同一个注册中心负责多个环境时极其重要），只读取此命名空间下的配置文件。
spring.cloud.nacos.namespace=
# nacos 账号密码（必填），注意：请务必将 nacos 服务器开启账号密码功能，并修改默认密码，严禁使用默认密码。
spring.cloud.nacos.username=
spring.cloud.nacos.password=
# 日志文件输出路径，请配置物理磁盘，防止日志写入延迟导致程序卡顿。一般情况不需要修改，默认会输出到项目根目录的 logs 中。
#logging.file.path=logs
# 日志文件备份路径，可以配置网盘路径，用于备份使用。尽量修改到拥有更大的存储盘中，默认会输出到项目根目录的 logs/bak 中。
#logging.file.bak-path=logs/bak
# 日志留存数量，由于按照日期存储的日志，所以这里可以理解为日志留存时间
logging.logback.rollingpolicy.max-history=180

参数说明

spring.cloud.nacos.server-addr 和 spring.cloud.nacos.namespace 参数必填，请确保这两个参数配置正确。
logging.file.path 为日志输出路径，一般情况下采取默认值即可，如果应用安装目录的磁盘真的很小可以考虑需改目录，但必须保证是物理盘，防止日志写入延迟导致程序卡顿。
logging.file.bak-path 为日志备份路径，可以根据情况修改，但必须保证磁盘空间充足，防止磁盘写满导致各种问题。

参数	必填	默认值	说明
`spring.cloud.nacos.server-addr`	✔️	-	nacos 访问地址，多个地址用逗号分隔。如：`127.0.0.1:8848,127.0.0.2:8848`
`spring.cloud.nacos.namespace`	✔️	-	命名空间，用于注册中心、配置中心的数据隔离（在同一个注册中心负责多个环境时极其重要），只读取此命名空间下的配置文件。
`spring.cloud.nacos.username`	✔️	-	nacos 用户名，注意：请务必将 nacos 服务器开启账号密码功能，并修改默认密码，严禁使用默认密码。
`spring.cloud.nacos.password`	✔️	-	nacos 密码，注意：请务必将 nacos 服务器开启账号密码功能，并修改默认密码，严禁使用默认密码。
`logging.file.path`	❌	`logs`	日志文件输出路径，请配置物理磁盘，防止日志写入延迟导致程序卡顿。一般情况不需要修改，默认会输出到项目根目录的 logs 中。
`logging.file.bak-path`	❌	`logs/bak`	日志文件备份路径，可以配置网盘路径，用于备份使用。尽量修改到网盘中，默认会输出到项目根目录的 `logs/bak` 中。
`logging.logback.rollingpolicy.max-history`	✔️	`180`	日志留存数量，由于按照日期存储的日志，所以这里可以理解为日志留存时间

应用配置文件

所有的应用配置文件的名字都是 ${应用名}.conf 的格式。这些配置文件只有各自的模块会读取，不会互相干扰。下面是默认内容：

# 启动端口号
server.port=8022
# JAVA_OPTS 参数，一般用于设置内存大小
java.opts=-Xms1024m -Xmx1024m -Xmn384m

参数说明

server.port 一般情况下无需修改，如果不填写会默认使用 bootstrap.yml 配置文件中的 server.port 的端口。
java.opts 参数，一般用于设置内存大小，默认值是 -Xms1024m -Xmx1024m -Xmn384m。也可以在后面补充其他 jvm 参数，使用空格分隔。这个参数在 jvm 调优的时候很有用。
app.opts 参数使用应用接收的参数，例如配置 IVR 多实例

参数	必填	默认值	说明
`server.port`	❌	`bootstrap.yml` -> `server.port`	启动端口号，一般情况无需修改
`java.opts`	❌	`-Xms1024m -Xmx1024m -Xmn384m`	JAVA_OPTS 参数，一般用于设置内存大小。
`app.opts`	❌	-	给应用传输的参数，只有较少的情况下会用到。