When the user wants to create,…

# Kong API 网关 · 文档首页

项目简介

Kong 是一款高性能、可扩展的开源 API 网关，基于 OpenResty/Nginx 构建，提供服务路由、认证授权、限流、日志监控等核心能力，支持插件化扩展，适用于微服务与云原生场景。

---

快速开始（Quick Start）

以下步骤可让 Kong 在几分钟内运行起来：

1. 使用 Docker 启动 Kong（需已安装 Docker）

2. 注册一个服务

3. 为服务添加路由

4. 通过网关访问该服务，验证代理是否生效

```bash

# 启动 Kong（无数据库模式，适合快速体验）

docker run -d --name kong \

-e "KONG_DATABASE=off" \

-e "KONG_PROXY_ACCESS_LOG=/dev/stdout" \

-e "KONG_ADMIN_ACCESS_LOG=/dev/stdout" \

-e "KONG_PROXY_LISTEN=0.0.0.0:8000" \

-e "KONG_ADMIN_LISTEN=0.0.0.0:8001" \

-p 8000:8000 -p 8001:8001 \

kong:latest

# 注册服务

curl -i -X POST http://localhost:8001/services \

--data name=example \

--data url='http://httpbin.org'

# 添加路由

curl -i -X POST http://localhost:8001/services/example/routes \

--data 'paths[]=/example'

# 通过网关访问

curl -i http://localhost:8000/example/get

```

---

安装步骤

方式一：Docker 安装

• 前置要求：Docker 与 Docker Compose 已安装
• 部署模式选择：
• 无数据库模式：适合开发测试，配置存内存
• 有数据库模式（PostgreSQL/Cassandra）：适合生产，支持集群
• 推荐步骤：

1. 拉取 Kong 镜像（建议使用官方稳定版本）

2. 有数据库模式需先运行数据库迁移命令 kong migrations bootstrap

3. 建议配合 Kong Manager（管理界面）使用，简化配置

4. 官方提供 Docker Compose 文件，可一键启动 Kong + 数据库

方式二：Kubernetes 安装（Kong Ingress Controller）

• 前置要求：Kubernetes 集群（版本建议 1.19+）、kubectl、Helm 3
• 推荐步骤：

1. 添加 Kong 官方 Helm 仓库

2. 通过 Helm 安装 Kong Ingress Controller（包含网关与控制器）

3. 确认 Pod 正常运行，获取代理访问地址

4. 通过 Ingress / KongIngress CRD 声明式管理路由与插件

```bash

helm repo add kong https://charts.konghq.com

helm repo update

helm install kong kong/kong -n kong --create-namespace

```

---

常见问题（FAQ）

• 管理端口 8001 无法访问？ 检查 Admin Listen