logologo
开始
手册
开发
插件
API
首页
English
简体中文
日本語
한국어
Español
Português
Deutsch
Français
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
开始
手册
开发
插件
API
首页
logologo
NocoBase 如何工作
系统要求
安装方式和版本对比

安装 NocoBase

Docker 安装
create-nocobase-app 安装
Git 源码安装
环境变量

升级 NocoBase

Docker 安装的升级
create-nocobase-app 安装的升级
Git 源码安装的升级

部署

生产环境部署

静态资源代理

nginx
caddy
cdn

常用运维命令

docker compose
pm2
如何部署才更快
安装与升级插件
翻译贡献
Previous PageDocker 安装
Next PageGit 源码安装

#create-nocobase-app 安装

前提条件
  • 安装了 Node.js 20+、Yarn 1.22.x
  • 配置并启动了所需数据库 MySQL 8.0.17+、MariaDB 10.9+、PostgreSQL 10+ 任选其一
  • 由于国内网络环境的原因,建议你更换国内镜像(非必须)
$ yarn config set disable-self-update-check true
$ yarn config set registry https://registry.npmmirror.com/

#1. 创建 NocoBase 项目

选择 NocoBase 版本(版本对比)和数据库类型,执行相应的命令。

Beta 版本 (2.0-beta)
Alpha 版本 (2.0-alpha)
Latest 版本(1.9)
PostgreSQL
MySQL
MariaDB
npx create-nocobase-app@beta my-nocobase-app -d postgres \
   -e DB_HOST=localhost \
   -e DB_PORT=5432 \
   -e DB_DATABASE=nocobase \
   -e DB_USER=nocobase \
   -e DB_PASSWORD=nocobase \
   -e TZ=Asia/Shanghai
环境变量说明
  • TZ 用于设置应用的时区,默认为操作系统时区
  • APP_KEY 是应用的密钥,用于生成用户 token 等(如果 APP_KEY 修改了,旧的 token 也会随之失效)。它可以是任意随机字符串。请修改为自己的秘钥,并确保不对外泄露
  • DB_* 为数据库相关配置,请根据实际情况修改为你的数据库连接信息

#2. 切换目录

cd my-nocobase-app

#3. 安装依赖

📢 由于网络环境、系统配置等因素影响,这一步可能需要十几分钟时间。

yarn install
生产环境提示

生产环境部署时,为了减少体积,可以只安装必要的依赖:

yarn install --production

#4. 安装 NocoBase

yarn nocobase install --lang=zh-CN

安装过程会自动创建数据库表结构和初始化数据。

#5. 启动 NocoBase

开发环境

yarn dev

生产环境

yarn start

#6. 登录 NocoBase

使用浏览器打开 http://localhost:13000,初始化账号和密码是 admin@nocobase.com 和 admin123。

账号安全提示

首次登录后,请及时修改默认密码以确保系统安全。