wehub/kong--kong
1
0
Fork 0
Code Issues Pull Requests Actions 4 Deployments Models Agent Notes Packages Projects Releases Wiki Activity

docs: make Chinese README the default

Browse Source
This commit is contained in:
wehub-resource-sync
2026-07-13 10:22:04 +00:00
parent 72f64c949c
commit 9e5aa77be9
1 changed files with 60 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+60 -54
View File
@@ -1,13 +1,19 @@
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/Kong/kong) · [上游 README](https://github.com/Kong/kong/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
[![][kong-logo]][kong-url]
![Stars](https://img.shields.io/github/stars/Kong/kong?style=flat-square) ![GitHub commit activity](https://img.shields.io/docker/pulls/_/kong?style=flat-square) [![Build Status][badge-action-image]][badge-action-url] ![Version](https://img.shields.io/github/v/release/Kong/kong?color=green&label=Version&style=flat-square) ![License](https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square) [![Twitter Follow](https://img.shields.io/twitter/follow/thekonginc?style=social)](https://x.com/thekonginc)
Kong or Kong Gateway is a cloud-native, platform-agnostic, scalable **API 𖧹 LLM 𖧹 MCP** Gateway distinguished for its high performance and extensibility via plugins. It also provides advanced AI traffic capabilities with multi-LLM support, semantic security, MCP traffic security and analytics, and more.
Kong 或 Kong Gateway 是一款云原生、跨平台、可扩展的 **API 𖧹 LLM 𖧹 MCP** 网关，以高性能和通过插件实现的扩展性而著称。它还提供先进的 AI 流量能力，支持多 LLM、语义安全（semantic security）、MCP 流量安全与分析等功能。
By providing functionality for proxying, routing, load balancing, health checking, authentication (and [more](#features)), Kong serves as the central layer for orchestrating microservices or conventional API traffic - and agentic LLM and MCP as well - with ease.
通过提供代理、路由、负载均衡、健康检查、身份验证（以及[更多功能](#features)），Kong 可轻松作为编排微服务或传统 API 流量——以及智能体 LLM 与 MCP——的中心层。
Kong runs natively on Kubernetes thanks to its official [Kubernetes Ingress Controller](https://github.com/Kong/kubernetes-ingress-controller).
借助官方 [Kubernetes Ingress Controller](https://github.com/Kong/kubernetes-ingress-controller).，Kong 可在 Kubernetes 上原生运行。
<br />
@@ -15,99 +21,99 @@ Kong runs natively on Kubernetes thanks to its official [Kubernetes Ingress Cont
---
[Installation](https://konghq.com/install/#kong-community) | [Documentation](https://docs.konghq.com) | [Discussions](https://github.com/Kong/kong/discussions) | [Forum](https://discuss.konghq.com) | [Blog](https://konghq.com/blog) | [Builds][kong-master-builds] | [AI Gateway](https://konghq.com/products/kong-ai-gateway) | [Cloud Hosted Kong](https://konghq.com/kong-konnect/)
[安装](https://konghq.com/install/#kong-community) | [文档](https://docs.konghq.com) | [讨论](https://github.com/Kong/kong/discussions) | [论坛](https://discuss.konghq.com) | [博客](https://konghq.com/blog) | [构建][kong-master-builds] | [AI Gateway](https://konghq.com/products/kong-ai-gateway) | [Cloud Hosted Kong](https://konghq.com/kong-konnect/)
---
## Getting Started
## 快速入门
If you prefer to use a cloud-hosted Kong, you can [sign up for a free trial of Kong Konnect](https://konghq.com/products/kong-konnect/register?utm_medium=Referral&utm_source=Github&utm_campaign=kong-gateway&utm_content=konnect-promo-in-gateway&utm_term=get-started) and get started in minutes. If not, you can follow the instructions below to get started with Kong on your own infrastructure.
如果你更倾向使用云托管 Kong，可以[注册 Kong Konnect 免费试用](https://konghq.com/products/kong-konnect/register?utm_medium=Referral&utm_source=Github&utm_campaign=kong-gateway&utm_content=konnect-promo-in-gateway&utm_term=get-started)，几分钟即可上手。否则，可按照下方说明在你自己的基础设施上部署 Kong。
Let’s test drive Kong by adding authentication to an API in under 5 minutes.
让我们在 5 分钟内为 API 添加身份验证，快速体验 Kong。
We suggest using the docker-compose distribution via the instructions below, but there is also a [docker installation](https://docs.konghq.com/gateway/latest/install/docker/#install-kong-gateway-in-db-less-mode) procedure if you’d prefer to run the Kong Gateway in DB-less mode.
我们建议通过以下说明使用 docker-compose 发行版，但如果你更希望以 DB-less 模式运行 Kong Gateway，也可参考 [Docker 安装](https://docs.konghq.com/gateway/latest/install/docker/#install-kong-gateway-in-db-less-mode) 流程。
Whether you’re running in the cloud, on bare metal, or using containers, you can find every supported distribution on our [official installation](https://konghq.com/install/#kong-community) page.
无论你是在云端、裸机上还是使用容器运行，都可以在我们的[官方安装](https://konghq.com/install/#kong-community) 页面找到所有受支持的发行版。
1) To start, clone the Docker repository and navigate to the compose folder.
1) 首先，克隆 Docker 仓库并进入 compose 文件夹。
```cmd
$ git clone https://github.com/Kong/docker-kong
$ cd docker-kong/compose/
```
2) Start the Gateway stack using:
2) 使用以下命令启动 Gateway 堆栈：
```cmd
$ KONG_DATABASE=postgres docker-compose --profile database up
```
The Gateway is now available on the following ports on localhost:
Gateway 现已在 localhost 的以下端口上可用：
- `:8000` - send traffic to your service via Kong
- `:8001` - configure Kong using Admin API or via [decK](https://github.com/kong/deck)
- `:8002` - access Kong's management Web UI ([Kong Manager](https://github.com/Kong/kong-manager)) on [localhost:8002](http://localhost:8002)
- `:8000` - 通过 Kong 将流量发送至你的服务
- `:8001` - 使用 Admin API 或通过 [decK](https://github.com/kong/deck) 配置 Kong
- `:8002` - 访问 Kong 管理 Web UI（[Kong Manager](https://github.com/Kong/kong-manager))，地址为 [localhost:8002](http://localhost:8002)
Next, follow the [quick start guide](https://docs.konghq.com/gateway-oss/latest/getting-started/configuring-a-service/
) to tour the Gateway features.
接下来，请按照[快速入门指南](https://docs.konghq.com/gateway-oss/latest/getting-started/configuring-a-service/
)浏览 Gateway 功能。
### Getting started with AI Gateway for LLM and MCP
### 面向 LLM 与 MCP 的 AI Gateway 快速入门
If you would like to get started with Kong AI Gateway capabilities including LLM and MCP features, please refer to the [official AI documentation](https://developer.konghq.com/ai-gateway/).
如果你想体验 Kong AI Gateway 的 LLM 与 MCP 等功能，请参阅[官方 AI 文档](https://developer.konghq.com/ai-gateway/).
## Features
## 功能特性
By centralizing common API, AI and MCP functionality across all your organization's services, Kong Gateway creates more freedom for engineering teams to focus on the challenges that matter most.
通过将组织内各项服务共通的 API、AI 与 MCP 能力集中管理，Kong Gateway 让工程团队更自由地专注于真正重要的挑战。
The top Kong features include:
Kong 的主要功能包括：
- Advanced routing, load balancing, health checking - all configurable via a RESTful admin API or declarative configuration.
- Authentication and authorization for APIs using methods like JWT, basic auth, OAuth, ACLs and more.
- Universal LLM API to route across multiple providers like OpenAI, Anthropic, GCP Gemini, AWS Bedrock, Azure AI, Databricks, Mistral, Huggingface and more.
- MCP traffic governance, MCP security and MCP observability in addition to MCP autogeneration from any RESTful API.
- 60+ AI features like AI observability, semantic security and caching, semantic routing and more.
- Proxy, SSL/TLS termination, and connectivity support for L4 or L7 traffic.
- Plugins for enforcing traffic controls, rate limiting, req/res transformations, logging, monitoring and including a plugin developer hub.
- Sophisticated deployment models like Declarative Databaseless Deployment and Hybrid Deployment (control plane/data plane separation) without any vendor lock-in.
- Native [ingress controller](https://github.com/Kong/kubernetes-ingress-controller) support for serving Kubernetes.
- 高级路由、负载均衡、健康检查——均可通过 RESTful 管理 API 或声明式配置进行设置。
- 面向 API 的身份验证与授权，支持 JWT、基本认证（basic auth）、OAuth、ACL 等多种方式。
- 通用 LLM API，可在 OpenAI、Anthropic、GCP Gemini、AWS Bedrock、Azure AI、Databricks、Mistral、Huggingface 等多家提供商之间路由。
- MCP 流量治理、MCP 安全与 MCP 可观测性，并支持从任意 RESTful API 自动生成 MCP。
- 60 余项 AI 功能，包括 AI 可观测性、语义安全与缓存、语义路由等。
- 代理、SSL/TLS 终止，以及对 L4 或 L7 流量的连接支持。
- 用于强制执行流量控制、限流、请求/响应转换、日志、监控等的插件，并提供插件开发者中心。
- 精密的部署模型，如声明式无数据库部署（Declarative Databaseless Deployment）和混合部署（控制平面/数据平面分离），且无供应商锁定。
- 原生 [Ingress Controller](https://github.com/Kong/kubernetes-ingress-controller) 支持，可在 Kubernetes 上提供服务。
[![][kong-benefits]][kong-url]
### Plugin Hub
### 插件中心（Plugin Hub）
Plugins provide advanced functionality that extends the use of the Gateway. Many of the Kong Inc. and community-developed plugins like AWS Lambda, Correlation ID, and Response Transformer are showcased at the [Plugin Hub](https://docs.konghq.com/hub/).
插件提供可扩展 Gateway 用途的高级功能。Kong Inc. 及社区开发的众多插件（如 AWS Lambda、Correlation ID、Response Transformer）可在[插件中心](https://docs.konghq.com/hub/). 查看。
Contribute to the Plugin Hub and ensure your next innovative idea is published and available to the broader community!
为插件中心做出贡献，让你的下一个创新想法得以发布并惠及更广泛的社区！
## Contributing
## 参与贡献
We ❤️ pull requests, and we’re continually working hard to make it as easy as possible for developers to contribute. Before beginning development with the Kong Gateway, please familiarize yourself with the following developer resources:
我们❤️ pull request，并持续努力让开发者尽可能轻松地参与贡献。在开始基于 Kong Gateway 进行开发之前，请先熟悉以下开发者资源：
- Community Pledge ([COMMUNITY_PLEDGE.md](COMMUNITY_PLEDGE.md)) for our pledge to interact with you, the open source community.
- Contributor Guide ([CONTRIBUTING.md](CONTRIBUTING.md)) to learn about how to contribute to Kong.
- Development Guide ([DEVELOPER.md](DEVELOPER.md)): Setting up your development environment.
- [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) and [COPYRIGHT](COPYRIGHT)
- 社区承诺（[COMMUNITY_PLEDGE.md](COMMUNITY_PLEDGE.md)）：我们与开源社区互动的承诺。
- 贡献者指南（[CONTRIBUTING.md](CONTRIBUTING.md)）：了解如何为 Kong 做出贡献。
- 开发指南（[DEVELOPER.md](DEVELOPER.md)）：搭建开发环境。
- [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) 与 [COPYRIGHT](COPYRIGHT)
Use the [Plugin Development Guide](https://docs.konghq.com/latest/plugin-development/) for building new and creative plugins, or browse the online version of Kong's source code documentation in the [Plugin Development Kit (PDK) Reference](https://docs.konghq.com/latest/pdk/). Developers can build plugins in [Lua](https://docs.konghq.com/gateway/latest/plugin-development/), [Go](https://docs.konghq.com/gateway-oss/latest/external-plugins/#developing-go-plugins) or [JavaScript](https://docs.konghq.com/gateway-oss/latest/external-plugins/#developing-javascript-plugins).
使用[插件开发指南](https://docs.konghq.com/latest/plugin-development/) 构建新颖创意的插件，或在[插件开发套件（PDK）参考](https://docs.konghq.com/latest/pdk/). 中浏览 Kong 源代码文档的在线版本。开发者可使用 [Lua](https://docs.konghq.com/gateway/latest/plugin-development/),、[Go](https://docs.konghq.com/gateway-oss/latest/external-plugins/#developing-go-plugins) 或 [JavaScript](https://docs.konghq.com/gateway-oss/latest/external-plugins/#developing-javascript-plugins). 构建插件。
## Releases
## 发布版本
Please see the [Changelog](CHANGELOG.md) for more details about a given release. The [SemVer Specification](https://semver.org) is followed when versioning Gateway releases.
有关各版本发布的更多详情，请参阅[更新日志](CHANGELOG.md)。Gateway 版本号遵循 [SemVer 规范](https://semver.org)。
## Join the Community
## 加入社区
- Check out the [docs](https://docs.konghq.com/)
- Join the [Kong discussions forum](https://github.com/Kong/kong/discussions)
- Join the Kong discussions at the Kong Nation forum: [https://discuss.konghq.com/](https://discuss.konghq.com/)
- Join our [Community Slack](http://kongcommunity.slack.com/)
- Read up on the latest happenings at our [blog](https://konghq.com/blog/)
- Follow us on [X](https://x.com/thekonginc)
- Subscribe to our [YouTube channel](https://www.youtube.com/c/KongInc/videos)
- Visit our [homepage](https://konghq.com/) to learn more
- 查阅[文档](https://docs.konghq.com/)
- 加入 [Kong 讨论论坛](https://github.com/Kong/kong/discussions)
- 在 Kong Nation 论坛参与 Kong 讨论：[https://discuss.konghq.com/](https://discuss.konghq.com/)
- 加入我们的[社区 Slack](http://kongcommunity.slack.com/)
- 在我们的[博客](https://konghq.com/blog/) 了解最新动态
- 在 [X](https://x.com/thekonginc) 关注我们
- 订阅我们的 [YouTube 频道](https://www.youtube.com/c/KongInc/videos)
- 访问我们的[主页](https://konghq.com/) 了解更多
## Konnect Cloud
Kong Inc. offers commercial subscriptions that enhance the Kong Gateway in a variety of ways. Customers of Kong's [Konnect Cloud](https://konghq.com/kong-konnect/) subscription take advantage of additional gateway functionality, commercial support, and access to Kong's managed (SaaS) control plane platform. The Konnect Cloud platform features include real-time analytics, a service catalog, developer portals, and so much more! [Get started](https://konghq.com/products/kong-konnect/register?utm_medium=Referral&utm_source=Github&utm_campaign=kong-gateway&utm_content=konnect-promo-in-gateway&utm_term=get-started) with Konnect Cloud.
Kong Inc. 提供商业订阅，以多种方式增强 Kong Gateway。Kong [Konnect Cloud](https://konghq.com/kong-konnect/) 订阅客户可享受额外的网关功能、商业支持，以及 Kong 托管（SaaS）控制平面平台的访问权限。Konnect Cloud 平台功能包括实时分析、服务目录、开发者门户等！[立即开始](https://konghq.com/products/kong-konnect/register?utm_medium=Referral&utm_source=Github&utm_campaign=kong-gateway&utm_content=konnect-promo-in-gateway&utm_term=get-started) 使用 Konnect Cloud。
## License
## 许可证
```
Copyright 2016-2026 Kong Inc.