bind.html.en revision 330d21e087f40d0b296ae96d6de57c27cba83b99
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd This file is generated from xml source: DO NOT EDIT
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<title>Binding to Addresses and Ports - Apache HTTP Server</title>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<link href="/images/favicon.ico" rel="shortcut icon" /></head>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Binding to Addresses and Ports</h1>
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd<p><span>Available Languages: </span><a href="/de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<a href="/en/bind.html" title="English"> en </a> |
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<a href="/fr/bind.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<a href="/ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<a href="/ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<a href="/tr/bind.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd <p>Configuring Apache HTTP Server to listen on specific addresses and ports.</p>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#overview">Overview</a></li>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<li><img alt="" src="/images/down.gif" /> <a href="#ipv6">Special IPv6 Considerations</a></li>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<li><img alt="" src="/images/down.gif" /> <a href="#protocol">Specifying the protocol with Listen</a></li>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost">How This Works With Virtual Hosts</a></li>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd</ul><h3>See also</h3><ul class="seealso"><li><a href="vhosts/">Virtual Hosts</a></li><li><a href="dns-caveats.html">DNS Issues</a></li></ul></div>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd <table class="related"><tr><th>Related Modules</th><th>Related Directives</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>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd <p>When httpd starts, it binds to some port and address on
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd the local machine and waits for incoming requests. By default,
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd it listens to all addresses on the machine. However, it may need to
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd be told to listen on specific ports, or only on selected
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd addresses, or a combination of both. This is often combined with the
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd <a href="vhosts.html">Virtual Host</a> feature, which determines how
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd <code>httpd</code> responds to different IP addresses, hostnames and
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd ports.</p>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd <p>The <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd directive tells the server to accept
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd incoming requests only on the specified port(s) or
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd address-and-port combinations. If only a port number is
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd specified in the <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd directive, the server listens to the given port on all interfaces.
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd If an IP address is given as well as a port, the server will listen
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd on the given port and interface. Multiple <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code> directives may be used to
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd specify a number of addresses and ports to listen on. The
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd server will respond to requests from any of the listed
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd addresses and ports.</p>
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd <p>For example, to make the server accept connections on both
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd port 80 and port 8000, on all interfaces, use:</p>
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd Listen 80<br />
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd Listen 8000
c82fca6d3f5608b946f18d37e8710b1d71e3478dnd <p>To make the server accept connections on port 80 for one interface,
<div class="warning"><p>Overlapping <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code> directives will result in a
<a class="glossarylink" href="/glossary.html#apr" title="see glossary">APR</a> supports IPv6 on most of these platforms,
special <code class="program"><a href="/programs/configure.html">configure</a></code> parameter can change this behavior
addresses, specify the <code>--enable-v4-mapped</code> <code class="program"><a href="/programs/configure.html">configure</a></code> option.</p>
<code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code> directives, as in the
IPv6 connections on separate sockets (i.e., to disable IPv4-mapped
addresses), specify the <code>--disable-v4-mapped</code> <code class="program"><a href="/programs/configure.html">configure</a></code> option. <code>--disable-v4-mapped</code> is the
<code class="directive"><a href="/mod/core.html#acceptfilter">AcceptFilter</a></code> directive.</p>
<p> The <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code> directive does not implement
<p><span>Available Languages: </span><a href="/de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<p class="apache">Copyright 2011 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div>