soul 网关入门篇（一）：搭建篇

前言

Soul 是一个异步的,高性能的,跨语言的,响应式的API网关。参考了Kong，Spring-Cloud-Gateway等优秀的网关后，站在巨人的肩膀上，诞生了Soul。是一个基于 实现的WebFlux响应式的 API 网关是一个拥有后台管理界面的网关。或许刚接触Soul的人看着官网上的架构图会一脸懵，没关系，我们先从搭建开始。

单机部署

1. 可以按照官网上soul 的极简入门进行实操，快捷，方便。
2. 也可以从 Github 上下载源码进行安装

安装数据库

安装数据库的操作，这里就不在详细描述，可以参考这篇。但注意的尽量安装 5.x 的版本, 8.x 会有莫名的坑。安装完数据库后，建soul的数据库，需要注意的是，数据最好不要设置密码

Github 下载 Soul 的后端代码

1. fork 代码

从Github Soul的 repo 中 fork 到自己的仓库，如果现在还没有 Github 的账号，点击申请账号。

Fork

由于此账号已经 fork 过，所以会提示已经存在。友情提醒：感谢一键三连(watch，star，fork )。

2. clone 代码

从自己的仓库中 clone 代码，代码的获取连接为：

获取链接

Clone 到本地。

git clone https://github.com/plutokaito/soul.git 

就像这样，如果你想在今后贡献代码，则可以参考这篇文章

3. 执行编译

执行命令mvn clean install，如果嫌慢，可以跳过所有检查，测试等，优化命令如下：

mvn clean package install -Dmaven.test.skip=true \
-Dmaven.javadoc.skip=true \
-Drat.skip=true \
-Dcheckstyle.skip=true

4. 运行
5. 在idea中打开 soul 代码， idea 的话可以使用社区版，有条件的可以使用购买专业版。
6. 在soul-admin目录中检查数据库是否配置正确，并启动程序

启动程序

5. 启动后界面如下

使用浏览器访问 localhost:9095

后台首页

用户名、密码为：admin/123456

总结：

1. 如果要很熟悉一个框架，要先从这个框架的使用开始入手。然后慢慢的深入。
2. 使用的第一步是搭建环境。先从环境的搭建，到使用，在到源码解析，再到调优。
3. 路漫漫其修远兮，吾将上下而求索。靡不有初，鲜克有终。

参考：

如何阅读大型项目的代码？

开源项目应当怎么学习，如何阅读大型项目的代码？