Skip to content
Barney0809Public

About

FuBlog 拾光笺 · Spring Boot 3.5 + Vue 3 个人博客 / 内容社区系统

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FuBlog · 拾光笺

一个功能相当完整的个人博客 / 内容社区系统,前后端分离:后端 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]
Loading

后端按职责拆成 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+

快速开始

1. 初始化数据库

mysql -uroot -p < blog/sql/fublog_init.sql
# 可选:示例数据与后续增量脚本
mysql -uroot -p fublog < blog/sql/article.sql

fublog_init.sql 只含表结构与基本种子数据,不含示例文章。其余 *_v1.2.x.sql 是各版本的增量脚本,按需导入。

2. 配置两把密钥(必填,否则后端启动失败)

本项目刻意不提供默认密钥。缺配置时应用会 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,等于把服务端密钥公开了。

3. 前端环境变量

cd blog-ui
cp .env.example .env.local

把 VITE_TRANSPORT_KEY 填成和后端 transport-key 完全一致的值。API 地址留空即自动用「当前域名 + /api」。

4. 启动后端

cd blog
mvn clean package -DskipTests
java -jar blog-server/target/blog-server-*.jar

数据库口令通过 ~/.fublog/secret.yml 的 spring.datasource.password 或环境变量 SPRING_DATASOURCE_PASSWORD 注入。

5. 启动前端

cd blog-ui
npm install
npm run dev          # 开发,默认 http://localhost:5173
npm run build        # 生产构建,产物在 dist/

6. Docker 部署(可选)

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 了解第三方库与素材的授权。

License

MIT

About

FuBlog 拾光笺 · Spring Boot 3.5 + Vue 3 个人博客 / 内容社区系统

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages