nocobase/docs/zh-CN/api/env.md
Junyi 796e73ae5a
refactor(doc): change to new structure (#804)
* refactor(doc): change to new structure

* docs: add database docs

* docs: add collection docs

* docs: add db field examples

* docs(api): fix filename and menu path

* docs: add database docs

* docs: add db operators doc

* docs: add resourcer menu

* docs: add resourcer docs

* docs: fix api docs

* docs: refactor api menu structure

* feat: update docs (#830)

* feat: updates

* feat: update docs

* chore: ignore docs from ci

Co-authored-by: Junyi <mytharcher@users.noreply.github.com>
Co-authored-by: mytharcher <mytharcher@gmail.com>

* docs: add database methods docs

* docs: add missed api

* docs: fix api docs

* feat: update development docs (#833)

* feat: update development docs

* feat: update docs

* feat: update docs

* docs: add first plugin example (#834)

* feat: update docs

* feat: update docs

* docs: fix typo

Co-authored-by: chenos <chenlinxh@gmail.com>
2022-09-19 09:23:01 +08:00

3.0 KiB

环境变量

全局环境变量

保存在 .env 文件里

APP_ENV

应用环境,默认值 development,可选项包括:

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

APP_HOST

应用主机,默认值 0.0.0.0

APP_HOST=192.168.3.154

APP_PORT

应用端口,默认值 13000

APP_PORT=13000

APP_KEY

秘钥,用于 jwt 等场景

APP_KEY=app-key-test

API_BASE_PATH

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

API_BASE_PATH=/api/

DB_DIALECT

数据库类型,默认值 sqlite,可选项包括:

  • sqlite
  • mysql
  • postgres
DB_DIALECT=mysql

DB_STORAGE

数据库文件路径(使用 SQLite 数据库时配置)

# 相对路径
DB_HOST=storage/db/nocobase.db
# 绝对路径
DB_HOST=/your/path/nocobase.db

DB_HOST

数据库主机(使用 mysql 或 postgres 数据库时需要配置)

默认值 localhost

DB_HOST=localhost

DB_PORT

数据库端口(使用 mysql 或 postgres 数据库时需要配置)

  • MySQL 默认端口 3306
  • PostgreSQL 默认端口 5432
DB_PORT=3306

DB_DATABASE

数据库名(使用 mysql 或 postgres 数据库时需要配置)

DB_DATABASE=nocobase

DB_USER

数据库用户(使用 mysql 或 postgres 数据库时需要配置)

DB_USER=nocobase

DB_PASSWORD

数据库密码(使用 mysql 或 postgres 数据库时需要配置)

DB_PASSWORD=nocobase

DB_TABLE_PREFIX

数据表前缀

DB_TABLE_PREFIX=nocobase_

DB_LOGGING

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

  • on 打开
  • off 关闭
DB_LOGGING=on

临时环境变量

安装 NocoBase 时,可以通过设置临时的环境变量来辅助安装,如:

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  INIT_ROOT_EMAIL=demo@nocobase.com \
  INIT_ROOT_PASSWORD=admin123 \
  INIT_ROOT_NICKNAME="Super Admin" \
  nocobase install

# 等同于
yarn nocobase install \
  --lang=zh-CN  \
  --root-email=demo@nocobase.com \
  --root-password=admin123 \
  --root-nickname="Super Admin"

# 等同于
yarn nocobase install -l zh-CN -e demo@nocobase.com -p admin123 -n "Super Admin"

INIT_APP_LANG

安装时的语言,默认值 en-US,可选项包括:

  • en-US
  • zh-CN
yarn cross-env \
  INIT_APP_LANG=zh-CN \
  nocobase install

INIT_ROOT_EMAIL

Root 用户邮箱

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  INIT_ROOT_EMAIL=demo@nocobase.com \
  nocobase install

INIT_ROOT_PASSWORD

Root 用户密码

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  INIT_ROOT_EMAIL=demo@nocobase.com \
  INIT_ROOT_PASSWORD=admin123 \
  nocobase install

INIT_ROOT_NICKNAME

Root 用户昵称

yarn cross-env \
  INIT_APP_LANG=zh-CN \
  INIT_ROOT_EMAIL=demo@nocobase.com \
  INIT_ROOT_PASSWORD=admin123 \
  INIT_ROOT_NICKNAME="Super Admin" \
  nocobase install