一个功能相当完整的个人博客 / 内容社区系统,前后端分离:后端 Spring Boot 3.5 + JDK 25,前端 Vue 3.5 + Vite + TypeScript。
除了常规的文章发布,还包含知识库、工具箱、游戏中心、金币成就、AI 助手等一堆「不一定需要、但挺好玩」的模块,适合当作全栈练习项目或二次开发底子。
| 模块 | 内容 |
|---|---|
| 内容 | 文章(Markdown 编辑)、分类/标签、专栏、评论与回复、点赞收藏、搜索、时间轴、RSS |
| 知识库 | Wiki 词条、树形目录、版本化、文档预览(Word / PPT / PDF / Excel) |
| 互动 | 微言、树洞、留言板、好友链接、通知中心、签到、金币与成就 |
| 个人空间 | 相册、音乐播放、旅行足迹、随笔笔记、卡片、涂鸦导航页 |
| 游戏 | 内置小游戏合集(含物理引擎、排行榜、收藏、成就) |
| 工具箱 | 40+ 在线小工具(编解码、时间戳、JWT、二维码、图片处理等) |
| AI | 助手「小风」:流式对话、知识库问答、写作助手、深度思考模式 |
| 后台 | 文章/评论/用户/分类/链接/工具/Wiki 管理、系统配置、会话管理 |
| 层 | 选型 |
|---|---|
| 后端 | Spring Boot 3.5、JDK 25、MyBatis-Plus 3.5、Druid、Lombok、Hutool、Fastjson2 |
| 数据库 | MySQL 8(utf8mb4) |
| 存储 | 本地磁盘 / 阿里云 OSS(可切换) |
| AI | DeepSeek(OpenAI 兼容协议),支持 SSE 流式输出 |
| 文档 | SpringDoc OpenAPI 3(/swagger-ui.html) |
| 前端 | Vue 3.5、Vite 8、TypeScript、Element Plus、Pinia、vue-router、md-editor-v3 |
| 部署 | Dockerfile + docker-compose、Nginx 反代 |
flowchart LR
U[浏览器] --> N[Nginx / OpenResty]
N -->|静态资源| S1[blog-ui dist]
N -->|/api| B[blog-server :8080]
B --> DB[(MySQL 8)]
B --> OSS[阿里云 OSS 或本地磁盘]
B --> AI[DeepSeek API]
B --> MAIL[SMTP]
后端按职责拆成 5 个 Maven 模块:
| 模块 | 职责 |
|---|---|
blog-common |
实体、常量、枚举、工具类、通用返回 |
blog-framework |
缓存、AOP、拦截器、全局异常、配置 |
blog-storage |
文件存储抽象(local / aliyun_oss) |
blog-ai |
AI 对话、知识库检索 |
blog-server |
Controller、Service、Mapper、启动类 |
| 依赖 | 版本 |
|---|---|
| JDK | 25 |
| Maven | 3.9+ |
| MySQL | 8.0+ |
| Node.js | 20.19+ / 22.12+ |
| npm | 10+ |
mysql -uroot -p < blog/sql/fublog_init.sql
# 可选:示例数据与后续增量脚本
mysql -uroot -p fublog < blog/sql/article.sqlfublog_init.sql 只含表结构与基本种子数据,不含示例文章。其余 *_v1.2.x.sql 是各版本的增量脚本,按需导入。
本项目刻意不提供默认密钥。缺配置时应用会 fail-fast 退出,避免带着默认密钥上线。
cp secret.example.yml ~/.fublog/secret.yml
# Windows: copy secret.example.yml %USERPROFILE%\.fublog\secret.yml填入两个不同的 16 字节值:
fublog:
security:
transport-key: 你的传输层密钥16字节 # 会下发到浏览器,仅作混淆
server-key: 你的服务端密钥16字节 # 绝不下发前端生成随机值:
node -e "console.log(require('crypto').randomBytes(12).toString('base64url').slice(0,16))"
⚠️ 两把密钥取值必须不同。transport-key会随前端产物下发到浏览器,如果它同时又是server-key,等于把服务端密钥公开了。
cd blog-ui
cp .env.example .env.local把 VITE_TRANSPORT_KEY 填成和后端 transport-key 完全一致的值。API 地址留空即自动用「当前域名 + /api」。
cd blog
mvn clean package -DskipTests
java -jar blog-server/target/blog-server-*.jar数据库口令通过 ~/.fublog/secret.yml 的 spring.datasource.password 或环境变量 SPRING_DATASOURCE_PASSWORD 注入。
cd blog-ui
npm install
npm run dev # 开发,默认 http://localhost:5173
npm run build # 生产构建,产物在 dist/cd blog
docker compose up -d # 后端,默认只绑 127.0.0.1:18080前端 npm run build 后把 dist/ 交给 Nginx,参考 blog-ui/nginx.conf(/api 反代到 fublog-server:8080)。
fublog_init.sql 里的管理员种子口令是占位符 CHANGE_ME_BEFORE_USE,无法直接登录。首次部署后按脚本内的注释执行一次提权 SQL,改成你自己的口令(后端已支持 MD5 → BCrypt 自动升级)。
| 配置项 | 位置 | 说明 |
|---|---|---|
fublog.security.transport-key |
~/.fublog/secret.yml 或 FUBLOG_TRANSPORT_KEY |
登录/注册/改密的传输层 AES 密钥,需与前端一致 |
fublog.security.server-key |
仅 secret.yml 或 FUBLOG_SERVER_KEY |
sys_config 的 ENC: 解密 + token 签名 |
spring.datasource.password |
secret.yml 或 SPRING_DATASOURCE_PASSWORD |
数据库口令 |
store.type |
secret.yml / 环境变量 STORE_TYPE / 后台配置 |
local 或 aliyun_oss |
store.aliyun.* |
同上 | OSS 的 AK/SK、bucket、CDN 域名 |
fublog.ai.api-key |
同上 | DeepSeek API Key |
spring.mail.* |
同上 | SMTP 发信(可选) |
VITE_TRANSPORT_KEY |
blog-ui/.env.local |
与后端 transport-key 一致 |
VITE_API_BASE_URL |
blog-ui/.env.local |
留空则自动用同域 /api |
优先级:环境变量 > ~/.fublog/secret.yml > application.yml。
sys_config 表的配置由 addFirst 注入,优先级高于以上三者——所以不要用后台「系统配置」界面保存密钥类配置,它会把值写进数据库(进而进备份、进导出)。
fublog
├── blog/ 后端(Maven 多模块)
│ ├── blog-common/ 实体、常量、工具
│ ├── blog-framework/ 缓存、AOP、异常、配置
│ ├── blog-storage/ 文件存储(local / OSS)
│ ├── blog-ai/ AI 对话与知识库
│ ├── blog-server/ 控制器、服务、Mapper、启动类
│ ├── sql/ 数据库脚本(初始化 + 增量)
│ ├── Dockerfile
│ └── docker-compose.yml
├── blog-ui/ 前端(Vue 3 + Vite)
│ ├── src/
│ ├── nginx.conf
│ └── .env.example
├── secret.example.yml 后端敏感配置模板
└── deploy.ps1 部署脚本(服务器地址在 deploy.config.ps1,已被忽略)
- 无单元测试:
src/test下只有一个空的contextLoads。 - CORS 默认放行所有来源且允许携带凭据(
CorsConfig),生产环境请收紧为你的域名。 - 口令存储仍在 MD5 → BCrypt 的迁移期:旧账号首次登录后会自动升级,新注册走 BCrypt。
- 前端产物内联了
VITE_TRANSPORT_KEY,这只做传输层混淆,不能替代 HTTPS。 - 部分外部依赖在运行时从公网拉取(hitokoto、今日诗词、live2d CDN 等),离线环境会降级或失败。
- 内置表情、字体等素材的授权情况见 THIRD-PARTY-NOTICES.md。
- 设计参考了开源博客系统 POETIZE(作者 Sara,AGPL-3.0),本项目在其设计思路上做了大量重构与扩展。
- 见 THIRD-PARTY-NOTICES.md 了解第三方库与素材的授权。