https://github.com/qianyugang/kong-docs-cn
微服务 Api 网关 Kong 最新文档中文版
https://github.com/qianyugang/kong-docs-cn
api-gateway kong kong-api kong-api-gateway kong-doc kong-docs kong-docs-cn kong-gateway kong-plugin lua microservice nginx openresty
Last synced: 4 days ago
JSON representation
微服务 Api 网关 Kong 最新文档中文版
- Host: GitHub
- URL: https://github.com/qianyugang/kong-docs-cn
- Owner: qianyugang
- Created: 2019-05-14T09:04:04.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-01-09T08:49:02.000Z (about 1 month ago)
- Last Synced: 2025-02-10T08:05:24.132Z (11 days ago)
- Topics: api-gateway, kong, kong-api, kong-api-gateway, kong-doc, kong-docs, kong-docs-cn, kong-gateway, kong-plugin, lua, microservice, nginx, openresty
- Homepage:
- Size: 853 KB
- Stars: 831
- Watchers: 29
- Forks: 173
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 简介
Kong Gateway (OSS) - 一个轻量级开源网关。
- 项目官方网站：https://konghq.com/
- 项目源码地址：https://github.com/Kong/kong
Kong是一个云原生，快速，可扩展和分布式微服务抽象层（也称为API网关，API中间件或某些情况下的Service Mesh）。作为2015年的开源项目，其核心价值在于高性能和可扩展性。
由于对项目的积极维护，Kong被广泛用于从初创公司到全球500强以及政府机构的生产中。
## 提示
**重要❗️：** 本文档是基于 [](https://legacy-gateway--kongdocs.netlify.app/gateway-oss/1.0.x/) 版本，目前官网已经更新至 [](https://docs.konghq.com/gateway/3.9.x/) 版本，如果使用的其他版本，请查看官方文档：
## 版本说明
- 官网最新版本：
[](https://docs.konghq.com/gateway/3.0.x/)
[](https://docs.konghq.com/gateway/3.1.x/)
[](https://docs.konghq.com/gateway/3.2.x/)
[](https://docs.konghq.com/gateway/3.3.x/)
[](https://docs.konghq.com/gateway/3.4.x/)
[](https://docs.konghq.com/gateway/3.5.x/)
[](https://docs.konghq.com/gateway/3.6.x/)
[](https://docs.konghq.com/gateway/3.7.x/)
[](https://docs.konghq.com/gateway/3.8.x/)
[](https://docs.konghq.com/gateway/3.9.x/)
- 官网维护版本：
[](https://docs.konghq.com/gateway-oss/2.1.x/)
[](https://docs.konghq.com/gateway-oss/2.2.x/)
[](https://docs.konghq.com/gateway-oss/2.3.x/)
[](https://docs.konghq.com/gateway-oss/2.4.x/)
[](https://docs.konghq.com/gateway-oss/2.5.x/)
[](https://docs.konghq.com/gateway/2.6.x/)
[](https://docs.konghq.com/gateway/2.7.x/)
[](https://docs.konghq.com/gateway/2.8.x/)
- 历史存档版本：
[](https://legacy-gateway--kongdocs.netlify.app/gateway-oss/1.0.x/)
[](https://legacy-gateway--kongdocs.netlify.app/gateway-oss/1.1.x/)
[](https://legacy-gateway--kongdocs.netlify.app/gateway-oss/1.2.x/)
[](https://legacy-gateway--kongdocs.netlify.app/gateway-oss/1.3.x/)
[](https://legacy-gateway--kongdocs.netlify.app/gateway-oss/1.4.x/)
[](https://legacy-gateway--kongdocs.netlify.app/gateway-oss/1.5.x/)
[](https://legacy-gateway--kongdocs.netlify.app/gateway-oss/2.0.x/)
**本篇文档说明：https://102no.com/2019/06/27/kong-docs-cn/**
# 安装文档目录
- **官方支持**
- **包安装**
* [使用 Docker 安装](INSTALL/docker.md)
* [在 Ubuntu 上安装](INSTALL/ubuntu.md)
* [在 CentOS 上安装](INSTALL/centos.md)
* [在 macOS 上安装](INSTALL/macos.md)
* [在 Debian 上安装](INSTALL/debian.md)
* [在 Red Hat 上安装](INSTALL/redhat.md)
* [在 Amazon Linux 上安装](INSTALL/aws-linux.md)
- **云安装**
* [在 Kubernetes 上安装 Kong 和 Kong Enterprise](INSTALL/kubernetes.md)
* [在 DC/OS 集群部署](INSTALL/dcos.md)
* [在 Google Cloud 上安装](INSTALL/google-cloud.md)
* [在 AWS 软件市场 AMI上安装](INSTALL/aws-marketplace.md)
- **源安装**
* [在 Vagrant 上安装](INSTALL/vagrant.md)
* [使用源码安装](INSTALL/source.md)
# 开发文档目录
* **快速入门**
* [简介](GETTING-STARTED/introduction.md)
* [五分钟快速开始](GETTING-STARTED/quickstart.md)
* [配置一个服务](GETTING-STARTED/configuring-a-service.md)
* [启用插件](GETTING-STARTED/enabling-plugins.md)
* [添加消费者](GETTING-STARTED/adding-consumers.md)
* **开发指南**
* [配置](GUIDES&REFERENCES/configuration.md)
* [CLI](GUIDES&REFERENCES/cli.md)
* [代理](GUIDES&REFERENCES/proxy.md)
* [认证](GUIDES&REFERENCES/auth.md)
* [负载均衡](GUIDES&REFERENCES/loadbalancing.md)
* [健康检查和断路器](GUIDES&REFERENCES/health-checks-circuit-breakers.md)
* [集群](GUIDES&REFERENCES/clustering.md)
* [日志](GUIDES&REFERENCES/logging.md)
* [网络&防火墙](GUIDES&REFERENCES/network.md)
* [保证 Admin API 安全](GUIDES&REFERENCES/secure-admin-api.md)
* [插件开发](GUIDES&REFERENCES/plugin-development/)
* [简介](GUIDES&REFERENCES/plugin-development/README.md)
* [文件结构](GUIDES&REFERENCES/plugin-development/file-structure.md)
* [实现自定义逻辑](GUIDES&REFERENCES/plugin-development/custom-logic.md)
* [插件配置](GUIDES&REFERENCES/plugin-development/plugin-configuration.md)
* [访问数据存储区](GUIDES&REFERENCES/plugin-development/access-the-datastore.md)
* [存储自定义实体](GUIDES&REFERENCES/plugin-development/custom-entities.md)
* [缓存自定义实体](GUIDES&REFERENCES/plugin-development/entities-cache.md)
* [扩展Admin API](GUIDES&REFERENCES/plugin-development/admin-api.md)
* [编写单元测试](GUIDES&REFERENCES/plugin-development/tests.md)
* [安装/卸载插件](GUIDES&REFERENCES/plugin-development/distribution.md)
* [插件开发套件(PDK)](GUIDES&REFERENCES/PDK/pdk.md)
* [kong.client](GUIDES&REFERENCES/PDK/kong-client.md)
* [kong.ctx](GUIDES&REFERENCES/PDK/kong-ctx.md)
* [kong.ip](GUIDES&REFERENCES/PDK/kong-ip.md)
* [kong.log](GUIDES&REFERENCES/PDK/kong-log.md)
* [kong.node](GUIDES&REFERENCES/PDK/kong-node.md)
* [kong.request](GUIDES&REFERENCES/PDK/kong-request.md)
* [kong.response](GUIDES&REFERENCES/PDK/kong-response.md)
* [kong.router](GUIDES&REFERENCES/PDK/kong-router.md)
* [kong.service](GUIDES&REFERENCES/PDK/kong-service.md)
* [kong.service.request](GUIDES&REFERENCES/PDK/kong-service-request.md)
* [kong.service.response](GUIDES&REFERENCES/PDK/kong-service-response.md)
* [kong.table](GUIDES&REFERENCES/PDK/kong-table.md)
* **Admin Api**
* [无数据库模式 Admin API](ADMIN-API/db-less.md)
* [支持的 Content Types](ADMIN-API/supported-content-types.md)
* [信息路由](ADMIN-API/information-routes.md)
* [标签](ADMIN-API/tags.md)
* [Service 对象](ADMIN-API/service-object.md)
* [Route 对象](ADMIN-API/route-object.md)
* [Consumer 对象](ADMIN-API/consumer-object.md)
* [插件对象](ADMIN-API/plugin-object.md)
* [证书对象](ADMIN-API/certificate-object.md)
* [SNI 对象](ADMIN-API/sni-object.md)
* [Upstream 对象](ADMIN-API/upstream-object.md)
* [Target 对象](ADMIN-API/target-object.md)
# 插件文档目录
- **认证**
* [Basic Authentication 基础认证插件](HUB/basic-auth.md)
* [HMAC Authentication 认证插件](HUB/hmac-auth.md)
* [JWT 插件](HUB/jwt.md)
* [Key Authentication 密钥认证插件](HUB/key-auth.md)
* [LDAP Authentication 认证插件](HUB/ldap-auth.md)
* [OAuth 2.0 Authentication 认证插件](HUB/oauth2.md)
* [Session 插件](HUB/session.md)
- **安全**
* [CORS 插件](HUB/cors.md)
* [IP Restriction 插件](HUB/ip-restriction.md)
* [Bot Detection 机器人检测插件](HUB/bot-detection.md)
- **日志**
* [File Log 插件](HUB/file-log.md)
* [TCP Log 插件](HUB/tcp-log.md)
* [UDP Log 插件](HUB/udp-log.md)
* [HTTP Log 插件](HUB/http-log.md)
* [Loggly 插件](HUB/loggly.md)
* [StatsD 插件](HUB/statsd.md)
* [Syslog 插件](HUB/syslog.md)
- **变更**
* [Correlation ID 关联 ID插件](HUB/correlation-id.md)
* [Request Transformer 请求变更插件](HUB/request-transformer.md)
* [Response Transformer 响应变更插件](HUB/response-transformer.md)
- **传输限制**
* [ACL 插件](HUB/acl.md)
* [Proxy Caching 代理缓存插件](HUB/proxy-cache.md)
* [Rate Limiting 速率限制插件](HUB/rate-limiting.md)
* [Response Rate Limiting 响应率限制插件](HUB/response-ratelimiting.md)
* [Request Termination 请求终止插件](HUB/request-termination.md)
* [Request Size Limiting 请求大小限制插件](HUB/request-size-limiting.md)
- **无服务**
* [AWS Lambda 插件](HUB/aws-lambda.md)
* [Serverless Functions 插件](HUB/serverless-functions.md)
* [Apache OpenWhisk 插件](HUB/openwhisk.md)
- **分析与监测**
* [Datadog 插件](HUB/datadog.md)
* [Zipkin 插件](HUB/zipkin.md)
* [Prometheus 插件](HUB/prometheus.md)
- **部署**
* [Kubernetes Sidecar 注入插件](HUB/kubernetes-sidecar-injector.md)
* [decK 插件](HUB/deck.md)
## 官方博客
- [Kong 1.0 GA 版本正式发布(更新详情)](BLOG/kong-1.0.md)
- [Kong 1.0.0 升级指南](BLOG/kong-1.0-update.md)
- [Kong 1.3 发布！支持原生gRPC代理，上游双向TLS认证，以及更多功能](BLOG/kong-1.3.md)
- [Kong 1.4 发布！自动检测Cassandra Topology 更改，自定义Host Header以及更多功能！](BLOG/kong-1.4.md)
- [Kong 2.0 正式发布！](BLOG/kong-2.0.md)
- [Kong 2.0 升级指南！](BLOG/kong-2.0-upgrade.md)
- [Kong 2.1 正式发布！](BLOG/kong-2.1.md)
- [Kong 2.2 正式发布！](BLOG/kong-2.2.md)
- [Kong 2.3 正式发布！](BLOG/kong-2.3.md)
- [Kong 2.4 正式发布！](BLOG/kong-2.4.md)
- [Kong 2.5 正式发布了！](BLOG/kong-2.5.md)
- [Kong 2.6 正式发布啦！](BLOG/kong-2.6.md)
- [Kong 2.7 已经准备就绪！](BLOG/kong-2.7.md)
- [Kong 2.8 已经发布：提高安全性，简化API管理](BLOG/kong-2.8.md)
- [Kong Gateway 3.0正式发布！](BLOG/kong-3.0.md)
- [Kong Gateway 3.6.x 正式发布，较大改变！](BLOG/kong-3.6.md)
- [Kong 3.7重磅上线！Kong AI Gateway 正式 GA！](https://mp.weixin.qq.com/s/zMZpuEA1tI0UNlD7X7PP8A)
- [Kong Gateway 3.8 正式 GA！](https://mp.weixin.qq.com/s/SrrLB8uvfH5dPPW2OnJXIQ)
- [Kong Gateway 3.9 发布了：扩展 AI 支持并强化安全功能](https://mp.weixin.qq.com/s/D_cvdZvFzKY16r0IwNVhvA)
**译者注：**
翻译这个文档的原因是自己正好在学习这个kong，一方面也是锻炼自己的英语能力，所以采用的是人工+机翻结合的方式，如果有遇到翻译的不够通顺，或者对于翻译的语句有歧义的地方，麻烦一定点击官网英文文档 https://docs.konghq.com/gateway-oss/ 查看，并且欢迎提 PR 提修改意见。另，由于kong的文档本身也在不断增加和完善当中，如果有遇到没有即使更新翻译的状况欢迎提issue，我会不断补充的。
**todo：**
- 目前文档中的超链接都是链接的英文原文，后续会慢慢改成中文内链。
- ~~会在每一页文档里面附上单独的英文原文链接，以便做对照。~~
- ~~会添加kong自带的插件文档。~~
[](https://star-history.com/#qianyugang/kong-docs-cn&Date)