conf_remap Plugin¶

The conf_remap plugin allows you to override configuration directives dependent on actual remapping rules. The plugin is built and installed as part of the normal Apache Traffic Server installation process.

The conf_remap plugin accepts configuration directives in the arguments list or in a separate configuration file. In both cases, only string and integer directives are supported.

When using a separate configuration file, the standard records.config syntax is used, for example:

map http://cdn.example.com/ http://some-server.example.com \
  @plugin=conf_remap.so @pparam=/etc/trafficserver/cdn.conf

where cdn.conf contains:

CONFIG proxy.config.url_remap.pristine_host_hdr INT 1

When using inline arguments, the conf_remap plugin accepts a key=value syntax, where the KEY is the name of the configuration directive and VALUE is the desired value, for example:

map http://cdn.example.com/ http://some-server.example.com \
  @plugin=conf_remap.so @pparam=proxy.config.url_remap.pristine_host_hdr=1

Doing this, you will override your global default configuration on a per mapping rule. For more details on the APIs, functionality, and a complete list of all overridable configurations, see TSHttpOverridableConfig.