前言
大家好，我是陌溪
这阵子很多新手小伙伴打算入坑蘑菇博客的开发，但是被博客所依赖的软件的安装和配置所劝退，导致最终无法顺利的完成蘑菇博客本地环境的搭建。鉴于此，我写了一篇使用 VMware 快速搭建蘑菇博客所依赖的中间件的文章，帮助小伙伴能够更快上手博客的开发。小伙伴坐稳扶好，陌溪带你上车。
注意：本博客使用的是 Nacos/master 分支代码
Eureka 分支的或者是想把所有软件安装到 Windows 中的小伙伴，参考下面这篇博客
Windows环境下配置蘑菇博客环境：
http://moguit.cn/#/info?blogOid=14
IDEA 开发环境需要提前安装 Lombok 插件，参考下面这篇博客
IDEA中引入Lombok :
http://moguit.cn/#/info?blogOid=138
目前蘑菇博客的搜索引擎切换，目前支持 Solr、ElasticSearch、MySQL 的方式，选择一种搜索方式即可。
蘑菇博客切换搜索模式：
http://moguit.cn/#/info?blogOid=119
VMware中安装CentOS
首先需要在 VMware 中安装 CentOS 环境，推荐硬盘大小设置为 40GB，内存大小为 4GB。
同时为了以后搭建更加方便，最好能够给 CentOS 服务器设置固定 IP
VMWare中CentOS如何配置固定IP：
http://moguit.cn/#/info?blogOid=126
此教程不仅仅适用于 VMWare，如果本地配置不行的话，也可以购买云服务器完成下面的部署。
安装Docker
因为我们需要拉取镜像，所以需要在服务器提前安装好 Docker，首先配置一下 Docker 的阿里 yum 源
cat >/etc/yum.repos.d/docker.repo<<EOF
[docker-ce-edge]
name=Docker CE Edge - \$basearch
baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/7/\$basearch/edge
enabled=1
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg
EOF然后yum方式安装docker
# yum安装
yum -y install docker-ce
# 查看docker版本
docker --version
# 开机自启
systemctl enable docker
# 启动docker
systemctl start docker配置docker的镜像源
cat >> /etc/docker/daemon.json << EOF
{
"registry-mirrors": ["https://b9pmyelo.mirror.aliyuncs.com"]
}
EOF然后重启docker
systemctl restart docker因为Docker容器之间，需要互相通信访问，所以我们需要创建我们的Docker网络
docker network create mogu安装Docker Compose
Docker Compose 是用来定义和运行多个 Docker 应用程序的工具。通过 Compose，可以使用 YAML 文件来配置应用程序需要的所有服务，然后使用一个命令即可从YML文件配置中创建并启动所有服务。
下载地址：
https://wws.lanzous.com/iTHoIiuilvi
把下载到的文件使用 Xftp 工具，拷贝到 /usr/local/bin/ 目录下
# 重命名
mv docker-compose-Linux-x86_64 docker-compose
# 加入执行权限
sudo chmod +x /usr/local/bin/docker-compose
# 查看docker-compose版本
docker-compose -v关闭防火墙
然后关闭 CentOS 的防火墙
systemctl stop firewalld.service下载源码
下载蘑菇博客的源码
https://gitee.com/moxi159753/mogu_blog_v2然后从刚刚的源码中，找到 docker-compose 目录
docker-compose脚本所在目录
首先我们来查看一下 docker-compose 的目录结构
docker-compose脚本目录结构
bin：相关一键启动脚本的目录
config：存放配置文件
data：存放数据文件
log：存放日志文件
yaml：存放docker compose的yaml文件
下面我们开始，将 docker-compose 文件夹，拷贝服务器目录位置随意，我是拷贝到 /root/docker-compose 目录，然后给命令设置执行权限
# 进入目录
cd docker-compose
# 添加执行权限
chmod +x bin/middleware.sh
chmod +x bin/kernShutdown.sh
chmod +x bin/wait-for-it.sh因为 Windows 与 Unix 文本编辑器默认格式不同，引起脚本无法执行的情况，因此需要进行转换
# 安装 dos2unix
yum -y install dos2unix*
# 转换脚本
dos2unix bin/middleware.sh
dos2unix bin/kernShutdown.sh
dos2unix bin/wait-for-it.sh部署核心组件
下面我们将部署蘑菇博客所依赖的核心中间件，例如：Nacos、MySQL、Redis、RabbitMQ、Nginx 等
首先到 docker-compose/bin 目录下，执行脚本
# 开始部署核心组件
sh middleware.sh
# 以后打算关闭的话，执行 ./kernShutdown.sh下面是安装过程，需要耐心等待
安装核心组件
在部署完中间件后，我们需要进行测试中间件安装是否成功。
MySQL
首先测试 MySQL 数据库，可以使用图形化工具如：SQLyog
CentOS IP：192.168.177.150 【配置的固定CentOS IP】
MySQL用户名：root
MySQL密码：mogu2018
SQLyog连接界面
连接后，即可看到我们安装好的蘑菇博客业务数据库
蘑菇博客业务数据库
Nacos
Nacos 服务注册和配置中心，如果想更加详细的了解 Nacos 的使用，参考下面博客
【SpringCloud】使用Nacos实现服务注册发现和配置中心等功能：
http://moguit.cn/#/info?blogUid=e6e619349d31dded928c9265c5a9c672
访问下面 URL 进行测试
# Nacos后台配置页面，默认账号和密码：nacos nacos
http://192.168.177.150:8848/nacos打开后，我们在配置列表即可看到我们的配置文件
配置文件所在地
Redis
Redis使用 RedisDesktopManager 进行连接
Host：192.168.177.150
Redis密码：mogu2018
开始连接
RDM连接界面
因为目前 Redis 还没有缓存数据，所以为空，以后有数据的话，将会使用 db0 数据库
Redis中的16个db
RabbitMQ
RabbitMQ 是消息队列，我们可以访问其图形化界面
# 图形化地址
192.168.177.150:15672
# 默认账号和密码为：admin mogu2018然后即可进入到 RabbitMQ 的可视化页面
RabbitMQ可视化页面
部署非核心组件
除了核心组件之外，还有一些组件可以根据自己的情况选择是否启动，如果本地内存不允许的话，也可以直接跳过本节的非核心组件的部署~
Zipkin
Zipkin 是一个开源的分布式的链路追踪系统，每个微服务都会向 Zipkin 报告计时数据，聚合各业务系统调用延迟数据，达到链路调用监控跟踪，深入了解可参考博客：
使用Zipkin搭建蘑菇博客链路追踪：
http://moguit.cn/#/info?blogOid=95
链路追踪服务可以选择安装，不过如果没有安装的话，在启动的时候会出现这样一个错误，不过该错误不会影响正常使用，可以忽略
I/O error on POSt request for "http://localhost:9411/api/v2/span" ：connect timeout到 docker-compose/bin 目录下，执行下面脚本安装 zipkin
docker-compose -f zipkin.yml up -d脚本将会给我们拉取 zipkin 镜像，并进行启动
拉取Zipkin镜像
启动完成后，我们访问下面 URL 进行测试
http://192.168.177.150:9411/zipkin/启动后的页面如下所示
Zipkin可视化页面
Sentinel
随着微服务的流行，服务和服务之间的稳定性变得越来越重要。Sentinel 以流量为切入点，从流量控制、熔断降级、系统负载保护等多个维度保护服务的稳定性。
【SpringCloud】使用Sentinel实现熔断和限流：
http://moguit.cn/#/info?blogOid=121
到 docker-compose/bin 目录下，执行下面脚本安装 Sentinel
docker-compose -f sentinel.yml up -d脚本将会给我们拉取 Sentinel 镜像，并进行启动
拉取Sentinel镜像
启动完成后，我们访问下面 URL 进行测试
# 访问Sentinel登录页面，输入账号密码： sentinel sentinel
http://192.168.177.150:8070即可进入到 Sentinel 后台管理，因为我们的微服务还没有启动，所以暂时还看不到任何东西
Sentinel后台页面
搜索模块
目前蘑菇博客支持三种搜索模式的配置，分别是 Solr、ElasticSearch 和 SQL，小伙伴可以按照自己的服务器配置进行相应的部署，默认是 SQL 搜索，即无需启动 mogu-search 也能正常运行。
蘑菇博客可以进行三种模式的切换(默认是 SQL 搜索，可以配置ElasticSearch 或者 Solr 作为全文检索 )
蘑菇博客切换搜索模式：
http://moguit.cn/#/info?blogOid=119
Solr
首先下载 Solr，因为 Solr 的配置比较复杂，因此我已经将配置好的 Solr 上传到网盘，小伙伴可以直接下载
下载地址：https://wws.lanzous.com/iZ3Nak07auh
下载完成后解压，将其上传到 CentOS 服务器上，存放的目录为 docker-compose/data/solr_data 下
Solr数据所在目录
然后在到 docker-compose/yaml ，执行下面脚本
docker-compose -f solr.yml up -d启动完成后，我们访问下面 URL 进行测试
http://192.168.177.150:8080/solr即可成功访问到 Solr 的图形化页面
Solr可视化页面
ElasticSearch
关于 ElasticSearch 的配置和相关介绍，可以参考这篇博客：
ElasticSearch安装与介绍：
http://moguit.cn/#/info?blogOid=375
下面到 docker-compose/yaml ，执行下面脚本，安装ELK模块
docker-compose -f elk.yml up -d启动完成后，我们访问下面 URL 进行测试
http://192.168.177.150:5601如果能出现下面的页面，说明已经成功安装了 ElasticSearch 和 Kibana，在这里 kibana 只是作为 ElasticSearch 的图形化显示工具，相当于原来的 SolrAdmin 页面一样。
Kibana可视化页面
启动后端项目
在启动项目前，我们需要修改一下 hosts 文件
hosts所在目录
然后加入如下配置
192.168.177.150 redis
192.168.177.150 rabbitmq
192.168.177.150 solr
192.168.177.150 zipkin
192.168.177.150 sentinel
192.168.177.150 mysql
192.168.177.150 nacos
127.0.0.1 mogu_monitor
127.0.0.1 mogu_web
127.0.0.1 mogu_search
127.0.0.1 mogu_admin
127.0.0.1 mogu_sms
127.0.0.1 mogu_gateway注意：里面的 192.168.177.150 是我 CentOS 的 IP 地址，小伙伴需要修改成自己的 IP 地址
当然也推荐小伙伴们使用 SwitchHosts! 来进行自由切换
自动修改项目配置
本着让小伙伴们 能不动手就不动手 的原则，我写了个自动修改配置的脚本，在 mogu_blog_v2/doc/yaml 目录下
脚本所在目录
这里里面有个两个 windows bat
replaceYaml.bat：替换项目的配置
revertYaml.bat：还原项目的配置
只需要双击 replaceYaml.bat 即可完成配置的替换
如果需要手动替换的下，参考下面这节，否者可以直接跳过~
手动修改项目配置
如果选择手动配置的话，需要使用本地 IDEA 打开项目，然后修改配置文件
首先修改的是 mogu_admin 项目的 application.yml，将 dev 改成 prod
切换环境
然后修改 bootstrap.yaml ，将 dev 改成 prod，同时还需要修改 nacos 和 sentinel ，将 localhost 改为对应的服务名称即可。
修改配置
我们重复上面操作，将 mogu_web、mogu_sms、mogu_gateway、mogu_picture、mogu_montor 等项目都进行修改。
启动项目
修改完成后，直接启动项目即可。其中我们需要启动核心组件包含下面几个【服务启动没有先后顺序】
mogu_admin、mogu_web、mogu_sms、mogu_picture、mogu_gateway下面是启动完成的图片，一共包含五个核心服务
项目启动
等服务器都启动完成后，下面我们验证一下后台是否正常启动，回到我们的Nacos管理界面
http://192.168.177.150:8848/nacos如果我们看到下面五个服务都注册到 Nacos 中，那说明启动成功
mogu_picture
mogu_sms
mogu_admin
mogu_web
mogu_gateway
如果我们看到下面五个服务都注册到 Nacos 中，那说明启动成功
Nacos注册中心
在通过访问下列 Swagger 接口，测试接口是否正常
############ admin端swagger ##################
http://localhost:8601/swagger-ui/index.html
############ picture端swagger ##################
http://localhost:8602/swagger-ui/index.html
############ web端swagger ##################
http://localhost:8603/swagger-ui/index.html如果能够进入下面页面的话，说明后台是没有问题的了，下面我们可以验证一下接口
Swagger接口界面
验证登录
输入账号和密码
然后执行完成后，复制到 token
获取token令牌
然后在 Swagger 页面的右上角，有一个 authorize 的按钮，点击后，将 token 粘贴进去，即可操作全部接口进行测试了~
输入token令牌
启动前端项目
前端项目使用的是 Vue 编写的，所以在这之前，需要下载好 nodejs ，因为 nodejs 里的 npm 模块是用于管理vue项目中的依赖，就类似于maven一样
node官网：https://nodejs.org/en/
在安装的时候，记得选择好加入到环境变量中，这样我们就能在任何地方都使用。
查看是否安装成功： npm -v
安装 vue_mogu_admin 依赖
进入vue_mogu_admin 文件夹内，使用下面命令进行安装
# 指定node-sass的国内镜像源
npm i node-sass --sass_binary_site=https://npm.taobao.org/mirrors/node-sass
# 使用淘宝镜像源进行依赖安装，解决国内下载缓慢的问题(出现警告可以忽略)
npm install --registry=https://registry.npm.taobao.org
# 启动项目
npm run dev
#打包项目（在部署的时候才需要使用）
npm run build强烈建议不要用直接使用 cnpm 安装，会有各种诡异的 bug，可以通过重新指定 registry 来解决 npm 安装速度慢的问题。若还是不行，可使用 yarn 替代 npm。
Windows 用户若安装不成功，很大概率是node-sass安装失败
解决方案：
https://github.com/PanJiaChen/vue-element-admin/issues/24
另外因为 node-sass 是依赖 python环境的，如果你之前没有安装和配置过的话，需要自行查看一下相关安装教程。
在启动项目成功后，会跳转到：localhost:9528 ，我们输入账号密码： admin mogu2018 访问即可
蘑菇博客登录页面
安装 vue_mogu_web依赖
这个步骤其实和 admin 端的安装时一致的，这里就不做过多的叙述
进入 vue_mogu_web 文件夹内，使用下面命令进行安装
# 使用淘宝镜像源进行依赖安装，解决国内下载缓慢的问题(出现警告可以忽略)
npm install --registry=https://registry.npm.taobao.org
# 启动项目
npm run dev
#打包项目（在部署的时候才需要使用）
npm run build下面是启动成功的界面，跳转到 localhost:9527
蘑菇博客门户页面
修改项目配置
最后在项目成功启动后，我们还需要修改一些配置，才算完全搭建好博客
mogu_web配置
我们进入到nacos配置文件管理界面，找到的 mogu_web_prod.yaml 文件
Nacos配置文件
我们需要将下面的域名，改成自己的
data:
# 门户页面
webSite:
url: http://192.168.177.150:9527/#/
# mogu_web网址，用于第三方登录回调
web:
url: http://192.168.177.150:8603同时在配置文件的最下面，还需要修改第三方注册需要的 clientId 和 ClientSecret：如果不清楚如何获取的小伙伴，可以查看我的这篇博客，在后面部分对ID的获取有相关介绍：
SpringBoot+Vue如何集成第三方登录JustAuth：
http://moguit.cn/#/info?blogOid=247
使用JustAuth集成QQ登录：
http://moguit.cn/#/info?blogOid=437
# 第三方登录
justAuth:
clientId:
gitee: XXXXXXXXXXXXXXXXXXXXXX
github: XXXXXXXXXXXXXXXXXXXXXX
qq: XXXXXXXXXXXXXXXX # APP ID
clientSecret:
gitee: XXXXXXXXXXXXXXXXXXXXXX
github: XXXXXXXXXXXXXXXXXXXXXX
qq: XXXXXXXXXXXXXXXXXX # APP Keymogu_sms配置
我们进入到 nacos 配置文件管理界面，找到的 mogu_sms_prod.yaml 文件
Nacos配置文件
在 mogu_sms 中，主要修改的就是邮箱的配置，我们将发送邮件的信息改成自己的
#mail
mail:
username: XXXXXXX@163.com
password: XXXXXXX #授权码开启SMTP服务里设置注意，上面的 password 是授权码，授权码不是密码，以 163 邮箱为例，我们需要开启 SMTP 服务，然后设置授权码
获取授权码
修改图片配置
图片默认使用的是本地图片上传，如果想使用其它的存储方式，可以参考另外的博客
蘑菇博客配置七牛云存储：
http://moguit.cn/#/info?blogOid=202
使用Minio搭建对象存储服务：
http://moguit.cn/#/info?blogOid=278
本文主要以本地文件存储为例，我们到系统配置，首先修改图片显示的本地域名
系统配置页面
修改完成后，进行保存，然后在图片管理上传新的图片
图片管理页面
要是图片无法正常显示，可以F12看看图片路径是否是修改后的IP，同时对应的 8600端口的防火墙是否开放
最后到博客管理页面，编辑博客，然后选择图片插入即可~
博客编辑页面
结语
