nb app start

启动指定 env 的 NocoBase 应用。npm/Git 安装会运行本地应用命令,Docker 安装会根据已保存的 env 配置重建应用容器。

用法

nb app start [flags]

参数

参数类型说明
--env, -estring要启动的 CLI env 名称,省略时使用当前 env
--yes, -yboolean当显式 --env 指向的 env 与当前 env 不一致时,跳过交互确认
--quickstartboolean快速启动应用
--port, -pstring覆盖 env 配置中的 appPort
--daemon, -d / --no-daemonboolean是否以守护进程模式运行,默认开启
--instances, -iinteger运行实例数
--launch-modestring启动方式:pm2node
--verboseboolean显示底层本地或 Docker 命令输出

示例

nb app start
nb app start --env local
nb app start --env local --quickstart
nb app start --env local --port 12000
nb app start --env local --daemon
nb app start --env local --no-daemon
nb app start --env local --instances 2
nb app start --env local --launch-mode pm2
nb app start --env local --verbose
nb app start --env local-docker

说明

只有在你显式传入 --env 时,CLI 才会检查它是否与当前 env 一致。如果显式指定了不同的 env,交互终端会先确认;在非交互终端或 AI agent 场景下,需要由你自己显式追加 --yes,或者先执行 nb env use <name> 再重试。

默认情况下,本地 env 会以后台模式启动,Docker env 会按已保存配置重建应用容器。只要 CLI 需要等待应用就绪,就会检查 __health_check 接口:先输出一条等待日志,之后每 10 秒输出一条进度提示,直到应用可用或超时。

如果本地 env 传入 --no-daemon,应用会以前台模式运行。此时 CLI 不会在启动后继续等待健康检查。

相关命令