This is an automated email from the ASF dual-hosted git repository.
Yilialinn pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/apisix-website.git
The following commit(s) were added to refs/heads/master by this push:
new e661377e360 fix(seo): clarify APISIX capabilities and search intent
paths (#2118)
e661377e360 is described below
commit e661377e36086f7d4e1bda754d6626f012375045
Author: Yilia Lin <[email protected]>
AuthorDate: Fri Sep 11 18:31:15 2026 +0800
fix(seo): clarify APISIX capabilities and search intent paths (#2118)
---
...ud-vs-open-source-vs-commercial-api-gateways.md | 4 +-
next/src/components/HomePage.astro | 35 +++++++---
next/tests/e2e/main-pages.spec.mjs | 74 ++++++++++++++++++++++
.../open-source-api-gateway-comparison.md | 4 +-
4 files changed, 105 insertions(+), 12 deletions(-)
diff --git
a/blog/en/blog/2025/02/17/cloud-vs-open-source-vs-commercial-api-gateways.md
b/blog/en/blog/2025/02/17/cloud-vs-open-source-vs-commercial-api-gateways.md
index e9df6798746..a485cee0062 100644
--- a/blog/en/blog/2025/02/17/cloud-vs-open-source-vs-commercial-api-gateways.md
+++ b/blog/en/blog/2025/02/17/cloud-vs-open-source-vs-commercial-api-gateways.md
@@ -27,6 +27,8 @@ Cloud-managed, open-source, and commercial API gateways are
not mutually exclusi
<!--truncate-->
+For a product-by-product evaluation, compare Apache APISIX, Kong, Envoy, and
Traefik in the [open-source API gateway
comparison](/learning-center/open-source-api-gateway-comparison/).
+
## What Are You Comparing?
An API gateway sits between API clients and upstream services. Depending on
the product and configuration, it can handle routing, authentication, traffic
limits, protocol translation, observability integrations, and other
cross-cutting policies.
@@ -123,7 +125,7 @@ Run a proof of concept with representative authentication,
routing, failure, and
That model can be useful when deployment control, open governance, or
extensibility is important. It also means the operating team remains
responsible for designing and running a reliable deployment unless it purchases
an appropriate managed service or support offering.
-Before selecting it, validate the plugins, deployment mode, configuration
workflow, performance profile, and operational model against your own
requirements. For a product-focused comparison, see the [open-source API
gateway comparison](/learning-center/open-source-api-gateway-comparison/). To
distinguish gateway functions from broader lifecycle tooling, see [API gateway
vs API management](/learning-center/api-gateway-vs-api-management/).
+Before selecting it, validate the plugins, deployment mode, configuration
workflow, performance profile, and operational model against your own
requirements. To distinguish gateway functions from broader lifecycle tooling,
see [API gateway vs API
management](/learning-center/api-gateway-vs-api-management/).
## Frequently Asked Questions
diff --git a/next/src/components/HomePage.astro
b/next/src/components/HomePage.astro
index 3fb7ca979c5..415c2884977 100644
--- a/next/src/components/HomePage.astro
+++ b/next/src/components/HomePage.astro
@@ -8,7 +8,7 @@ const { locale } = Astro.props;
const p = localePrefix(locale);
const STATS = [
- ['100+', t(locale, 'plugins', '插件')],
+ ['100+', t(locale, 'open-source plugins', '开源插件')],
['~18k', t(locale, 'QPS / core', '单核 QPS')],
['0.2 ms', t(locale, 'added latency', '额外延迟')],
['Apache 2.0', t(locale, 'licensed', '开源协议')],
@@ -16,7 +16,12 @@ const STATS = [
const QUICK_CARDS = [
{ title: t(locale, 'Get started', '快速开始'), body: t(locale, 'Install APISIX
and configure your first route in minutes.', '几分钟内安装 APISIX 并配置你的第一条路由。'),
link: t(locale, 'Read the docs →', '阅读文档 →'), href:
`${p}/docs/apisix/getting-started/README/` },
- { title: t(locale, 'Learn the concepts', '学习核心概念'), body: t(locale, 'API
gateway, AI gateway, rate limiting, mTLS, Kubernetes and more.', 'API 网关、AI
网关、限流限速、mTLS、Kubernetes 等。'), link: t(locale, 'Explore the learning center →',
'进入学习中心 →'), href: `${p}/learning-center/` },
+ {
+ title: t(locale, 'Understand API gateways', '学习核心概念'),
+ body: t(locale, 'Learn how an API gateway routes, secures, and observes
traffic, and where Apache APISIX fits.', 'API 网关、AI 网关、限流限速、mTLS、Kubernetes
等。'),
+ link: t(locale, 'Read the API gateway guide →', '进入学习中心 →'),
+ href: locale === 'zh' ? '/zh/learning-center/' :
'/learning-center/what-is-an-api-gateway/',
+ },
{ title: t(locale, 'Case studies', '用户案例'), body: t(locale, 'See how teams
run Apache APISIX in production at scale.', '看看各团队如何在生产环境大规模运行 Apache
APISIX。'), link: t(locale, 'Read case studies →', '阅读用户案例 →'), href:
`${p}/blog/` },
];
@@ -28,7 +33,7 @@ const AI_CARDS: [string, string, string][] = [
['Retry & fallback', 'Fail over to a backup model or provider automatically
when one is unavailable.', '/docs/apisix/plugins/ai-proxy-multi/'],
['Token rate limiting', 'Cap usage and cost with token-based rate limits per
consumer.', '/docs/apisix/plugins/ai-rate-limiting/'],
['Prompt security', 'Guardrails, content moderation, and prompt decoration
before requests reach the model.', '/docs/apisix/plugins/ai-prompt-guard/'],
- ['MCP support', 'Expose and govern Model Context Protocol tools through the
gateway.', '/ai-gateway/'],
+ ['Prompt transformation', 'Apply predefined prompt templates before requests
reach the configured LLM provider.',
'/docs/apisix/plugins/ai-prompt-template/'],
];
// name, brand icon/logo under /img/integrations/ (null = text-only chip), and
@@ -93,8 +98,8 @@ const PILLARS = [
kicker: t(locale, 'Multi-platform and protocol', '多平台、多协议'),
title: t(locale, 'Create once, run anywhere', '一次创建，随处运行'),
body: t(locale,
- "Platform agnostic, no vendor lock-in. Apache APISIX as API Management
solution, can run from bare-metal to Kubernetes. It supports HTTP to gRPC
transcoding, websockets, gRPC, Dubbo, MQTT proxy and multiple platforms
including ARM64, don't worry about the lock-in of the infra technology.",
- 'Apache APISIX 提供了多平台解决方案，它不但支持在裸机运行，也支持在 Kubernetes 中使用。它支持 HTTP 到 gRPC
的转换、WebSockets、gRPC、Dubbo、MQTT 代理和包括 ARM64 在内的多个平台，无需担心供应商对基础设施技术的锁定。'),
+ 'Apache APISIX can run on bare metal or Kubernetes, giving teams
deployment flexibility across infrastructure environments. It supports
HTTP-to-gRPC transcoding, WebSocket, gRPC, Dubbo, MQTT proxy, and ARM64.',
+ 'Apache APISIX 可运行于裸机和 Kubernetes，为团队在不同基础设施环境中部署网关提供灵活性。它支持 HTTP 到 gRPC
转换、WebSocket、gRPC、Dubbo、MQTT 代理和 ARM64。'),
},
];
@@ -208,16 +213,28 @@ const SOFTWARE_APPLICATION_SCHEMA = {
<div class="container">
<h2>{t(locale, 'Building for large-scale, high value systems',
'适用于超大规模、复杂的业务系统')}</h2>
<p class="sub">{t(locale,
- 'Apache APISIX provides open source API Gateway to help you manage
microservices, delivering the ultimate performance, security, and scalable
platform for all your APIs and microservices.',
- 'Apache APISIX 作为云原生架构的开源 API 网关，可以为海量 API
和微服务提供安全可靠的动态、高性能、可扩展的管理平台。')}</p>
+ 'Apache APISIX is an open-source API gateway for routing, securing,
and managing traffic to APIs and microservices at scale.',
+ 'Apache APISIX 是云原生开源 API 网关，可用于大规模 API 和微服务流量的路由、安全与流量管理。')}</p>
<div class="why-block">
<p class="badge solid">{t(locale, 'Why APISIX API Gateway?', '为什么选择
APISIX API 网关？')}</p>
<h3 class="feature-headline">{t(locale,
'Reduce time fighting bugs, focus on designing world-class systems
with API Gateway',
'Apache APISIX 值得信赖，你只需专注在具体业务中，而无需考虑 API 处理基础组件。')}</h3>
<p class="feature-lead">{t(locale,
- 'APISIX API Gateway offers 100+ open-source plugins, comprehensive
API management capabilities, and advanced technical advantages.',
- 'APISIX API 网关提供 100+ 开源插件、全面的 API 管理能力和先进的技术优势。')}</p>
+ 'Apache APISIX provides 100+ open-source plugins and gateway-level
capabilities for traffic management, security, observability, and protocol
handling.',
+ 'Apache APISIX 提供 100+ 开源插件，以及面向流量管理、安全、可观测性和协议处理的网关能力。')}</p>
+ <p>
+ {t(locale, 'Evaluating open-source options?', '正在评估开源方案？')}
+ {' '}
+ <a
+ class="cta-link"
+ href={locale === 'zh' ? '/zh/comparisons/' :
'/learning-center/open-source-api-gateway-comparison/'}
+ >
+ {t(locale,
+ 'Compare API gateway architectures, extensibility, Kubernetes
support, and operations →',
+ '查看 API 网关对比与选型内容 →')}
+ </a>
+ </p>
</div>
</div>
</section>
diff --git a/next/tests/e2e/main-pages.spec.mjs
b/next/tests/e2e/main-pages.spec.mjs
index f8660af09bd..0b2f94071ed 100644
--- a/next/tests/e2e/main-pages.spec.mjs
+++ b/next/tests/e2e/main-pages.spec.mjs
@@ -45,6 +45,54 @@ async function expectSocialImage(page) {
await
expect(page.locator('meta[name="twitter:card"]')).toHaveAttribute('content',
'summary_large_image');
}
+test('homepage keeps positioning and distinct search-intent paths', async ({
page }) => {
+ await page.goto('/');
+
+ await expect(page).toHaveTitle('Apache APISIX - Open Source API Gateway & AI
Gateway');
+ await expect(page.locator('meta[name="description"]')).toHaveAttribute(
+ 'content',
+ 'Apache APISIX is a dynamic, high-performance, open-source API gateway and
AI gateway. Features include load balancing, authentication, rate limiting, AI
proxying, LLM load balancing, and 100+ plugins.',
+ );
+ await expect(page.getByRole('heading', {
+ level: 1,
+ name: 'The open-source API Gateway & AI Gateway',
+ })).toBeVisible();
+ await expect(page.locator('link[rel="canonical"]'))
+ .toHaveAttribute('href', 'https://apisix.apache.org/');
+ await expect(page.locator('link[rel="alternate"][hreflang="en"]'))
+ .toHaveAttribute('href', 'https://apisix.apache.org/');
+ await expect(page.locator('link[rel="alternate"][hreflang="zh"]'))
+ .toHaveAttribute('href', 'https://apisix.apache.org/zh/');
+ await expect(page.locator('link[rel="alternate"][hreflang="x-default"]'))
+ .toHaveAttribute('href', 'https://apisix.apache.org/');
+
+ await expect(page.locator('.stat')).toHaveCount(4);
+ await expect(page.locator('.stat').nth(0)).toContainText('100+');
+ await expect(page.locator('.stat').nth(0)).toContainText('open-source
plugins');
+ await expect(page.locator('.stat').nth(1)).toContainText('~18k');
+ await expect(page.locator('.stat').nth(1)).toContainText('QPS / core');
+ await expect(page.locator('.stat').nth(2)).toContainText('0.2 ms');
+ await expect(page.locator('.stat').nth(2)).toContainText('added latency');
+ await expect(page.locator('.stat').nth(3)).toContainText('Apache 2.0');
+ await expect(page.locator('.stat').nth(3)).toContainText('licensed');
+
+ await expect(page.locator('main').getByText(/MCP/i)).toHaveCount(0);
+ await expect(page.getByText('~18k', { exact: true })).toBeVisible();
+ await expect(page.getByText('0.2 ms', { exact: true })).toBeVisible();
+ await expect(page.getByRole('link', { name: 'Prompt transformation' }))
+ .toHaveAttribute('href', '/docs/apisix/plugins/ai-prompt-template/');
+ await expect(page.getByRole('link', { name: /Understand API gateways/ }))
+ .toHaveAttribute('href', '/learning-center/what-is-an-api-gateway/');
+ await expect(page.getByRole('link', { name: /Compare API gateway
architectures/ }))
+ .toHaveAttribute('href',
'/learning-center/open-source-api-gateway-comparison/');
+ await expect(page.getByText(
+ 'Apache APISIX is an open-source API gateway for routing, securing, and
managing traffic to APIs and microservices at scale.',
+ { exact: true },
+ )).toBeVisible();
+ await expect(page.getByText(/scalable platform for all your
APIs/i)).toHaveCount(0);
+ await expectNoPageOverflow(page);
+});
+
test('AI Gateway has complete responsive content and valid footer links',
async ({ page }, testInfo) => {
await page.goto('/ai-gateway/');
@@ -117,6 +165,32 @@ test('Downloads exposes release artifacts, signatures, and
checksums', async ({
});
test('Chinese routes keep localized primary content', async ({ page }) => {
+ await page.goto('/zh/');
+ await expect(page).toHaveTitle('Apache APISIX - 开源 API 网关与 AI 网关');
+ await expect(page.locator('meta[name="description"]')).toHaveAttribute(
+ 'content',
+ 'Apache APISIX 是一个动态、高性能的开源 API 网关和 AI 网关，提供负载均衡、身份认证、限流限速、AI 代理、LLM
负载均衡等能力和 100+ 插件。',
+ );
+ await expect(page.getByRole('heading', { level: 1, name: '开源 API 网关与 AI 网关'
}))
+ .toBeVisible();
+ await expect(page.locator('link[rel="canonical"]'))
+ .toHaveAttribute('href', 'https://apisix.apache.org/zh/');
+ await expect(page.locator('link[rel="alternate"][hreflang="en"]'))
+ .toHaveAttribute('href', 'https://apisix.apache.org/');
+ await expect(page.locator('link[rel="alternate"][hreflang="zh"]'))
+ .toHaveAttribute('href', 'https://apisix.apache.org/zh/');
+ await expect(page.getByRole('link', { name: /学习核心概念/ }))
+ .toHaveAttribute('href', '/zh/learning-center/');
+ await expect(page.getByRole('link', { name: /查看 API 网关对比与选型内容/ }))
+ .toHaveAttribute('href', '/zh/comparisons/');
+ await expect(page.getByText(
+ 'Apache APISIX 是云原生开源 API 网关，可用于大规模 API 和微服务流量的路由、安全与流量管理。',
+ { exact: true },
+ )).toBeVisible();
+ await expect(page.getByText(/可扩展的管理平台/)).toHaveCount(0);
+ await expect(page.locator('main').getByText(/MCP/i)).toHaveCount(0);
+ await expectNoPageOverflow(page);
+
await page.goto('/zh/ai-gateway/');
await expect(page.getByRole('heading', { level: 1, name: '面向 LLM 与 AI Agent
的开源 AI 网关' }))
.toBeVisible();
diff --git a/website/learning-center/open-source-api-gateway-comparison.md
b/website/learning-center/open-source-api-gateway-comparison.md
index 86e75bf7f06..8314a1d19c8 100644
--- a/website/learning-center/open-source-api-gateway-comparison.md
+++ b/website/learning-center/open-source-api-gateway-comparison.md
@@ -20,7 +20,7 @@ faq:
There is no universal winner. Compare the maintained controller or
integration for each project, its Gateway API conformance, supported policies
and custom resources, upgrade lifecycle, and the operational model required by
your platform.
---
-This open-source [API gateway
comparison](/learning-center/what-is-an-api-gateway/) evaluates Apache APISIX,
Kong, Envoy, and Traefik across architecture, extensibility, Kubernetes
integration, and day-two operations. Each project can route and protect service
traffic, but its control plane, extension model, and deployment assumptions
create different tradeoffs for platform teams.
+This guide compares Apache APISIX, Kong, Envoy, and Traefik across
architecture, extensibility, Kubernetes integration, and day-two operations.
The best open-source API gateway depends on your deployment model, extension
requirements, and operational constraints. If you are new to the category,
start with [how an API gateway works](/learning-center/what-is-an-api-gateway/).
## Why the Choice of API Gateway Matters
@@ -47,7 +47,7 @@ Note: Feature details change across releases and editions.
Verify required capab
### Apache APISIX
-Apache APISIX is built on NGINX and LuaJIT. Its traditional mode uses etcd to
distribute route and plugin configuration dynamically, while standalone mode
loads declarative configuration from a local file.
+[Apache APISIX](/) is built on NGINX and LuaJIT. Its traditional mode uses
etcd to distribute route and plugin configuration dynamically, while standalone
mode loads declarative configuration from a local file.
The [plugin ecosystem](/plugins/) spans authentication (JWT, key-auth, OpenID
Connect), traffic management (rate limiting, circuit breaking), observability
(Prometheus, Zipkin, OpenTelemetry), and transformation (request/response
rewriting, gRPC transcoding). APISIX also supports several external plugin
runners and WebAssembly extensions in addition to native Lua plugins.
