|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.4-dev8-149 - Configuration Manual</title> |
| 5 | + <title>HAProxy version 3.4-dev9 - 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" /> |
|
4619 | 4619 |
|
4620 | 4620 | <a class="list-group-item" href="#tune.quic.fe.stream.max-concurrent">tune.quic.fe.stream.max-concurrent</a> |
4621 | 4621 |
|
| 4622 | + <a class="list-group-item" href="#tune.quic.fe.stream.max-total">tune.quic.fe.stream.max-total</a> |
| 4623 | + |
4622 | 4624 | <a class="list-group-item" href="#tune.quic.fe.stream.rxbuf">tune.quic.fe.stream.rxbuf</a> |
4623 | 4625 |
|
4624 | 4626 | <a class="list-group-item" href="#tune.quic.fe.tx.pacing">tune.quic.fe.tx.pacing</a> |
|
4896 | 4898 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
4897 | 4899 | </p> |
4898 | 4900 | <p class="text-right"> |
4899 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/04/14</b></small> |
| 4901 | + <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/04/15</b></small> |
4900 | 4902 | </p> |
4901 | 4903 | </div> |
4902 | 4904 | <!-- /.sidebar --> |
|
4907 | 4909 | <div class="text-center"> |
4908 | 4910 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
4909 | 4911 | <h2>Configuration Manual</h2> |
4910 | | - <p><strong>version 3.4-dev8-149</strong></p> |
| 4912 | + <p><strong>version 3.4-dev9</strong></p> |
4911 | 4913 | <p> |
4912 | | - 2026/04/03<br> |
| 4914 | + 2026/04/15<br> |
4913 | 4915 |
|
4914 | 4916 | </p> |
4915 | 4917 | </div> |
@@ -8000,6 +8002,7 @@ <h2 id="chapter-2.10" data-target="2.10"><small><a class="small" href="#2.10">2. |
8000 | 8002 | - <a href="#tune.quic.fe.sock-per-conn">tune.quic.fe.sock-per-conn</a> |
8001 | 8003 | - <a href="#tune.quic.fe.stream.data-ratio">tune.quic.fe.stream.data-ratio</a> |
8002 | 8004 | - <a href="#tune.quic.fe.stream.max-concurrent">tune.quic.fe.stream.max-concurrent</a> |
| 8005 | + - <a href="#tune.quic.fe.stream.max-total">tune.quic.fe.stream.max-total</a> |
8003 | 8006 | - <a href="#tune.quic.fe.stream.rxbuf">tune.quic.fe.stream.rxbuf</a> |
8004 | 8007 | - <a href="#tune.quic.fe.tx.pacing">tune.quic.fe.tx.pacing</a> |
8005 | 8008 | - <a href="#tune.quic.fe.tx.udp-gso">tune.quic.fe.tx.udp-gso</a> |
@@ -10789,7 +10792,23 @@ <h2 id="chapter-3.2" data-target="3.2"><small><a class="small" href="#3.2">3.2.< |
10789 | 10792 | upload throughput. It can be corrected by increasing the QUIC stream rxbuf |
10790 | 10793 | connection setting. |
10791 | 10794 | </pre><div class="page-header"><b>See also:</b> "<a href="#tune.quic.be.stream.rxbuf">tune.quic.be.stream.rxbuf</a>", "<a href="#tune.quic.fe.stream.rxbuf">tune.quic.fe.stream.rxbuf</a>", "<a href="#tune.quic.be.stream.data-ratio">tune.quic.be.stream.data-ratio</a>", "<a href="#tune.quic.fe.stream.data-ratio">tune.quic.fe.stream.data-ratio</a>"</div> |
10792 | | -<a class="anchor" name="tune.quic.frontend.max-streams-bidi"></a><a class="anchor" name="3-tune.quic.frontend.max-streams-bidi"></a><a class="anchor" name="3.2-tune.quic.frontend.max-streams-bidi"></a><a class="anchor" name="tune.quic.frontend.max-streams-bidi (Global section)"></a><a class="anchor" name="tune.quic.frontend.max-streams-bidi (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.quic.frontend.max-streams-bidi"></a><a href="#3.2-tune.quic.frontend.max-streams-bidi">tune.quic.frontend.max-streams-bidi</a></b> <span style="color: #080"><number></span> <span class="label label-warning">(deprecated)</span></div><pre class="text">This keyword has been deprecated in 3.3 and will be removed in 3.5. It is |
| 10795 | +<a class="anchor" name="tune.quic.fe.stream.max-total"></a><a class="anchor" name="3-tune.quic.fe.stream.max-total"></a><a class="anchor" name="3.2-tune.quic.fe.stream.max-total"></a><a class="anchor" name="tune.quic.fe.stream.max-total (Global section)"></a><a class="anchor" name="tune.quic.fe.stream.max-total (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.quic.fe.stream.max-total"></a><a href="#3.2-tune.quic.fe.stream.max-total">tune.quic.fe.stream.max-total</a></b> <span style="color: #080"><number></span></div><pre class="text">Sets the maximum number of requests that can be handled by a single QUIC |
| 10796 | +connection. Once this total is reached, the connection will be gracefully |
| 10797 | +shutdown. In HTTP/3, this translates in a GOAWAY frame. The connection is |
| 10798 | +finally closed when all remaining transfers are completed. |
| 10799 | + |
| 10800 | +This setting is applied as a hard limit on the connection via the QUIC flow |
| 10801 | +control mechanism. If a peer violates it, the connection will be immediately |
| 10802 | +closed. |
| 10803 | + |
| 10804 | +This setting can be used to force clients to open new connections once in a |
| 10805 | +while to continue the emission of requests and avoid maintaining connections |
| 10806 | +for too many times. However, low values will increase latency on the client |
| 10807 | +side, as well as CPU consumption on both sides due to TLS handshakes. |
| 10808 | + |
| 10809 | +The default value is 0 which implies no specific limit outside of the QUIC |
| 10810 | +protocol encoding limitation (2^60, more that a billion billion). |
| 10811 | +</pre><a class="anchor" name="tune.quic.frontend.max-streams-bidi"></a><a class="anchor" name="3-tune.quic.frontend.max-streams-bidi"></a><a class="anchor" name="3.2-tune.quic.frontend.max-streams-bidi"></a><a class="anchor" name="tune.quic.frontend.max-streams-bidi (Global section)"></a><a class="anchor" name="tune.quic.frontend.max-streams-bidi (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.quic.frontend.max-streams-bidi"></a><a href="#3.2-tune.quic.frontend.max-streams-bidi">tune.quic.frontend.max-streams-bidi</a></b> <span style="color: #080"><number></span> <span class="label label-warning">(deprecated)</span></div><pre class="text">This keyword has been deprecated in 3.3 and will be removed in 3.5. It is |
10793 | 10812 | part of the streamlining process apply on QUIC configuration. If used, this |
10794 | 10813 | setting will only be applied on frontend connections. |
10795 | 10814 | </pre><a class="anchor" name="tune.quic.be.stream.rxbuf"></a><a class="anchor" name="3-tune.quic.be.stream.rxbuf"></a><a class="anchor" name="3.2-tune.quic.be.stream.rxbuf"></a><a class="anchor" name="tune.quic.be.stream.rxbuf (Global section)"></a><a class="anchor" name="tune.quic.be.stream.rxbuf (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.quic.be.stream.rxbuf"></a><a href="#3.2-tune.quic.be.stream.rxbuf">tune.quic.be.stream.rxbuf</a></b> <span style="color: #080"><size></span></div><a class="anchor" name="tune.quic.fe.stream.rxbuf"></a><a class="anchor" name="3-tune.quic.fe.stream.rxbuf"></a><a class="anchor" name="3.2-tune.quic.fe.stream.rxbuf"></a><a class="anchor" name="tune.quic.fe.stream.rxbuf (Global section)"></a><a class="anchor" name="tune.quic.fe.stream.rxbuf (Performance tuning)"></a><div class="keyword"><b><a class="anchor" name="tune.quic.fe.stream.rxbuf"></a><a href="#3.2-tune.quic.fe.stream.rxbuf">tune.quic.fe.stream.rxbuf</a></b> <span style="color: #080"><size></span></div><pre class="text">This setting is the hard limit for the number of data bytes in flight over a |
@@ -35171,6 +35190,15 @@ <h2 id="chapter-12.8" data-target="12.8"><small><a class="small" href="#12.8">12 |
35171 | 35190 |
|
35172 | 35191 | When "<a href="#challenge">challenge</a>" is set to "dns-persist-01" and this option is not |
35173 | 35192 | configured, the default is "dns,delay". |
| 35193 | + |
| 35194 | +When "<a href="#challenge">challenge</a>" is set to "dns-persist-01", an initial opportunistic DNS |
| 35195 | +check is always performed before the challenge-ready conditions are evaluated. |
| 35196 | +Since the "_validation-persist.<domain>" TXT record is set once and never |
| 35197 | +changes between renewals, HAProxy checks at renewal time whether the record |
| 35198 | +is already present. If the check succeeds for all domains, the challenge is |
| 35199 | +submitted immediately without going through the challenge-ready steps (cli, |
| 35200 | +delay, dns). If the check fails, HAProxy falls back to the normal |
| 35201 | +challenge-ready flow. |
35174 | 35202 | </pre><div class="separator"> |
35175 | 35203 | <span class="label label-success">Example:</span> |
35176 | 35204 | <pre class="prettyprint"> |
@@ -35319,8 +35347,8 @@ <h2 id="chapter-12.9" data-target="12.9"><small><a class="small" href="#12.9">12 |
35319 | 35347 | <br> |
35320 | 35348 | <hr> |
35321 | 35349 | <div class="text-right"> |
35322 | | - HAProxy 3.4-dev8-149 – Configuration Manual<br> |
35323 | | - <small>, 2026/04/03</small> |
| 35350 | + HAProxy 3.4-dev9 – Configuration Manual<br> |
| 35351 | + <small>, 2026/04/15</small> |
35324 | 35352 | </div> |
35325 | 35353 | </div> |
35326 | 35354 | <!-- /.col-lg-12 --> |
|
0 commit comments