← 返回

EdgeLang 教程：如何在 OpenResty Edge 中编写网关与 WAF 规则

章亦春发布于 Apr 19, 2023 更新于 Aug 26, 2026

用时 6 分钟

阅读次数

本 EdgeLang 教程演示如何在 OpenResty Edge 中使用其基于规则的小语言 EdgeLang 编写网关规则。每条 EdgeLang 规则由一个条件和一个结果（一组动作）组成，二者用箭头（=>）连接，并以分号结束——例如把 /foo/ 的请求重定向到 /bar/。下面我们添加一条页面规则重定向、用 curl 测试、把它从精确匹配改为前缀匹配，再编写一条 WAF 规则——所有改动都无需重载、重启或二进制升级即可推送到每台网关。初次接触 EdgeLang？请先了解 EdgeLang 是什么、为何优于手写 Lua。

EdgeLang 如何编译规则以提升性能

用户可以使用 Edgelang 来编写复杂的网关规则，用于自定义认证、重写请求和响应、配置动态上游路由等等。这些规则的运行速度通常要比手写的 Lua 代码快很多。Edgelang 编译器会生成高效的原生代码，在网关服务器上运行。

Edgelang 编译器是非常高效的。它实现了许多先进的优化技术。它支持将所有 Edgelang 规则所引用的正则表达式合并到一个状态机中。这样只需扫描一次请求数据，就会立即知道能匹配上哪些规则以及这些规则的哪些部分。

它还支持把所有 Edgelang 规则的常量字符串前缀和后缀模式组合成单一的树状数据结构。

如何编写 EdgeLang 页面规则（URL 重定向示例）

让我们进入 OpenResty Edge 的 Admin Web 控制台。这就是我们控制台的样本部署。每个用户都有自己的本地部署。

我们可以继续使用之前的示例应用，test-edge.com。

进入该应用。

在之前的教程中我们已经创建了一个页面规则。

这个页面规则设置了一个反向代理到一个上游。

可以在这里添加我们的 Edgelang 代码。

现在来添加第一条规则。

首先是规则的条件部分。条件是当 URI 是 “/foo/” 时。

用箭头来标志条件部分的结束。

箭头之后，我们指定当条件得到满足时要执行的动作。

这个动作启动了一个 HTTP 重定向到 “/bar/” 页面。

保存这个规则。

正如我们看到的那样，一段 EdgeLang 配置由若干条规则组成。每条规则都有两个基本部分：

一个是条件部分，

另外一个是由动作组成的结果。

条件和结果由一个箭头连接。

整个规则以一个分号结束。

这只是一个最简单的规则。我们可以随意添加各种规则。一条规则可以有多个条件，各个条件之间可以用 AND 或者 OR 连接。一条规则在其结果部分也可以执行多个动作。

像往常一样，需要发布一个新的版本来推送我们刚才的改动。

点击这个按钮。

发布！

新版本现在已经同步到所有的网关服务器上了。

现在，新的页面规则已经被推送到所有的网关集群和服务器。

这些配置的变化不需要服务器重载、重启或二进制升级。所以它是非常高效和可扩展的。

用 curl 测试 EdgeLang 规则

在终端上，我们通过 curl 命令行工具向一个由 DNS 解析的网关服务器发送 HTTP 请求。

curl -I http://test-edge.com/bar/

请注意响应头没有重定向。

接下来，让我们发送一个带有 /foo/ URI 的 HTTP 请求。

curl -I http://test-edge.com/foo/

可以看到这个请求已经被重定向了。

它被重定向到 /bar/ 这个位置。刚才定义的 Edgelang 规则生效了！

让我们测试另一个前缀为 “/foo/” 的 URI。

这个 URI 有一个额外的后缀，“blah/"。

发送请求。

可以看到这个请求并没有命中 Edgelang 规则。这是因为我们的 Edgelang 条件需要完全匹配 “/foo/"。

修改 EdgeLang 规则：精确匹配 vs. 前缀匹配

我们可以修改 Edgelang 规则中的条件部分来处理这种情况。

单击 “编辑” 按钮。

删除原来的条件。

将其改为匹配 URI 前缀 “/foo/"。

保存这个规则。

再做一次新配置的发布。

回到终端。再次发送我们之前的测试请求。

仍然采用 “blah/” URI 的后缀。

发送请求。

可以看到它触发了一个重定向，这次是命中了我们的 Edgelang 规则。

接下来，让我们发送一个没有任何额外 URI 后缀的 HTTP 请求。

curl -I http://test-edge.com/foo/

仍然能够命中。

如何用 EdgeLang 编写 WAF 规则

我们可以在 Web 控制台的许多不同地方使用 Edgelang。例如，可以用 EdgeLang 为 WAF，或 Web 应用防火墙添加自定义规则。如需深入了解可编程 WAF 本身——包括如何启用、测试和拦截攻击，以及它对比 ModSecurity 的性能基准——请参阅这些专门的教程。

创建一个新的 WAF 规则。

在这里写入 Edgelang。

EdgeLang 用户手册与更多示例

我们自主设计的 EdgeLang 网关小语言是一种非常强大的语言，有很多特性。语言支持调用自定义 Lua 模块和 Lua 代码，或者任意 .so 动态链接库——参见在 EdgeLang 中调用 Lua 模块的实操示例。其编译器支持跨规则深度优化。

如需了解更多，欢迎阅读 Edgelang 用户手册。英文版更完整更新一些。

手册里有许多代码实例。

非常详细地介绍了 Edgelang 的各种用法。

常见问题

如何编写一条 EdgeLang 规则？

一段 EdgeLang 配置由若干条规则组成。每条规则有两个部分——一个条件和一个结果（一组动作）——用箭头（=>）连接，并以分号结束。一条规则可以用 AND/OR 组合多个条件，其结果部分也可以执行多个动作。例如，一条条件匹配 URI /foo/ 的规则，可以触发一个把请求重定向到 /bar/ 的动作。

修改 EdgeLang 规则后需要重载或重启网关吗？

不需要。编辑 EdgeLang 规则后，你发布一个新的配置版本，它会同步到所有网关服务器和集群。这些改动不需要任何服务器重载、重启或二进制升级，因此推送新规则非常高效且可扩展。

EdgeLang 能定义 WAF 规则吗？

可以。除了页面规则，EdgeLang 还能用在 Web 控制台的许多地方，包括为 Web 应用防火墙（WAF）编写自定义规则。你直接在 WAF 规则编辑器中写 EdgeLang，使用同样的条件与动作语法。

EdgeLang 中精确匹配和前缀匹配有什么区别？

对 /foo/ 的精确匹配条件只在 URI 恰好是 /foo/ 时命中，因此对 /foo/blah/ 的请求不会命中。如果你希望规则也覆盖子路径，就把条件改为匹配 URI 前缀 /foo/；这样 /foo/ 和 /foo/blah/ 都会触发规则。

关于 OpenResty Edge

OpenResty Edge 是一款专为微服务和分布式流量架构设计的全能型网关软件，由我们自主研发。它集流量管理、私有 CDN 构建、API 网关、安全防护等功能于一体，帮助您轻松构建、管理和保护现代应用程序。OpenResty Edge 拥有业界领先的性能和可扩展性，能够满足高并发、高负载场景下的苛刻需求。它支持调度 K8s 等容器应用流量，并可管理海量域名，轻松满足大型网站和复杂应用的需求。

申请试用 OpenResty Edge

如果你喜欢这个教程，请订阅这个博客网站和我们的 YouTube 频道或 B 站频道。谢谢！

关于作者

章亦春是开源 OpenResty^® 项目创始人兼 OpenResty Inc. 公司 CEO 和创始人。

章亦春（Github ID: agentzh），生于中国江苏，现定居美国湾区。他是中国早期开源技术和文化的倡导者和领军人物，曾供职于多家国际知名的高科技企业，如 Cloudflare、雅虎、阿里巴巴, 是 “边缘计算“、”动态追踪 “和 “机器编程 “的先驱，拥有超过 22 年的编程及 16 年的开源经验。作为拥有超过 4000 万全球域名用户的开源项目的领导者。他基于其 OpenResty^® 开源项目打造的高科技企业 OpenResty Inc. 位于美国硅谷中心。其主打的两个产品 OpenResty XRay（利用动态追踪技术的非侵入式的故障剖析和排除工具）和 OpenResty Edge（最适合微服务和分布式流量的全能型网关软件），广受全球众多上市及大型企业青睐。在 OpenResty 以外，章亦春为多个开源项目贡献了累计超过百万行代码，其中包括，Linux 内核、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl 等，并编写过 60 多个开源软件库。