蘑菇博客,一个基于微服务架构的前后端分离博客系统
蘑菇博客,一个基于微服务架构的前后端分离博客系统。前台使用Vue + Element , 后端使用spring boot + spring cloud + mybatis-plus进行开发,使用 Jwt + Spring Security做登录验证和权限校验,使用ElasticSearch和Solr作为全文检索服务,使用Github Actions完成博客的持续集成,文件支持上传七牛云。
- 从大学的时候开始,就一直想要搭建一套属于自己的博客系统,但是一直被没有去弄,现在时间多了,结合目前流行的技术栈,使用前后端分离架构进行项目的开发,也希望自己能够将项目一步步进行完善。
- 蘑菇博客大部分功能是我个人进行开发的,因能力有限,其中很多技术都是一边学习一边使用的,可以说蘑菇博客也是一个我用来熟悉技术的项目,所以很多地方可能考虑不周,在加上没怎么接触公司实际项目,故有能改正的地方,还请各位老哥能够指出~
- 现在挺多是SSM或者SSH的博客管理系统,想用spring boot + spring cloud + vue 的微服务架构进行尝试项目的构建,里面很多功能可能只是为了满足自己的学习需求而引入的,因此本博客也是一个非常好的SpringBoot、SpringCloud以及Vue技术的入门学习项目。
- 由于原来做过vue + element-ui 做过管理系统,所以现在打算做一套自己的、基于当前最新技术栈、前后端分离的微服务博客系统。
- 考虑到门户网站使用Vue不是很好支持SEO优化,所以门户网站采用Nuxt.js进行开发(因部署时遇到问题,无法完成正常部署,故搁置...欢迎有了解nuxt或者SEO优化的老哥一起探讨~)
- 友好的代码结构及注释,便于阅读及二次开发
- 实现前后端分离,通过Json进行数据交互,前端再也不用关注后端技术
- 页面交互使用Vue2.x,极大的提高了开发效率。
- 引入swagger文档支持,方便编写API接口文档。
- 引入RabbitMQ消息队列,用于邮件发送、更新Redis和Solr
- 引入JustAuth第三方登录开源库,支持Gitee、Github账号登录。
- 引入ElasticSearch和Solr作为全文检索服务,并支持可插拔配置
- 引入Github Actions 完成蘑菇博客的持续集成、持续部署。
- 引入七牛云对象存储,同时支持本地文件存储
- 引入RBAC权限管理设计,灵活的权限控制,满足绝大部分的权限需求。(后期考虑到按钮级别)
- 引入Zipkin链路追踪,聚合各业务系统调用延迟数据,可以一眼看出延迟高的服务
- 自定义参数校验注解,轻松实现后端参数校验
文档地址:http://moxi159753.gitee.io/mogu_blog_doc
备用文档地址:http://doc.moguit.cn
目前项目托管在Gitee和Github平台上中,欢迎大家star 和 fork 支持~
- MoguBlog 是一款基于最新技术开发的多人在线、简洁的博客系统。
- mogu_admin: 提供admin端API接口服务;
- mogu_web:提供web端API接口服务;
- mogu_eureka: 服务发现和注册
- mogu_picture: 图片服务,用于图片上传和下载;
- mogu_sms:消息服务,用于更新ElasticSearch、Solr索引、邮件和短信发送
- mogu_monitor:监控服务,集成SpringBootAdmin用于管理和监控SpringBoot应用程序
- mogu_search:搜索服务,ElasticSearch和Solr作为检索工具,可插拔配置
- mogu_utils: 是常用工具类;
- mogu_xo: 是存放 Entity,Service,Dao层的
- mogu_base: 是一些Base基类
- mogu_config: 是存放一些配置
- mogu_zipkin:链路追踪服务,目前使用java -jar的方式启动
- doc: 是蘑菇博客的一些文档和数据库文件
- vue_mogu_admin:VUE的后台管理页面
- vue_mogu_web:VUE的门户网站
- nuxt_mogu_web:Nuxt的门户网站
技术 | 说明 | 官网 |
---|---|---|
Vue.js | 前端框架 | https://vuejs.org/ |
Vue-router | 路由框架 | https://router.vuejs.org/ |
Vuex | 全局状态管理框架 | https://vuex.vuejs.org/ |
Nuxt.js | 创建服务端渲染 (SSR) 应用 | https://zh.nuxtjs.org/ |
Element | 前端ui框架 | https://element.eleme.io |
Axios | 前端HTTP框架 | https://github.com/axios/axios |
Echarts | 图表框架 | www.echartsjs.com |
CKEditor | 富文本编辑器 | https://ckeditor.com/ |
Highlight.js | 代码语法高亮插件 | https://github.com/highlightjs/highlight.js |
Tui-editor | Markdown编辑器 | https://github.com/nhn/tui.editor |
vue-cropper | 图片裁剪组件 | https://github.com/xyxiao001/vue-cropper |
vue-image-crop-upload | vue图片剪裁上传组件 | https://github.com/dai-siki/vue-image-crop-upload |
参考 window环境下配置蘑菇博客环境,能够在window下搭建蘑菇博客的开发环境
参考 使用Docker快速搭建蘑菇博客,能够快速在服务器中,搭建好博客系统
参考蘑菇博客如何部署到阿里云服务器,在你修改蘑菇博客源码后,将项目打包部署到云服务器
参考 使用Github Action完成蘑菇博客持续集成 ,在你提交一个push请求后,通过Github Actions能够完成蘑菇博客自动化 编译、打包、部署等操作。
参考蘑菇博客切换搜索模式,完成蘑菇博客的搜索引擎切换,目前支持Solr、ElasticSearch、mysql的方式
参考蘑菇博客切换七牛云存储,配置文件的七牛云对象存储,及本地文件存储
参考使用Zipkin搭建蘑菇博客链路追踪,通过聚合各业务系统调用延迟数据,达到链路调用监控跟踪,快速定位其中延迟高的服务
工具 | 说明 | 官网 |
---|---|---|
IDEA | Java开发IDE | https://www.jetbrains.com/idea/download |
WebStorm | 前端开发IDE | https://www.jetbrains.com/webstorm/ |
RedisDesktop | Redis可视化工具 | https://redisdesktop.com/download |
SwitchHosts | 本地Host管理 | https://oldj.github.io/SwitchHosts/ |
X-shell | Linux远程连接工具 | https://xshell.en.softonic.com/ |
X-ftp | Linux文件传输工具 | https://www.netsarang.com/zh/all-downloads/ |
SQLyog | 数据库连接工具 | https://sqlyog.en.softonic.com/ |
ScreenToGif | Gif录制工具 | https://www.screentogif.com/ |
工具 | 版本号 | 下载 |
---|---|---|
JDK | 1.8 | https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html |
Maven | 3.3.0+ | http://maven.apache.org/ |
Elasticsearch | 6.3.0 | https://www.elastic.co/downloads |
Solr | 7.0 | http://lucene.apache.org/solr/ |
MySQL | 5.6 | https://www.mysql.com/ |
Erlang | 20.3 | https://www.erlang.org/ |
RabbitMQ | 3.7.4 | http://www.rabbitmq.com/download.html |
Nginx | 1.10 | http://nginx.org/en/download.html |
Redis | 3.3.0 | https://redis.io/download |
- 后台登录:用户:admin,密码:mogu2018
- Mysql:用户:root,密码:mogu2018
- Redis:密码:mogu2018
- 远程SSH初始密码:用户:root,密码:mogu2018
- RabbitMQ管理页面: 用户:guest,密码:guest
- Eureka管理页面: 用户:user,密码:password123
- 蘑菇博客监控页面:用户:user,密码:password123
- 感谢杨青小姐姐的博客模板,http://www.yangqq.com/
- 感谢PanJiaChen提供的vue-element-admin: https://github.com/PanJiaChen/vue-element-admin
- Vue项目参考这篇博客:https://segmentfault.com/a/1190000009506097
- 感谢苞米豆提供的Mybatis-plus框架:http://mp.baomidou.com/
- 感谢JetBrains提供的免费开源License: https://www.jetbrains.com/?from=mogu_blog_v2
- 感谢yadong.zhang提供的第三方登录开源库:https://gitee.com/yadong.zhang/JustAuth.git
刚刚创建了一个QQ群,目前项目还存在很多不足之处,欢迎各位老哥进群交流~
QQ群(备注:蘑菇博客) | QQ(备注:蘑菇博客) |
---|---|
- 集成Github Actions,完成蘑菇博客持续集成服务
- 门户网站增加登录页面
- 支持第三方登录
- 集成ElasticSearch和Solr
- 将图片存储在七牛云中
- 写一个评论模块,用于替换搜狐畅言
- 增加更新记录
- 增加数据字典管理
- 使用页面静态化技术对博客详情页静态化
- 解决Nuxt_mogu_web中存在的问题,使博客能被搜索引擎收录
- 前端增加用户模块
- 让原创文章能够同步到多平台,如:CSDN,掘金,博客园等
开源项目离不开大家的支持,如果您有好的想法或者代码实现,欢迎提交Pull Request~
- fork本项目到自己的repo
- 把fork过去的项目也就是你仓库中的项目clone到你的本地
- 修改代码
- commit后push到自己的库
- 发起PR(pull request) 请求,提交到
dev
分支 - 等待作者合并
服务器和域名等服务的购买和续费都会产生一定的费用,为了维持项目的正常运作,如果觉得本项目对您有帮助的话,欢迎朋友能够给予一些支持,非常感谢~
微信 | 支付宝 |
---|---|
Admin端 | |
---|---|
Web端 | |