Stream 代理

众多的闻名的应用和服务，像 LDAP、 MYSQL 和 RTMP ，选择 TCP 作为通信协议。 但是像 DNS、 syslog 和 RADIUS 这类非事务性的应用，他们选择了 UDP协议。

APISIX 可以对 TCP/UDP 协议进行代理并实现动态负载均衡。 在 nginx 世界，称 TCP/UDP 代理为 stream 代理，在 APISIX 这里我们也遵循了这个声明.

如何开启 Stream 代理?

在 conf/config.yaml 配置文件设置 stream_proxy 选项， 指定一组需要进行动态代理的IP地址。默认情况不开启stream代理。

  1. apisix:
  2.   stream_proxy:                 # TCP/UDP proxy
  3.     tcp:                        # TCP proxy address list
  4.       - 9100
  5.       - 127.0.0.1:9101
  6.     udp:                        # UDP proxy address list
  7.       - 9200
  8.       - 127.0.0.1:9211

如何设置 route ?

简例如下:

  1. curl http://127.0.0.1:9080/apisix/admin/stream_routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3.     "remote_addr": "127.0.0.1",
  4.     "upstream": {
  5.         "nodes": {
  6.             "127.0.0.1:1995": 1
  7.         },
  8.         "type": "roundrobin"
  9.     }
  10. }'

例子中 APISIX 对客户端IP为 127.0.0.1 的请求代理转发到上游主机 127.0.0.1:1995。 更多用例，请参照 test case.

更多限制选项

我们可以添加更多的选项来匹配 route ，例如

  1. curl http://127.0.0.1:9080/apisix/admin/stream_routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3.     "server_addr": "127.0.0.1",
  4.     "server_port": 2000,
  5.     "upstream": {
  6.         "nodes": {
  7.             "127.0.0.1:1995": 1
  8.         },
  9.         "type": "roundrobin"
  10.     }
  11. }'

例子中 APISIX 把上游地址 127.0.0.1:1995 代理成地址为 127.0.0.1, 端口为 2000