Apache APISIX 路由配置完全指南：从入门到实践

农鸽望

于 2025-06-03 09:00:35 发布

阅读量268

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00117/article/details/148391539

Apache APISIX 路由配置完全指南：从入门到实践

apisix The Cloud-Native API Gateway 项目地址: https://gitcode.com/gh_mirrors/ap/apisix

前言

在现代微服务架构中，API网关扮演着至关重要的角色。作为Apache APISIX的核心功能之一，路由配置是每个开发者必须掌握的基础知识。本文将深入浅出地介绍如何在Apache APISIX中配置路由，帮助您快速上手这一强大的API网关工具。

路由基础概念

什么是路由？

在Apache APISIX中，路由(Route)是请求转发的基础单元。它定义了如何将客户端请求匹配到特定的后端服务(Upstream)。一个路由通常包含以下关键元素：

URI匹配规则：定义哪些请求路径会被该路由捕获
上游服务(Upstream)：指定请求将被转发到的后端服务
插件配置：可选的中间件处理逻辑

什么是上游(Upstream)？

上游是Apache APISIX中的一个重要抽象概念，它代表了一组提供相同服务的后端节点。上游配置允许您：

定义多个后端节点
配置负载均衡策略
设置健康检查机制
管理节点权重

环境准备

在开始配置路由前，请确保您已经：

成功安装Apache APISIX
确保APISIX服务已启动
准备好访问Admin API的权限

创建第一个路由

让我们从一个简单的示例开始，创建一个将请求转发到httpbin.org的路由。

基本路由配置

使用以下命令创建一个路由，将所有发送到/ip路径的请求转发到httpbin.org的/ip端点：

curl -i "http://127.0.0.1:9180/apisix/admin/routes" -X PUT -d '
{
  "id": "getting-started-ip",
  "uri": "/ip",
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "httpbin.org:80": 1
    }
  }
}'

参数解析

id：路由的唯一标识符
uri：匹配的请求路径
upstream：上游配置
- type：负载均衡类型，这里使用轮询(roundrobin)
- nodes：后端节点列表，格式为"地址:端口": 权重

如果配置成功，您将收到HTTP/1.1 201 Created的响应。

验证路由

创建路由后，我们可以通过发送测试请求来验证其是否正常工作：

curl "http://127.0.0.1:9080/ip"

预期会收到类似以下的响应，显示您的客户端IP地址：

{
  "origin": "183.94.122.205"
}

进阶路由配置

多节点上游配置

在实际生产环境中，我们通常需要配置多个后端节点：

curl -i "http://127.0.0.1:9180/apisix/admin/routes" -X PUT -d '
{
  "id": "multi-node-route",
  "uri": "/api",
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "backend1.example.com:80": 1,
      "backend2.example.com:80": 2,
      "backend3.example.com:80": 1
    }
  }
}'

在这个例子中，我们配置了三个后端节点，并为它们分配了不同的权重。

使用主机头路由

Apache APISIX支持基于主机头的路由匹配：

curl -i "http://127.0.0.1:9180/apisix/admin/routes" -X PUT -d '
{
  "id": "host-based-route",
  "uri": "/*",
  "host": "api.example.com",
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "backend.example.com:80": 1
    }
  }
}'

方法匹配路由

您还可以限制路由只匹配特定的HTTP方法：

curl -i "http://127.0.0.1:9180/apisix/admin/routes" -X PUT -d '
{
  "id": "method-specific-route",
  "uri": "/secure",
  "methods": ["POST", "PUT"],
  "upstream": {
    "type": "roundrobin",
    "nodes": {
      "secure-backend.example.com:80": 1
    }
  }
}'