--- title: "Apache HTTP server" slug: "apache-http-server" updated: 2026-06-22T08:47:53Z published: 2026-06-22T08:47:53Z canonical: "docs.document360.com/apache-http-server" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # Apache HTTP server Alojar tu base de conocimientos de Document360 en una subcarpeta en Apache, como `example.com/docs`, requiere habilitar módulos de Apache y configurar reglas de proxy y redirección. Este artículo trata sobre cómo habilitar los módulos requeridos, enrutar la página principal, las páginas de artículos y categorías, y la ruta de la API del sitio, la generación de mapas del sitio y la gestión de la redirección de URL para evitar contenido duplicado en los motores de búsqueda. NOTA Sustituye el dominio de ejemplo a lo largo de este artículo por tu propio dominio proporcionado por Document360 o dominio personalizado. Por ejemplo, `example.document360.io` representa tu dominio, `example.document360.io/v1` representa la ruta de una subcarpeta de espacio de trabajo y `example.document360.io/help` representa la ruta de la página principal de una subcarpeta. --- ## Antes de que empieces El alojamiento de subcarpetas solo funciona cuando tanto la **ruta de subcarpeta** (por ejemplo, `/docs` o `/help`) como la **ruta de la API del sitio** (por ejemplo, `/api`) están definidas en Document360, con la configuración correspondiente en tu servidor. Asegúrate de que los siguientes módulos de Apache estén habilitados — estos forman parte de la instalación estándar de Apache: - `proxy` - `proxy_http` - `headers` - `substitute` - `proxy_html` Habilitalos con: ``` sudo a2enmod proxy proxy_http headers substitute proxy_html ``` --- ## Cómo configurar la página principal Configura el siguiente bloque de ubicación del Host Virtual para que proxy las solicitudes de la página principal, donde la ruta comienza con `/help`: ``` ProxyPreserveHost off RequestHeader set Host example.document360.io RequestHeader set requested-by proxy RequestHeader unset Accept-Encoding ProxyPass https://example.document360.io/v1 ProxyPassReverse https://example.document360.io/v1 AddOutputFilterByType SUBSTITUTE text/html substitute 's|href="/docs|href="/help|ni' substitute 's|href="/v1/docs|href="/help|ni' substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni' ``` ### Corrección de enlaces de vista previa de artículos para alojamiento de subcarpetas Los enlaces de vista previa del artículo en el portal Document360 incluyen el espacio de trabajo y el lenguaje en la URL. Por ejemplo, la URL del artículo en activo podría ser `docs.example.com/getting-started`, mientras que el enlace de vista previa del portal es `docs.example.com/v1/en/getting-started`. Puedes añadir un bloque de ubicación para gestionar el `/v1/en` camino, o establecer una redirección desde `/v1/en` a:`/` ``` RewriteEngine on RewriteRule ^v1/en$ / [R=301,L,NC] ``` Esta redirección requiere el `rewrite` módulo: ``` sudo a2enmod rewrite ``` --- ## Cómo configurar páginas de artículos y categorías Añadir los siguientes bloques de ubicación al mismo archivo de configuración de Apache Virtual Host para proxy artículo, categoría y solicitudes de API: ``` ProxyPreserveHost off RequestHeader set Host example.document360.io RequestHeader set requested-by proxy ProxyPass https://example.document360.io/docs/ ProxyPassReverse https://example.document360.io/docs/ AddOutputFilterByType SUBSTITUTE text/html substitute 's|href="/docs|href="/help|ni' substitute 's|href="/v1/docs|href="/help|ni' substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni' ProxyPreserveHost off RequestHeader set Host example.document360.io RequestHeader set requested-by proxy RequestHeader unset Accept-Encoding ProxyPass https://example.document360.io/api ProxyPassReverse https://example.document360.io/api AddOutputFilterByType SUBSTITUTE application/json substitute 's|href="/docs/|href="/help/|ni' substitute 's|href="/v1/docs/|href="/help/|ni' substitute 's|href="https://example.document360.io/docs/|href="https://docs.example.com/help/|ni' ``` Reinicia el servidor Apache una vez configurado: ``` sudo systemctl restart apache2 ``` NOTA Sustituye `/docs` y `/api` con los valores exactos configurados en **ruta de subcarpeta** y **ruta de API del sitio** en el portal Document360. --- ## Cómo configurar la generación de mapas del sitio El prefijo del sitemap se mantiene igual excepto por el código del idioma (en, fr, de, etc.). ``` RequestHeader set Host example.document360.io RequestHeader set requested-by proxy ProxyPass https://example.document360.io/sitemap.xml.en ProxyPassReverse https://example.document360.io/sitemap.xml.en ``` --- ## ¿Qué pasa después? Una vez configurado Apache, tu sitio de la base de conocimientos estará activo en tu subcarpeta personalizada. La URL existente de Document360 sigue atendiendo solicitudes también — por ejemplo, ambas `example.document360.io` y `example.com/docs` apuntará a tu sitio de base de conocimiento. Esto provoca contenido duplicado en motores de búsqueda como Google y Bing. Para evitar contenido duplicado, activa el interruptor **Restringir acceso a subdominio** en Configuración > Sitio de la base de conocimientos > **Dominio personalizado** personalizado > **Alojamiento de subcarpetas**. Asegúrate de que un dominio canónico esté configurado antes de habilitarlo: una vez habilitado, tu subdominio Document360 redirige automáticamente a tu dominio canónico. --- ## Mejores prácticas - Activa los cinco módulos Apache requeridos (`proxy`, `proxy_http`, `headers`, `substitute`, `proxy_html`) antes de configurar los bloques de ubicación, o proxy y reescritura no funcionará. - Mantén la ruta de subcarpetas y la ruta de la API del sitio idénticas entre el portal Document360 y tu configuración de Apache para evitar enrutamientos rotos. - Utiliza las `substitute` reglas de forma constante en la página principal, artículo/categoría y bloques de ubicación de la API para evitar enlaces mixtos `/docs` `/help` y en el sitio en vivo. - Configura la `/v1/en` redirección para los enlaces de vista previa del artículo con antelación, ya que los enlaces de vista previa desajustados pueden causar confusión para los autores de contenido. ## Related - [Servidor Nginx](/nginx-server.md)