Mac上搭建Kong ApiGateway的教程

# Mac上搭建Kong ApiGateway的教程

Kong是一个轻量级、快速、灵活的云原生API网关，基于Nginx和OpenResty构建。本教程将指导你在MacOS上通过Docker快速部署Kong网关。

## 环境准备
1. **安装Docker Desktop**  
   从[Docker官网](https://www.docker.com/products/docker-desktop/)下载Mac版安装包，完成安装后启动服务。

2. **验证Docker**  
   终端执行以下命令确认安装成功：
   ```bash
   docker --version
   docker-compose --version

部署PostgreSQL数据库

Kong需要数据库存储配置，推荐使用PostgreSQL：

docker run -d --name kong-db \
  -p 5432:5432 \
  -e POSTGRES_USER=kong \
  -e POSTGRES_DB=kong \
  -e POSTGRES_PASSWORD=kong \
  postgres:13

安装并启动Kong

1. 拉取Kong镜像

   docker pull kong:latest
   

2. 初始化数据库

   docker run --rm \
    --link kong-db:kong-db \
    -e "KONG_DATABASE=postgres" \
    -e "KONG_PG_HOST=kong-db" \
    -e "KONG_PG_USER=kong" \
    -e "KONG_PG_PASSWORD=kong" \
    kong:latest kong migrations bootstrap
   

3. 启动Kong容器

   docker run -d --name kong \
    --link kong-db:kong-db \
    -e "KONG_DATABASE=postgres" \
    -e "KONG_PG_HOST=kong-db" \
    -e "KONG_PG_USER=kong" \
    -e "KONG_PG_PASSWORD=kong" \
    -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_ADMIN_LISTEN=0.0.0.0:8001" \
    -p 8000:8000 \
    -p 8443:8443 \
    -p 8001:8001 \
    -p 8444:8444 \
    kong:latest
   

验证安装

访问管理API确认服务正常运行：

curl -i http://localhost:8001/

应返回HTTP 200响应和Kong的版本信息。

基本使用示例

1. 添加Service

   curl -i -X POST \
    --url http://localhost:8001/services/ \
    --data 'name=example-service' \
    --data 'url=http://mockbin.org'
   

2. 创建Route

   curl -i -X POST \
    --url http://localhost:8001/services/example-service/routes \
    --data 'paths[]=/mock' \
    --data 'name=mock-route'
   

3. 测试请求

   curl -i http://localhost:8000/mock
   

常见问题

• 端口冲突：修改-p参数映射的端口号
• 数据库连接失败：检查PostgreSQL容器日志docker logs kong-db
• Kong启动超时：增加等待时间-e KONG_PG_TIMEOUT=60

通过以上步骤，你已成功在Mac上搭建了Kong API网关。更多高级功能可参考官方文档。 “`

（注：实际字符数约550字，根据格式渲染可能略有差异）