#全局环境变量

#TZ

用于设置应用的时区，默认为操作系统时区。

https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

#APP_ENV

应用环境，默认值 development，可选项包括：

• production 生产环境
• development 开发环境

APP_ENV=production

#APP_KEY

应用的密钥，用于生成用户 token 等，修改为自己的应用密钥，并确保不对外泄露

APP_KEY=app-key-test

#APP_PORT

应用端口，默认值 13000

APP_PORT=13000

#API_BASE_PATH

NocoBase API 地址前缀，默认值 /api/

API_BASE_PATH=/api/

#API_BASE_URL

#CLUSTER_MODE

v1.6.0+

多核（集群）启动模式，如配置了该变量，会透传至 pm2 start 命令中作为 -i <instances> 的参数。可选项与 pm2 -i 参数一致（参考 PM2: Cluster Mode），包括：

• max：使用 CPU 最大核数
• -1：使用 CPU 最大核数 -1
• <number>：指定核数

默认值为空，代表不开启。

更多可参考：集群模式。

#PLUGIN_PACKAGE_PREFIX

插件包名前缀，默认为：@nocobase/plugin-,@nocobase/preset-。

例如，添加 hello 插件到 my-nocobase-app 项目，插件的完整包名则为 @my-nocobase-app/plugin-hello。

PLUGIN_PACKAGE_PREFIX 可以配置为：

PLUGIN_PACKAGE_PREFIX=@nocobase/plugin-,@nocobase-preset-,@my-nocobase-app/plugin-

则插件名称和包名对应关系如下：

• users 插件的包名为 @nocobase/plugin-users
• nocobase 插件的包名为 @nocobase/preset-nocobase
• hello 插件的包名为 @my-nocobase-app/plugin-hello

#DB_DIALECT

数据库类型，可选项包括：

• mariadb
• mysql
• postgres

DB_DIALECT=mysql

#DB_HOST

数据库主机（使用 MySQL 或 PostgreSQL 数据库时需要配置）

默认值 localhost

DB_HOST=localhost

#DB_PORT

数据库端口（使用 MySQL 或 PostgreSQL 数据库时需要配置）

• MySQL、MariaDB 默认端口 3306
• PostgreSQL 默认端口 5432

DB_PORT=3306

#DB_DATABASE

数据库名（使用 MySQL 或 PostgreSQL 数据库时需要配置）

DB_DATABASE=nocobase

#DB_USER

数据库用户（使用 MySQL 或 PostgreSQL 数据库时需要配置）

DB_USER=nocobase

#DB_PASSWORD

数据库密码（使用 MySQL 或 PostgreSQL 数据库时需要配置）

DB_PASSWORD=nocobase

#DB_TABLE_PREFIX

数据表前缀

DB_TABLE_PREFIX=nocobase_

#DB_UNDERSCORED

数据库表名、字段名是否转为 snake case 风格，默认为 false。如果使用 MySQL（MariaDB）数据库，并且 lower_case_table_names=1，则 DB_UNDERSCORED 必须为 true

#DB_LOGGING

数据库日志开关，默认值 off，可选项包括：

• on 打开
• off 关闭

DB_LOGGING=on

#LOGGER_TRANSPORT

日志输出方式，多个用 , 分隔。开发环境默认值 console, 生产环境默认值 console,dailyRotateFile. 可选项：

• console - console.log
• file - 文件
• dailyRotateFile - 按天滚动文件

LOGGER_TRANSPORT=console,dailyRotateFile

#LOGGER_BASE_PATH

基于文件的日志存储路径，默认为 storage/logs。

LOGGER_BASE_PATH=storage/logs

#LOGGER_LEVEL

输出日志级别，开发环境默认值 debug, 生产环境默认值 info. 可选项：

• error
• warn
• info
• debug
• trace

LOGGER_LEVEL=info

数据库日志输出级别为 debug, 由 DB_LOGGING 控制是否输出，不受 LOGGER_LEVEL 影响。

#LOGGER_MAX_FILES

最大保留日志文件数。

• LOGGER_TRANSPORT 为 file 时，默认值为 10.
• LOGGER_TRANSPORT 为 dailyRotateFile, 使用 [n]d 代表天数。默认值为 14d.

LOGGER_MAX_FILES=14d

#LOGGER_MAX_SIZE

按大小滚动日志。

• LOGGER_TRANSPORT 为 file 时，单位为 byte, 默认值为 20971520 (20 * 1024 * 1024).
• LOGGER_TRANSPORT 为 dailyRotateFile, 可以使用 [n]k, [n]m, [n]g. 默认不配置。

LOGGER_MAX_SIZE=20971520

#LOGGER_FORMAT

日志打印格式，开发环境默认 console, 生产环境默认 json. 可选项:

• console
• json
• logfmt
• delimiter

LOGGER_FORMAT=json

参考：日志格式

#CACHE_DEFAULT_STORE

使用缓存方式的唯一标识，指定服务端默认缓存方式，默认值 memory, 内置可选项：

• memory
• redis

CACHE_DEFAULT_STORE=memory

#CACHE_MEMORY_MAX

内存缓存项目最大个数，默认值 2000。

CACHE_MEMORY_MAX=2000

#CACHE_REDIS_URL

Redis连接，可选。示例：redis://localhost:6379

CACHE_REDIS_URL=redis://localhost:6379

#TELEMETRY_ENABLED

启动遥测数据收集，默认为 off.

TELEMETRY_ENABLED=on

#TELEMETRY_METRIC_READER

启用的监控指标采集器，默认为 console. 其他值需要参考对应采集器插件注册的名字，如 prometheus. 多个使用 , 分隔。

TELEMETRY_METRIC_READER=console,prometheus

#TELEMETRY_TRACE_PROCESSOR

启用的链路数据处理器，默认为 console. 其他值需要参考对应处理器插件注册的名字。多个使用 , 分隔。

TELEMETRY_TRACE_PROCESSOR=console