kong

Kong 插件开发语言

Kong 支持使用多种语言开发自定义插件：

语言	方式	说明
Lua	原生支持	Kong 基于 OpenResty/Lua 构建，Lua 是最成熟、性能最好的插件开发语言，官方内置插件均用 Lua 编写
Go	Go PDK	通过 go-pdk 库开发，编译为独立进程，Kong 通过 IPC 通信调用
JavaScript / TypeScript	JavaScript PDK	通过 kong-js-pdk 开发，运行在独立的 Node.js 进程中
Python	Python PDK	通过 kong-python-pdk 开发，运行在独立进程中，适合快速原型开发
WebAssembly (Wasm)	Wasm Filter	Kong 3.4+ 支持，可以用 Rust、C/C++、Go (TinyGo) 等编译到 Wasm 的语言开发，性能接近原生

除 Lua 外的其他语言插件都通过进程间通信（IPC）与 Kong 交互，会有一定的性能开销。生产环境对性能要求高的场景推荐使用 Lua 或 Wasm。

run postgresql

docker network create kong-net

# 创建 postgresql, 并创建一个实例 kong-db
# KONG_DATABASE 数据库类型，必须是 postgres

# 初始化 kong 数据库
nerdctl run --rm \
  -e KONG_DATABASE=postgres \
  -e KONG_PG_HOST=postgresql \
  -e KONG_PG_PORT=5432 \
  -e KONG_PG_USER=user_0 \
  -e KONG_PG_PASSWORD=password_0 \
  -e KONG_PG_DATABASE=kong_db \
  -e KONG_PASSWORD=password_0 \
  kong:3.9.1 kong migrations bootstrap

# kong OSS + kong manager OOS
nerdctl run -d --name kong \
--network=kong-net \
-e "KONG_DATABASE=postgres" \
-e "KONG_PG_HOST=postgresql" \
-e "KONG_PG_PORT=5432" \
-e "KONG_PG_USER=user_0" \
-e "KONG_PG_PASSWORD=password_0" \
-e "KONG_PG_DATABASE=kong_db" \
-e "KONG_PROXY_ACCESS_LOG=/dev/stdout" \
-e "KONG_ADMIN_ACCESS_LOG=/dev/stdout" \
-e "KONG_PROXY_ERROR_LOG=/dev/stderr" \
-e "KONG_ADMIN_ERROR_LOG=/dev/stderr" \
-e "KONG_PROXY_LISTEN=0.0.0.0:8000,0.0.0.0:8443 ssl" \
-e "KONG_ADMIN_LISTEN=0.0.0.0:8001,0.0.0.0:8444 ssl" \
-e "KONG_ADMIN_GUI_LISTEN=0.0.0.0:8002" \
-p 80:8000 \
-p 443:8443 \
-p 8444:8444 \
-p 8001:8001 \
-p 8002:8002 \
kong:3.9.1

# -p 80:8000 # HTTP 代理端口
# -p 443:8443 # HTTPS 代理端口
# -p 8001:8001 # Admin API HTTP 端口
# -p 8444:8444 # Admin API HTTPS 端口
# -p 8002:8002 # Admin GUI HTTP 端口


curl -i -X GET --url http://localhost:8001/services

# Kong Manager OSS
http://kong:8002/

load balance

# 创建一个 upstream
curl -X POST http://192.168.50.31:8001/upstreams --data "name=k8s"

# 添加两个 targets 到 upstream
curl -X POST http://192.168.50.31:8001/upstreams/k8s/targets \
    --data "target=192.168.50.80:6443" \
    --data "weight=100"
curl -X POST http://192.168.50.31:8001/upstreams/k8s/targets \
    --data "target=192.168.50.82:6443" \
    --data "weight=100"
    
# 创建一个Service 目标到 Blue upstream
# host: upstream name
curl -X POST http://192.168.50.31:8001/services/ \
    --data "name=k8s-service" \
    --data "host=k8s"
    
# 最后, 添加一个 Route 作为一个端点到 Service
curl -X POST http://192.168.50.31:8001/services/k8s-service/routes/ \
    --data "hosts[]=k8s.wiloon.com"

commands

curl -s localhost:8001 | jq '.configuration'

kong manager

add route

upstreams
- name: enx-api
- targets
  - target address: enx:8080
gateway service
- new gateway service
  - name: enx-api-service
  - service endpoint
    - protocol: https
    - host: enx-api-upstream
ca certificate
- cert: past the content of ca-cert.crt
certificates
- cert: the content of wiloon.crt
- key: wiloon.key

upstreams

Upstream 是在 Kong 中管理后端服务的负载均衡机制。当请求到达 Service 时，Kong 会通过定义的 Upstream 来选择一个具体的后端实例（例如，一个微服务的多个副本）。如果不使用负载均衡就不需要配置 upstreams 了, 直接在 gateway service 中配置 service endpoint 即可.

gateway service

Service 是指一个后端的服务，它可以是一个 HTTP、HTTPS、gRPC 或 TCP 服务。Service 表示需要路由到的目标服务。

gateway service> service endpoint>protocol: http; 后端服务(upstream)的协议 gateway service> service endpoint>host: 后端服务的 upstream name gateway service> service endpoint>path: 设置转发到后端时请求 URL 的路径前缀, 比如 /api/v1/users?id=42 中的 “v1”

Route

一个 route 对应一个 service Route 是对请求的匹配规则，决定请求如何路由到具体的 Service。你可以根据请求的 URL 路径、HTTP 方法、头信息等来匹配 Route。

route> route configuration> protocols: http, https; 控制客户端到 Kong 的通信协议（入口）, protocols 决定了客户端使用什么协议才能命中这个 Route，是匹配协议的第一道门槛。 route> route configuration> host: enx-dev.wiloon.com; 控制客户端到 Kong 的通信协议（入口）, host 决定了客户端请求的域名是否能命中这个 Route. route> route configuration> path: /api; 控制客户端到 Kong 的通信协议（入口）, path 决定了客户端请求的 URL 路径是否能命中这个 Route. 比如前端资源(/static)的请求要发给其它的 route.

Client Request
     ↓
   Route
     ↓
  Service (host=my-upstream)
     ↓
  Upstream (name=my-upstream)
     ↓
Targets:
  - 192.168.1.101:8000
  - 192.168.1.102:8000

health check

curl -s http://kong.wiloon.com:8001/upstreams/enx-api-upstream/health | jq

kong add new loadbalance service

new gateway service general information name: kong-manager-service service endpoint protocol: http host: 192.168.50.64 port: 8002 new route general information: name: kong-manager-route

在 Kubernetes 中查看 Kong 日志

对于运行在 Kubernetes 中的 Kong 服务，有以下几种查看日志的方式：

1. 容器级别查看（推荐方式）

这是最常用和便捷的方式：

# 查看 Kong Pod 的日志
kubectl logs <pod-name> -n <namespace>

# 实时查看日志（类似 tail -f）
kubectl logs -f <pod-name> -n <namespace>

# 查看最近的日志（如最近100行）
kubectl logs --tail=100 <pod-name> -n <namespace>

# 如果 Pod 有多个容器，指定容器名
kubectl logs <pod-name> -c kong -n <namespace>

2. 查看所有 Kong Pod 的日志

# 通过 label selector 查看所有 Kong Pod 的日志
kubectl logs -l app=kong -n <namespace> --all-containers=true

# 或者使用 stern（需要安装）
stern kong -n <namespace>

3. 进入容器查看文件日志

Kong 默认将日志输出到标准输出/错误，但也可以配置写入文件：

# 进入容器
kubectl exec -it <pod-name> -n <namespace> -- /bin/sh

# Kong 默认日志位置（如果配置了文件输出）
# /usr/local/kong/logs/access.log
# /usr/local/kong/logs/error.log

4. Kong 日志配置

Kong 有两种主要日志：

Access Log（访问日志）：记录请求信息
Error Log（错误日志）：记录错误和警告

可以通过环境变量或配置文件控制：

env:
  - name: KONG_PROXY_ACCESS_LOG
    value: "/dev/stdout"  # 输出到标准输出
  - name: KONG_ADMIN_ACCESS_LOG
    value: "/dev/stdout"
  - name: KONG_PROXY_ERROR_LOG
    value: "/dev/stderr"
  - name: KONG_ADMIN_ERROR_LOG
    value: "/dev/stderr"

5. 集中式日志方案

如果集群配置了日志收集系统：

ELK/EFK Stack：通过 Kibana 查看
Loki + Grafana：通过 Grafana 查看
云服务：如阿里云日志服务、AWS CloudWatch 等

推荐做法：

开发/调试阶段：直接使用 kubectl logs -f 查看实时日志
生产环境：配置集中式日志收集系统，方便查询和分析
Kong 默认配置已经将日志输出到 stdout/stderr，非常适合容器环境

Kong 插件开发语言#

kong#

load balance#

commands#

kong manager#

add route#

upstreams#

gateway service#

Route#

health check#

kong add new loadbalance service#

在 Kubernetes 中查看 Kong 日志#

1. 容器级别查看（推荐方式）#

2. 查看所有 Kong Pod 的日志#

3. 进入容器查看文件日志#

4. Kong 日志配置#

5. 集中式日志方案#