blob: bf9c7c87ba0aed209167041b4b352887b1a93b7e [file]
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="es"><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>Hosts virtuales masivos din&aacute;micos con mod_rewrite - Servidor HTTP Apache Versi&oacute;n 2.5</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&oacute;dulos</a> | <a href="../mod/quickreference.html">Directivas</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Reportar un error</a></p>
<p class="apache">Versi&oacute;n 2.5 del Servidor HTTP Apache</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> &gt; <a href="https://httpd.apache.org/">Servidor HTTP</a> &gt; <a href="https://httpd.apache.org/docs/">Documentaci&oacute;n</a> &gt; <a href="../">Versi&oacute;n 2.5</a> &gt; <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Hosts virtuales masivos din&aacute;micos con mod_rewrite</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>Idiomas disponibles: </span><a href="../de/rewrite/vhosts.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/rewrite/vhosts.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/rewrite/vhosts.html" title="Espa&ntilde;ol">&nbsp;es&nbsp;</a> |
<a href="../fr/rewrite/vhosts.html" hreflang="fr" rel="alternate" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="../ja/rewrite/vhosts.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/rewrite/vhosts.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../tr/rewrite/vhosts.html" hreflang="tr" rel="alternate" title="T&uuml;rk&ccedil;e">&nbsp;tr&nbsp;</a> |
<a href="../zh-cn/rewrite/vhosts.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
</div>
<div class="outofdate">Esta traducci&oacute;n podr&iacute;a estar
obsoleta. Consulte la versi&oacute;n en ingl&eacute;s de la
documentaci&oacute;n para comprobar si se han producido cambios
recientemente.</div>
<p>Este documento complementa la <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">documentaci&oacute;n de referencia</a>. Describe
c&oacute;mo puede usar <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> para crear hosts virtuales
configurados din&aacute;micamente.</p>
<div class="warning"><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> generalmente no es la mejor forma de configurar
hosts virtuales. Deber&iacute;a considerar primero las <a href="../vhosts/mass.html">alternativas</a> antes de recurrir a
mod_rewrite. Vea tambi&eacute;n el documento "<a href="avoid.html#vhosts">c&oacute;mo evitar
mod_rewrite</a>".</div>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif"> <a href="#per-hostname">Hosts Virtuales para Nombres de Host Arbitrarios</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#simple.rewrite">Hosts Virtuales
Din&aacute;micos Usando <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></a></li>
<li><img alt="" src="../images/down.gif"> <a href="#xtra-conf">Usando un Archivo de Configuraci&oacute;n de Host Virtual Separado</a></li>
</ul><h3>Consulte tambi&eacute;n</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentaci&oacute;n del m&oacute;dulo</a></li><li><a href="intro.html">Introducci&oacute;n a mod_rewrite</a></li><li><a href="remapping.html">Redirecci&oacute;n y remapeo</a></li><li><a href="access.html">Control de acceso</a></li><li><a href="proxy.html">Proxy</a></li><li><a href="rewritemap.html">RewriteMap</a></li><li><a href="advanced.html">T&eacute;cnicas avanzadas</a></li><li><a href="avoid.html">Cu&aacute;ndo no usar mod_rewrite</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="per-hostname">Hosts Virtuales para Nombres de Host Arbitrarios <a title="Enlace permanente" href="#per-hostname" class="permalink">&para;</a></h2>
<dl>
<dt>Descripci&oacute;n:</dt>
<dd>
<p>Queremos crear autom&aacute;ticamente un host virtual para cada nombre de host
que resuelva en nuestro dominio, sin tener que crear
nuevas secciones VirtualHost.</p>
<p>En esta receta, asumimos que usaremos el nombre de host
<code><strong>SITIO</strong>.example.com</code> para cada
usuario, y serviremos su contenido desde
<code>/home/<strong>SITIO</strong>/www</code>. Sin embargo, queremos
que <code>www.example.com</code> sea omitido de este mapeo.</p>
</dd>
<dt>Soluci&oacute;n:</dt>
<dd>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap lowercase int:tolower
RewriteCond %{HTTP_HOST} !^www\.
RewriteCond ${lowercase:%{<strong>HTTP_HOST</strong>}} ^<strong>([^.]+)</strong>\.example\.com$
RewriteRule ^(.*) /home/<strong>%1</strong>/www$1</pre>
</dd>
<dt>Discusi&oacute;n</dt>
<dd>
<div class="warning">Necesitar&aacute; encargarse de la resoluci&oacute;n DNS
- Apache no maneja la resoluci&oacute;n de nombres. Necesitar&aacute; crear registros CNAME
para cada nombre de host, o un registro DNS comod&iacute;n. La creaci&oacute;n de registros DNS
est&aacute; fuera del alcance de este documento.</div>
<p>La directiva interna <code>tolower</code> de RewriteMap se usa para
asegurar que los nombres de host que se usen est&eacute;n todos en min&uacute;sculas, de modo que no haya
ambig&uuml;edad en la estructura de directorios que debe crearse.</p>
<p>Los par&eacute;ntesis usados en una <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> se capturan en las
referencias inversas <code>%1</code>, <code>%2</code>, etc, mientras que los par&eacute;ntesis
usados en <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> se
capturan en las referencias inversas <code>$1</code>, <code>$2</code>,
etc.</p>
<p>La primera <code>RewriteCond</code> verifica si el nombre de host
comienza con <code>www.</code>, y si es as&iacute;, la reescritura se
omite.</p>
<p>
Como con muchas t&eacute;cnicas discutidas en este documento, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> realmente
no es la mejor forma de lograr esta tarea. Deber&iacute;a, en su lugar,
considerar usar <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>, ya que manejar&aacute;
mucho m&aacute;s elegantemente cualquier cosa m&aacute;s all&aacute; de servir archivos est&aacute;ticos, como cualquier
contenido din&aacute;mico, y resoluci&oacute;n de Alias.
</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="simple.rewrite">Hosts Virtuales
Din&aacute;micos Usando <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> <a title="Enlace permanente" href="#simple.rewrite" class="permalink">&para;</a></h2>
<p>Este extracto de <code>httpd.conf</code> hace lo mismo
que <a href="#per-hostname">el primer ejemplo</a>. La primera
mitad es muy similar a la parte correspondiente anterior, excepto por
algunos cambios, necesarios para compatibilidad hacia atr&aacute;s y para hacer que la
parte de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> funcione correctamente; la segunda mitad
configura <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> para hacer el trabajo real.</p>
<p>Debido a que <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> se ejecuta antes que otros m&oacute;dulos de traducci&oacute;n
de URI (por ejemplo, <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>), se le debe decir a <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
que ignore expl&iacute;citamente cualquier URL que hubiera sido manejada
por esos m&oacute;dulos. Y, debido a que estas reglas de lo contrario evitar&iacute;an
cualquier directiva <code>ScriptAlias</code>, debemos hacer que
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ejecute expl&iacute;citamente esos mapeos.</p>
<pre class="prettyprint lang-config"># get the server name from the Host: header
UseCanonicalName Off
# splittable logs
LogFormat "%{Host}i %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
&lt;Directory "/www/hosts"&gt;
# ExecCGI is needed here because we can't force
# CGI execution in the way that ScriptAlias does
Options FollowSymLinks ExecCGI
&lt;/Directory&gt;
RewriteEngine On
# a ServerName derived from a Host: header may be any case at all
RewriteMap lowercase "int:tolower"
## deal with normal documents first:
# allow Alias /icons/ to work - repeat for other aliases
RewriteCond "%{REQUEST_URI}" "!^/icons/"
# allow CGIs to work
RewriteCond "%{REQUEST_URI}" "!^/cgi-bin/"
# do the magic
RewriteRule "^/(.*)$" "/www/hosts/${lowercase:%{SERVER_NAME}}/docs/$1"
## and now deal with CGIs - we have to force a handler
RewriteCond "%{REQUEST_URI}" "^/cgi-bin/"
RewriteRule "^/(.*)$" "/www/hosts/${lowercase:%{SERVER_NAME}}/cgi-bin/$1" [H=cgi-script]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="xtra-conf">Usando un Archivo de Configuraci&oacute;n de Host Virtual Separado <a title="Enlace permanente" href="#xtra-conf" class="permalink">&para;</a></h2>
<p>Este arreglo usa caracter&iacute;sticas m&aacute;s avanzadas de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
para determinar la traducci&oacute;n de host virtual a ra&iacute;z de documento,
desde un archivo de configuraci&oacute;n separado. Esto proporciona m&aacute;s
flexibilidad, pero requiere una configuraci&oacute;n m&aacute;s complicada.</p>
<p>El archivo <code>vhost.map</code> deber&iacute;a verse algo como
esto:</p>
<div class="example"><p><code>
customer-1.example.com /www/customers/1<br>
customer-2.example.com /www/customers/2<br>
# ...<br>
customer-N.example.com /www/customers/N<br>
</code></p></div>
<p>El <code>httpd.conf</code> deber&iacute;a contener lo siguiente:</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap lowercase "int:tolower"
# define the map file
RewriteMap vhost "txt:/www/conf/vhost.map"
# deal with aliases as above
RewriteCond "%{REQUEST_URI}" "!^/icons/"
RewriteCond "%{REQUEST_URI}" "!^/cgi-bin/"
RewriteCond "${lowercase:%{SERVER_NAME}}" "^(.+)$"
# this does the file-based remap
RewriteCond "${vhost:%1}" "^(/.*)$"
RewriteRule "^/(.*)$" "%1/docs/$1"
RewriteCond "%{REQUEST_URI}" "^/cgi-bin/"
RewriteCond "${lowercase:%{SERVER_NAME}}" "^(.+)$"
RewriteCond "${vhost:%1}" "^(/.*)$"
RewriteRule "^/cgi-bin/(.*)$" "%1/cgi-bin/$1" [H=cgi-script]</pre>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../de/rewrite/vhosts.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/rewrite/vhosts.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/rewrite/vhosts.html" title="Espa&ntilde;ol">&nbsp;es&nbsp;</a> |
<a href="../fr/rewrite/vhosts.html" hreflang="fr" rel="alternate" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="../ja/rewrite/vhosts.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/rewrite/vhosts.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../tr/rewrite/vhosts.html" hreflang="tr" rel="alternate" title="T&uuml;rk&ccedil;e">&nbsp;tr&nbsp;</a> |
<a href="../zh-cn/rewrite/vhosts.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licencia bajo los t&eacute;rminos de la <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">M&oacute;dulos</a> | <a href="../mod/quickreference.html">Directivas</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Reportar un error</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 = '&#9776;';
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>