Create reverseproxy.rst

users/reverseproxy.rst

@@ -0,0 +1,71 @@
+.. _reverse-proxy-setup:
+
+Reverse Proxy Setup
+===================
+
+A reverse proxy allow you to "pass" requests to your web server to another
+site or program. The reverse proxy will make it look like Syncthing's WebUI
+is a page within your existing site.
+
+This is especially useful if:
+
+-   You need to access the WebUI through the ports 80/443 but you already host a website.
+-   You want to share SSL certificates with an existing site.
+-   You want to share authentification with an existing setup.
+
+Server Configuration
+--------------------
+
+If you have access to your web server's configuration use the following
+examples to pass the location **/syncthing** on your web server to Syncthing's
+WebUI hosted on **localhost:8384**.
+
+Apache
+~~~~~~
+
+.. code::
+
+    ProxyPass /syncthing/ http://localhost:8384/
+    <Location /syncthing/>
+      ProxyPassReverse http://localhost:8384/
+      Order Allow,Deny
+      Allow from All
+    </Location>
+
+Nginx
+~~~~~
+
+.. code::
+
+    location /syncthing/ {
+      proxy_set_header        Host $host;
+      proxy_set_header        X-Real-IP $remote_addr;
+      proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
+      proxy_set_header        X-Forwarded-Proto $scheme;
+    
+      proxy_pass              http://localhost:8384/;
+    }
+
+Folder Configuration
+--------------------
+
+If you don't have access to your web server configuration files you might try
+the following technique.
+
+Apache
+~~~~~~
+
+Add the configuration bellow to a **.htaccess** file in the folder of your
+webroot which should redirect to the WebUI, **/syncthing** to produce the same
+behaviour as above
+
+.. code::
+
+    RewriteEngine On
+    RewriteCond %{HTTPS} !=on
+    RewriteCond %{ENV:HTTPS} !=on
+    RewriteRule .* https://%{SERVER_NAME}%{REQUEST_URI} [R=301,L]
+    RewriteRule ^(.*) http://localhost:8080/$1 [P]
+
+
+This method also redirects to https to prevent opening the gui unencrypted.