Reverse proxy en URL base

Zet HolyArrs op een adres als https://home.example/holyarrs achter je reverse proxy.

Een reverse proxy is de webserver die vóór je apps staat en elk adres naar de juiste container stuurt. De URL base is het pad waaronder HolyArrs draait.

Het pad instellen

1. Voeg het pad toe aan je Compose-bestand:

   services:
     holyarrs:
       environment:
         - HOLYARRS_URL_BASE=/holyarrs

2. Herstart de container.

3. Voeg een proxyregel toe uit Proxy-voorbeelden.

4. Open https://home.example/holyarrs/. Je ziet de aanmeldpagina. Settings > This app (instellingen > deze app) toont het pad dat in gebruik is.

Opgepast

Je proxy moet het pad ongewijzigd doorgeven. Haalt hij /holyarrs eraf, dan zegt elke pagina dat ze niet bestaat.

Keuzes

Waar je het pad instelt

Waar	Gaat in
HOLYARRS_URL_BASE	Bij de start. Wint van de andere.
Vlag -url-base /holyarrs	Bij de start, als de variabele niet is ingesteld.
Settings > This app	Bij de volgende start, alleen als variabele en vlag allebei ontbreken.

Proxy-voorbeelden

nginx-proxy-manager. Maak een proxy host voor je domein en voeg dan een eigen locatie toe:

• Locatie: /holyarrs
• Forward hostnaam holyarrs, poort 6262. Geen slash aan het eind, anders wordt het pad eraf gehaald.
• In het tandwielvak van die locatie:

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_buffering off;
proxy_read_timeout 1h;

Traefik. Voeg geen StripPrefix-middleware toe.

labels:
  - traefik.enable=true
  - traefik.http.routers.holyarrs.rule=Host(`home.example`) && PathPrefix(`/holyarrs`)
  - traefik.http.services.holyarrs.loadbalancer.server.port=6262

Caddy. Gebruik handle. handle_path haalt het pad eraf.

home.example {
  handle /holyarrs* {
    reverse_proxy holyarrs:6262 {
      flush_interval -1
    }
  }
}

Hostnamen en proxyadressen

• Komen mensen via een hostnaam bij HolyArrs, voeg die dan toe aan HOLYARRS_ALLOWED_HOSTS.
• Voegt de proxy X-Forwarded-For toe, voeg dan het adres van de proxy toe aan HOLYARRS_TRUSTED_PROXIES. Zonder dit kan de aanmelding niet zien wie op je thuisnetwerk zit.

Als het niet werkt

Symptoom	Oorzaak	Oplossing
Elke pagina zegt dat ze niet bestaat	De proxy haalt het pad eraf	Zet het verwijderen van het pad uit, of haal de slash aan het eind weg.
Live-updates komen nooit binnen	De proxy buffert antwoorden	Zet buffering uit (proxy_buffering off, flush_interval -1).
Een opgeslagen pad heeft je buitengesloten	Het opgeslagen pad is fout	Start met HOLYARRS_URL_BASE=/ om het te negeren.
De aanmelding behandelt je als buiten je netwerk	De proxy wordt niet vertrouwd	Stuur X-Real-IP en X-Forwarded-For mee en stel HOLYARRS_TRUSTED_PROXIES in.

Meer oplossingen: Problemen oplossen.

Voor gevorderden

Padregels

• Toegestane tekens: letters, cijfers, -, _, . en /. Geen .. of //.
• holyarrs, /holyarrs en /holyarrs/ betekenen alle drie /holyarrs.
• Een opgeslagen pad dat niet geldig is, wordt genegeerd.
• Alles verhuist onder het pad: pagina’s, de API, live-updates, aanmelding en links die HolyArrs zelf maakt (uitnodigingslinks, de agendafeed).
• /healthz en /readyz antwoorden ook op de root, zodat de eigen gezondheidscontrole van de image blijft werken.
• Elk ander adres buiten het pad antwoordt met niet gevonden.

Wat de proxy moet doen

Nodig	Waarom
Het pad ongewijzigd doorgeven	HolyArrs routeert op het volledige pad.
De Host-header behouden	Hostcontroles en gemaakte links gebruiken die.
Geen buffering van antwoorden	Live-updates stromen over één open antwoord.
Lange leestimeout (1 uur)	De stroom met live-updates blijft open.

Gerelateerde pagina’s

• Installeren
• Aanmelden
• Omgevingsvariabelen