HAProxy 2.1后reqirep指令被弃用，如何改用http-request？

Question

在HAProxy 2.1版本之后，`reqirep`指令已被弃用，用户需要改用功能更强大且灵活的`http-request`指令来实现类似需求。例如，若需修改请求头或内容，可使用`http-request set-header`或`http-request replace-header`替代原先的`reqirep`功能。假设原配置中使用`reqirep ^Host\:\ .*\.example\.com Host:\ backend.example.com`将主机头替换为后端服务器地址，在新版本中可通过以下方式实现： ``` http-request replace-header Host (.*)\.example\.com backend.example.com ``` 此方法不仅保持了原有功能，还提供了更清晰的语义和更好的错误处理能力。需要注意的是，`http-request`指令只能用于frontend或listen部分，并且执行顺序会影响最终效果，因此合理安排规则顺序至关重要。

Answer 1

1. 了解HAProxy 2.1版本的变化

在HAProxy 2.1版本发布后，`reqirep`指令被正式弃用。这一变化意味着用户需要转向更灵活的`http-request`指令来实现类似的功能需求。对于熟悉旧版配置的用户来说，这可能是一个挑战，但新指令提供了更强的功能和更高的灵活性。

例如，原先通过`reqirep ^Host: .*.example.com Host: backend.example.com`修改主机头的方式，现在可以改用以下方式：

http-request replace-header Host (.*).example.com backend.example.com

这种新方法不仅保持了原有的功能，还带来了更清晰的语义表达和更好的错误处理能力。

2. `http-request`指令的基本使用

`http-request`指令是HAProxy 2.1及更高版本中用于处理HTTP请求的强大工具。它可以用来设置、替换或删除请求头，甚至可以根据条件执行复杂的逻辑操作。

• set-header: 设置一个请求头为指定值。
• replace-header: 替换请求头中的特定值。
• del-header: 删除某个请求头。

以替换主机头为例，以下是具体配置代码：

frontend http_front
    bind *:80
    http-request replace-header Host (.*).example.com backend.example.com
    default_backend servers

此配置明确指定了规则应用的位置（即frontend部分），并确保了主机头能够正确替换。

3. 配置顺序的重要性

在HAProxy中，`http-request`指令的执行顺序至关重要。如果多个规则存在冲突或依赖关系，则必须合理安排它们的顺序以避免意外行为。

例如，假设我们需要先检查用户的来源IP地址，再决定是否修改主机头，那么可以按照以下顺序编写：

步骤	指令
1	http-request deny if { src 192.168.1.1 }
2	http-request replace-header Host (.*).example.com backend.example.com

这样可以确保只有符合条件的请求才会继续执行后续规则。

4. 深入分析与最佳实践

除了基本的替换功能外，`http-request`还支持复杂的匹配模式和条件判断。例如，可以通过正则表达式精确控制哪些请求头需要被修改。

此外，为了保证配置的可维护性，建议遵循以下最佳实践：

1. 将所有相关的`http-request`规则集中写在同一个section中。
2. 使用注释清楚描述每个规则的作用和逻辑。
3. 定期测试配置文件，确保其符合预期行为。

下面是一个包含条件判断的复杂示例：

frontend http_front
    bind *:80
    acl is_example hdr_end(host) -i example.com
    http-request set-header X-Forwarded-Proto https if { ssl_fc }
    http-request replace-header Host (.*).example.com backend.example.com if is_example
    default_backend servers

此配置展示了如何结合ACL和条件判断来实现更精细的请求头管理。

5. 流程图：配置执行逻辑

为了更直观地理解`http-request`指令的执行流程，可以用流程图表示如下：

graph TD;
            A[客户端请求] --> B{是否匹配ACL};
            B -- 是 --> C[执行http-request规则];
            B -- 否 --> D[直接转发到后端];
            C --> E[返回修改后的请求];

通过这种方式，我们可以清晰地看到请求在前端处理阶段经历了哪些步骤。