a6eebb940f
* feat: improve code * feat: update docs * feat: update docs * Update index.md * Update features.md * Update when.md * Update contributing.md * Update translations.md * feat: clean up * Add files via upload * Update the-first-app.md * Update plugins.md * Update a-b-c.md * Update blocks.md * feat: update docs * Add files via upload * Update charts.md * feat: update navs * Update index.md * Update index.md * Update features.md * Update index.md * Update docker-compose.md * Update create-nocobase-app.md * Update git-clone.md * Update contributing.md * Update translations.md * Update plugins.md * Update the-first-app.md * Add files via upload * Update charts.md * Update charts.md * Update a-b-c.md * Update collections.md * Update menus.md * Update menus.md Co-authored-by: Zhou <zhou.working@gmail.com>
226 lines
3.5 KiB
Markdown
226 lines
3.5 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/
|
|
```
|
|
|
|
### PLUGIN_PACKAGE_PREFIX
|
|
|
|
插件包前缀，默认值 `@nocobase/plugin-,@nocobase/preset-`
|
|
|
|
例如，有一名为 `my-nocobase-app` 的项目，新增了 `hello` 插件，包名为 `@my-nocobase-app/plugin-hello`。
|
|
|
|
PLUGIN_PACKAGE_PREFIX 配置如下：
|
|
|
|
```bash
|
|
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
|
|
|
|
数据库类型，默认值 `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
|
|
```
|