蘑菇博客 http://www.moguit.cn 蘑菇博客，一个基于微服务架构的前后端分离博客系统 https://gitee.com/moxi159753/mogu_blog_v2 #%E9%A1%B9%E7%9B%AE%E4%BB%8

蘑菇博客

http://www.moguit.cn

蘑菇博客，一个基于微服务架构的前后端分离博客系统

https://gitee.com/moxi159753/mogu_blog_v2

#%E9%A1%B9%E7%9B%AE%E4%BB%8B%E7%BB%8D | #%E7%AB%99%E7%82%B9%E6%BC%94%E7%A4%BA | #%E9%A1%B9%E7%9B%AE%E7%89%B9%E7%82%B9 | #%E6%8A%80%E6%9C%AF%E9%80%89%E5%9E%8B | #%E9%A1%B9%E7%9B%AE%E7%9B%AE%E5%BD%95 | #%E9%A1%B9%E7%9B%AE%E6%96%87%E6%A1%A3 | #%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B | #%E8%A7%86%E9%A2%91%E6%95%99%E7%A8%8B| #%E7%A7%BB%E5%8A%A8%E7%AB%AF%E6%88%AA%E5%9B%BE | https://gitee.com/moxi159753/mogu_blog_v2/releases | https://gitee.com/moxi159753/LearningNotes

前言

https://gitee.com/moxi159753/LearningNotes/raw/master/doc/images/qq/%E6%B7%BB%E5%8A%A0%E9%99%8C%E6%BA%AA.png 是一个从三本院校一路摸滚翻爬上来的程序员。目前就职于字节跳动的Data商业化广告部门，是字节跳动全线产品的商业变现研发团队。这两天创建了一个 微信公众号【https://gitee.com/moxi159753/LearningNotes/raw/master/doc/images/qq/%E5%85%AC%E4%BC%97%E5%8F%B72.jpg】，未来将会在公众号上持续性的输出很多原创小知识以及学习资源，欢迎各位小伙伴关注我，和我一起共同学习，同时我也希望各位小伙伴能够给蘑菇博客项目多多 Star 支持，您的点赞就是我维护的动力！

项目已有较详细的 http://moxi159753.gitee.io/mogu_blog_doc ，同时包括了 Windows、Linux 以及 Docker 环境下蘑菇博客的搭建。在使用过程中遇到问题时，首先认真阅读项目搭建文档 ，同时 http://www.moguit.cn/info/288 还收集了小伙伴咨询的问题，可以提前阅读~

【提问前】可以先 https://www.baidu.com/ 或者 https://www.google.com/ 进行解决，有的问题通过搜索引擎很快就能得到解决

【提问前】可以首先看看 https://gitee.com/moxi159753/mogu_blog_v2/issues 或者 https://www.moguit.cn/info/288，可能你的问题别人也遇到过

【提问前】可以提前阅读 https://www.moguit.cn/info/311

【提问】推荐使用 https://gitee.com/moxi159753/mogu_blog_v2/issues 进行提问，因为issue解决后能够保留解决记录，帮助其它小伙伴避坑。其次可以使用 http://www.moguit.cn/#/question， ##关注&交流 或者 ##前言 进行提问。群里提问注意提问的时间，把遇到问题的详细过程都描述清楚，最好配上图文信息，这样能有利于更高效的解决问题。

字节内推

目前字节跳动拥有大量岗位需求，欢迎点击下方内推链接【内推码: WYU3X8M】选择合适的岗位投递。小伙伴们使用内推链接投递后，可以通过 公众号 联系我跟进面试进度。

提前批投递：https://jobs.toutiao.com/s/eGmrue1 ，社会招聘：https://job.toutiao.com/s/eGmBtNC

项目介绍

蘑菇博客( MoguBlog )，一个基于微服务架构的前后端分离博客系统。Web 端使用 Vue + ElementUi , 移动端使用 uniapp 和 ColorUI。后端使用 SpringCloud + SpringBoot + Mybatis-plus进行开发，使用 Jwt + SpringSecurity 做登录验证和权限校验，使用 ElasticSearch 和 Solr 作为全文检索服务，使用 Github Actions完成博客的持续集成，使用 ElasticStack 收集博客日志，文件支持上传本地、七牛云 和 Minio.

• 蘑菇博客大部分功能是我个人进行开发的，因能力有限，其中很多技术都是一边学习一边使用的，可以说蘑菇博客也是一个我用来熟悉技术的项目，所以很多地方可能考虑不周，故有能改正的地方，还请各位老哥能够指出~
• 现在挺多是SSM或者SSH的博客管理系统，想用 SpringBoot + SpringCloud + Vue 的微服务架构进行尝试项目的构建，里面很多功能可能只是为了满足自己的学习需求而引入的，大家可以根据自己服务器配置来选择启动的服务，因此本博客也是一个非常好的 SpringBoot、SpringCloud以及 Vue 技术的入门学习项目。
• 原来做过 Vue + ElementUi 做过管理系统，所以现在打算做一套自己的、基于当前最新技术栈、前后端分离的微服务博客系统。
• http://www.moguit.cn中的一些文章，很多都来自我平时的学习笔记，目前托管在另一个仓库：https://gitee.com/moxi159753/LearningNotes，里面涵盖了 JVM、JUC、Java，Spring，SpringCloud，计算机网络，操作系统，数据结构，Vue、Linux 等 ，感兴趣的小伙伴可以跳转该仓库 https://gitee.com/moxi159753/LearningNotes 一下

运行配置

蘑菇博客使用了一些监控的 SpringCloud 组件，但是并不一定都需要部署，必须启动的服务包含

nacos，nginx，rabbitmq， redis，mysql，mogu-gateway，mogu-sms，mogu-picture， mogu-web, mogu-admin

其它的服务都可以不启动，也不影正常使用，可以根据自身服务器配置来启动

最低配置：1核2G 【https://www.moguit.cn/info/96】【容易宕机】

推荐配置：2核4G 【https://curl.qcloud.com/TYzPgyNC】【博主目前配置】

最近，腾讯云和阿里云的优惠力度非常大，如果有需求的小伙伴，可以了解一下~

【阿里云】云服务器狂欢特惠，2核2G5M 轻量级应用服务器 60 元/年 https://www.aliyun.com/minisite/goods?taskPkg=1111ydsrwb&pkgSid=617&recordId=953032&userCode=w7aungxw

【腾讯云】云产品限时秒杀，爆款 2核4G8M 云服务器，首年 74元/年、222/3年【博主强烈推荐】https://curl.qcloud.com/TYzPgyNC

站点演示

首先特别感谢群里小伙伴 @鹏 对蘑菇博客提供服务器支持，利用服务器穿透到小主机搭建了演示环境。同时我也在搭建的时候，顺便录制了一套视频：https://www.bilibili.com/video/BV13y4y1V7Us ，感兴趣的小伙伴可以参考视频一起完成部署~

【社区演示前端】：http://103.85.84.19:39527/

【社区演示后端】：http://103.85.84.19:39528/

【演示账号】：https://gitee.com/moxi159753/mogu_blog_v2/raw/Nacos/doc/images/qq/%E8%8E%B7%E5%8F%96%E6%BC%94%E7%A4%BA%E7%8E%AF%E5%A2%83%E8%B4%A6%E5%8F%B7.jpg

【小程序】蘑菇博客的移动端版本，可以扫码体验。参考 http://www.moguit.cn/info/605 文档，以及Bilibili上 https://www.bilibili.com/video/BV1sQ4y117nN 完成小程序的搭建。【下面是社区版的小程序演示】

后期维护

项目后台目前有 Eureka 版本和 Nacos 版本，其中 Eureka 版本使用的是 SpringCloud 一些组件，Nacos 版本使用的是 SpringCloudAlibaba 的一些组件，例如 Nacos、Sentinel 等

• Eureka 版本请切换至 Eureka 分支（已停止维护，将不再进行新功能的开发）
• Nacos 版本请切换至 Nacos 分支（作为以后长期维护的分支）
• master 分支为主分支，是基于 Nacos 分支的稳定版本

蘑菇博客社区版

蘑菇博客的定位是个人博客系统，而蘑菇博客社区版定位是多人博客系统。蘑菇社区版在原有蘑菇博客的基础上加入了更多的社区玩法，如：支持用户投稿、个人主页、用户签到、关注/取关、收藏/点赞、积分模块、VIP特权功能、用户动态（蘑菇圈）、面经模块、课程模块、消息通知、公众号登录/管理、私信/群聊模块、SEO优化、图片敏感审核、任务模块、成就模块、勋章模块、支付模块、提现模块、消息触达、资源模块、抽奖模块等。。

关于蘑菇社区功能模块的介绍，可查看：https://vsp58xj3kr.feishu.cn/wiki/wikcnHtRsM9HojaYqrvHWjMu0Ah

关于蘑菇社区版的学习/商用授权，以及查看版本对比，可以查看：https://www.moguit.cn/version

社区版演示环境如下，目前 https://www.moguit.cn/ 使用的是蘑菇博客社区版代码。

【社区演示前端】：http://103.85.84.19:29527/

【社区演示后端】：http://103.85.84.19:29528/

【演示账号】：https://gitee.com/moxi159753/mogu_blog_v2/raw/Nacos/doc/images/qq/%E8%8E%B7%E5%8F%96%E6%BC%94%E7%A4%BA%E7%8E%AF%E5%A2%83%E8%B4%A6%E5%8F%B7.jpg

目前，蘑菇社区版源码暂未开源，可通过 https://www.moguit.cn/version 的方式获取源码授权，详情可添加陌溪微信了解：https://gitee.com/moxi159753/mogu_blog_v2/raw/Nacos/doc/images/qq/coder_moxi.png (备注：蘑菇社区)

https://www.moguit.cn/version

蘑菇博客Go版本

https://gitee.com/moxi159753/mogu_blog_go 是根据蘑菇博客改编的一个 Golang 简化版分支，实现了蘑菇博客后台原有的大部分基础功能，同时前端代码和数据库基本没有变化，因此可以直接使用蘑菇博客原有的前端页面。

https://gitee.com/moxi159753/mogu_blog_go 目前采用的技术有：beego、gorm、mysql、redis 和 nginx。相比于蘑菇博客微服务版，Golang版蘑菇能够做到 1C2G 的服务器轻松运行，再也不怕网站第二天起来就宕机了~。

参考https://www.moguit.cn/info/593，快速在 Windows 平台搭建蘑菇博客Go版开发环境

项目中初始用户和密码

• 后台登录：用户：admin，密码：mogu2018
• 前台登录：用户：mogu2018，密码：mogu2018
• Mysql：用户：root，密码：mogu2018
• Redis：密码：mogu2018
• 远程SSH初始密码：用户：root，密码：mogu2018
• RabbitMQ管理页面： 用户：admin，密码：mogu2018
• Nacos管理页面： 用户：nacos，密码：nacos
• Sentinel管理页面： 用户：sentinel，密码：sentinel
• 蘑菇博客监控页面：用户：user，密码：password123
• Druid初始密码： 用户：admin，密码：123456

项目特点

• 友好的代码结构及注释，便于阅读及二次开发
• 实现前后端分离，通过 Json 进行数据交互，前端再也不用关注后端技术
• 页面交互使用 Vue2.x，极大的提高了开发效率。
• 引入Swagger 文档支持，方便编写 API 接口文档。
• 引入RabbitMQ 消息队列，用于邮件发送、更新 Redis 和 Solr
• 引入JustAuth 第三方登录开源库，支持 Gitee、Github 账号登录。
• 引入ElasticSearch 和 Solr 作为全文检索服务，并支持可插拔配置
• 引入Github Actions 工作流，完成蘑菇博客的持续集成、持续部署。
• 引入七牛云对象存储，同时支持本地文件存储
• 引入 RBAC 权限管理设计，灵活的权限控制，按钮级别的细粒度权限控制，满足绝大部分的权限需求
• 引入 Zipkin 链路追踪，聚合各业务系统调用延迟数据，可以一眼看出延迟高的服务
• 采用自定义参数校验注解，轻松实现后端参数校验
• 采用 AOP + 自定义注解 + Redis 实现限制IP接口访问次数
• 采用自研的评论模块，实现评论邮件通知
• 采用 Nacos 作为服务发现和配置中心，轻松完成项目的配置的维护
• 采用 Sentinel 流量控制框架，通过配置再也不怕网站被爆破
• 采用https://uniapp.dcloud.io/ 和https://github.com/weilanwl/ColorUI 完成蘑菇博客的移动端门户页面搭建
• 支持多种文本编辑器，Markdown 编辑器(https://github.com/Vanessa219/vditor)和富文本编辑器(https://github.com/ckeditor/ckeditor4)随心切换
• 采用 ElasticStack【ElasticSearch + Beats + Kibana + Logstash】https://www.moguit.cn/info/436
• 采用 Docker Compose 完成容器编排，Portainer 实现容器可视化，支持http://www.moguit.cn/info/565

项目文档

文档地址：http://docs.moguit.cn

项目地址

目前项目托管在 Gitee 和 Github 平台上中，欢迎大家 Star 和 Fork 支持~

• Gitee地址：https://gitee.com/moxi159753/mogu_blog_v2
• Github地址：https://github.com/moxi624/mogu_blog_v2

项目目录

• MoguBlog 是一款基于最新技术开发的多人在线、简洁的博客系统。
• mogu_admin: 提供admin端API接口服务；
• mogu_web：提供web端API接口服务；
• mogu_eureka： 服务发现和注册【注: Nacos分支没有该目录，用Nacos作为服务发现组件】
• mogu_picture： 图片服务，用于图片上传和下载；
• mogu_sms：消息服务，用于更新ElasticSearch、Solr索引、邮件和短信发送
• mogu_monitor：监控服务，集成SpringBootAdmin用于管理和监控SpringBoot应用程序
• mogu_spider：爬虫服务（目前还未完善）
• mogu_gateway：网关服务（目前还未完善）
• mogu_zipkin：链路追踪服务，目前使用java -jar的方式启动
• mogu_search：搜索服务，ElasticSearch和Solr作为全文检索工具，http://www.moguit.cn/info/119，默认使用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搜索引擎优化（目前还未完善）

技术选型

系统架构图

蘑菇博客系统架构图，使用 https://www.processon.com/i/5e380df1e4b05b335ffa81e9 在线绘制

后端技术

前端技术

快速开始

【推荐】一条命令部署蘑菇博客

参考 http://www.moguit.cn/info/597， 在云服务器上执行下面命令，完成一键部署蘑菇博客

wget http://oss.moguit.cn/script/moguInit.sh && chmod +x moguInit.sh && sh moguInit.sh

Bilibili一键部署视频：https://www.bilibili.com/video/BV13y4y1V7Us

[推荐] Windows+VMware一键搭建蘑菇博客本地开发环境

参考 http://www.moguit.cn/info/583，快速在 Windows 平台搭建蘑菇博客开发环境，将中间件安装在 VMware 中。

Windows环境下搭建蘑菇博客

参考 http://www.moguit.cn/info/14，能够在 Windows下搭建蘑菇博客的开发环境，同时将所有组件安装在Windows 环境中

[推荐] DockerCompose一键部署蘑菇博客(Nacos版)

参考 http://www.moguit.cn/info/1151 ，在 Linux 服务器中，一键完成蘑菇博客项目的部署

Docker搭建蘑菇博客

参考 http://www.moguit.cn/info/299，快速在Linux服务器中搭建好博客运行环境，通过发布 Jar 包的方式完成部署

参考 http://www.moguit.cn/info/224，快速在Linux服务器中搭建好博客运行环境，通过发布 Jar 包的方式完成部署

蘑菇博客部署到云服务器

【推荐】参考https://www.moguit.cn/info/588，在你修改Nacos分支博客源码后，将重新制作镜像部署到云服务器，然后通过DockerCompose进行启动。

参考https://www.moguit.cn/info/238，在你修改Eureka分支博客源码后将项目打包部署到云服务器

参考https://www.moguit.cn/info/405，在你修改Nacos分支博客源码后将项目打包部署到云服务器

使用Github Actions完成蘑菇博客持续集成

参考 https://www.moguit.cn/info/13 ，在你提交一个 push 请求后，通过 Github Actions 能够完成蘑菇博客自动化 编译、打包、部署等操作。

切换搜索模式

参考https://www.moguit.cn/info/119，完成蘑菇博客的搜索引擎切换，目前支持 Solr、ElasticSearch、SQL 的方式

配置七牛云对象存储

参考https://www.moguit.cn/info/202，配置文件的七牛云对象存储，及本地文件存储

使用Zipkin搭建蘑菇博客链路追踪

参考http://www.moguit.cn/info/95，通过聚合各业务系统调用延迟数据，达到链路调用监控跟踪，快速定位其中延迟高的服务

使用Nacos搭建蘑菇博客服务注册和配置中心

参考http://www.moguit.cn/info/248，搭建蘑菇博客的服务注册和配置中心

使用Sentinel搭建蘑菇博客流量控制

参考http://www.moguit.cn/info/198，Sentinel 被称为分布式系统的流量防卫兵，相当于Hystrix

蘑菇博客QQ小程序发布

参考http://www.moguit.cn/info/223，完成蘑菇博客 uniapp 移动端的启动和发布

【推荐】蘑菇博客微信小程序发布

参考http://www.moguit.cn/info/605，完成蘑菇博客 uniapp 移动端的启动和发布

蘑菇博客扩展新的功能和页面

参考http://www.moguit.cn/info/141，在蘑菇博客现有架构基础上，开发自己需要的页面。

使用ELK搭建蘑菇博客日志收集

参考http://www.moguit.cn/info/436，使用 Docker 快速搭建 ELK 环境用于蘑菇博客日志收集

搭建网站免费CDN加速访问

参考 http://www.moguit.cn/info/976 ，免费搭建自己的CDN加速

环境搭建

开发工具

开发环境

致谢

蘑菇博客起初参考了很多开源项目的解决方案，开源不易，感谢分享

• https://portal.qiniu.com/signup?utm_source=kaiyuan&utm_media=mogu感谢 https://portal.qiniu.com/signup?utm_source=kaiyuan&utm_media=mogu 提供的 免费云存储 和 CDN 服务

• https://www.jetbrains.com/?from=mogu_blog_v2感谢 https://www.jetbrains.com/?from=mogu_blog_v2 提供的开源 License

• 感谢 杨青小姐姐 的博客模板：http://www.yangqq.com/

• 感谢PanJiaChen的Vue后台管理模板：https://github.com/PanJiaChen/vue-element-admin

• Vue 项目搭建参考这篇博客：https://segmentfault.com/a/1190000009506097

• 感谢 苞米豆 提供的 Mybatis-plus框架：http://mp.baomidou.com/

• 感谢 yadong.zhang 提供的第三方登录开源库：https://gitee.com/yadong.zhang/JustAuth

• 感谢 bihell 的 Dice 博客项目：https://github.com/bihell/Dice

• 感谢 pppercyWang 提供的Emoji表情评论组件：https://github.com/pppercyWang/vue-emoji-comment

• 感谢 若依 提供的 RuoYi 项目：https://gitee.com/y_project/RuoYi

• 感谢 yaowei9363 提供的 Vue侧目录组件： https://github.com/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常见问题文档
• 集成表单构建页面，来源于https://gitee.com/y_project/RuoYi
• 增加博客详情页目录导航，来源于https://github.com/yaowei9363/vue-side-catalog
• 资源管理页面集成网盘管理
• 新建Nacos分支，用于替换Eureka作为服务发现组件和配置中心
• 使用Sentinel做服务限流和熔断
• 增加蘑菇博客小程序项目 uniapp_mogu_web，基于https://github.com/weilanwl/ColorUI 和 https://uniapp.dcloud.io/
• 富文本编辑器和Markdown编辑器任意切换
• 使用ELK搭建http://www.moguit.cn/#/info?blogUid=fd9ab58588d93ef792ec72a359a09f6c
• 使用Minio http://www.moguit.cn/#/info?blogUid=a1058b2d030310e2c5d7b0584e514f1f
• 使用DockerCompose完成 http://www.moguit.cn/info/565
• 使用Portainer对Docker镜像可视化管理
• 适配门户页面的移动端布局
• 完善网盘管理
• 增加更新记录
• 完善爬虫模块
• 完善网关模块
• 增加K8S部署蘑菇博客教程
• 增加大屏数据展示页面
• 增加定时任务模块
• 使用Freemark页面静态化技术对博客详情页静态化
• 解决Nuxt_mogu_web中存在的问题，使博客能被搜索引擎收录
• 让原创文章能够同步到多平台，如：CSDN，掘金，博客园等
• 增加博客迁移功能，让其它平台的博客，如：CSDN、博客园，WordPress能够同步到蘑菇博客中

贡献代码

开源项目离不开大家的支持，如果您有好的想法，遇到一些 BUG 并修复了，以及 https://gitee.com/moxi159753/mogu_blog_doc 上有错误的地方订正过来了，欢迎小伙伴们提交 Pull Request 参与开源贡献

1. fork 本项目到自己的 repo
2. 把 fork 过去的项目也就是你仓库中的项目 clone 到你的本地
3. 修改代码
4. commit 后 push 到自己的库
5. 发起PR（ pull request） 请求，提交到 Nacos 分支
6. 等待作者合并

开源协议

https://www.apache.org/licenses/LICENSE-2.0.html

赞赏

服务器和域名等服务的购买和续费都会产生一定的费用，为了维持项目的正常运作，如果觉得本项目对您有帮助的话，欢迎朋友能够给予一些支持，陌溪将用于提升服务器配置，感谢小伙伴们的支持（ ps: 小伙伴赞赏的时候可以备注一下下~）

微信	支付宝

移动端截图

目前移动端版本的代码已经开源至Nacos分支，如果想体验的小伙伴可以移动至Nacos分支

网站截图

Admin端
Web端

开源项目地址：https://gitee.com/moxi159753/mogu_blog_v2