Kong API Gateway 配置文件详解

一、前言

Kong配置文件是Kong服务的核心文件，它配置了Kong以怎样的方式运行，并且依赖于这个配置生成Nginx的配置文件，本文通过解读Kong配置文件，以了解Kong的运行和配置。

在成功安装Kong以后，会有一个名为kong.conf.default默认的配置文件示例,如果是通过包管理器安装的，通常位于/etc/kong/kong.conf.default，我们要将其复制为kong.conf以便于我们修改使用他。

在Kong的配置文件中，约定了以下的几条规则：

• 配置文件中以#开头的行均为注释行，程序不会读取这些内容。
• 在官方提供的默认配置文件中，以#开头的有值的配置项目均为默认配置。
• 所有的配置项，均可以在系统环境变量中配置，但是必须要加上KONG_为前缀。
• 值为布尔型的配置，可以使用on/off或者true/false。
• 值为列表的，必须使用半角逗号分割。

Kong的配置，大概分为几种，分别是：

• 常规配置：配置服务运行目录，插件加载，日志等等
• NGINX配置：配置Nginx注入，例如监听IP和端口配置等等，用于Kong在启动的时候生成Nginx配置文件
• 数据库存储配置：配数据库类型，地址、用户名密码等等信息
• 数据库缓存配置：配置数据的缓存规则，Kong会缓存诸如API信息、用户、凭证等信息，以减少访问数据库次数提高性能
• DNS解析器配置：默认情况会使用系统设置，如hosts和resolv.conf的配置，你也可以通过DNS的解析器配置来修改
• 其他杂项配置：继承自lua-nginx模块的其他设置允许更多的灵活性和高级用法。

下面我们一个模块一个模块解释一下各项的配置。

二、常规配置

在常规配置中，主要是控制Kong一些运行时的一些配置，主要有如下配置：

在常规的配置中，主要配置了Kong运行的目录日志等信息。

无论如何，配置的文件或者目录Kong必须要用权限访问，否则会报错。

三、Nginx注入配置

Kong基于Nginx，当然需要配置Nginx来满足Kong的运行要求，Kong提供了Nginx的注入配置，使得我们更轻松控制。

在Nginx注入配置中，有如下配置：

在Nginx注入配置中，配置了Nginx的基本的参数，这些参数大部分和NGINX的配置值是一样的，可以通过Nginx的配置文档了解一下。

四、 数据库存储配置

数据库配置的模块配置数据库相关的连接信息等等。主要有如下配置：

推荐使用PostgreSQL数据库作为生产环境的存储，PostgreSQL具有良好的性能和稳定性，是一个非常优秀的开源数据库。

五、 数据库缓存配置

在上一节中，配置了Kong持久化存储，显然如果每次的请求都需要去查询数据库中的相关信息那无疑是非常消耗资源，性能和稳定性也会大大降低，作为一个API网关肯定是不能忍的，解决这个问题的办法就是缓存，Kong将数据缓存在内存中，这样会大大提高性能，本节介绍Kong的缓存配置。

六、 DNS解析器配置

默认情况下，DNS解析器将使用标准配置文件/etc/hosts和/etc/resolv.conf。如果设置了环境变量LOCALDOMAIN和RES_OPTIONS，那么后一个文件中的设置将被覆盖。

在DNS配置中，我们基本上不需要更改，官网的配置给出了最优的配置。如果我们需要在host文件中定义后端绑定的域名，一定要在编辑hosts文件后重载Kong的配置，或者重启Kong，无论hosts的文件是否是/etc/hosts，否则都不会生效的。

七、 其他杂项配置

杂项配置基本上关于LUA的配置，如果不熟悉请不要修改，按照官方默认即可。