Stel subpadhosting in met Caddy

Je kunt Caddy gebruiken om je Notiondesk helpcentrum te hosten vanuit een subpad van je hoofddomein.

In plaats van bijvoorbeeld een subdomein zoals help.yourdomain.com te gebruiken, kunt u uw helpcentrum ook beschikbaar maken via:

yourdomain.com/help

yourdomain.com/docs

yourdomain.com/support

Deze configuratie is handig als uw hoofdwebsite wordt gehost op een server waar Caddy al als webserver of reverse proxy wordt gebruikt.

Voordat je begint

Voordat je subpad-hosting met Caddy instelt, zorg ervoor dat je het volgende hebt:

Toegang tot uw server

Toegang tot uw Caddyfile

Een subpad dat u wilt gebruiken voor uw helpcentrum, bijvoorbeeld:
- __GERESERVEERD_19__
- __GERESERVEERD_18__
- __GERESERVEERD_17__

Zorg er ook voor dat uw hoofdwebsite al correct werkt voordat u de subpadconfiguratie Notiondesk toevoegt.

Schakel subpadhosting in in Notiondesk

Schakel eerst subpadhosting in via uw Notiondesk dashboard.

Open je Notiondesk dashboard

Ga naar __GEVESTIGD_16__

Scroll naar het gedeelte __GEVANGEN_15__

Schakel de Subpath schakelaar in.

Wijzigingen opslaan

Kopieer de gegenereerde Caddy-configuratie.

Notiondesk genereert een Caddy-configuratie met de juiste waarden voor uw helpcentrum. U moet deze configuratie in de volgende stap aan uw Caddyfile toevoegen.

Voeg de Caddy-configuratie toe

Nadat je de configuratie van Notiondesk hebt gekopieerd, voeg je deze toe aan je Caddyfile.

Open het Caddy-siteblok dat uw hoofddomein beheert.

Bijvoorbeeld:

Voeg de gegenereerde route Notiondesk toe binnen dit siteblok.

De configuratie moet het volgende afhandelen:

yourdomain.com {
    # Your main website configuration
}

Het door u geselecteerde subpad van het helpcentrum, bijvoorbeeld /help

Geneste helpcentrumpagina's, zoals /help/*

Notiondesk interne routes, zoals /_nd/*

Alle andere paden moeten via uw hoofdwebsite blijven worden afgehandeld.

Als uw helpcentrum bijvoorbeeld /help gebruikt, moeten alleen /help, /help/* en /_nd/* worden doorgestuurd naar Notiondesk.

Caddy reverse proxy voorbeeld

Hier is een voorbeeld van een Caddy-configuratie voor een helpcentrum dat wordt aangeboden vanuit /help.

Je moet de gegenereerde configuratie kopiëren vanuit je eigen Notiondesk dashboard. De waarden voor het helpcentrumdomein, het subpad en de proxy zijn specifiek voor jouw configuratie.

Reload Caddy

Nadat je de configuratie aan je Caddyfile hebt toegevoegd, herlaad je Caddy om de wijzigingen toe te passen.

Het exacte commando hangt af van uw serverconfiguratie. Als Caddy wordt beheerd met systemd, kunt u het meestal opnieuw laden met:

Voordat je de pagina opnieuw laadt, kun je ook je Caddyfile controleren:

Als de validatie slaagt, herlaad dan Caddy en test het subpad van uw helpcentrum.

Controleer uw configuratie.

Nadat je Caddy opnieuw hebt geladen, open je het helpcentrum in je browser.

Test vervolgens een paar pagina's om er zeker van te zijn dat alles correct werkt:

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

Open de startpagina van het helpcentrum

Open een bekende artikelpagina

Open de homepage van uw website

Inhoudsopgave