| <!DOCTYPE html SYSTEM "about:legacy-compat"> |
| <html lang="pt-br"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <meta content="width=device-width, initial-scale=1" name="viewport"> |
| <!-- |
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| This file is generated from xml source: DO NOT EDIT |
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| --> |
| <title>Vinculando a Endereços e Portas - Servidor HTTP Apache Versão 2.4</title> |
| <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet"> |
| <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size"> |
| <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css"> |
| <script src="./style/scripts/prettify.min.js"> |
| </script> |
| |
| <link href="./images/favicon.png" rel="shortcut icon"></head> |
| <body id="manual-page"><div id="page-header"> |
| <p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/quickreference.html">Diretivas</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Perguntas Frequentes</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do Site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Relate um problema</a></p> |
| <p class="apache">Servidor HTTP Apache Versão 2.4</p> |
| <img alt="" src="./images/feather.png"></div> |
| <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif"></a></div> |
| <div id="path"> |
| <a href="https://www.apache.org/">Apache</a> > <a href="https://httpd.apache.org/">Servidor HTTP</a> > <a href="https://httpd.apache.org/docs/">Documentação</a> > <a href="./">Versão 2.4</a></div><div id="page-content"><div id="preamble"><h1>Vinculando a Endereços e Portas</h1> |
| <button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button> |
| <div class="toplang"> |
| <p><span>Línguas Disponíveis: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | |
| <a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> | |
| <a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | |
| <a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | |
| <a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | |
| <a href="./pt-br/bind.html" title="Português (Brasil)"> pt-br </a> | |
| <a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> |
| </div> |
| |
| <p>Configurando o Servidor HTTP Apache para escutar em endereços e portas específicas.</p> |
| </div> |
| <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif"> <a href="#overview">Visão Geral</a></li> |
| <li><img alt="" src="./images/down.gif"> <a href="#reload">Alterando a configuração de Listen no reinício</a></li> |
| <li><img alt="" src="./images/down.gif"> <a href="#ipv6">Considerações Especiais sobre IPv6</a></li> |
| <li><img alt="" src="./images/down.gif"> <a href="#protocol">Especificando o protocolo com Listen</a></li> |
| <li><img alt="" src="./images/down.gif"> <a href="#virtualhost">Como Isto Funciona com Hosts Virtuais</a></li> |
| </ul><h3>Veja também</h3><ul class="seealso"><li><a href="vhosts/">Hosts Virtuais</a></li><li><a href="dns-caveats.html">Problemas com DNS</a></li></ul></div> |
| <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div> |
| <div class="section"> |
| <h2 id="overview">Visão Geral <a title="Link permanente" href="#overview" class="permalink">¶</a></h2> |
| |
| |
| <table class="related"><tr><th>Módulos Relacionados</th><th>Diretrizes Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table> |
| |
| |
| <p>Quando o httpd inicia, ele se vincula a algumas portas e endereços na |
| máquina local e aguarda por requisições entrantes. Por padrão, |
| ele monitora todos os endereços na máquina. No entanto, pode ser necessário |
| monitoramento em portas específicas ou somente em |
| endereços selecionados, ou uma combinação dos dois. Isto é muitas vezes combinado com |
| o recurso de <a href="vhosts/">Host Virtual</a>, que determina como o |
| <code>httpd</code> responde a endereços, nomes de hosts e portas |
| diferentes.</p> |
| |
| <p>A diretiva <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> |
| informa ao servidor que ele deve aceitar |
| requisições entrantes apenas na(s) porta(s) especificada(s) ou |
| em combinações de endereço e porta. Se apenas um número de porta for |
| especificado na diretiva <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, |
| o servidor monitora a porta informada em todas as interfaces. |
| Se um endereço IP é informado junto com uma porta, o servidor irá monitorar |
| na porta e na interface especificadas. Múltiplas diretivas <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> podem ser usadas para |
| especificar vários endereços e portas para monitoramento. O |
| servidor responderá a requisições de quaisquer dos endereços e |
| portas listados.</p> |
| |
| <p>Por exemplo, para que o servidor aceite conexões tanto na |
| porta 80 quanto na 8000, em todas as interfaces, use:</p> |
| |
| <div class="example"><pre class="prettyprint lang-config">Listen 80 |
| Listen 8000</pre> |
| </div> |
| |
| <p>Para que o servidor aceite conexões na porta 80 para uma interface |
| e na porta 8000 para outra, use:</p> |
| |
| <div class="example"><pre class="prettyprint lang-config">Listen 192.0.2.1:80 |
| Listen 192.0.2.5:8000</pre> |
| </div> |
| |
| <p>Endereços IPv6 precisam ser envolvidos por colchetes, como no |
| exemplo a seguir:</p> |
| |
| <div class="example"><pre class="prettyprint lang-config">Listen [2001:db8::a00:20ff:fea7:ccea]:80</pre> |
| </div> |
| |
| <div class="warning"><p>A sobreposição de diretivas <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> resultará em um |
| erro fatal que irá impedir o servidor de iniciar.</p> |
| |
| <div class="example"><p><code> |
| (48)Address already in use: make_sock: could not bind to address [::]:80 |
| </code></p></div> |
| |
| <p>Consulte esta <a href="https://cwiki.apache.org/confluence/display/httpd/CouldNotBindToAddress">discussão |
| na wiki</a> para mais dicas de soluções de problemas.</p> |
| |
| </div> |
| |
| </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div> |
| <div class="section"> |
| <h2 id="reload">Alterando a configuração de Listen no reinício <a title="Link permanente" href="#reload" class="permalink">¶</a></h2> |
| |
| |
| <p>Quando o httpd é reiniciado, uma consideração especial precisa ser feita para |
| alterações a diretivas <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>. Durante um reinício, o httpd mantém as portas |
| vinculadas (como na configuração original) para evitar a geração de erros |
| "Connection refused" (conexão recusada) para quaisquer novas tentativas de conexão |
| ao servidor. Se as alterações são feitas no conjunto de diretivas <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> |
| que conflitam com a configuração antiga, a configuração irá falhar |
| e o servidor irá terminar.</p> |
| |
| <p>Por exemplo, alterando da configuração:</p> |
| |
| <div class="example"><pre class="prettyprint lang-config">Listen 127.0.0.1:80</pre> |
| </div> |
| |
| <p>para a configuração a seguir pode falhar, porque a vinculação da porta 80 para |
| todos os endereços conflita com a vinculação da porta 80 somente para |
| 127.0.0.1.</p> |
| |
| <div class="example"><pre class="prettyprint lang-config">Listen 80</pre> |
| </div> |
| |
| <p>Para que tal configuração tenha efeito, é necessário |
| parar e depois iniciar o servidor.</p> |
| |
| </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div> |
| <div class="section"> |
| <h2 id="ipv6">Considerações Especiais sobre IPv6 <a title="Link permanente" href="#ipv6" class="permalink">¶</a></h2> |
| |
| |
| <p>Um número crescente de plataformas implementa IPv6 e o |
| <a class="glossarylink" href="./glossary.html#apr" title="ver glossário">APR</a> suporta IPv6 na maioria delas, |
| permitindo que o httpd aloque soquetes IPv6 e manipule requisições enviadas |
| através de IPv6.</p> |
| |
| <p>Um fator complicador para administradores de httpd é definir se |
| um soquete IPv6 pode lidar tanto com conexões IPv4 quanto com |
| IPv6. Lidar com conexões IPv4 com soquete IPv6 usa |
| endereços IPv6 mapeados para IPv4, o que é permitido por padrão na maioria |
| das plataformas mas é proibido por padrão no FreeBSD, NetBSD e |
| OpenBSD, para alinhamento com a política de sistema dessas |
| plataformas. Em sistemas onde isso é proibido por padrão, um |
| parâmetro especial do programa <code class="program"><a href="./programs/configure.html">configure</a></code> pode alterar este |
| comportamento para o httpd.</p> |
| |
| <p>Por outro lado, em algumas plataformas como Linux e Tru64, a |
| <strong>única</strong> forma de lidar tanto com IPv6 quanto com IPv4 é usar |
| endereços mapeados. Se o <code>httpd</code> tiver que lidar com conexões IPv4 e IPv6 |
| com um mínimo de soquetes, que requerem o uso de endereços IPv6 mapeados |
| para IPv4, especifique a opção <code>--enable-v4-mapped</code> do programa <code class="program"><a href="./programs/configure.html">configure</a></code>.</p> |
| |
| <p><code>--enable-v4-mapped</code> é o padrão para todas as plataformas exceto |
| para FreeBSD, NetBSD e OpenBSD, portanto esta é provavelmente a forma como o seu httpd foi |
| compilado.</p> |
| |
| <p>Se o httpd tiver que lidar somente com conexões IPv4, independente do que |
| a sua plataforma e APR irão suportar, especifique um endereço IPv4 em todas as |
| diretivas <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, como nos |
| exemplos a seguir:</p> |
| |
| <div class="example"><pre class="prettyprint lang-config">Listen 0.0.0.0:80 |
| Listen 192.0.2.1:80</pre> |
| </div> |
| |
| <p>Se a sua plataforma suporta e a intenção for lidar com conexões IPv4 e |
| IPv6 em soquetes separados (ou seja, desabilitar endereços mapeados |
| para IPv4), especifique a opção <code>--disable-v4-mapped</code> do programa <code class="program"><a href="./programs/configure.html">configure</a></code>. <code>--disable-v4-mapped</code> é o padrão |
| no FreeBSD, NetBSD, e OpenBSD.</p> |
| </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div> |
| <div class="section"> |
| <h2 id="protocol">Especificando o protocolo com Listen <a title="Link permanente" href="#protocol" class="permalink">¶</a></h2> |
| |
| <p>O segundo argumento opcional <var>protocol</var> de |
| <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> |
| não é requerido para a maioria das |
| configurações. Se não especificado, <code>https</code> é o padrão para |
| a porta 443 e <code>http</code> é o padrão para todas as outras portas. O |
| protocolo é usado para determinar que módulo deve lidar com uma requisição e |
| para aplicar otimizações de protocolo específicas com a diretiva |
| <code class="directive"><a href="./mod/core.html#acceptfilter">AcceptFilter</a></code>.</p> |
| |
| <p>Somente é necessário definir o protocolo se o servidor estiver monitorando |
| portas não padrão. Por exemplo, para servir um site <code>https</code> na porta 8443:</p> |
| |
| <div class="example"><pre class="prettyprint lang-config">Listen 192.170.2.1:8443 https</pre> |
| </div> |
| </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div> |
| <div class="section"> |
| <h2 id="virtualhost">Como Isto Funciona com Hosts Virtuais <a title="Link permanente" href="#virtualhost" class="permalink">¶</a></h2> |
| |
| |
| <p>A diretiva <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> não implementa |
| Hosts Virtuais - ela apenas informa ao |
| servidor principal quais endereços e portas devem ser monitorados. Se nenhuma |
| diretiva <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> |
| for usada, o servidor se comportará |
| da mesma forma para todas as requisições aceitas. Entretanto, |
| <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> |
| pode ser usada para especificar um comportamento diferente |
| para um ou mais dos enredeços e portas. Para implementar um |
| Host Virtual, o servidor primeiro precisa ser informado para monitorar o |
| endereço e a porta que serão usados. Depois, uma |
| seção <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> |
| deve ser criada para o endereço e a porta especificados para definir o |
| comportamento desse host virtual. Observe que se a seção |
| <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> |
| estiver definida para um endereço e uma porta que o |
| servidor não estiver monitorando, o host virutal não poderá ser acessado.</p> |
| </div></div> |
| <div class="bottomlang"> |
| <p><span>Línguas Disponíveis: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | |
| <a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> | |
| <a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | |
| <a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | |
| <a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | |
| <a href="./pt-br/bind.html" title="Português (Brasil)"> pt-br </a> | |
| <a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> |
| </div><div id="footer"> |
| <p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licenciado sob a <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> |
| <p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/quickreference.html">Diretivas</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Perguntas Frequentes</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do Site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Relate um problema</a></p></div><script><!--//--><![CDATA[//><!-- |
| if (typeof(prettyPrint) !== 'undefined') { |
| prettyPrint(); |
| } |
| var langToggle = document.querySelector('.lang-toggle'); |
| var topLang = document.querySelector('.toplang'); |
| if (langToggle && topLang) { |
| langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); }); |
| } |
| var qv = document.getElementById('quickview'); |
| if (qv) { |
| document.body.appendChild(qv); |
| var qvBtn = document.createElement('button'); |
| qvBtn.className = 'qv-toggle'; |
| qvBtn.setAttribute('aria-label', 'Toggle page navigation'); |
| qvBtn.innerHTML = '☰'; |
| document.body.appendChild(qvBtn); |
| qvBtn.addEventListener('click', function() { |
| var isOpen = qv.classList.toggle('open'); |
| if (isOpen) { |
| qv.style.top = window.scrollY + 10 + 'px'; |
| } |
| }); |
| window.addEventListener('scroll', function() { qv.classList.remove('open'); }); |
| } |
| //--><!]]></script> |
| </body></html> |
