sub_filter_once

sub_filter_once 指令在 NGINX 的 http、server 或 location 上下文中使用，用于决定由 sub_filter 指令执行的子字符串替换的行为。当设置为 on 时，替换只会应用于响应正文中被指定字符串的第一次出现。相反，如果设置为 off，sub_filter 会处理该子字符串的所有实例，并在编译输出中对它们进行修改。这在处理存在多个相同字符串且只需一次替换而不想修改每个实例的场景中特别有用——从而避免对响应上下文造成意外更改。

该指令接受布尔值（'on' 或 'off'）。默认情况下通常设置为 off，即允许进行多次替换，除非另行指定。要启用 sub_filter_once，需要在 NGINX 中启用 sub 模块，这是该指令正常工作的关键。另一个需要注意的点是，还必须配置 sub_filter 以明确标识要替换的特定子字符串，然后再根据 sub_filter_once 的设置应用单次或多次替换。