Network.HTTP.ReverseProxy

Types

data ProxyDest

Host/port combination to which we want to proxy.

Constructors

ProxyDest

Fields

pdHost :: !ByteString

pdPort :: !Int

Raw

rawProxyTo

Arguments

:: (MonadBaseControl IO m, MonadIO m)

=> (RequestHeaders -> m (Either (AppData -> m ()) ProxyDest))

How to reverse proxy. A Left result will run the given Application, whereas a Right will reverse proxy to the given host/port.

-> AppData

-> m ()

Set up a reverse proxy server, which will have a minimal overhead.

This function uses raw sockets, parsing as little of the request as possible. The workflow is:

1. Parse the first request headers.
2. Ask the supplied function to specify how to reverse proxy.
3. Open up a connection to the given host/port.
4. Pass all bytes across the wire unchanged.

If you need more control, such as modifying the request or response, use waiProxyTo.

WAI + http-conduit

waiProxyTo

Arguments

:: (Request -> IO WaiProxyResponse)

How to reverse proxy. A Left result will be sent verbatim as the response, whereas Right will cause a reverse proxy.

-> (SomeException -> Application)

How to handle exceptions when calling remote server. For a simple 502 error page, use defaultOnExc.

-> Manager

connection manager to utilize

-> Application

Creates a WAI Application which will handle reverse proxies.

Connections to the proxied server will be provided via http-conduit. As such, all requests and responses will be fully processed in your reverse proxy. This allows you much more control over the data sent over the wire, but also incurs overhead. For a lower-overhead approach, consider rawProxyTo.

Most likely, the given application should be run with Warp, though in theory other WAI handlers will work as well.

Note: This function will use chunked request bodies for communicating with the proxied server. Not all servers necessarily support chunked request bodies, so please confirm that yours does (Warp, Snap, and Happstack, for example, do).

defaultOnExc :: SomeException -> Application

Sends a simple 502 bad gateway error message with the contents of the exception.

waiProxyToSettings :: (Request -> IO WaiProxyResponse) -> WaiProxySettings -> Manager -> Application

data WaiProxyResponse

The different responses that could be generated by a waiProxyTo lookup function.

Since 0.2.0

Constructors

WPRResponse Response

Respond with the given WAI Response.

Since 0.2.0

WPRProxyDest ProxyDest

Send to the given destination.

Since 0.2.0

WPRProxyDestSecure ProxyDest

Send to the given destination via HTTPS.

WPRModifiedRequest Request ProxyDest

Send to the given destination, but use the given modified Request for computing the reverse-proxied request. This can be useful for reverse proxying to a different path than the one specified. By the user.

Since 0.2.0

WPRModifiedRequestSecure Request ProxyDest

Same as WPRModifiedRequest but send to the given destination via HTTPS.

WPRApplication Application

Respond with the given WAI Application.

Since 0.4.0

Settings

data WaiProxySettings

Instances

Default WaiProxySettings

def :: Default a => a

The default value for this type.

wpsOnExc :: WaiProxySettings -> SomeException -> Application

wpsTimeout :: WaiProxySettings -> Maybe Int

wpsSetIpHeader :: WaiProxySettings -> SetIpHeader

Set the X-Real-IP request header with the client's IP address.

Default: SIHFromSocket

Since 0.2.0

wpsProcessBody :: WaiProxySettings -> Response () -> Maybe (Conduit ByteString IO (Flush Builder))

Post-process the response body returned from the host.

Since 0.2.1

wpsUpgradeToRaw :: WaiProxySettings -> Request -> Bool

Determine if the request should be upgraded to a raw proxy connection, as is needed for WebSockets. Requires WAI 2.1 or higher and a WAI handler with raw response support (e.g., Warp) to work.

Default: check if the upgrade header is websocket.

Since 0.3.1

wpsGetDest :: WaiProxySettings -> Maybe (Request -> IO (LocalWaiProxySettings, WaiProxyResponse))

Allow to override proxy settings for each request. If you supply this field it will take precedence over getDest parameter in waiProxyToSettings

Default: have one global setting

Since 0.4.2

data SetIpHeader

How to set the X-Real-IP request header.

Since 0.2.0

Constructors

SIHNone

Do not set the header

SIHFromSocket

Set it from the socket's address.

SIHFromHeader

Set it from either X-Real-IP or X-Forwarded-For, if present

Local settings

data LocalWaiProxySettings

Instances

Default LocalWaiProxySettings

defaultLocalWaiProxySettings :: LocalWaiProxySettings

Default value for LocalWaiProxySettings, same as def but with a more explicit name.

Since 0.4.2

setLpsTimeBound :: Maybe Int -> LocalWaiProxySettings -> LocalWaiProxySettings

Allows to specify the maximum time allowed for the conection on per request basis.

Default: no timeouts

Since 0.4.2