Configura el alojamiento de subrutas con Caddy.

Puedes usar Caddy para servir tu centro de ayuda Notiondesk desde una subruta de tu dominio principal.

Por ejemplo, en lugar de usar un subdominio como help.yourdomain.com, puede hacer que su centro de ayuda esté disponible desde:

yourdomain.com/help

yourdomain.com/docs

yourdomain.com/support

Esta configuración resulta útil si su sitio web principal está alojado en un servidor donde Caddy ya se utiliza como servidor web o proxy inverso.

Antes de empezar

Antes de configurar el alojamiento de subrutas con Caddy, asegúrese de tener lo siguiente:

Acceso a su servidor

Acceso a tu archivo Caddyfile

Una subruta que quieras usar para tu centro de ayuda, como por ejemplo:
- __CONSERVADO_19__
- __CONSERVADO_18__
- __CONSERVADO_17__

También debe asegurarse de que su sitio web principal ya funcione correctamente antes de agregar la configuración de subruta Notiondesk.

Habilitar el alojamiento de subrutas en Notiondesk

Primero, habilite el alojamiento de subrutas desde su panel de control Notiondesk.

Abra su panel de control Notiondesk

Ir a __PRESERVADO_16__

Desplácese hasta la sección Domains

Habilitar el interruptor Subpath

Guardar cambios

Copie la configuración de Caddy generada.

Notiondesk genera una configuración de Caddy con los valores correctos para tu centro de ayuda. Deberás agregar esta configuración a tu archivo Caddyfile en el siguiente paso.

Agregar la configuración de Caddy

Después de copiar la configuración de Notiondesk, agréguela a su archivo Caddyfile.

Abra el bloque de sitio de Caddy que gestiona el dominio principal de su sitio web.

Por ejemplo:

Agregue la ruta generada Notiondesk dentro de este bloque de sitio.

La configuración debe contemplar:

yourdomain.com {
    # Your main website configuration
}

La subruta del centro de ayuda que ha seleccionado, como por ejemplo /help

Páginas de centro de ayuda anidadas, como /help/*

Rutas internas como Notiondesk, tales como /_nd/*

El resto de las rutas deben seguir siendo gestionadas por su sitio web principal.

Por ejemplo, si su centro de ayuda utiliza /help, solo /help, /help/* y /_nd/* deben ser redirigidos a Notiondesk.

Ejemplo de proxy inverso de Caddy

Aquí hay un ejemplo de configuración de Caddy para un centro de ayuda atendido desde /help.

Debe copiar la configuración generada desde su propio panel de control Notiondesk. El dominio del centro de ayuda, la subruta y los valores del proxy son específicos de su configuración.

Recargar Caddy

Tras añadir la configuración a tu archivo Caddyfile, reinicia Caddy para aplicar los cambios.

El comando exacto depende de la configuración de su servidor. Si Caddy se gestiona con systemd, normalmente puede recargarlo con:

Antes de recargar, también puede validar su archivo Caddyfile:

Si la validación se realiza correctamente, recargue Caddy y pruebe la subruta de su centro de ayuda.

Verifica tu configuración

Después de recargar Caddy, abre la subcarpeta del centro de ayuda en tu navegador.

A continuación, prueba algunas páginas para asegurarte de que todo funciona correctamente:

route {
    @subpath path /help /help/*
    handle @subpath {
        reverse_proxy your-help-center.notiondesk.help:443 {
            header_up Host {http.request.host}
            header_up X-Forwarded-Host {http.request.host}
            header_up X-Forwarded-Proto https
            header_up X-Site-Path-Prefix /help
            transport http {
                tls
                tls_server_name your-help-center.notiondesk.help
            }
        }
    }

    handle /_nd/* {
        reverse_proxy your-help-center.notiondesk.help:443 {
            header_up Host {http.request.host}
            header_up X-Forwarded-Host {http.request.host}
            header_up X-Forwarded-Proto https
            transport http {
                tls
                tls_server_name your-help-center.notiondesk.help
            }
        }
    }

    # Let your main app handle every other path.
}

sudo systemctl reload caddy

caddy validate

Abra la página principal del centro de ayuda.

Abrir una página de artículo conocida

Abra la página de inicio principal de su sitio web.

Tabla de contenido