為什麼會想試試 APISIX？

在使用 Kong 免費版的過程中，發現一些限制像Service 跟 Route 必須綁定 Service、不提供Consumer Group 功能受限等等，後來了解到 APISIX 這個開源方案，決定實際測試看看，經過實測後發現 APISIX 確實表現不錯，它是 Apache 基金會維護的項目，社群相當活躍，功能也很彈性，支援 Route Only 模式、Consumer Group、熱更新、多語言套件等等，是很值得考慮使用的 API Gateway 。

架設 Docker-compose 及相關設定檔

在架設的過程中，由於官方文件不夠詳細，版本相容性也有些問題，花了一些時間才成功建置環境。相關的設定檔已整理並放在 GitHub 上，有需要的朋友可以參考：

GitHub repo

APISIX vs Kong 規格大PK

來看看這兩個到底差在哪裡：

實測後發現 Kong 的限制

1. 免費版沒有Route only mode。
2. 免費版沒有consumer group 。
3. 免費版的限流功能，只能做到很基礎的限流。
4. 預設不支援動態路由，即便開啟，預設不支援路徑捕獲(得自己寫plugin)。

Kong vs APISIX 路由設定比較

實際情況

假設你想要把 /wms/api/item/1 轉到 http://172.62.1.1:1080/api/item/1，來看看兩個怎麼做：

Kong 的設定方式（超麻煩）

1. 先建 Service：

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

{
  "name": "wms",
  "url": "http://localhost:1081/"
}

2. 再建 Route：

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

{
  "name": "wms-api-item-1",
  "paths": ["~/wms/(?<path>api/item/1)$"],
  "strip_path": true,
  "path_handling": "v1",
  "service": {
    "name": "wms"
  },
  "tags": ["wms"]
}

3. 最後還要加個套件來改路徑：

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

{
  "name": "request-transformer",
  "service": {
    "name": "wms"
  },
  "tags": ["wms"],
  "config": {
    "replace": {
      "uri": "/api/item/1"
    }
  }
}

Kong 需要 3 次 API 呼叫，而且改路徑還需要額外安裝套件，設定流程較為複雜。

APISIX 的設定方式（簡化流程）

APISIX 支援 Route Only 模式，一次 API Call 即可完成設定：

PUT http://127.0.0.1:9180/apisix/admin/routes/api-0001
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "uri": "/wms/api/item/1",
  "name": "/wms/api/item/1",
  "priority": 10,
  "methods": ["GET", "POST", "PUT", "DELETE"],
  "plugins": {
    "proxy-rewrite": {
      "regex_uri": ["^/wms/(.*)", "/$1"]
    }
  },
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "172.62.1.1:1080": 1
    }
  }
}

APISIX 僅需 1 次 API Call，內建的 proxy-rewrite 功能可直接處理路徑重寫，設定流程相當簡潔。

設定複雜度比較

動態路由條件（彈性分流機制）

APISIX 的優勢之一是支援多種條件來決定路由，不僅是 URI，還可以根據 HTTP Method、Header、Query 參數、Host 等等，實現動態條件分流

常見的動態條件

• HTTP Method：可以指定 GET、POST、PUT、DELETE 等等
• Header：根據自訂的 Header 內容來分流
• Query 參數：看 URL 後面的參數來決定
• Host：根據請求的 Host 來分流
• Remote Addr：根據來源 IP 來分流

範例：根據 Header 來路由

PUT http://127.0.0.1:9180/apisix/admin/routes/dynamic-header
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "uri": "/api/v1/resource",
  "methods": ["GET"],
  "name": "dynamic-header-route",
  "priority": 20,
  "vars": [
    ["http_x-user-type", "==", "admin"]
  ],
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "10.0.0.1:8080": 1
    }
  }
}

這樣設定的話，只有帶著 X-User-Type: admin header 的請求，才會被導到指定的 upstream。

範例：根據 Query 參數來路由

PUT http://127.0.0.1:9180/apisix/admin/routes/dynamic-query
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "uri": "/api/v1/resource",
  "methods": ["GET"],
  "name": "dynamic-query-route",
  "priority": 10,
  "vars": [
    ["arg_version", "==", "beta"]
  ],
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "10.0.0.2:8080": 1
    }
  }
}

這個設定會把帶有 ?version=beta 的請求，導到不同的 upstream。

P.S. APISIX 的路由條件設計相當彈性，可以根據各種請求屬性來做動態分流

APISIX 的核心功能

實際使用後，推薦以下幾個實用功能：

• Route Only 模式：無需先建 Service，直接設定 Route 即可，流程簡化，減少設定步驟
• Consumer Group：雖然沒有 UI，但可透過 API 操作，分群管理相當靈活（不過一個 Consumer 只能加入一個 Consumer Group）
• 動態路由：可根據 Header、Query 參數、IP 等條件動態分流，提供靈活的流量導向
• 限流動態模板 Key：支援多變數組合限流（IP+Consumer+Header），Kong 付費版才有的功能，APISIX 開源版即提供
• 熱更新套件：支援不重啟服務即可加載新套件或修改設定，便於維運，確保服務連續性
• 多語言套件：支援 Lua、Go、Java、Wasm 等多種語言
• 彈性配置：支援 RESTful API、etcd、YAML 等多種配置方式

Route Only 實測

還是用剛剛 /wms/api/item/1 轉址的例子：

PUT http://127.0.0.1:9180/apisix/admin/routes/api-0001
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "uri": "/wms/api/item/1",
  "name": "/wms/api/item/1",
  "priority": 10,
  "methods": ["GET", "POST", "PUT", "DELETE"],
  "plugins": {
    "proxy-rewrite": {
      "regex_uri": ["^/wms/(.*)", "/$1"]
    }
  },
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "172.62.1.1:1080": 1
    }
  }
}

Consumer Group 與限流設定

APISIX 的 Consumer Group 功能相當實用，雖然沒有 UI 介面，但透過 API 操作也很方便，可以搭配 Plugin Config 來實現分群限流：

PUT http://localhost:9180/apisix/admin/consumer_groups/free
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "plugins": {}
}

建立限流的 Plugin Config：

PUT http://localhost:9180/apisix/admin/plugin_configs/free_ratelimit
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "plugins": {
    "key-auth": {},
    "limit-count": {
      "count": 100,
      "time_window": 1,
      "rejected_code": 429,
      "key": "consumer_name",
      "policy": "local",
      "group": "daily"
    }
  }
}

建立 Consumer 並套用群組：

PUT http://localhost:9180/apisix/admin/consumers/mark
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "username": "mark",
  "plugins": {
    "key-auth": {
      "key": "mark-api-key"
    }
  },
  "consumer_group": "standard"
}

注意喔！一個 consumer 只能加入一個 consumer group

限流功能

APISIX 在限流方面表現優秀，支援類似 Kong 付費版才有的「動態模板 key」功能。可以在 key 欄位中使用多個變數（如 IP、consumer、header 等）組合，實現精細的分群限流。

舉例來說：

PUT /apisix/admin/plugin_configs/pc_free
{
  "plugins": {
    "limit-count": {
      "time_window": 60,
      "count": 100,      
      "rejected_code": 429,            
      "key_type": "var_combination",      
      "key": "standard-1-47|$consumer_name", 
      "policy": "redis",      
      "redis_host": "192.168.0.15",
      "redis_port": 6379,
      "redis_timeout": 1000000,
      "redis_database": 0
    }
  }
}

P.S. 這個實測有問題，應該是有bug

這個設定會根據來源 IP、consumer 名稱、以及 header X-User-Group 的組合，動態計算每個分群的頻次，限流資料儲存在 Redis 中。這種彈性分群限流功能，Kong 需企業版才提供，APISIX 開源版即內建此功能。

Plugin Config 與套件綁定層級

APISIX 支援多個層級的套件綁定，讓你可以很彈性地管理：

Plugin Config 可以重複使用，讓 Route/Service 直接引用 plugin_config_id，維運效率大大提升！

API 分組與查詢

APISIX 支援 labels 功能，可以為 Route、Consumer、Service 加上 group 標籤，便於查詢和管理：

{
  "uri": "/wms/api/item/1",
  "labels": {
    "group": "wms"
  },
  "name": "get-wms-item-1"
}

想查詢 group 是 wms 的 route，直接這樣打：

GET /apisix/admin/routes?label=group==wms

全域套件與監控設定

可以用 Global Rule 來套用全域套件，像是 request-id、prometheus、udp-logger 等等：

PUT http://127.0.0.1:9180/apisix/admin/global_rules/1
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "plugins": {
    "key-auth": {"_meta": {"disable": false}},
    "request-id": {"_meta": {"disable": false}},
    "prometheus": {"_meta": {"disable": false}},
    "udp-logger": {
      "host": "192.168.0.1",
      "port": 5000,
      "custom_fields": {"client_ip": "$remote_addr"}
    }
  }
}

注意：APISIX 支援多筆 Global rules（有特殊用途），但 Dashboard 只能管理一筆。一般情況下，維持一筆 global_rule（如 /global_rules/1）即可滿足需求，將所有 plugin 配置在同一筆記錄中。

啟用 Prometheus 監控：

PUT http://localhost:9180/apisix/admin/plugins/prometheus
X-API-KEY: <your-api-key>
Content-Type: application/json

{
  "enabled": true
}

APISIX 的限制（還是要知道一下）

雖然 APISIX 很強，但還是有一些限制要注意。不管是用 KONG 還是 APISIX，都各有各的限制，如果需要更複雜的流量分組，可能都需要自己寫 plugin，或是大幅度客製化：

• 一個 consumer 只能加入一個 consumer group
• 一個 route 只能套用一個 plugin config
• Route uri 不能重複
• 一個 Route 對同一種pluing只能套一個 plugin
• plugin_config 不可以 group 或動態條件切換，但可以透過動態路由條件
• 一個限流設定只能限制單一時間
• 有些套件在某有些版本 bug

心得分享

使用 APISIX 一段時間後，認為這個開源方案確實很不錯。其高彈性、熱更新、多語言套件等優勢，使其成為現代 API Gateway 的優質選擇，雖然有些功能需要透過 API 操作，維運複雜度稍微高一些，但對於需要高彈性、分群限流、動態路由的場景來說，APISIX 提供了完善的解決方案，了解這些限制之後，就能更清楚該提供什麼樣的解決方案。但在特定領域的 API Gateway 需求如果過於複雜，即使使用付費版本，除非需求可以調整，否則最終還是可能需要客製化開發。