Apache APISIX 路由配置入门指南

邬祺芯Juliet

于 2025-06-02 09:16:04 发布

阅读量284

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00280/article/details/148377513

Apache APISIX 路由配置入门指南

apisix Apisix是一个基于Nginx的API网关，主要用于微服务架构中的API管理和服务发现。它的特点是高性能、轻量级、易于配置等。适用于API管理和负载均衡场景。项目地址: https://gitcode.com/gh_mirrors/api/apisix

什么是路由

在 Apache APISIX 网关系统中，路由(Route)是连接客户端请求和后端服务的关键桥梁。路由定义了请求应该如何被匹配、处理和转发。简单来说，它告诉网关："当收到符合特定条件的请求时，应该将其发送到哪个后端服务"。

路由的核心功能包括：

请求匹配：根据URI、主机头、HTTP方法等条件匹配请求
插件执行：在请求转发前后执行各种插件功能（如认证、限流等）
流量转发：将请求代理到指定的上游服务

上游服务(Upstream)概念

上游服务(Upstream)是指一组提供相同功能的后端服务节点。在APISIX中，上游服务配置包括：

服务节点列表：可以是一个或多个后端服务器
负载均衡策略：如轮询(roundrobin)、一致性哈希(chash)等
健康检查机制：自动检测节点可用性

准备工作

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

已完成APISIX的安装并正常运行
管理API(默认端口9180)可访问
准备好测试工具如curl

创建第一个路由

下面我们创建一个简单的路由，将所有发送到/ip路径的请求转发到httpbin.org服务：

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: 负载均衡类型(这里是轮询)
- nodes: 后端节点列表(这里只有一个节点)

成功创建后会收到HTTP/1.1 201 Created响应。

测试路由配置

使用curl测试新创建的路由：

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

预期会看到类似以下响应，显示你的公网IP地址：

{
  "origin": "183.94.122.205"
}

这表示APISIX成功将请求转发到了httpbin.org服务。

路由匹配规则详解

除了简单的URI路径匹配外，APISIX路由还支持更复杂的匹配条件：

主机名匹配：可以指定特定的域名
```
"host": "example.com"
```
HTTP方法匹配：限制特定的请求方法
```
"methods": ["GET", "POST"]
```
优先级设置：当多个路由匹配时决定优先级
```
"priority": 10
```
高级URI匹配：支持正则表达式匹配
```
"uris": ["/user/*", "/order/[0-9]+"]
```

进阶学习方向

掌握了基本路由配置后，你可以进一步学习：

多节点负载均衡：配置多个后端节点并设置不同权重
流量分割：将不同比例的流量分配到不同服务版本
插件系统：在路由上添加认证、限流等插件
服务发现：集成Consul、Nacos等服务发现组件

路由是APISIX最核心的功能之一，灵活运用路由配置可以实现复杂的流量管理策略，为微服务架构提供强大的网关支持。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考