http_client
Prev | Reference | Next

## Name

http_client — Metaproxy HTTP Client Module

## DESCRIPTION

This module implements HTTP client functionality. Filter frontend_net + http_client in combo - acts as a normal, non-transparent, proxy.

The element default-host of configuration specifies the default host in the remote URL. If this is set, frontend_net + http_client acts as a transparent HTTP proxy as well.

The configuration element, proxy, is optional and enables a remote HTTP proxy to be in use.

default-host

  Specifies host for transparent proxy mode.

max-redirects

  Maximum number of HTTP redirects. Default value is 0 (HTTP redirect disabled).

proxy

  Specifies HTTP proxy for outgoing connections.

x-forwarded-for

  Is a boolean value (false, true). If true, the peer IP address as seen in frontend_net will be added to x-forwarded HTTP header.

bind_host

  Is a boolean value (false, true). If true, the out going TCP connection will be bound to the same as listening IP.

## SCHEMA

# Metaproxy XML config file schemas
#
# Copyright (C) Index Data
# See the LICENSE file for details.
namespace mp = "http://indexdata.com/metaproxy"
filter_http_client =
attribute type { "http_client" },
attribute id { xsd:NCName }?,
attribute name { xsd:NCName }?,
element mp:default-host { xsd:string }?,
element mp:max-redirects { xsd:integer }?,
element mp:proxy { xsd:string }?,
element mp:x-forwarded-for { xsd:boolean }?,
element mp:bind_host { xsd:boolean }?

## EXAMPLES

A typical configuration looks like this:

       <filter type="http_client">
        <proxy>localhost:3128</proxy>
       </filter>

## SEE ALSO

metaproxy(1)

## COPYRIGHT

Copyright (C) 2005-2026 Index Data

Prev | Up | Next
frontend_net | Home | http_file