物联网网关神器 Kong （三） - 图形化管理界面 Konga

拼搏现实的明天。 2023-01-22 09:58 263阅读 0赞

# 物联网网关神器 Kong （ 三 ） - 图形化管理界面 Konga #

## 前言 ##

上文我们我们讲了 Kong 的安装和利用 Kong 的 HTTP/REST API 来进行配置。但总是使用 CURL 命令去调用 HTTP 接口来进行配置却又太过复杂。

**读到这，不知道你是否和我有一样的想法：**

> 可以开发一个图形化管理界面，通过调用接口来实现简便操作的功能。

Konga 就帮我们来实现了这个功能，通过搭建 Konga 服务器可以管理多个 Kong ，并实现图形化界面配置。下文我们将会讲解如何安装 Konga，并通过 Konga 配置来讲解 Kong 的各个模块的功能与设计。

### 利用 Docker 安装 Konga ###

下面我们将利用 Docker 来安装 Konga， 如果你没有或者不知道什么是Docker，请点击[传送门][Link 1]

#### 获取 Konga 镜像 ####

docker pull pantsel/konga

![img\_18.png][img_18.png]

#### 准备数据库 ####

由于 Konga 需要数据库支持，在这里我们使用 Postgres 来进行配置其数据库。

docker run -d \
      --name kong-db \
      --network=kong-net \   
      -p 5432:5432 \
      -e "POSTGRES_USER=kong" \
      -e "POSTGRES_DB=kong" \
      -e "POSTGRES_PASSWORD=kong" \
      postgres:9.6

*  network=kong-net 该网络在创建 Kong 的时候创建的，使得 Konga 和 Kong 在同一网络内。

![img\_19.png][img_19.png]

#### 准备初始化数据库 ####

在运行 Konga 前，我们需要把 Konga 运行所需要的一些表结构创建出来。

docker run --rm pantsel/konga:latest -c prepare -a postgres -u postgresql://kong:kong@< your ip >:5432/konga_db

![img\_21.png][img_21.png]

> 排坑指南：
> 
> 这里有指定Postgres 的版本是 **9.6**，由于版本兼容问题，如果你使用最新版本的 Postgres 在初始化数据库的时候会报错。  
> ![img\_17.png][img_17.png]

#### 运行 Konga ####

经过繁杂的准备工作，我们终于要运行 Konga 了。

docker run -d -p 1337:1337 \
     --network {
       {kong-network}} \ // 可选的
     --name konga \
     -e "NODE_ENV=production" \ // or "development" | defaults to 'development'
     -e "TOKEN_SECRET={
       {somerandomstring}}" \
     pantsel/konga

![img\_22.png][img_22.png]

*  network : 最好和 Kong 在同一网络
 *  TOKEN\_SECRET : 一串随机字符串

### 登陆 Web 页面 ###

经过复杂繁琐的过程，我们已经将 Konga 安装完毕。 接下来我们访问 1337 端口来看一下 Konga 的图形化界面。

#### 创建管理员账户 ####

当我们打开 Konga 的 Web 页面，迎面而来的就是让你创建一个管理员帐号。

![img\_24.png][img_24.png]

*  Email : 日后如果有需要，会将报警内容发送至该邮箱。

#### 登陆 ####

当注册成功后，会自动跳转登陆界面。你需要输入刚才注册的用户名和密码。

![img\_25.png][img_25.png]

#### 主界面 ####

登陆成功后我们将看到其主界面的欢迎页面。

![img\_26.png][img_26.png]

**左侧边栏简单介绍讲解:**

*  DASHBOARD : Konga 的仪表盘，当我们接下来绑定了 Kong 以后将会展示。
 *  USERS : 用户管理
 *  CONNECTIONS : Kong 的连接管理，也就是说一个 Konga 可以管理多个 Kong API Gateway.
 *  SNAPSHOTS : 现存的节点的快照
 *  SETTING 设置

### 绑定 Kong ###

由图可见，我们可选择四种方式来连接我们的Kong API Gateway。由于直接暴露管理端口存在风险，所以我们可以采取多种措施来保护管理端口，进行安全连接。

*  默认 ：直接通过调用Kong 暴露出的 admin 管理接口来进行连接。（ 不推荐 ）
 *  Key AUTH ： 使用 Kong 的 Key Authentication 插件来进行验权。
 *  JWT ：使用 Kong 的 JWT 插件来进行验权。
 *  BASIC AUTH ：使用 Kong 的 BASIC AUTH 插件来进行验权。

#### 默认连接 ####

我们首先使用默认连接的方式来连接我们的 Kong 服务。

首先输入名称和管理端口的URL。

![img\_33.png][img_33.png]

连接成功后会自动跳转至 Dashboard 界面。

#### Dashboard 界面讲解 ####

![img\_29.png][img_29.png]

仪表盘 （ Dashboard ）就像汽车的显示台一样，展示出一些对现有数据和信息的汇总分析。可以帮助快速了解服务情况。

*  CONNECTIONS : 该模块展示了现在所有连接的数量统计，例如总共连接数、现在正在连接的连接数等。
 *  NODE INFO ： 该模块展示了 Kong 服务的基本信息。 如 Kong 版本、Lua 脚本版本、监听端口等。
 *  TIMERS ： 该模块展示了现在各计时器的数量和所处的状态。
 *  DATASTORE INFO ：该模块展示了 Konga 所连接的数据库基本信息。如数据库名称、用户名等。
 *  PLUGINS ： 该模块展示了 Kong 服务所使用的插件。

## 总结 ##

本篇文章对 Kong 的GUI 图形化界面 Konga 进行了简要的讲解，并讲解了利用 Docker 进行安装 Konga。 安装成功后使用默认连接连接到 Kong。

但是这种默认连接是不安全的。我们下篇文章将会介绍如何在生产环境中连接 Konga，并介绍几种插件的使用。

[Link 1]: https://www.docker.com/
[img_18.png]: /images/20221020/b4dbe7f34d89445285fb6c5b49e42be6.png
[img_19.png]: /images/20221020/1ee5396c051546299982b87d369a6dd0.png
[img_21.png]: /images/20221020/d840c40e144a4bdda2cd6ca740d12775.png
[img_17.png]: /images/20221020/0de5b6ff628e41248e333ec76412181c.png
[img_22.png]: /images/20221020/5fa817ce54e74f80b35b1e799a02b6ac.png
[img_24.png]: /images/20221020/0a36c6d915764cf0a19b8be3a6ec8ce2.png
[img_25.png]: /images/20221020/b374d83d155a458f814fcb5a4dff46cd.png
[img_26.png]: /images/20221020/8ca92bd1434b4601814fef71574e270d.png
[img_33.png]: /images/20221020/7aea28e7117340aea884c5e6c9ba005c.png
[img_29.png]: /images/20221020/5e2fc78f697044c99e6a3530747dfbe4.png