mirrors/nextcloud-documentation
3
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-10-26 11:18:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #58 from herbrechtsmeier/reverse-proxy

Browse Source 
configuration_overwrite: rename title to reverse proxy configuration and revised content
This commit is contained in:
Bernhard Posselt 2013-02-25 00:20:52 -08:00
commit b5078f6bfd
4 changed files with 50 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
admin_manual/configuration/configuration_overwrite.rst
View File

@ -1,26 +0,0 @@
Overwrite Configuration
=======================
The automatic hostname, protocol or webroot detection of ownCloud can fail in certain reverse proxy situations. This configuration allows to manually override the automatic detection.
Parameters
----------
If ownCloud fails to automatically detected the hostname, protocol or webroot you can use the **overwrite** parameters inside the :file:`config/config.php`. The **overwritehost** parameter is used to set the hostname of the proxy. You can also specify a port. The **overwriteprotocol** parameter is used to set the protocol of the proxy. You can choose between the two options **http** and **https**. The **overwritewebroot** parameter is used to set the absolute web path of the proxy to the ownCloud folder. When you want to keep the automatic detection of one of the three parameters you can leave the value empty or don't set it. The **overwritecondaddr** parameter is used to overwrite the values dependent on the remote address. The value must be a **regular expression** of the IP addresses of the proxy. This is useful when you use a reverse SSL proxy only for https access and you want to use the automatic detection for http access.
Example
-------
Multiple Domains Reverse SSL Proxy
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you want to access your ownCloud installation **http://domain.tld/owncloud** via a multiple domains reverse SSL proxy **https://ssl-proxy.tld/domain.tld/owncloud** with the IP address **10.0.0.1** you can set the following parameters inside the :file:`config/config.php`.
.. code-block:: php
<?php
"overwritehost" => "ssl-proxy.tld",
"overwriteprotocol" => "https",
"overwritewebroot" => "/domain.tld/owncloud",
"overwritecondaddr" => "^10\.0\.0\.1$",

48
admin_manual/configuration/configuration_reverseproxy.rst Normal file
View File

@ -0,0 +1,48 @@
Reverse Proxy Configuration
===========================
The automatic hostname, protocol or webroot detection of ownCloud can fail in
certain reverse proxy situations. This configuration allows to manually override
the automatic detection.
Parameters
----------
If ownCloud fails to automatically detected the hostname, protocol or webroot
you can use the **overwrite** parameters inside the :file:`config/config.php`.
The **overwritehost** parameter is used to set the hostname of the proxy. You
can also specify a port. The **overwriteprotocol** parameter is used to set the
protocol of the proxy. You can choose between the two options **http** and
**https**. The **overwritewebroot** parameter is used to set the absolute web
path of the proxy to the ownCloud folder. When you want to keep the automatic
detection of one of the three parameters you can leave the value empty or don't
set it. The **overwritecondaddr** parameter is used to overwrite the values
dependent on the remote address. The value must be a **regular expression** of
the IP addresses of the proxy. This is useful when you use a reverse SSL proxy
only for https access and you want to use the automatic detection for http
access.
Example
-------
Multiple Domains Reverse SSL Proxy
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you want to access your ownCloud installation **http://domain.tld/owncloud**
via a multiple domains reverse SSL proxy
**https://ssl-proxy.tld/domain.tld/owncloud** with the IP address **10.0.0.1**
you can set the following parameters inside the :file:`config/config.php`.
.. code-block:: php
<?php
$CONFIG = array (
"overwritehost" => "ssl-proxy.tld",
"overwriteprotocol" => "https",
"overwritewebroot" => "/domain.tld/owncloud",
"overwritecondaddr" => "^10\.0\.0\.1$",
);
.. note:: If you want to use the SSL proxy during installation you have to
create the :file:`config/config.php` otherwise you have to extend to existing
**$CONFIG** array.

2
admin_manual/configuration/index.rst
View File

@ -12,7 +12,7 @@ Configuration
configuration_knowledgebase
configuration_logging
configuration_mail
configuration_overwrite
configuration_reverseproxy
custom_mount_config
custom_user_backend
auth_ldap

2
admin_manual/index.rst
View File

@ -59,7 +59,7 @@ This chapter covers ownCloud and Webserver configuration.
* :doc:`configuration/configuration_knowledgebase`
* :doc:`configuration/configuration_logging`
* :doc:`configuration/configuration_mail`
* :doc:`configuration/configuration_overwrite`
* :doc:`configuration/configuration_reverseproxy`
* :doc:`configuration/custom_mount_config`
* :doc:`configuration/custom_user_backend`
* :doc:`configuration/auth_ldap`