管理应用
如果你已经把一个 NocoBase 应用保存成 CLI env,日常管理基本都在 nb app 这一组命令里完成:启动、停止、重启、查看日志、升级,以及清理本地运行资源。
大多数时候,你不需要记住所有参数。先分清楚自己要做的是“把应用跑起来”“看日志排查问题”,还是“彻底清理这个 env”,再选对应命令就行。
快速索引
nb app 命令默认作用在当前 env 上。如果你同时维护多个环境,默认推荐先切到目标 env,再执行启动、升级或清理操作。
如果你显式传入了不同的 --env,CLI 通常会要求确认。脚本或非交互场景里,可以加 --yes 跳过这一步。
启动应用
把应用拉起来,默认用 nb app start 就行:
如果你要操作的不是当前 env,可以显 式指定:
另外几个比较常用的启动参数:
nb app start默认会先自动完成必要的安装或升级准备,再把服务拉起来--no-daemon只在本地 env 下有明显意义——应用会以前台模式运行,方便你直接看控制台输出
本地 npm/Git env 会启动本地应用进程,Docker env 会按已保存配置重建应用容器。详细参数见 nb app start。
停止和重启
只想临时把应用停掉,用 nb app stop:
如果你刚改完配置、依赖或代码,通常来说直接 nb app restart 更省事:
nb app restart 会先执行停止,再按 start 的方式重新启动,所以它也支持 --no-daemon 这类启动参数。详细用法见 nb app stop 和 nb app restart。
查看日志
排查问题时,通常先看日志:
如果你只想多看一点最近输出,或者不想持续跟随日志,可以这样用:
本地 npm/Git env 读取的是 pm2 日志,Docker env 读取的是容器日志。默认情况下,nb app logs 会持续跟随新日志输出。详细参数见 nb app logs。
升级应用
升级命令是 nb app upgrade:
这个命令做的不只是“下载新版本”。默认流程通常包括:
- 停止当前应用
- 下载并替换已保存的源码或镜像
- 同步商业插件
- 升级并启动应用
- 刷新 env runtime 信息
如果你已经提前更新好了源码或镜像,只想基于当前内容继续执行升级并启动应用,可以加 --skip-download:
如果你想显式指定目标版本,也可以加 --version:
nb app upgrade 在真正开始前通常还会要求你确认一次。脚本、CI 或其他非交互场景里,需要显式传入 --force。如果同时还是跨 env 操作,通常要一起带上 --yes。
更完整的参数说明见 nb app upgrade。
清理运行资源和销毁 env
这几种场景最容易混淆。可以先记住一个默认建议:
- 只是想把应用停掉,用
nb app stop - 也想把当前机器上的内置数据库运行时一起停掉,用
nb app stop --with-db - 确定这个 env 不再需要了,但想先保留 storage 和本地 app 文件,用
nb env remove - 连本机托管资源也一起清理掉,再用
nb env remove --purge
如果你只是想停掉应用和 CLI 托管的内置数据库,直接这样写就行:
如果你要移除这个 env,但还想保留 storage 和本地 app 文件:
如果你确实要把这个 env 的本机托管内容也一起清理掉,那么加上 --purge:
对于 CLI 下载管理的本地 npm/Git env,--purge 还会删除 CLI 托管的本地应用文件。对于 HTTP 或 SSH env,它只会删除 CLI 里保存的 env 配置,不会去删除外部服务本身。

