蘑菇博客，一个基于微服务架构的前后端分离博客系统
虽然我知道很多人来到这里，都是pull 或者dowonload了一下代码，就把项目关闭了。突然有一天想起了看看蘑菇博客这个项目有没有更新，然后继续执行以下操作：
- 更新了，pull或者download代码
- 没更新，直接关闭项目
但是我还是非常希望各位小伙伴能够 多多star支持，您的点赞就是我维护的动力！
如果您有任何相关建议，欢迎在issue或者群里提出，再次感谢大家的支持~
项目后台目前有Eureka版本和Nacos版本，其中Eureka版本使用的是SpringCloud一些组件，Nacos版本使用的是SpringCloudAlibaba的一些组件，例如Nacos、Sentinel
- Eureka版本请切换至Eureka分支（将不再进行新功能的开发）
- Nacos版本请切换至Nacos分支（作为以后长期维护的分支）
- 目前移动端版本的代码已经开源至Nacos分支，如果想体验的小伙伴可以移动至Nacos分支~
蘑菇博客，一个基于微服务架构的前后端分离博客系统。前台使用Vue + Element , 后端使用spring boot + spring cloud + mybatis-plus进行开发，使用 Jwt + Spring Security做登录验证和权限校验，使用ElasticSearch和Solr作为全文检索服务，使用Github Actions完成博客的持续集成，文件支持上传七牛云，使用uniapp和ColorUi搭建移动端博客平台。
- 蘑菇博客大部分功能是我个人进行开发的，因能力有限，其中很多技术都是一边学习一边使用的，可以说蘑菇博客也是一个我用来熟悉技术的项目，所以很多地方可能考虑不周，在加上没怎么接触公司实际项目，故有能改正的地方，还请各位老哥能够指出~
- 现在挺多是SSM或者SSH的博客管理系统，想用spring boot + spring cloud + vue 的微服务架构进行尝试项目的构建，里面很多功能可能只是为了满足自己的学习需求而引入的，因此本博客也是一个非常好的SpringBoot、SpringCloud以及Vue技术的入门学习项目。
- 由于原来做过vue + element-ui 做过管理系统，所以现在打算做一套自己的、基于当前最新技术栈、前后端分离的微服务博客系统。
- 考虑到门户网站使用Vue不是很好支持SEO优化，所以门户网站采用Nuxt.js进行开发（因部署时遇到问题，无法完成正常部署，故搁置...欢迎有了解nuxt或者SEO优化的老哥一起探讨~）
- 蘑菇博客中的一些文章，很多都来自我平时的学习笔记，目前托管在另一个仓库：LearningNotes，里面涵盖了JVM、JUC、Java，Spring，SpringCloud，计算机网络，操作系统，数据结构，Vue、Linux 等 ，感兴趣的小伙伴可以跳转该仓库 Star支持一下
首先特别感谢阿里云提供的 学生“在家实践” 计划，免费提供的6个月的2核4G 1M的服务器，所以就刚好以此用来做蘑菇博客的演示站点，同时我也在搭建的时候，顺便录制了一套视频：利用阿里云免费服务器搭建个人博客 ，感兴趣的小伙伴可以参考视频一起完成部署~
【演示前端】：http://demoweb.moguit.cn/
【演示后端】：http://demoadmin.moguit.cn/
【演示账号】：mogu2018 mogu2018
【QQ小程序】蘑菇博客的移动端版本，可以扫码体验（代码在Nacos分支）
- 后台登录：用户：admin，密码：mogu2018
- Mysql：用户：root，密码：mogu2018
- Redis：密码：mogu2018
- 远程SSH初始密码：用户：root，密码：mogu2018
- RabbitMQ管理页面： 用户：guest，密码：guest
- Nacos管理页面： 用户：nacos，密码：nacos
- Sentinel管理页面： 用户：sentinel，密码：sentinel
- 蘑菇博客监控页面：用户：user，密码：password123
- Druid初始密码： 用户：admin，密码：123456
蘑菇博客使用了一些监控的Spring Cloud组件，但是并不一定都需要部署，必须启动的服务包含
nacos，nginx，rabbitmq, redis，mysql，mogu-sms，mogu-picture， mogu-web, mogu-admin
其它的服务都可以不启动，也不影正常使用，可以根据自身服务器配置来启动
最低配置：1核2G 需要开启虚拟内存
推荐配置：2核4G
【阿里云】 限量爆款低至91.8元/年 点我进入
【腾讯云】云产品限时秒杀，爆款1核2G云服务器，首年99元 点我进入
【阿里云翼计划】 1核2G 5M / 年 (博主目前使用的) 仅需114元 点我进入
(仅限学生或未满24岁的用户)
- 友好的代码结构及注释，便于阅读及二次开发
- 实现前后端分离，通过Json进行数据交互，前端再也不用关注后端技术
- 页面交互使用Vue2.x，极大的提高了开发效率。
- 引入swagger文档支持，方便编写API接口文档。
- 引入RabbitMQ 消息队列，用于邮件发送、更新Redis和Solr
- 引入JustAuth第三方登录开源库，支持Gitee、Github账号登录。
- 引入ElasticSearch 和 Sol r作为全文检索服务，并支持可插拔配置
- 引入Github Actions工作流，完成蘑菇博客的持续集成、持续部署。
- 引入七牛云对象存储，同时支持本地文件存储
- 引入RBAC权限管理设计，灵活的权限控制，按钮级别的细粒度权限控制，满足绝大部分的权限需求
- 引入Zipkin链路追踪，聚合各业务系统调用延迟数据，可以一眼看出延迟高的服务
- 采用自定义参数校验注解，轻松实现后端参数校验
- 采用AOP+自定义注解+Redis实现限制IP接口访问次数
- 采用自研的评论模块，实现评论邮件通知
- 采用Nacos作为服务发现和配置中心，轻松完成项目的配置的维护
- 采用Sentinel流量控制框架，通过配置再也不怕网站被爆破
- 采用uniapp 和ColorUi 完成蘑菇博客的移动端门户页面搭建
- 支持多种文本编辑器，Markdown编辑器(Vditor)和富文本编辑器(CKEditor)随心切换
文档地址：http://moxi159753.gitee.io/mogu_blog_doc
备用文档地址：http://doc.moguit.cn
目前项目托管在Gitee和Github平台上中，欢迎大家star 和 fork 支持~
- Gitee地址：https://gitee.com/moxi159753/mogu_blog_v2
- Github地址：https://github.com/moxi624/mogu_blog_v2
FAQ文档汇集了一些小伙伴在使用过程中遇到的问题，在进行蘑菇博客的搭建和部署的时，遇到问题后可以优先查看本FAQ文档看看是否出现，这里将收集各个小伙伴遇到的问题，希望各位小伙伴能自己提前翻阅一下，高效提问，避免重复提问。
如果你遇到了FAQ文档中没有出现的问题，并且已经解决了，欢迎能够提交Pull Request更新文档，或者直接在群里给我反馈，感谢各位小伙伴~，希望大家在部署和使用的时候能够少走弯路。
- MoguBlog 是一款基于最新技术开发的多人在线、简洁的博客系统。
- mogu_admin: 提供admin端API接口服务；
- mogu_web：提供web端API接口服务；
- mogu_eureka： 服务发现和注册
- mogu_picture： 图片服务，用于图片上传和下载；
- mogu_sms：消息服务，用于更新ElasticSearch、Solr索引、邮件和短信发送
- mogu_monitor：监控服务，集成SpringBootAdmin用于管理和监控SpringBoot应用程序
- mogu_spider：爬虫服务
（目前还未完善） - mogu_gateway：网关服务
（目前还未完善） - mogu_zipkin：链路追踪服务，
目前使用java -jar的方式启动 - mogu_search：搜索服务，ElasticSearch和Solr作为全文检索工具，支持可插拔配置，默认使用SQL搜索
- mogu_commons：公共模块，主要用于存放Entity实体类、Feign远程调用接口、以及公共config配置
- mogu_utils: 是常用工具类；
- mogu_xo: 是存放 VO、Service，Dao层的
- mogu_base: 是一些Base基类
- doc: 是蘑菇博客的一些文档和数据库文件
- vue_mogu_admin：VUE的后台管理页面
- vue_mogu_web：VUE的门户网站
- uniapp_mogu_web：基于uniapp 和 colorUi 的蘑菇博客移动端门户页面（Nacos分支）
- nuxt_mogu_web：Nuxt的门户网站，主要用于支持SEO搜索引擎优化
（目前还未完善）
参考 window环境下配置蘑菇博客环境，能够在window下搭建蘑菇博客的开发环境
参考 使用Docker快速搭建蘑菇博客，能够快速在Linux服务器中，搭建好博客系统
参考蘑菇博客如何部署到阿里云服务器，在你修改蘑菇博客源码后将项目打包部署到云服务器
参考 使用Github Action完成蘑菇博客持续集成 ，在你提交一个push请求后，通过Github Actions能够完成蘑菇博客自动化 编译、打包、部署等操作。
参考蘑菇博客切换搜索模式，完成蘑菇博客的搜索引擎切换，目前支持Solr、ElasticSearch、mysql的方式
参考蘑菇博客切换七牛云存储，配置文件的七牛云对象存储，及本地文件存储
参考使用Zipkin搭建蘑菇博客链路追踪，通过聚合各业务系统调用延迟数据，达到链路调用监控跟踪，快速定位其中延迟高的服务
参考蘑菇博客Nacos部署指南，搭建蘑菇博客的服务注册和配置中心
参考蘑菇博客Sentinel安装指南，Sentinel被称为分布式系统的流量防卫兵，相当于Hystrix
参考蘑菇博客QQ小程序发布指南，完成蘑菇博客uniapp移动端的启动和发布
参考蘑菇博客如何扩展新的功能和页面，在蘑菇博客现有架构基础上，开发自己需要的页面。
| 工具 | 说明 | 官网 |
|---|---|---|
| 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 |
| Zipkin | 2.12.5 | https://search.maven.org/remote_content?g=io.zipkin.java&a=zipkin-server&v=LATEST&c=exec |
| Nacos | 1.3.2 | https://github.com/alibaba/nacos/releases |
| Sentinel | 1.7.2 | https://github.com/alibaba/Sentinel/releases |
项目起初参考了很多开源项目的解决方案，开源不易，感谢分享
- 感谢杨青小姐姐的博客模板：http://www.yangqq.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
- 感谢 bihell 的 Dice 博客项目：https://github.com/bihell/Dice
- 感谢 pppercyWang 提供的Emoji表情评论组件：vue-emoji-comment
- 感谢 若依 提供的RuoYi项目：https://gitee.com/y_project/RuoYi
- 感谢 yaowei9363 提供的 侧目录组件： vue-side-catalog
- 感谢 奇文社区 提供的 奇文网盘：https://gitee.com/qiwen-cloud/qiwen-file
- 感谢 weilanwl 提供的 ColorUI：https://github.com/weilanwl/ColorUI
刚刚创建了一个QQ群 (加群备注：蘑菇博客) 
，目前项目还存在很多不足之处，欢迎各位老哥进群进行技术交流，为了防止广告进入，希望加群的时候能添加备注，谢谢~
QQ群（加群备注：蘑菇博客） |
QQ（备注：蘑菇博客） |
|---|---|
 |
 |
- 集成Github Actions，完成蘑菇博客持续集成服务
- 门户网站增加登录页面
- 支持第三方登录
- 集成ElasticSearch和Solr
- 将图片存储在七牛云中
- 写一个评论模块，用于替换搜狐畅言
- 按钮级别的细粒度权限控制
- 增加评论表情
- 增加数据字典管理
- 前端增加用户个人中心
- 增加一个FAQ常见问题文档
- 集成表单构建页面，来源于RuoYi
- 增加博客详情页目录导航，来源于vue-side-catalog
- 资源管理页面集成网盘管理
- 新建Nacos分支，用于替换Eureka作为服务发现组件和配置中心
- 使用Sentinel做服务限流和熔断
- 增加蘑菇博客小程序项目 uniapp_mogu_web，基于ColorUI 和 Uniapp
- 富文本编辑器和Markdown编辑器任意切换
- 完善网盘管理
- 增加更新记录
- 完善爬虫模块
- 完善网关模块
- 使用Freemark页面静态化技术对博客详情页静态化
- 解决Nuxt_mogu_web中存在的问题，使博客能被搜索引擎收录
- 让原创文章能够同步到多平台，如：CSDN，掘金，博客园等
- 增加博客迁移功能，让其它平台的博客，如：CSDN、博客园，WordPress能够同步到蘑菇博客中
- 适配门户页面的移动端布局
开源项目离不开大家的支持，如果您有好的想法或者代码实现，欢迎提交Pull Request~
- fork本项目到自己的repo
- 把fork过去的项目也就是你仓库中的项目clone到你的本地
- 修改代码
- commit后push到自己的库
- 发起PR（pull request） 请求，提交到
dev分支 - 等待作者合并
服务器和域名等服务的购买和续费都会产生一定的费用，为了维持项目的正常运作，如果觉得本项目对您有帮助的话，欢迎朋友能够给予一些支持，非常感谢~
| 微信 | 支付宝 |
|---|---|
 |
 |
目前移动端版本的代码已经开源至Nacos分支，如果想体验的小伙伴可以移动至Nacos分支
| Admin端 | |
|---|---|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
|
| Web端 | |
 |
 |
|
 |
 |
 |
 |
 |
 |
 |