From 64e8a31949f6c562d77dd8e375dc8868d7d1283d Mon Sep 17 00:00:00 2001 From: eikek Date: Sun, 10 Jul 2022 11:08:45 +0200 Subject: [PATCH] Add info about forwarding headers when using a reverse proxy --- .../site/content/docs/install/reverseproxy.md | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/website/site/content/docs/install/reverseproxy.md b/website/site/content/docs/install/reverseproxy.md index 84c17dce..27eb789e 100644 --- a/website/site/content/docs/install/reverseproxy.md +++ b/website/site/content/docs/install/reverseproxy.md @@ -58,6 +58,28 @@ server and web application. If you have examples for more http servers (e.g. apache), please let me know or add it to this site. +# Headers + +If `base-url` is left to its default, then Docspell tries to find the +external URL from the http request. When using a reverse proxy, you +then need to pass some information from the original request so +Docspell can construct the correct url. These headers are evaluated: + +``` +X-Forwarded-Host +X-Forwarded-Proto +X-Forwarded-Port +X-Forwarded-For +``` + +Example for nginx: + +``` +proxy_set_header X-Forwarded-Host $host; +proxy_set_header X-Forwarded-Port 443; +proxy_set_header X-Forwarded-Proto https; +``` + # Nginx This defines two servers: one listens for http traffic and redirects @@ -97,6 +119,9 @@ server { proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection $connection_upgrade; + proxy_set_header X-Forwarded-Host $host; + proxy_set_header X-Forwarded-Port 443; + proxy_set_header X-Forwarded-Proto https; //client_max_body_size 40M; //to allow larger uploads }