mirror of
https://github.com/cytopia/devilbox.git
synced 2024-12-22 14:12:25 +00:00
135 lines
4.2 KiB
ReStructuredText
135 lines
4.2 KiB
ReStructuredText
.. include:: /_includes/snippets/__ANNOUNCEMENTS__.rst
|
|
|
|
.. _apache_conf:
|
|
|
|
***********
|
|
apache.conf
|
|
***********
|
|
|
|
Apache 2.2 and Apache 2.4 both come with their default vendor configuration. This might not be the
|
|
ideal setup for some people, so you have the chance to change any of those settings, by supplying
|
|
custom configurations.
|
|
|
|
.. seealso:: If you are rather using Nginx, have a look at: :ref:`nginx_conf`
|
|
|
|
.. important::
|
|
You could actually also create virtual hosts here, but it is recommended to use the
|
|
Devilbox Auto-vhost generation feature. If you want to custimize your current virtual hosts
|
|
have a look at:
|
|
|
|
* vhost-gen: :ref:`vhost_gen_virtual_host_templates`
|
|
* vhost-gen: :ref:`vhost_gen_customize_all_virtual_hosts_globally`
|
|
* vhost-gen: :ref:`vhost_gen_customize_specific_virtual_host`
|
|
* vhost-gen: :ref:`vhost_gen_example_add_sub_domains`
|
|
|
|
|
|
**Table of Contents**
|
|
|
|
.. contents:: :local:
|
|
|
|
|
|
General
|
|
=======
|
|
|
|
You can set custom apache.conf configuration options for each Apache version separately.
|
|
See the directory structure for Apache configuration directories inside ``./cfg/`` directory:
|
|
|
|
.. code-block:: bash
|
|
|
|
host> ls -l path/to/devilbox/cfg/ | grep 'apache'
|
|
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 apache-2.2/
|
|
drwxr-xr-x 2 cytopia cytopia 4096 Mar 5 21:53 apache-2.4/
|
|
|
|
Customization is achieved by placing a file into ``cfg/apache-X.X/`` (where ``X.X`` stands for
|
|
your Apache version). The file must end by ``.conf`` in order to be sourced by the web server.
|
|
|
|
Each of the Apache configuration directories already contain an example file:
|
|
``devilbox-custom.conf-example``, that can simply be renamed to ``devilbox-custom.conf``.
|
|
This file holds some example values that can be adjusted or commented out.
|
|
|
|
In order for the changes to be applied, you will have to restart the Devilbox.
|
|
|
|
|
|
Examples
|
|
========
|
|
|
|
Adjust KeepAlive settings for Apache 2.2
|
|
----------------------------------------
|
|
|
|
The following examples shows you how to change the
|
|
`KeepAlive <https://httpd.apache.org/docs/2.2/mod/core.html#keepalive>`_, the
|
|
`MaxKeepAliveRequests <https://httpd.apache.org/docs/2.2/mod/core.html#maxkeepaliverequests>`_
|
|
as well as the
|
|
`KeepAliveTimeout <https://httpd.apache.org/docs/2.2/mod/core.html#keepalivetimeout>`_ values of
|
|
Apache 2.2.
|
|
|
|
.. code-block:: bash
|
|
|
|
# Navigate to the Devilbox directory
|
|
host> cd path/to/devilbox
|
|
|
|
# Navigate to Apache 2.2 config directory
|
|
host> cd cfg/apache-2.2
|
|
|
|
# Create new conf file
|
|
host> touch keep_alive.conf
|
|
|
|
Now add the following content to the file:
|
|
|
|
.. code-block:: ini
|
|
:caption: keep_alive.conf
|
|
|
|
KeepAlive On
|
|
KeepAliveTimeout 10
|
|
MaxKeepAliveRequests 100
|
|
|
|
In order to apply the changes you need to restart the Devilbox.
|
|
|
|
.. note::
|
|
The above is just an example demonstration, you probably need other values for your setup.
|
|
So make sure to understand how to configure Apache, if you are going to change any of those
|
|
settings.
|
|
|
|
|
|
Limit HTTP headers and GET size for Apache 2.4
|
|
----------------------------------------------
|
|
|
|
The following examples shows you how to limit the amount of headers the client can send to the
|
|
server as well as changing the maximum URL GET size by adjusting
|
|
`LimitRequestFields <http://httpd.apache.org/docs/current/mod/core.html#limitrequestfields>`_,
|
|
`LimitRequestFieldSize <http://httpd.apache.org/docs/current/mod/core.html#limitrequestfieldsize>`_
|
|
and
|
|
`LimitRequestLine <http://httpd.apache.org/docs/current/mod/core.html#limitrequestline>`_
|
|
for Apache 2.4.
|
|
|
|
.. code-block:: bash
|
|
|
|
# Navigate to the Devilbox directory
|
|
host> cd path/to/devilbox
|
|
|
|
# Navigate to Apache 2.4 config directory
|
|
host> cd cfg/apache-2.4
|
|
|
|
# Create new conf file
|
|
host> touch limits.conf
|
|
|
|
Now add the following content to the file:
|
|
|
|
.. code-block:: ini
|
|
:caption: limits.conf
|
|
|
|
# Limit amount of HTTP headers a client can send to the server
|
|
LimitRequestFields 20
|
|
LimitRequestFieldSize 4094
|
|
|
|
# URL GET size
|
|
LimitRequestLine 2048
|
|
|
|
In order to apply the changes you need to restart the Devilbox.
|
|
|
|
.. note::
|
|
The above is just an example demonstration, you probably need other values for your setup.
|
|
So make sure to understand how to configure Apache, if you are going to change any of those
|
|
settings.
|