Forge Admin

Appearance

🔒 升级 PRO

全栈快速入门 ​

这是首次把 Forge Admin 跑起来的唯一规范入口。成功标准：能用默认账号登录，菜单加载，用户管理页有数据。

一次只走这一条路径

请只执行本页步骤，或只按分步页阅读解释。不要既跑本页又再跑一遍 init-db.sh。命令和配置以本页 Include 的共享片段为准。

适用：本地新环境，MySQL 8.0+。已有业务数据的库不要重跑全量初始化。

1. 环境检查 ​

环境版本要求验证命令
JDK17+java -version
Maven3.8+mvn -version
MySQL8.0+mysql --version
Redis6.0+redis-cli ping
Node.js20.19+node -v
pnpm8+pnpm -v

未安装时先看 环境搭建，再回到本页。

2. 获取源码 ​

bash
git clone https://gitee.com/ForgeLab/forge-admin.git
cd forge-admin

3. 初始化数据库 ​

新环境只执行 forge-server/scripts/db/init-db.sh。脚本已经导入全量 SQL。

bash
bash forge-server/scripts/db/init-db.sh \
  --host 127.0.0.1 \
  --port 3306 \
  --database forge_admin \
  --user root \
  --password your_password

脚本会创建数据库（或校正已有空库的默认字符集），统一为 utf8mb4 + utf8mb4_0900_ai_ci，然后导入全量 SQL 和 db/seed/required/。不要再手工导入一次全量 SQL。

如需演示数据，首次初始化用下面的命令替代上一条，不要先后执行两次：

bash
bash forge-server/scripts/db/init-db.sh \
  --database forge_admin \
  --user root \
  --password your_password \
  --with-demo

验证：SHOW CREATE DATABASE forge_admin; 必须是 utf8mb4_0900_ai_ci。解释、历史库和 Flyway 边界见 初始化数据库。Collation 混用见 START-DB-COLLATION-MIXED。

4. 配置 Admin ​

bash
cp forge-server/forge-admin-server/src/main/resources/application-dev.example.yml \
   forge-server/forge-admin-server/src/main/resources/application-dev.yml

编辑 application-dev.yml，把占位符改成本地值。不要提交真实密码。

yaml
spring:
  datasource:
    dynamic:
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/forge_admin?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&autoReconnect=true&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true
          username: root
          password: 'your_password'

spring.data:
  redis:
    host: localhost
    port: 6379
    password: 'your_redis_password'

Admin 官方启动端口是 8580。Flow 客户端官方覆盖地址是 http://127.0.0.1:8081。

完整配置键留在 Admin 配置参考。本页只改能连上 MySQL / Redis 的最小项。

5. 启动后端 ​

bash
cd forge-server
mvn clean install -DskipTests

启动 Admin：

bash
cd forge-server/forge-admin-server
mvn spring-boot:run

Admin 运行在 http://localhost:8580。日志出现 Started ForgeAdminApplication 且没有数据源 / Redis / Flyway 错误即视为成功。

可选启动 Flow（工作流需要）：

bash
cd forge-server/forge-flow/forge-flow-server
mvn spring-boot:run

Flow 官方端口是 8081，不是 Report 的 8581。

6. 启动前端 ​

bash
cd forge-admin-ui
pnpm install
pnpm dev

开发服务器默认是 http://localhost:3000。后端需已在 8580 就绪。

7. 可选服务 ​

Admin + 前端成功后再启动这些服务。它们不是第一次登录所必需。

服务官方启动端口说明
Admin8580forge-admin-server 活动 application.yml
Report8581forge-report-server 活动 application.yml
Flow8081forge-flow-server 活动 application.yml
App8583forge-app-server 活动 application.yml
前端开发3000Vite 开发服务器

FlowClientProperties 类内默认 URL 是 http://localhost:8080。Admin 官方配置覆盖为 http://127.0.0.1:8081。文档和启动清单一律使用官方启动端口 8081，不要把 Report 的 8581 写成 Flow。

  • Flow（8081）：第一个审批流程需要
  • Report（8581）：数据大屏需要
  • App（8583）：H5 / 移动端需要

8. 登录与验收 ​

打开 http://localhost:3000。

项目值
用户名admin
密码123456

这是初始化种子里的默认账号，仅用于本地首次验收。登录后立刻改密码，不要把这对凭据用于生产。

然后按 启动验收清单 勾选：登录成功、菜单加载、Flyway 无失败记录、用户列表有数据。

9. 失败时去哪 ​

现象入口
数据库连不上 / Collation / Flyway初始化数据库、START-DB-COLLATION-MIXED
后端起不来启动后端、常见报错索引
前端白屏或代理失败启动前端
其他首次启动症状快速开始常见问题

10. 下一步 ​

不要在本页继续复制完整教程。

相关文档 ​