|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.0.10-1 - Configuration Manual</title> |
| 5 | + <title>HAProxy version 3.0.10-32 - 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" /> |
|
4327 | 4327 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
4328 | 4328 | </p> |
4329 | 4329 | <p class="text-right"> |
4330 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/04/22</b></small> |
| 4330 | + <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2025/05/20</b></small> |
4331 | 4331 | </p> |
4332 | 4332 | </div> |
4333 | 4333 | <!-- /.sidebar --> |
|
4338 | 4338 | <div class="text-center"> |
4339 | 4339 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
4340 | 4340 | <h2>Configuration Manual</h2> |
4341 | | - <p><strong>version 3.0.10-1</strong></p> |
| 4341 | + <p><strong>version 3.0.10-32</strong></p> |
4342 | 4342 | <p> |
4343 | 4343 | 2025/04/22<br> |
4344 | 4344 |
|
@@ -9666,7 +9666,7 @@ <h2 id="chapter-3.9" data-target="3.9"><small><a class="small" href="#3.9">3.9.< |
9666 | 9666 |
|
9667 | 9667 | ring myring |
9668 | 9668 | description "My local buffer" |
9669 | | - format rfc3164 |
| 9669 | + format rfc5424 |
9670 | 9670 | maxlen 1200 |
9671 | 9671 | size 32764 |
9672 | 9672 | timeout connect 5s |
@@ -21347,15 +21347,20 @@ <h2 id="chapter-5.2" data-target="5.2"><small><a class="small" href="#5.2">5.2.< |
21347 | 21347 | instances on the fly. This option defaults to "last,libc" indicating that the |
21348 | 21348 | previous address found in the state file (if any) is used first, otherwise |
21349 | 21349 | the libc's resolver is used. This ensures continued compatibility with the |
21350 | | -historic behavior. |
21351 | | -</pre><div class="separator"> |
21352 | | -<span class="label label-success">Example:</span> |
21353 | | -<pre class="prettyprint"> |
21354 | | -<code>defaults |
21355 | | - <span class="comment"># never fail on address resolution</span> |
21356 | | - default-server init-addr last,libc,none |
21357 | | -</code></pre> |
21358 | | -</div><a class="anchor" name="inter"></a><a class="anchor" name="5-inter"></a><a class="anchor" name="5.2-inter"></a><a class="anchor" name="inter (Bind and server options)"></a><a class="anchor" name="inter (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="inter"></a><a href="#5.2-inter">inter</a></b> <span style="color: #080"><delay></span></div><a class="anchor" name="fastinter"></a><a class="anchor" name="5-fastinter"></a><a class="anchor" name="5.2-fastinter"></a><a class="anchor" name="fastinter (Bind and server options)"></a><a class="anchor" name="fastinter (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="fastinter"></a><a href="#5.2-fastinter">fastinter</a></b> <span style="color: #080"><delay></span></div><a class="anchor" name="downinter"></a><a class="anchor" name="5-downinter"></a><a class="anchor" name="5.2-downinter"></a><a class="anchor" name="downinter (Bind and server options)"></a><a class="anchor" name="downinter (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="downinter"></a><a href="#5.2-downinter">downinter</a></b> <span style="color: #080"><delay></span></div><pre class="text">May be used in the following contexts: tcp, http, log |
| 21350 | +historic behavior. When using internal resolvers, it is generally recommended |
| 21351 | +to either disable libc-based resolution, or make it explicit (see <a href="#5.3">section 5.3</a> |
| 21352 | +for more details). |
| 21353 | + |
| 21354 | +Example 1: |
| 21355 | + defaults |
| 21356 | + # never fail on address resolution |
| 21357 | + default-server init-addr last,libc,none |
| 21358 | + |
| 21359 | +Example 2: |
| 21360 | + defaults |
| 21361 | + # disable libc resolution in combination with resolvers |
| 21362 | + default-server init-addr last,none |
| 21363 | +</pre><a class="anchor" name="inter"></a><a class="anchor" name="5-inter"></a><a class="anchor" name="5.2-inter"></a><a class="anchor" name="inter (Bind and server options)"></a><a class="anchor" name="inter (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="inter"></a><a href="#5.2-inter">inter</a></b> <span style="color: #080"><delay></span></div><a class="anchor" name="fastinter"></a><a class="anchor" name="5-fastinter"></a><a class="anchor" name="5.2-fastinter"></a><a class="anchor" name="fastinter (Bind and server options)"></a><a class="anchor" name="fastinter (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="fastinter"></a><a href="#5.2-fastinter">fastinter</a></b> <span style="color: #080"><delay></span></div><a class="anchor" name="downinter"></a><a class="anchor" name="5-downinter"></a><a class="anchor" name="5.2-downinter"></a><a class="anchor" name="downinter (Bind and server options)"></a><a class="anchor" name="downinter (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="downinter"></a><a href="#5.2-downinter">downinter</a></b> <span style="color: #080"><delay></span></div><pre class="text">May be used in the following contexts: tcp, http, log |
21359 | 21364 |
|
21360 | 21365 | The "<a href="#inter">inter</a>" parameter sets the interval between two consecutive health checks |
21361 | 21366 | to <delay> milliseconds. If left unspecified, the delay defaults to 2000 ms. |
@@ -21828,13 +21833,16 @@ <h2 id="chapter-5.2" data-target="5.2"><small><a class="small" href="#5.2">5.2.< |
21828 | 21833 | </div><a class="anchor" name="resolvers"></a><a class="anchor" name="5-resolvers"></a><a class="anchor" name="5.2-resolvers"></a><a class="anchor" name="resolvers (Bind and server options)"></a><a class="anchor" name="resolvers (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="resolvers"></a><a href="#5.2-resolvers">resolvers</a></b> <span style="color: #080"><id></span></div><pre class="text">May be used in the following contexts: tcp, http, log |
21829 | 21834 |
|
21830 | 21835 | Points to an existing "<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">resolvers<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#resolvers%20%28Server%20and%20default-server%20options%29">Server and default-server options</a></li><li><a href="#resolvers%20%28The%20resolvers%20section%29">The resolvers section</a></li></ul></span>" section to resolve current server's |
21831 | | -hostname. |
| 21836 | +hostname. It is often recommended to disable libc-based resolution when using |
| 21837 | +resolvers, though exceptions exist (see <a href="#5.3.1">section 5.3.1</a>). In any case it is a |
| 21838 | +good practice to explicitly specify "<a href="#init-addr">init-addr</a>" when using resolvers in order |
| 21839 | +not to overlook this element. |
21832 | 21840 | </pre><div class="separator"> |
21833 | 21841 | <span class="label label-success">Example:</span> |
21834 | 21842 | <pre class="prettyprint"> |
21835 | | -<code>server s1 app1.domain.com:80 check resolvers mydns |
| 21843 | +<code>server s1 app1.domain.com:80 init-addr last,none check resolvers mydns |
21836 | 21844 | </code></pre> |
21837 | | -</div><pre class="text">See also <a href="#5.3">section 5.3</a> |
| 21845 | +</div><pre class="text">See also <a href="#5.3">section 5.3</a> for implementation details and traps to be aware of. |
21838 | 21846 | </pre><a class="anchor" name="send-proxy"></a><a class="anchor" name="5-send-proxy"></a><a class="anchor" name="5.2-send-proxy"></a><a class="anchor" name="send-proxy (Bind and server options)"></a><a class="anchor" name="send-proxy (Server and default-server options)"></a><div class="keyword"><b><a class="anchor" name="send-proxy"></a><a href="#5.2-send-proxy">send-proxy</a></b></div><pre class="text">May be used in the following contexts: tcp, http |
21839 | 21847 |
|
21840 | 21848 | The "<a href="#send-proxy">send-proxy</a>" parameter enforces use of the PROXY protocol over any |
@@ -22157,10 +22165,13 @@ <h2 id="chapter-5.3" data-target="5.3"><small><a class="small" href="#5.3">5.3.< |
22157 | 22165 | This is not sufficient in some cases, such as in Amazon where a server's IP |
22158 | 22166 | can change after a reboot or an ELB Virtual IP can change based on current |
22159 | 22167 | workload. |
| 22168 | + |
22160 | 22169 | This chapter describes how HAProxy can be configured to process server's name |
22161 | 22170 | resolution at run time. |
22162 | | -Whether run time server name resolution has been enable or not, HAProxy will |
22163 | | -carry on doing the first resolution when parsing the configuration. |
| 22171 | + |
| 22172 | +Whether run time server name resolution has been enable or not, by default |
| 22173 | +HAProxy will do the first resolution at startup during configuration parsing |
| 22174 | +via libc unless disabled by the "<a href="#init-addr">init-addr</a>" parameter. |
22164 | 22175 | </pre></div> |
22165 | 22176 | <a class="anchor" id="5.3.1" name="5.3.1"></a> |
22166 | 22177 | <h3 id="chapter-5.3.1" data-target="5.3.1"><small><a class="small" href="#5.3.1">5.3.1.</a></small> Global overview</h3> |
@@ -22192,6 +22203,17 @@ <h3 id="chapter-5.3.1" data-target="5.3.1"><small><a class="small" href="#5.3.1" |
22192 | 22203 |
|
22193 | 22204 | - a resolution is considered as invalid (NX, timeout, refused), when all the |
22194 | 22205 | servers return an error. |
| 22206 | + |
| 22207 | + - The DNS client implemented in HAProxy is very basic and will not understand |
| 22208 | + the vast number of options and advanced setups that an operating system's |
| 22209 | + resolver can deal with. As such, except for really trivial setups where a |
| 22210 | + server known by its FQDN only has exactly one IP address at a time and |
| 22211 | + might occasionally renew it (e.g. a reboot), it is highly recommended to |
| 22212 | + avoid mixing libc-based init-time resolution with DNS-based runtime |
| 22213 | + resolution, as such setups are known to cause failures upon address |
| 22214 | + renewal. As a conclusion, unless you know exactly what you are doing, you |
| 22215 | + should always exclude "libc" from "<a href="#init-addr">init-addr</a>" when using "<span class="dropdown"><a class="dropdown-toggle" data-toggle="dropdown" href="#">resolvers<span class="caret"></span></a><ul class="dropdown-menu"><li class="dropdown-header">This keyword is available in sections :</li><li><a href="#resolvers%20%28Server%20and%20default-server%20options%29">Server and default-server options</a></li><li><a href="#resolvers%20%28The%20resolvers%20section%29">The resolvers section</a></li></ul></span>" on a |
| 22216 | + server line. |
22195 | 22217 | </pre></div> |
22196 | 22218 | <a class="anchor" id="5.3.2" name="5.3.2"></a> |
22197 | 22219 | <h3 id="chapter-5.3.2" data-target="5.3.2"><small><a class="small" href="#5.3.2">5.3.2.</a></small> The resolvers section</h3> |
@@ -22318,6 +22340,8 @@ <h3 id="chapter-5.3.2" data-target="5.3.2"><small><a class="small" href="#5.3.2" |
22318 | 22340 | valid status from the DNS server. |
22319 | 22341 |
|
22320 | 22342 | A separate behavior exists for "hold valid" and "hold obsolete". |
| 22343 | + |
| 22344 | +Default value is 10s for "valid", 0s for "obsolete" and 30s for others. |
22321 | 22345 | </pre><a class="anchor" name="resolve_retries"></a><a class="anchor" name="5-resolve_retries"></a><a class="anchor" name="5.3.2-resolve_retries"></a><a class="anchor" name="resolve_retries (Bind and server options)"></a><a class="anchor" name="resolve_retries (The resolvers section)"></a><div class="keyword"><b><a class="anchor" name="resolve_retries"></a><a href="#5.3.2-resolve_retries">resolve_retries</a></b> <span style="color: #080"><nb></span></div><pre class="text">Defines the number <nb> of queries to send to resolve a server name before |
22322 | 22346 | giving up. |
22323 | 22347 | Default value: 3 |
@@ -30753,7 +30777,7 @@ <h2 id="chapter-11.3" data-target="11.3"><small><a class="small" href="#11.3">11 |
30753 | 30777 | <br> |
30754 | 30778 | <hr> |
30755 | 30779 | <div class="text-right"> |
30756 | | - HAProxy 3.0.10-1 – Configuration Manual<br> |
| 30780 | + HAProxy 3.0.10-32 – Configuration Manual<br> |
30757 | 30781 | <small>, 2025/04/22</small> |
30758 | 30782 | </div> |
30759 | 30783 | </div> |
|
0 commit comments