Kong 配置讲解之五——常规属性配置详解

Kong通常是通过配置文件kong.conf来进行配置。

prefix

工作目录。相当于Nginx的前缀路径，包含临时文件和日志。

每个Kong进程必须有一个单独的工作目录。

默认值：/usr/local/kong

log_level

Nginx服务器的日志级别。可以在<prefix>/logs/error.log中找到日志。

查看http://nginx.org/en/docs/ngx_core_module.html#error_log获取可接受的值列表。

默认值：notice

proxy_access_log

代理端口请求访问日志的路径。将此值设置为off可禁用代理请求的日志。

如果这个值是一个相对路径，它将被放在<prefix>的目录之下。

默认值：logs/access.log

proxy_error_log

代理端口请求错误日志的路径。这些日志的粒度由log_level属性调整。

默认值：logs/error.log

admin_access_log

管理API请求访问日志的路径。将此值设置为off可禁用管理API请求的日志。

如果这个值是一个相对路径，它将被放在<prefix>的目录之下。

默认值：logs/admin_access.log

admin_error_log

管理API请求错误日志的路径。这些日志的粒度由log_level属性调整。

默认值：logs/admin_error.log

status_access_log

状态API请求访问日志的路径。默认值off表示默认情况下禁用此API的日志。

如果这个值是一个相对路径，它将被放在<prefix>的目录之下。

默认值：off

status_error_log

状态API请求错误日志的路径。这些日志的粒度由log_level属性调整。

默认值：logs/status_error.log

plugins

这个节点应该加载的以逗号分隔的插件列表。默认情况下，只有官方发行版的插件才会通过绑定关键字加载。默认情况下，加载插件不会启用它，但只会指示Kong加载其源代码，并允许通过各种相关的管理API端点配置插件。

在Lua命名空间中指定的名称将被替换为:kong.plugins.{name}.*。

当off关键字被指定为唯一的值时，将不会加载任何插件。

绑定名称和插件名称可以混合在一起，如下例所示：

1. plugins = bundled,custom-auth,custom-log将包括bundled插件加上两个自定义插件
2. plugins = custom-auth,custom-log 将包括 custom-auth和custom-log插件。
3. plugins = off 将不会包括任何插件。

注意：如果一些插件是以前配置的(例如在数据库中有一些)，并且没有在这个列表中指定，Kong将不会启动。在禁用一个插件之前，确保它的所有实例在重新启动Kong之前被删除。

注意：当数据库缓存中LRU被频繁使用造成已满时(即配置的mem_cache_size)，限制可用插件的数量可以提高P99延迟。

默认值：bundled

go_pluginserver_exe

go-pluginserver可执行文件的路径，用于运行用Go编写的Kong插件。

默认值：/usr/local/bin/go-pluginserver

go_plugins_dir

用于安装用Go编写的Kong插件的目录。

如果想禁用插件服务加载Go插件，可以把此值设置为off。

默认值：off

port_maps

通过这个配置参数，你可以配置Kong从哪个端口转发数据包。在容器化或虚拟化环境中运行Kong时，这是常用的使用方式。

例如：配置 port_maps=80:8000,443:8443表示将端口80映射到8000（443端口映射到8443），其中8000,8443位Kong监听的服务端口。

这个参数帮助Kong设置一个适当的转发上面的Http请求头，或者使用Kong PDK获得适当的转发端口（如果其他手段确定它已经失败了）。它将通过目的端口的路由数据包转发至Kong对应路由端口的路由，同样根据该映射，它改变默认插件日志序列化器使用端口，而不是Kong正在监听的端口。

默认值：none

anonymous_reports

发送匿名使用数据，如错误堆栈跟踪，以帮助改进Kong。

默认值：on