|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.2.9-1 - Configuration Manual</title> |
| 5 | + <title>HAProxy version 3.2.9-21 - 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" /> |
|
4622 | 4622 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
4623 | 4623 | </p> |
4624 | 4624 | <p class="text-right"> |
4625 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/11/21</b></small> |
| 4625 | + <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> |
4626 | 4626 | </p> |
4627 | 4627 | </div> |
4628 | 4628 | <!-- /.sidebar --> |
|
4633 | 4633 | <div class="text-center"> |
4634 | 4634 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
4635 | 4635 | <h2>Configuration Manual</h2> |
4636 | | - <p><strong>version 3.2.9-1</strong></p> |
| 4636 | + <p><strong>version 3.2.9-21</strong></p> |
4637 | 4637 | <p> |
4638 | 4638 | 2025/11/21<br> |
4639 | 4639 |
|
@@ -13921,8 +13921,9 @@ <h2 id="chapter-4.2" data-target="4.2"><small><a class="small" href="#4.2">4.2.< |
13921 | 13921 | server features are supported, but not TCP or HTTP specific ones. |
13922 | 13922 |
|
13923 | 13923 | spop When used in a backend section, it will turn the backend into a |
13924 | | - log backend. This mode is mandatory and automatically set, if |
13925 | | - necessary, for backends referenced by SPOE engines.</pre> |
| 13924 | + spop backend. This mode is mandatory if the backend contains |
| 13925 | + SPOA servers, but when mode is tcp, it will automatically be |
| 13926 | + converted to mode spop if such servers are detected.</pre> |
13926 | 13927 | </div> |
13927 | 13928 | <pre class="text">When doing content switching, it is mandatory that the frontend and the |
13928 | 13929 | backend are in the same mode (generally HTTP), otherwise the configuration |
@@ -23263,27 +23264,27 @@ <h2 id="chapter-6.2" data-target="6.2"><small><a class="small" href="#6.2">6.2.< |
23263 | 23264 | <a class="anchor" id="6.2.1" name="6.2.1"></a> |
23264 | 23265 | <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> |
23265 | 23266 | <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 |
23266 | | -size of cache is mandatory. |
23267 | | -</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 |
23268 | | -blocks of 1kB which are used by the cache entries. Its maximum value is 4095. |
23269 | | -</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 |
23270 | | -an half of "<a href="#total-max-size">total-max-size</a>". If not set, it equals to a 256th of the cache size. |
23271 | | -All objects with sizes larger than "<a href="#max-object-size">max-object-size</a>" will not be cached. |
| 23267 | +size of cache is mandatory (see keyword "<a href="#total-max-size">total-max-size</a>" below). |
23272 | 23268 | </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 |
23273 | 23269 | value between the s-maxage or max-age (in this order) directive in the |
23274 | 23270 | Cache-Control response header and this value. The default value is 60 |
23275 | 23271 | seconds, which means that you can't cache an object more than 60 seconds by |
23276 | 23272 | default. |
| 23273 | +</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 |
| 23274 | +an half of "<a href="#total-max-size">total-max-size</a>". If not set, it equals to a 256th of the cache size. |
| 23275 | +All objects with sizes larger than "<a href="#max-object-size">max-object-size</a>" will not be cached. |
| 23276 | +</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 |
| 23277 | +key in the cache. This needs the vary support to be enabled. Its default value is 10 |
| 23278 | +and should be passed a strictly positive integer. |
23277 | 23279 | </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 |
23278 | 23280 | containing such a header will never be cached. When enabled, we need to calculate |
23279 | 23281 | a preliminary hash for a subset of request headers on all the incoming requests |
23280 | 23282 | (which might come with a cpu cost) which will be used to build a secondary |
23281 | 23283 | key for a given request (see RFC 7234#4.1). The secondary key is built out of |
23282 | 23284 | the contents of the 'accept-encoding', 'referer' and 'origin' headers for |
23283 | 23285 | now. The default value is off (disabled). |
23284 | | -</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 |
23285 | | -key in the cache. This needs the vary support to be enabled. Its default value is 10 |
23286 | | -and should be passed a strictly positive integer. |
| 23286 | +</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 |
| 23287 | +blocks of 1kB which are used by the cache entries. Its maximum value is 4095. |
23287 | 23288 | </pre></div> |
23288 | 23289 | <a class="anchor" id="6.2.2" name="6.2.2"></a> |
23289 | 23290 | <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> |
@@ -33216,7 +33217,7 @@ <h2 id="chapter-12.9" data-target="12.9"><small><a class="small" href="#12.9">12 |
33216 | 33217 | <br> |
33217 | 33218 | <hr> |
33218 | 33219 | <div class="text-right"> |
33219 | | - HAProxy 3.2.9-1 – Configuration Manual<br> |
| 33220 | + HAProxy 3.2.9-21 – Configuration Manual<br> |
33220 | 33221 | <small>, 2025/11/21</small> |
33221 | 33222 | </div> |
33222 | 33223 | </div> |
|
0 commit comments