跳到主要内容

配置路由

Apache APISIX 基于路由提供灵活的网关管理能力，其中定义了路由路径和目标上游。

路由 是通往上游目标的路由路径。在 Apache APISIX 中，路由负责根据定义的规则匹配客户端请求，加载并执行相应的插件，以及将请求转发到指定的上游服务。一个简单的路由可以使用路径匹配 URI 和相应的上游地址来设置。

上游 是一组具有相同工作的目标节点。它定义了一个虚拟主机抽象，根据配置的规则对给定的一组服务节点执行负载均衡。

本教程指导你如何创建路由并对其进行验证。你将：

  1. 创建一个路由和一个指向 httpbin 服务的示例上游。
  2. 向路由发送请求，查看 APISIX 如何代理请求。

前置条件​

  1. 完成 安装 APISIX 以在 Docker 或 Kubernetes 中安装 APISIX。
  2. 如果使用这些工具，请安装 ADC 或 APISIX-MCP。

创建路由​

在本节中，你将创建一个路由，将客户端请求转发到 httpbin，这是一个 HTTP 请求和响应服务。

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
    }
  }
}'

如果路由创建成功，你将收到 HTTP/1.1 201 Created 响应。

验证​

向路由发送请求：

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

你应该看到类似的响应：

{
  "origin": "183.94.122.205"
}

下一步​

本教程创建了一个指向单个上游节点的路由。在下一个教程中，你将学习如何配置多上游节点的负载均衡。