aboutsummaryrefslogtreecommitdiffstats
path: root/doc-src/features/reverseproxy.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc-src/features/reverseproxy.html')
-rw-r--r--doc-src/features/reverseproxy.html47
1 files changed, 0 insertions, 47 deletions
diff --git a/doc-src/features/reverseproxy.html b/doc-src/features/reverseproxy.html
deleted file mode 100644
index af5a5c53..00000000
--- a/doc-src/features/reverseproxy.html
+++ /dev/null
@@ -1,47 +0,0 @@
-
-In reverse proxy mode, mitmproxy accepts standard HTTP requests and forwards
-them to the specified upstream server. This is in contrast to
-<a href="@!urlTo("upstreamproxy.html")!@">upstream proxy mode</a>, in which
-mitmproxy forwards HTTP proxy requests to an upstream proxy server.
-
-<table class="table">
- <tbody>
- <tr>
- <th width="20%">command-line</th> <td>-R <i>scheme</i>://hostname[:port]</td>
- </tr>
- </tbody>
-</table>
-
-Here, **scheme** signifies if the proxy should use TLS to connect to the server.
-mitmproxy accepts both encrypted and unencrypted requests and transforms them to what the server
-expects.
-
- mitmdump -R https://httpbin.org -p 80
- mitmdump -R https://httpbin.org -p 443
-
-
-### Host Header
-
-In reverse proxy mode, mitmproxy does not rewrite the host header. While often useful, this
-may lead to issues with public web servers. For example, consider the following scenario:
-
- $ python mitmdump -d -R http://example.com/ &
- $ curl http://localhost:8080/
-
- >> GET https://example.com/
- Host: localhost:8080
- User-Agent: curl/7.35.0
- [...]
-
- << 404 Not Found 345B
-
-Since the Host header doesn't match <samp>example.com</samp>, an error is returned.<br>
-There are two ways to solve this:
-<ol>
- <li>Modify the hosts file of your OS so that example.com resolves to 127.0.0.1.</li>
- <li>
- Instruct mitmproxy to rewrite the host header by passing <kbd>&#8209;&#8209;setheader&nbsp;:~q:Host:example.com</kbd>.
- However, keep in mind that absolute URLs within the returned document or HTTP redirects will cause the client application
- to bypass the proxy.
- </li>
-</ol> \ No newline at end of file