Docker Compose 实战：Kong云原生API网关与PostgreSQL集成部署

关注

原创最新推荐文章于 2026-06-06 11:33:58 发布 642 阅读 AI 写同款· GEO 优化 ›

10 分钟玩转 Kong + Konga：从 0 到生产级 API 网关实战阶段推荐学习阶段小团队中型系统Kong 集群云原生Kong 不是“反向代理”。认证中心限流中心安全网关微服务入口可观测流量层。阅读详情

1. 为什么选择Kong作为云原生API网关

第一次接触Kong是在2018年一个电商系统重构项目中，当时我们需要一个能够统一管理300+微服务接口的解决方案。经过多轮技术选型，最终选择了Kong，这个决定让我们的运维效率提升了近70%。Kong基于Nginx和OpenResty构建，单节点就能轻松处理每秒上万次API请求，这在当时完全碾压其他开源方案。

Kong的核心优势在于它的插件机制。上周我帮一个客户调试系统时，仅仅启用了Rate Limiting和JWT插件，就解决了他们最头疼的API滥用问题。这些插件就像乐高积木一样，可以按需组合：

认证类：Basic Auth、Key Auth、JWT、OAuth2.0
安全类：CORS、IP限制、Bot检测
监控类：Prometheus、Zipkin
流量控制：限流、熔断、缓存

实测数据表明，在16核32G的服务器上，Kong处理HTTP请求的延迟可以控制在5ms以内。更难得的是，它支持DB-less模式，去年我们在一个物联网项目中就用这种模式实现了毫秒级配置热更新。

2. Docker Compose部署全攻略

2.1 环境准备

建议使用Ubuntu 22.04 LTS，这是我测试过最稳定的组合。先确保安装最新版Docker和Compose：

# 安装Docker
sudo apt-get update
sudo apt-get install docker.io

# 安装Compose插件
sudo apt-get install docker-compose-plugin

验证安装：

docker --version
docker compose version

2.2 编写Compose文件

这是我优化过的docker-compose.yaml，增加了健康检查和资源限制：

version: '3.8'

services:
  kong-db:
    image: postgres:13
    container_name: kong-db
    environment:
      POSTGRES_DB: kong
      POSTGRES_USER: kong
      POSTGRES_PASSWORD: kongpass
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U kong"]
      interval: 5s
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 2G

  kong-migrations:
    image: kong:3.4
    depends_on:
      kong-db:
        condition: service_healthy
    environment:
      KONG_DATABASE: postgres
      KONG_PG_HOST: kong-db
      KONG_PG_PASSWORD: kongpass
    command: "kong migrations bootstrap"
    restart: on-failure

  kong:
    image: kong:3.4
    depends_on:
      kong-migrations:
        condition: service_completed_successfully
    environment:
      KONG_DATABASE: postgres
      KONG_PG_HOST: kong-db
      KONG_PROXY_LISTEN: 0.0.0.0:8000
      KONG_ADMIN_LISTEN: 0.0.0.0:8001
    ports:
      - "8000:8000"
      - "8001:8001"
    healthcheck:
      test: ["CMD", "kong", "health"]
      interval: 10s

关键配置说明：

使用PostgreSQL 13而非最新版，稳定性更好
为数据库容器设置内存限制避免OOM
健康检查确保服务依赖顺序
Kong 3.4版本经过长期验证

2.3 启动与验证

启动服务：

docker compose up -d

检查状态：

docker compose ps

测试Admin API：

curl -i http://localhost:8001/

3. 实战：订单系统集成案例

去年我们为某零售企业实施的架构如下：

用户 → Kong → 订单服务 → Kong → 库存服务

3.1 注册服务

# 注册订单服务
curl -X POST http://localhost:8001/services \
  --data name=order-service \
  --data url=http://order:5000

# 注册库存服务  
curl -X POST http://localhost:8001/services \
  --data name=inventory-service \
  --data url=http://inventory:6000

3.2 配置路由

# 订单服务路由
curl -X POST http://localhost:8001/services/order-service/routes \
  --data paths[]=/orders

# 库存服务路由
curl -X POST http://localhost:8001/services/inventory-service/routes \
  --data paths[]=/inventory

3.3 启用插件

限流配置（每秒10次请求）：

curl -X POST http://localhost:8001/plugins \
  --data name=rate-limiting \
  --data config.policy=local \
  --data config.minute=10

JWT认证：

curl -X POST http://localhost:8001/plugins \
  --data name=jwt

4. 性能调优经验分享

在压力测试中我们发现几个关键点：

Worker数量：设置为CPU核数的2倍

environment:
  KONG_NGINX_WORKER_PROCESSES: "8"

缓存优化：增加实体缓存

environment:
  KONG_DATABASE_CACHE_WARMUP_ENTITIES: "on"
  KONG_DATABASE_CACHE_TTL: 3600

连接池：PostgreSQL连接数配置

environment:
  KONG_PG_POOL_SIZE: 20
  KONG_PG_MAX_CONNECTIONS: 1000

实测调优前后对比：

QPS从3k提升到15k
P99延迟从120ms降到35ms

5. 常见问题排查

问题1：数据库连接超时

检查PostgreSQL日志
增加连接超时时间：
```
environment:
  KONG_PG_TIMEOUT: 10000
```

问题2：插件冲突

禁用所有插件后逐个启用

检查插件执行顺序：

curl http://localhost:8001/plugins?enabled=true

问题3：内存泄漏

使用kong health --verbose检查

限制内存使用：

deploy:
  resources:
    limits:
      memory: 1G

6. 进阶技巧

声明式配置：使用deck工具管理配置

deck sync -s kong.yaml

混合模式：DB-less与数据库模式混用

environment:
  KONG_DECLARATIVE_CONFIG: "/opt/kong/kong.yml"
  KONG_DATABASE: "postgres"

Prometheus监控：

curl -X POST http://localhost:8001/plugins \
  --data name=prometheus

访问指标：

http://localhost:8001/metrics

标签

#Docker #Kong #云原生 #API网关

5分钟搞定Konga与Kong的Docker部署：新手避坑指南本文提供了一份详细的Konga与Kong的Docker部署指南，帮助新手在5分钟内快速搭建API网关和可视化管理界面。通过Docker Compose配置和常见问题排查，实现高效的微服务架构管理，特别适合需要快速部署和可视化操作的开发团队。阅读详情