跳到主要内容
版本:3.2.16.4.1

代理 TCP 流量

API7 网关可以单独处理传输层(四层)的 TCP 和 UDP 流量,也可以同时处理应用层(七层)流量。

本教程介绍如何在已发布服务中配置四层路由,代理客户端与 MySQL 服务器之间的四层流量。

前提条件​

  1. 安装 API7 企业版。
  2. 在你的网关组中至少有一个网关实例。
  3. 安装一个 MySQL 客户端以验证四层代理路由。

启动 MySQL 服务器​

如果你在 Docker 中安装了网关实例,并使用控制台或 ADC 进行配置,请在 API7 企业版的默认网络 api7-ee_api7 中启动 MySQL 服务器。

docker run -d \
--name mysql \
--network=api7-ee_api7 \
-p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=password \
mysql:8.4 \
mysqld --mysql-native-password=ON

启用传输层(四层)代理​

默认情况下,API7 网关(数据面)只启用应用层(七层)代理。要同时接收传输层(四层)流量,请按以下示例在 config.yaml 配置文件中配置 proxy_mode 和 stream_proxy。

docker exec {container_name} /bin/sh -c "echo '
apisix:
proxy_mode: http&stream
stream_proxy:
tcp:
- 2000
' > /usr/local/apisix/conf/config.yaml"

❶ proxy_mode 指定同时接收传输层(四层)和应用层(七层)流量。

❷ stream_proxy 用于配置传输层(四层)代理的接口。

重新加载 API7 网关,使配置更改生效。

docker exec {container_name} apisix reload

添加带有四层路由的服务​

  1. 从侧边栏选择网关组的已发布服务,然后点击新增服务。
  2. 选择手动新增。
  3. 在对话框中完成以下操作。
  • 在名称字段中输入 MySQL。
  • 在服务类型字段中选择 Stream(四层代理)。
  • 在上游 Scheme 字段中选择 TCP。
  • 在如何找到上游字段中选择 使用节点。
  • 点击新增节点。
  • 在新增节点对话框中完成以下操作。
    • 在主机字段中输入你的私有 IP 地址,例如 192.168.2.103。
    • 在端口字段中输入 3306。
    • 权重字段使用默认值 100。
    • 点击新增。这会创建一个处于「无版本」状态的服务。
  1. 在服务内点击新增四层路由。
  2. 在服务内点击新增四层路由。
  • 在名称字段中输入 stream-route-mysql。
  • 在服务器地址字段中输入 127.0.0.1。
  • 在服务器端口字段中输入 2000。
  • 点击新增。

验证四层路由​

如果你在 Docker 中安装了网关实例,并使用控制台或 ADC 进行配置,请先将服务器端口 2000 暴露到主机(-p2000:2000),然后再进行验证。

使用 MySQL 客户端通过 API7 网关连接 MySQL 服务器。使用前面配置的密码以 root 用户身份连接。

mysql --host=127.0.0.1 --port=2000 -u root -p

你应该会看到以下 MySQL 提示符。

Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 9
Server version: 8.4.0 MySQL Community Server - GPL

Copyright (c) 2000, 2024, Oracle and/or its affiliates.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

相关阅读​