一、简介

Kong 或 Kong Gateway 是一款云原生、平台无关、可扩展的 API 网关
它具备高性能、高可扩展性、稳定可靠的特性
可以设置代理服务、路由、负载均衡、健康检查等，适配各种http协议相关服务
官方提供N多即插即用的插件，包含认证类、安全类、流量控制类、分析监控类、转换类、日志类等
kong网关开源地址参考：https://github.com/Kong/kong
kong可视化组件konga的开源地址：https://github.com/pantsel/konga

二、安装

建议在Docker中部署，提前准备好Docker、docker-compose软件环境

新建docker-compose.yml配置文件，配置内容如下：

services:
  # PostgreSQL 数据库（仅给 Kong 使用）
  kong-database:
    image: postgres:13
    restart: always
    environment:
      POSTGRES_USER: kong
      POSTGRES_PASSWORD: kong123456
      POSTGRES_DB: kong
    volumes:
      - ./kong-db-data:/var/lib/postgresql/data    # 数据持久化到本地目录
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U kong"]    # 检查数据库是否就绪
      interval: 10s
      timeout: 5s
      retries: 5

  # Kong 数据库初始化（只在首次运行时执行）
  kong-migration:
    image: kong:2.8
    command: kong migrations bootstrap             # 创建 Kong 所需的表结构
    depends_on:
      kong-database:
        condition: service_healthy                 # 等待数据库健康后再执行
    environment:
      KONG_DATABASE: postgres
      KONG_PG_HOST: kong-database                  # Docker 服务名作为主机名
      KONG_PG_USER: kong
      KONG_PG_PASSWORD: kong123456
      KONG_PG_DATABASE: kong
    restart: on-failure                            # 失败时重试

  # Kong 网关
  kong:
    image: kong:2.8
    restart: always
    depends_on:
      kong-database:
        condition: service_healthy
      kong-migration:
        condition: service_completed_successfully  # 等待迁移完成
    environment:
      KONG_DATABASE: postgres
      KONG_PG_HOST: kong-database
      KONG_PG_USER: kong
      KONG_PG_PASSWORD: kong123456
      KONG_PG_DATABASE: kong
      KONG_PROXY_ACCESS_LOG: /dev/stdout           # 日志输出到控制台
      KONG_ADMIN_ACCESS_LOG: /dev/stdout
      KONG_PROXY_ERROR_LOG: /dev/stderr
      KONG_ADMIN_ERROR_LOG: /dev/stderr
      KONG_ADMIN_LISTEN: 0.0.0.0:8001              # Admin API 监听地址
      KONG_PROXY_LISTEN: 0.0.0.0:8000, 0.0.0.0:8443 ssl  # 代理监听 HTTP 和 HTTPS
      KONG_UNTRUSTED_LUA: "on"                     # 允许自定义 Lua 脚本
      KONG_UNTRUSTED_LUA_SANDBOX_REQUIRES: "cjson.safe,resty.http"  # 允许的 Lua 模块
    ports:
      - "8000:8000"      # HTTP 代理入口
      - "8443:8443"     # HTTPS 代理入口
      - "8001:8001"      # Admin API（配置管理）
    healthcheck:
      test: ["CMD", "kong", "health"]
      interval: 30s
      timeout: 10s
      retries: 3

  # Konga - Kong 可视化管理界面
  konga:
    image: pantsel/konga:0.14.9
    restart: always
    depends_on:
      - kong
    environment:
      NODE_ENV: production
      TOKEN_SECRET: your-secret-token-key-here     # JWT 签名密钥，建议修改
    volumes:
      - ./konga-data:/app/kongadata                # 持久化用户和连接配置
    ports:
      - "1337:1337"      # Web 管理界面

配置完成，直接启动即可

docker-compose up -d

三、使用

1. 简单反向代理应用示例

程序运行起来后，可访问konga管理界面，访问：http://server_ip:1337，首次访问需要初始化管理员账号密码
注册登录konga之后，需要设置连接到kong网关，默认kong网关的管理API服务在8001端口，配置接入kong网关配置如下图所示
接下来，就可以新增配置后端服务了，进入SERVICES菜单，新增一个后端服务
给后端服务设置路由，就是外部访问那些域名、路径时流量负载到后端服务
点击进入服务详情，在Routes子菜单新增路由

设定路由命中规则，可根据域名(使用域名时，域名要先解析到服务器ip)、路径、method匹配等
后端服务、路由配置完后，就可以通过路由规则反向代理流量到目标后端服务（8000为http、8443为https），如下示例

2. 使用插件示例

kong 网关默认提供很多类别的易于集成的插件，点击即可应用
示例一：使用 Basic Auth 插件，该插件控制访问网页需要登录授权
增加一个全局的 Basic 授权插件

开启Basic Auth之后，需要新增Comsumers用户，添加授权凭证

给新增的用户建一个登录凭证，如下

再次访问上面配置的反向代理网站，就需要登录授权才能访问了，输入刚刚新增凭证即可成功登录进入

示例二：高级用法，编辑后置函数，实现把每个请求的请求参数、响应数据提交到日志接口
添加一个“Post Function”插件

access 字段输入下面内容回车

kong.ctx.shared.request_body = kong.request.get_raw_body() or ''

body_filter 字段输入下面内容回车

kong.ctx.shared.response_body = (kong.ctx.shared.response_body or '') .. (ngx.arg[1] or '')

log 字段输入下面内容回车，其中接口https://log.xxx.top/api/log替换成你的接口

local cjson = require('cjson.safe'); local data = { request = { uri = kong.request.get_path(), method = kong.request.get_method(), headers = kong.request.get_headers(), query = kong.request.get_query(), body = kong.ctx.shared.request_body }, response = { status = kong.response.get_status(), headers = kong.response.get_headers(), body = kong.ctx.shared.response_body }, client_ip = kong.client.get_ip(), timestamp = ngx.now() }; local json_body = cjson.encode(data); local function send_log(premature, body) if premature then return end; local http = require('resty.http'); local httpc = http.new(); httpc:set_timeout(5000); local res, err = httpc:request_uri('https://log.xxx.top/api/log', { method = 'POST', body = body, headers = { ['Content-Type'] = 'application/json' }, ssl_verify = false }); if not res then kong.log.err('Failed to send log: ', err) else kong.log.notice('Log sent, status: ', res.status) end end; local ok, err = ngx.timer.at(0, send_log, json_body); if not ok then kong.log.err('Failed to create timer: ', err) end

配置截图如下

配置完并启用后，kong每个请求都会触发这个后置函数，并想目标接口发起的 POST 请求，参数参考如下

{
    "request": { //请求信息
        "uri": "\/api\/generate",
        "headers": {
            "content-length": "50",
            "user-agent": "Mozilla\/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/142.0.0.0 Safari\/537.36 Edg\/142.0.0.0",
            "origin": "http:\/\/gitcard.hd.luler.top",
            "referer": "http:\/\/gitcard.hd.luler.top\/",
            "accept-encoding": "gzip, deflate",
            "content-type": "application\/json",
            "host": "gitcard.hd.luler.top",
            "x-credential-username": "zhangsan",
            "accept": "*\/*",
            "x-credential-identifier": "zhangsan",
            "x-consumer-username": "zhangsan",
            "x-consumer-id": "1b1f6295-633f-4795-8c47-9af8a62888ec",
            "accept-language": "zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6"
        },
        "body": "{\"repo_url\":\"https:\/\/github.com\/microsoft\/vscode\"}",
        "query": [],
        "method": "POST"
    },
    "client_ip": "14.145.46.xxx", //客户端ip
    "timestamp": 1766571822.627,
    "response": {  //接口响应
        "headers": { //相应头
            "date": "Wed, 24 Dec 2025 10:23:39 GMT",
            "content-length": "276",
            "connection": "close",
            "x-kong-upstream-latency": "5906",
            "server": "uvicorn",
            "via": "kong\/2.8.5",
            "x-kong-proxy-latency": "30",
            "content-type": "application\/json"
        },
        "status": 200, //状态码
        "body": "{\"success\":true,\"message\":\"卡片生成成功\",\"data\":{\"owner\":\"microsoft\",\"repo_name\":\"vscode\",\"image_url\":\"\/images\/microsoft\/vscode.png\",\"filename\":\"vscode.png\",\"repo_info\":{\"description\":\"Visual Studio Code\",\"stars\":179950,\"forks\":37022,\"issues\":12223,\"contributors\":328}}}"
    }
}

3. 更多官方插件、开源插件、lua玩法有兴趣的同学可以进一步探索

kong 官方插件列表：https://docs.konghq.com/hub/
Lua 教程：https://www.runoob.com/lua/lua-tutorial.html
kong 插件开发指南：https://docs.konghq.com/gateway/latest/plugin-development/
社区插件仓库：https://github.com/Kong/kong-plugin

四、总结

kong 是一个非常出色的网关和代理工具，特别是支持众多插件集成与使用，可自定义实现各种特殊用途和功能
kong本质上是基于Nginx + Lua的内核，性能足够强劲，但要注意插件使用越多，性能损耗越大
kong官方的可视化界面是不开源的，只有网关开源，需要搭配非官方的开源可视化管理组件konga实现在线Web UI管理
支持Docker方式进行部署，启动方便，迁移与调整容易