|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.1.10-19 - Configuration Manual</title> |
| 5 | + <title>HAProxy version 3.1.10-43 - Configuration Manual</title> |
6 | 6 | <link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" /> |
7 | 7 | <link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" /> |
8 | 8 | <link href="../css/page.css?0.4.2-15" rel="stylesheet" /> |
|
4432 | 4432 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
4433 | 4433 | </p> |
4434 | 4434 | <p class="text-right"> |
4435 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/12/05</b></small> |
| 4435 | + <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/12/12</b></small> |
4436 | 4436 | </p> |
4437 | 4437 | </div> |
4438 | 4438 | <!-- /.sidebar --> |
|
4443 | 4443 | <div class="text-center"> |
4444 | 4444 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
4445 | 4445 | <h2>Configuration Manual</h2> |
4446 | | - <p><strong>version 3.1.10-19</strong></p> |
| 4446 | + <p><strong>version 3.1.10-43</strong></p> |
4447 | 4447 | <p> |
4448 | 4448 | 2025/11/07<br> |
4449 | 4449 |
|
@@ -13858,8 +13858,9 @@ <h2 id="chapter-4.2" data-target="4.2"><small><a class="small" href="#4.2">4.2.< |
13858 | 13858 | server features are supported, but not TCP or HTTP specific ones. |
13859 | 13859 |
|
13860 | 13860 | spop When used in a backend section, it will turn the backend into a |
13861 | | - log backend. This mode is mandatory and automatically set, if |
13862 | | - necessary, for backends referenced by SPOE engines.</pre> |
| 13861 | + spop backend. This mode is mandatory if the backend contains |
| 13862 | + SPOA servers, but when mode is tcp, it will automatically be |
| 13863 | + converted to mode spop if such servers are detected.</pre> |
13863 | 13864 | </div> |
13864 | 13865 | <pre class="text">When doing content switching, it is mandatory that the frontend and the |
13865 | 13866 | backend are in the same mode (generally HTTP), otherwise the configuration |
@@ -23298,27 +23299,27 @@ <h2 id="chapter-6.2" data-target="6.2"><small><a class="small" href="#6.2">6.2.< |
23298 | 23299 | <a class="anchor" id="6.2.1" name="6.2.1"></a> |
23299 | 23300 | <h3 id="chapter-6.2.1" data-target="6.2.1"><small><a class="small" href="#6.2.1">6.2.1.</a></small> Cache section</h3> |
23300 | 23301 | <div><a class="anchor" name="cache"></a><a class="anchor" name="6-cache"></a><a class="anchor" name="6.2.1-cache"></a><a class="anchor" name="cache (Cache)"></a><a class="anchor" name="cache (Cache section)"></a><div class="keyword"><b><a class="anchor" name="cache"></a><a href="#6.2.1-cache">cache</a></b> <span style="color: #080"><name></span></div><pre class="text">Declare a cache section, allocate a shared cache memory named <name>, the |
23301 | | -size of cache is mandatory. |
23302 | | -</pre><a class="anchor" name="total-max-size"></a><a class="anchor" name="6-total-max-size"></a><a class="anchor" name="6.2.1-total-max-size"></a><a class="anchor" name="total-max-size (Cache)"></a><a class="anchor" name="total-max-size (Cache section)"></a><div class="keyword"><b><a class="anchor" name="total-max-size"></a><a href="#6.2.1-total-max-size">total-max-size</a></b> <span style="color: #080"><megabytes></span></div><pre class="text">Define the size in RAM of the cache in megabytes. This size is split in |
23303 | | -blocks of 1kB which are used by the cache entries. Its maximum value is 4095. |
23304 | | -</pre><a class="anchor" name="max-object-size"></a><a class="anchor" name="6-max-object-size"></a><a class="anchor" name="6.2.1-max-object-size"></a><a class="anchor" name="max-object-size (Cache)"></a><a class="anchor" name="max-object-size (Cache section)"></a><div class="keyword"><b><a class="anchor" name="max-object-size"></a><a href="#6.2.1-max-object-size">max-object-size</a></b> <span style="color: #080"><bytes></span></div><pre class="text">Define the maximum size of the objects to be cached. Must not be greater than |
23305 | | -an half of "<a href="#total-max-size">total-max-size</a>". If not set, it equals to a 256th of the cache size. |
23306 | | -All objects with sizes larger than "<a href="#max-object-size">max-object-size</a>" will not be cached. |
| 23302 | +size of cache is mandatory (see keyword "<a href="#total-max-size">total-max-size</a>" below). |
23307 | 23303 | </pre><a class="anchor" name="max-age"></a><a class="anchor" name="6-max-age"></a><a class="anchor" name="6.2.1-max-age"></a><a class="anchor" name="max-age (Cache)"></a><a class="anchor" name="max-age (Cache section)"></a><div class="keyword"><b><a class="anchor" name="max-age"></a><a href="#6.2.1-max-age">max-age</a></b> <span style="color: #080"><seconds></span></div><pre class="text">Define the maximum expiration duration. The expiration is set as the lowest |
23308 | 23304 | value between the s-maxage or max-age (in this order) directive in the |
23309 | 23305 | Cache-Control response header and this value. The default value is 60 |
23310 | 23306 | seconds, which means that you can't cache an object more than 60 seconds by |
23311 | 23307 | default. |
| 23308 | +</pre><a class="anchor" name="max-object-size"></a><a class="anchor" name="6-max-object-size"></a><a class="anchor" name="6.2.1-max-object-size"></a><a class="anchor" name="max-object-size (Cache)"></a><a class="anchor" name="max-object-size (Cache section)"></a><div class="keyword"><b><a class="anchor" name="max-object-size"></a><a href="#6.2.1-max-object-size">max-object-size</a></b> <span style="color: #080"><bytes></span></div><pre class="text">Define the maximum size of the objects to be cached. Must not be greater than |
| 23309 | +an half of "<a href="#total-max-size">total-max-size</a>". If not set, it equals to a 256th of the cache size. |
| 23310 | +All objects with sizes larger than "<a href="#max-object-size">max-object-size</a>" will not be cached. |
| 23311 | +</pre><a class="anchor" name="max-secondary-entries"></a><a class="anchor" name="6-max-secondary-entries"></a><a class="anchor" name="6.2.1-max-secondary-entries"></a><a class="anchor" name="max-secondary-entries (Cache)"></a><a class="anchor" name="max-secondary-entries (Cache section)"></a><div class="keyword"><b><a class="anchor" name="max-secondary-entries"></a><a href="#6.2.1-max-secondary-entries">max-secondary-entries</a></b> <span style="color: #080"><number></span></div><pre class="text">Define the maximum number of simultaneous secondary entries with the same primary |
| 23312 | +key in the cache. This needs the vary support to be enabled. Its default value is 10 |
| 23313 | +and should be passed a strictly positive integer. |
23312 | 23314 | </pre><a class="anchor" name="process-vary"></a><a class="anchor" name="6-process-vary"></a><a class="anchor" name="6.2.1-process-vary"></a><a class="anchor" name="process-vary (Cache)"></a><a class="anchor" name="process-vary (Cache section)"></a><div class="keyword"><b><a class="anchor" name="process-vary"></a><a href="#6.2.1-process-vary">process-vary</a></b> <span style="color: #080"><on/off></span></div><pre class="text">Enable or disable the processing of the Vary header. When disabled, a response |
23313 | 23315 | containing such a header will never be cached. When enabled, we need to calculate |
23314 | 23316 | a preliminary hash for a subset of request headers on all the incoming requests |
23315 | 23317 | (which might come with a cpu cost) which will be used to build a secondary |
23316 | 23318 | key for a given request (see RFC 7234#4.1). The secondary key is built out of |
23317 | 23319 | the contents of the 'accept-encoding', 'referer' and 'origin' headers for |
23318 | 23320 | now. The default value is off (disabled). |
23319 | | -</pre><a class="anchor" name="max-secondary-entries"></a><a class="anchor" name="6-max-secondary-entries"></a><a class="anchor" name="6.2.1-max-secondary-entries"></a><a class="anchor" name="max-secondary-entries (Cache)"></a><a class="anchor" name="max-secondary-entries (Cache section)"></a><div class="keyword"><b><a class="anchor" name="max-secondary-entries"></a><a href="#6.2.1-max-secondary-entries">max-secondary-entries</a></b> <span style="color: #080"><number></span></div><pre class="text">Define the maximum number of simultaneous secondary entries with the same primary |
23320 | | -key in the cache. This needs the vary support to be enabled. Its default value is 10 |
23321 | | -and should be passed a strictly positive integer. |
| 23321 | +</pre><a class="anchor" name="total-max-size"></a><a class="anchor" name="6-total-max-size"></a><a class="anchor" name="6.2.1-total-max-size"></a><a class="anchor" name="total-max-size (Cache)"></a><a class="anchor" name="total-max-size (Cache section)"></a><div class="keyword"><b><a class="anchor" name="total-max-size"></a><a href="#6.2.1-total-max-size">total-max-size</a></b> <span style="color: #080"><megabytes></span></div><pre class="text">Define the size in RAM of the cache in megabytes. This size is split in |
| 23322 | +blocks of 1kB which are used by the cache entries. Its maximum value is 4095. |
23322 | 23323 | </pre></div> |
23323 | 23324 | <a class="anchor" id="6.2.2" name="6.2.2"></a> |
23324 | 23325 | <h3 id="chapter-6.2.2" data-target="6.2.2"><small><a class="small" href="#6.2.2">6.2.2.</a></small> Proxy section</h3> |
@@ -31872,7 +31873,7 @@ <h2 id="chapter-11.3" data-target="11.3"><small><a class="small" href="#11.3">11 |
31872 | 31873 | <br> |
31873 | 31874 | <hr> |
31874 | 31875 | <div class="text-right"> |
31875 | | - HAProxy 3.1.10-19 – Configuration Manual<br> |
| 31876 | + HAProxy 3.1.10-43 – Configuration Manual<br> |
31876 | 31877 | <small>, 2025/11/07</small> |
31877 | 31878 | </div> |
31878 | 31879 | </div> |
|
0 commit comments