如何为Wildfly反向代理设置基于客户端或请求头的条件规则

要实现非路径规则（如请求头、客户端信息）的反向代理条件控制，可借助Wildfly内置的Undertow谓词（Predicate）机制，通过条件判断决定是否触发反向代理，否则直接交由本地REST接口处理。以下是具体配置方案：

核心思路 #

Wildfly的Undertow子系统支持通过predicate属性或predicate-handler对请求进行条件匹配，只有当条件满足时才执行指定的反向代理handler；不满足条件时，请求会默认路由到本地托管的REST接口。

常见场景配置示例 #

1. 基于请求头参数跳过代理 #

当请求头存在X-Skip-Proxy且值为true时，直接走本地接口，否则触发反向代理：

<host name="default-host" alias="localhost">
   <location name="/greet" handler="my-handler" predicate="not(header('X-Skip-Proxy') = 'true')"/>
</host>

• 谓词解释：not(header('X-Skip-Proxy') = 'true')表示仅当请求头不满足该条件时，才执行反向代理handler。

2. 基于客户端IP跳过代理 #

允许特定网段（如192.168.1.0/24）的请求走本地，其他请求走代理：

<host name="default-host" alias="localhost">
   <location name="/greet" handler="my-handler" predicate="not(remote-ip('192.168.1.0/24'))"/>
</host>

• 谓词解释：remote-ip('192.168.1.0/24')匹配客户端IP在目标网段，not()取反后表示非该网段请求才触发代理。

3. 组合多条件判断 #

同时判断请求头和客户端IP，仅当两个条件都不满足时才触发代理：

<host name="default-host" alias="localhost">
   <location name="/greet" handler="my-handler" predicate="not(header('X-Skip-Proxy') = 'true') and not(remote-ip('192.168.1.0/24'))"/>
</host>

4. 复杂逻辑：使用handler-chain #

如果需要更灵活的逻辑（比如多handler分支），可以用handler-chain配置，明确指定不同条件对应的处理逻辑：

<host name="default-host" alias="localhost">
   <location name="/greet">
      <handler-chain>
         <!-- 满足条件时执行反向代理 -->
         <predicate-handler predicate="not(header('X-Skip-Proxy') = 'true')">
            <handler name="my-handler"/>
         </predicate-handler>
         <!-- 不满足条件时，使用默认handler处理本地REST接口 -->
         <handler name="default"/>
      </handler-chain>
   </location>
</host>

• 注：default是Wildfly默认的本地web请求处理handler，确保本地REST接口能正常响应。

配置生效方式 #

修改standalone.xml后，可通过以下方式让配置生效：

• 重启Wildfly服务器；
• 使用Wildfly CLI执行重载命令：

/subsystem=undertow:reload()

内容的提问来源于stack exchange，提问作者Andy0709