README.md · Myles Yang/MyBlog

# MyBlog个人博客系统

**传送门**

- 预览地址：http://myblog.refrain.xyz/madmin
- 后台管理：[Github](https://github.com/snwjas/MyBlog) | [Gitee](https://gitee.com/snwjas/my-blog)
- 后台前端：[Github](https://github.com/snwjas/MyBlog-Admin) | [Gitee](https://gitee.com/snwjas/my-blog-admin)
- 前台前端：[Github](https://github.com/snwjas/MyBlog-App) | [Gitee](https://gitee.com/snwjas/my-blog-app)

## 项目介绍

MyBlog主要是基于 SpringBoot + Vue 前后端分离开发的一款动态个人博客系统，主要功能有文章管理、分类管理、标签管理、附件管理、评论管理和友链管理等。学习 Java 也有一段时间了，这个是本人第一个真正意义上项目，希望借此项目锻炼自己编码能力，激励自己多写文章。

`鸣谢`：本项目在诸多方面，特别是UI设计方面，借鉴学习了[Halo](https://halo.run/)。

如果本项目对你有帮助，不妨点个***Star***，你的支持就是对我行动的最大鼓励！

## 技术使用

**规范实现**：

- 统一请求响应
- 统一异常处理
- Java Bean Validation参数校验
- 面向AOP编程：通过自定义注解实现接口限流、操作日志记录等
- ……

**开发环境**

- 工具：IntelliJ IDEA
- JDK 1.8
- 数据库：MySQL 8.0.15
- 项目构建：后端Maven、前端 Webpack

**后端**

- Web框架：Spring Boot
- 安全框架：Spring Security
- 字段校验：Spring Validation
- 持久层：[MyBatis-Plus](https://mybatis.plus/)
- 接口文档：Swagger2
- Lombok：请确保您的 IDE 安装了此插件
- 使用简单的自定义缓存，可更换成 Redis
- 其他：[Thumbnailator](https://github.com/coobird/thumbnailator)、[wordfilter](https://gitee.com/sharegpj/wordfilter)、等等

**前端**

- Vue.js2 全家桶
- Element-UI
- [vue-admin-template](https://github.com/PanJiaChen/vue-admin-template) 后台模板
- axios
- echarts
- [mavon-editor](https://github.com/hinesboy/mavonEditor)
- 等等

## 快速开始

1、新建数据库`myblogdb`，选择编码为utf8mb4；然后导入项目源码下resources目录的表结构`schema.sql`。

2、环境准备完毕后，修改配置文件`application-dev.yaml`中的`datasource`配置即可以开发环境运行：

- 默认后台地址：http://localhost:9096/admin

- 默认账号密码：admin / 123456

你也可以配置博客的一些属性，其配置前缀为`my-blog`

| 属性                               | 默认值                     | 说明                           |
| ---------------------------------- | -------------------------- | ------------------------------ |
| doc-enable                         | false                      | swagger api文档是否启用        |
| admin-path                         | “admin”                    | 后台管理入口，不需要添加'/'    |
| admin-web-path                     | “classpath:/admin/”        | 管理端WEB静态文件所在目录      |
| app-web-path                       | “classpath:/app/”          | 展示前端WEB静态文件所在目录    |
| allow-login-failure-seconds        | 3600                       | 允许连续登录失败的时间(单位秒) |
| allow-login-failure-count          | 10                         | 允许连续登录失败的次数         |
| remember-me-token-validity-seconds | 604800                     | 登录记住我token时间(单位秒)    |
| file-save-path                     | “[user.home]/MyBlog/files” | 上传文件保存路径               |

请将打包后的管理端 / 展示前端文件分别放置以上属性`admin-web-path` / `app-web-path`目录

## 项目结构

## 数据库设计

数据库名：`myblogdb`，数据库统一编码：`utf8mb4`

本项目共设计了 11个表，分别是：user(用户表)、blog(文章表)、category(分类表)、tag(标签表)、blog_tag(文章标签关联表)、comment(评论表)、attachment(附件表)、link(友链表)、options(系统选项/设置表)、log(日志表)和statistics(数据统计表)，具体设计如下：

**user : 用户表**

**blog : 博客文章表**

可以将 original_content 和 format_content 抽离出一张表。

**category : 博客分类表**

**tag : 博客标签表**

|    字段     |       类型       |   约束   |   说明   |
| :---------: | :--------------: | :------: | :------: |
|     id      | int(11) unsigned |   主键   |  标签id  |
|    name     |   varchar(63)    | not null |  标签名  |
| update_time |    timestamp     |          |      更新时间       |
| create_time |    timestamp     |          |      创建时间       |

**blog_tag : 博客标签关联表**

**comment : 博客评论表**

**attachment  : 附件表**

**link : 友链表**

**options : 系统设置**

|     字段     |       类型       |   约束   |    说明    |
| :----------: | :--------------: | :------: | :--------: |
|      id      | int(11) unsigned |   主键   | 系统设置id |
|  option_key  |   varchar(127)   | not null |     键     |
| option_value |  varchar(1023)   | not null |     值     |
| update_time  |    timestamp     |          |  更新时间  |
| create_time  |    timestamp     |          |  创建时间  |

**log : 日志表**

|    字段     |        类型         | 约束 |          说明          |
| :---------: | :-----------------: | :--: | :--------------------: |
|     id      |  int(11) unsigned   | 主键 |         日志id         |
|   content   |    varchar(1023)    |      |        操作内容        |
|    type     | tinyint(4) unsigned |      |        操作类型        |
| ip_address  |       int(11)       |      | 操作人的ipv4地址，整型 |
| update_time |      timestamp      |      |        更新时间        |
| create_time |      timestamp      |      |        创建时间        |

**statistics : 统计表（统计每日的数据）**

**speciallist : 特殊清单**

|    字段     |        类型         | 约束 |   说明   |
| :---------: | :-----------------: | :--: | :------: |
|     id      |  int(11) unsigned   | 主键 |    ID    |
|    type     | tinyint(4) unsigned |      |   类型   |
|   content   |    varchar(511)     |      |   内容   |
| update_time |      timestamp      |      | 更新时间 |
| create_time |      timestamp      |      | 创建时间 |

Myles Yang/MyBlog

简介

发行版

贡献者

近期动态

Myles Yang/MyBlog .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Myles Yang/MyBlog