快速开始

本文带你完成 BlogLoom 的最小可运行环境：初始化数据库、启动后端、启动管理后台与博客前台。

不想在服务器安装 JDK 与 Node.js？可直接参考 Docker 部署一键启动。

准备工作

确保本机具备以下环境：

创建数据库：

CREATE DATABASE blogloom
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

复制并填写数据库连接配置：

cp bin/local/deploy.conf.example bin/local/deploy.conf

执行增量 SQL 完成初始化：

bin/local/upgrate-sql.sh --dry-run   # 预览待执行 SQL
bin/local/upgrate-sql.sh             # 执行并记录

脚本会按时间戳顺序执行 sql/increment/ 下的增量脚本（基线已包含建表语句），并将执行记录写入 sql/local/，可安全重复执行。详见初始化数据库。

本地开发配置位于：

blog-backend/src/main/resources/application-dev.properties

至少检查数据库、token.secretKey 与访问地址配置，然后启动：

cd blog-backend
mvn spring-boot:run

后端默认运行在 8090 端口。

cd blog-cms-ui
npm install
npm run dev

访问 http://localhost:8079，使用默认账号登录：

用户名：admin
密码：123456

cd blog-view-ui
npm install
npm run dev

访问 http://localhost:8080 查看博客站点。