Skip to content

快速开始:安装与首次登录 ​

产品先做演示?无需安装 Docker 与平台

如果只需在本地做出可点击、可切角色的产品前端(Mock 运行时),只需要 Git、Node 22 和 pnpm 10。直接克隆 kaiwu-web-starter 起步,见产品先做前端与纳管和无平台一句话起步。需要完整平台与后端联调时,继续按下方启动 Kaiwu。

推荐使用 AI 编码工具自动完成

如果你正在使用 Claude Code、Codex、Cursor 等支持本地终端的 AI 工具,可以直接复制 AI 开工提示词,让它自动检查环境、启动平台并引导你建仓。

1. 准备环境 ​

本机需要安装:Git、Docker(含 Compose v2)、OpenSSL 和 curl。

2. 克隆并启动平台(以 v0.3.0 为例) ​

bash
git clone --branch v0.3.0 --depth 1 https://github.com/kaiwuzaidao/kaiwu.git
cd kaiwu
./kaiwu doctor
KAIWU_DB_TYPE=mysql ./kaiwu up

使用 Gitee 可将仓库地址替换为 https://gitee.com/wujm12138/kaiwu.git。./kaiwu up 会自动拉取运行仓、初始化本地 MySQL、执行迁移并启动平台。

常见环境补充说明(Colima / 源码构建 / 已有数据库)
  • macOS Colima 用户:请将代码克隆在虚拟机可共享挂载的目录下(如 $HOME 子目录)。
  • 镜像与源码构建:发行版默认从 GHCR 拉取 amd64 / arm64 镜像,拉取失败会自动回退到源码构建;也可追加 --build 强制从源码构建。
  • 已有 MySQL 或达梦 DM8:如需连接外部数据库或启动第二套实例,见数据库与部署排错。

3. 登录与验证 ​

启动完成后,浏览器打开 http://127.0.0.1:8000:

  1. 使用默认账号 admin 和终端打印的随机初始密码登录(首次登录按提示修改密码)。
  2. 如果忘记初始密码,可在 kaiwu 目录执行 ./kaiwu credentials 重新查看(改密后请使用新密码)。
  3. 进入工作台后,可用以下命令快速核对服务健康状态:
bash
./kaiwu status
curl -fsS http://127.0.0.1:8088/actuator/health

停止平台执行 ./kaiwu down;下次在同一目录运行 ./kaiwu up 会自动复用已有数据卷。

v0.2.0 工作台,示例项目为订单中心

下一步 ​

Apache License 2.0