ContextQMD
Back to Nocobase

安装 NocoBase 应用

docs/docs/cn/ai/install-nocobase-app.md

2.1.104.0 KB
Original Source

安装 NocoBase 应用

前置条件

  • Node.js >= 22
  • Yarn 1.x
  • 如果你打算用 Docker 安装，先确保 Docker 已启动

第一步：安装 CLI

先全局安装 NocoBase CLI：

bash
npm install -g @nocobase/cli
nb --version

如果你会同时开多个终端，或者要和 AI Agent 并行操作，建议额外执行一次 nb session setup。这样每个会话都会维护自己的 current env，不容易互相影响。

第二步：初始化应用

推荐通过 UI 向导安装

bash
nb init --ui --locale zh-CN
  1. 「开始设置」——设置 --env 标识，并选择「新安装」

  1. 「应用环境信息」——设置应用的基础信息、存储位置和运行端口

  1. 「应用来源和版本」——选择应用的获取方式，以及要使用的来源和版本

  1. 「配置数据库」——选择内置数据库或自定义数据库

  1. 「创建管理员账号」——设置第一个管理员账号

  1. 「连接与认证」——填写应用访问地址并选择认证方式

如果你更习惯终端交互，也可以直接运行：

bash
nb init

如果你在脚本或 CI 里初始化，可以用非交互模式：

bash
nb init --yes --env app1

:::tip 远程服务器安装

如果你是在服务器上执行 nb init --ui，建议先把默认 host 改成当前服务器 IP。这样你才能从本地浏览器打开向导页面。

bash
nb config set default-ui-host <server-ip>
nb config set default-api-host <server-ip>

:::

第三步：确认应用可用

安装完成后，通常建议先确认这 3 件事：

  • env 是否已经保存成功
  • 应用是否已经正常启动
  • 你能否用管理员账号登录页面

常用命令是：

bash
nb env list
nb env info
nb app logs

如果是本地默认安装，浏览器通常可以直接打开 http://localhost:13000。登录后，再新开或重启一次 AI Agent 会话，AI 就可以开始操作这个 NocoBase 应用了。

CLI 的配置默认保存在 ~/.nocobase/，所以 AI Agent 通常可以在任意工作目录访问它。

如果这个应用后面要正式对外提供服务，不建议长期直接使用 IP + port。下一步通常就是接入反向代理，并启用 HTTPS。

接下来

相关链接