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

208 lines
3.0 KiB
Markdown

# 环境变量
## 全局环境变量
保存在 `.env` 文件里
### APP_ENV
应用环境,默认值 `development`,可选项包括:
- `production` 生产环境
- `development` 开发环境
```bash
APP_ENV=production
```
### APP_HOST
应用主机,默认值 `0.0.0.0`
```bash
APP_HOST=192.168.3.154
```
### APP_PORT
应用端口,默认值 `13000`
```bash
APP_PORT=13000
```
### APP_KEY
秘钥,用于 jwt 等场景
```bash
APP_KEY=app-key-test
```
### API_BASE_PATH
NocoBase API 地址前缀,默认值 `/api/`
```bash
API_BASE_PATH=/api/
```
### DB_DIALECT
数据库类型,默认值 `sqlite`,可选项包括:
- `sqlite`
- `mysql`
- `postgres`
```bash
DB_DIALECT=mysql
```
### DB_STORAGE
数据库文件路径(使用 SQLite 数据库时配置)
```bash
# 相对路径
DB_HOST=storage/db/nocobase.db
# 绝对路径
DB_HOST=/your/path/nocobase.db
```
### DB_HOST
数据库主机(使用 mysql 或 postgres 数据库时需要配置)
默认值 `localhost`
```bash
DB_HOST=localhost
```
### DB_PORT
数据库端口(使用 mysql 或 postgres 数据库时需要配置)
- MySQL 默认端口 3306
- PostgreSQL 默认端口 5432
```bash
DB_PORT=3306
```
### DB_DATABASE
数据库名(使用 mysql 或 postgres 数据库时需要配置)
```bash
DB_DATABASE=nocobase
```
### DB_USER
数据库用户(使用 mysql 或 postgres 数据库时需要配置)
```bash
DB_USER=nocobase
```
### DB_PASSWORD
数据库密码(使用 mysql 或 postgres 数据库时需要配置)
```bash
DB_PASSWORD=nocobase
```
### DB_TABLE_PREFIX
数据表前缀
```bash
DB_TABLE_PREFIX=nocobase_
```
### DB_LOGGING
数据库日志开关,默认值 `off`,可选项包括:
- `on` 打开
- `off` 关闭
```bash
DB_LOGGING=on
```
## 临时环境变量
安装 NocoBase 时,可以通过设置临时的环境变量来辅助安装,如:
```bash
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`
```bash
yarn cross-env \
INIT_APP_LANG=zh-CN \
nocobase install
```
### INIT_ROOT_EMAIL
Root 用户邮箱
```bash
yarn cross-env \
INIT_APP_LANG=zh-CN \
INIT_ROOT_EMAIL=demo@nocobase.com \
nocobase install
```
### INIT_ROOT_PASSWORD
Root 用户密码
```bash
yarn cross-env \
INIT_APP_LANG=zh-CN \
INIT_ROOT_EMAIL=demo@nocobase.com \
INIT_ROOT_PASSWORD=admin123 \
nocobase install
```
### INIT_ROOT_NICKNAME
Root 用户昵称
```bash
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
```