Git 源码安装
0. 先决条件
请确保你已经:
- 安装了 Git、Node.js 20+、Yarn 1.22.x
- 配置并启动了所需数据库 MySQL 8.0.17+、MariaDB 10.9+、PostgreSQL 10+ 任选其一
1. 将 NocoBase 下载到本地
latest 版本 (main
)
功能稳定,测试较为完善的版本,仅做缺陷修复。推荐安装此版本。
git clone https://github.com/nocobase/nocobase.git -b main --depth=1 my-nocobase
beta 版本 (next
)
包含即将发布的新功能,经过初步测试的版本,可能存在部分已知或未知问题。
git clone https://github.com/nocobase/nocobase.git -b next --depth=1 my-nocobase
alpha 版本 (develop
)
包含即将发布的新功能,经过初步测试的版本,可能存在部分已知或未知问题。
git clone https://github.com/nocobase/nocobase.git -b develop --depth=1 my-nocobase
2. 切换目录
cd my-nocobase
3. 安装依赖
由于国内网络环境的原因,强烈建议你更换国内镜像。
$ yarn config set disable-self-update-check true
$ yarn config set registry https://registry.npmmirror.com/
📢 由于网络环境、系统配置等因素影响,接下来这一步骤可能需要十几分钟时间。
yarn install --frozen-lockfile
4. 设置环境变量
NocoBase 所需的环境变量储存在根目录 .env
文件里,根据实际情况修改环境变量,如果你不知道怎么改,点此查看环境变量说明,也可以保持默认。
TZ=Asia/Shanghai
APP_KEY=your-secret-key
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=postgres
DB_USER=nocobase
DB_PASSWORD=nocobase
WARNING
TZ
用于设置应用的时区,默认为操作系统时区;APP_KEY
是应用的密钥,用于生成用户 token 等(如果 APP_KEY 修改了,旧的 token 也会随之失效)。它可以是任意随机字符串。请修改为自己的秘钥,并确保不对外泄露;DB_*
为数据库相关,如果不是例子默认的数据库服务,请根据实际情况修改。
5. 安装 NocoBase
yarn nocobase install --lang=zh-CN
6. 启动 NocoBase
开发环境
yarn dev
生产环境
# 编译(请确保已执行 `yarn install --frozen-lockfile`)
yarn build
# 启动
yarn start
7. 登录 NocoBase
使用浏览器打开 http://localhost:13000 初始化账号和密码是 admin@nocobase.com
和 admin123
。
参考: https://docs-cn.nocobase.com/welcome/getting-started/installation/git-clone