Kong 是什麼？

Kong 是一套基於 Nginx 和 OpenResty 的高效能 API Gateway，核心以 Lua 編寫，具備反向代理、API 管理與套件管理及擴充的應用，同時也繼承了Nginx 優點及特性，Kong 主要採用的資料是PostgreSQL 來儲存相關設定，也支援無資料庫（DB-less）模式，本身就提供Restful api 管理，非常適合 API 單一入口及API訂閱的場景。

Kong 可以做什麼？

• 負載平衡（反向代理）
• 統一 API 進入點（API Gateway）
• 支援多環境與版本部署
• API 使用統計與計費
• 安全驗證（API Key、JWT、OAuth2 等）

---

核心特性

• 管理與部署 RESTful API 變得簡單高效
• 支援 API 版本控管與權限驗證
• 可依使用者等級設定請求限制（Rate Limiting）
• 變更設定時，基於 Nginx 架構無須重啟服務
• 強大的插件機制，可擴充功能或自訂開發

---

官方文件

https://docs.konghq.com/gateway/latest/

---

類似工具

• Apache APISIX
• Tyk
• NGINX Plus（商用）

---

佈署 Kong Api Gateway（Docker with db 版）

version: '3.8'

services:
  kong-database:
    image: postgres:13
    container_name: kong-database
    environment:
      POSTGRES_USER: kong
      POSTGRES_DB: kong
      POSTGRES_PASSWORD: kong
    ports:
      - "5432:5432"

  kong-migrations:
    image: kong:3.6.0
    command: kong migrations bootstrap
    environment:
      KONG_DATABASE: postgres
      KONG_PG_HOST: kong-database
      KONG_PG_PASSWORD: kong
    depends_on:
      - kong-database

  kong:
    image: kong:3.6.0
    container_name: kong
    environment:
      KONG_DATABASE: postgres
      KONG_PG_HOST: kong-database
      KONG_PG_PASSWORD: kong
      KONG_ADMIN_LISTEN: 0.0.0.0:8001
      KONG_ADMIN_GUI_URL: http://localhost:8002
      KONG_ADMIN_GUI_API_URL: http://localhost:8001
    ports:
      - "8000:8000"   # Proxy
      - "8443:8443"   # Proxy SSL
      - "8001:8001"   # Admin API
      - "8002:8002"   # Kong Dashboard
    depends_on:
      - kong-database
      - kong-migrations

啟動指令：

docker-compose up -d

開啟 Dashboard: http://localhost:8002

預設就安裝了很多方便套件，不夠時也能自己做擴充

---

常用 Port 說明

---

快速測試 - 建立反向代理

建立服務：

POST http://localhost:8001/services
Content-Type: application/json

{
  "name": "my-service",
  "url": "https://blog.markkulab.net/"
}

建立路由：

POST http://localhost:8001/services/my-service/routes
Content-Type: application/json

{
  "paths": ["/blog"]
}

測試結果：

http://localhost:8000/blog -> https://blog.markkulab.net/

---

負載平衡策略

補充：

• 支援健康檢查，自動排除故障節點
• 支援 DNS 動態發現 target

進階補充：

• 健康檢查：Kong 內建健康檢查機制，能自動偵測後端服務狀態，異常時自動排除，恢復後自動加入。
• 動態目標發現：支援 DNS 動態解析，後端服務 IP 變動時無需重啟 Kong。
• 多目標（Targets）管理：可針對同一服務設定多個目標，並動態調整權重。

---

請求速率限制（Rate Limiting）

透過 Consumer 與 Key Auth 搭配 Rate Limiting 插件，可根據用戶等級設定頻率。

基本流程：

1. 建立 Consumer
2. 建立 key-auth 憑證
3. 套用 rate-limiting 插件

範例：

curl -i -X POST http://localhost:8001/consumers \
  --data "username=gold"

curl -i -X POST http://localhost:8001/consumers/gold/key-auth

POST /consumers/gold/plugins
{
  "name": "rate-limiting",
  "config": {
    "second": 30,
    "policy": "local"
  }
}
...

API 請求時帶上 key：

GET /your-api
apikey: <your-key>

進階補充：

• 多種策略：支援 local（本地）、cluster（叢集）、redis（外部 Redis）等多種儲存策略，適合不同規模需求。
• 自訂回應：可自訂超出限制時的回應訊息與 HTTP 狀態碼。
• 搭配身份驗證：建議與 key-auth、JWT 等插件搭配，針對不同用戶群組設不同限制。

---

性能與壓力測試

官方實測：單台 8 vCPU 機器，QPS 可達 10~20 萬，延遲低於 10ms。

詳細報告：Kong Gateway Performance Benchmark

更大流量場景建議考慮硬體設備（如 F5）。

---

高可用架構（HA）

       ┌──────────────┐
     │ LoadBalancer │
     └─────┬────────┘
      ┌────┴───────┐
 ┌────▼────┐   ┌────▼────┐
 │ Kong #1 │...│ Kong #N │
 └────┬────┘   └────┬────┘
      └────┬────┬───┘
           │    │
       ┌─────────────┐
       │ PostgreSQL  │
       └─────────────┘

進階補充：

• 資料庫高可用：PostgreSQL 建議採用主從複寫或叢集方案，避免單點故障。
• 多 Kong 節點：可橫向擴展 Kong 節點，配合 Load Balancer 實現高可用與彈性擴充。
• 設定同步：Kong 節點間設定自動同步，確保 API 管理一致性。

---

壓測工具：K6

安裝：

npm install -g k6

測試腳本：

import http from 'k6/http';
import { sleep } from 'k6';

export default function () {
  http.get('http://localhost:8000/v1/users');
  sleep(1);
}

執行：

k6 run script.js

---

導入遇到的問題

1.一個(路由) 只能有一個設定，但可以透過 route prefix 繞開 2.合併計算流的部份子系統的域名後面拿到不同，就得拆一個流量計算

延伸閱讀與資源

• Kong Kubernetes Ingress Controller
• CSDN：Kong實戰教學