Reverse proxy ja URL base

Laita HolyArrs osoitteeseen, kuten https://home.example/holyarrs, reverse proxysi taakse.

Reverse proxy on sovellustesi edessä oleva verkkopalvelin, joka ohjaa jokaisen osoitteen oikeaan containeriin. URL base on polku, jonka alla HolyArrs on.

Aseta polku

1. Lisää polku Compose-tiedostoosi:

   services:
     holyarrs:
       environment:
         - HOLYARRS_URL_BASE=/holyarrs

2. Käynnistä container uudelleen.

3. Lisää proxysääntö kohdasta Proxy-esimerkit.

4. Avaa https://home.example/holyarrs/. Näet kirjautumissivun. Kohdassa Settings > This app (asetukset > tämä sovellus) näkyy käytössä oleva polku.

Varoitus

Proxyn täytyy välittää polku muuttamattomana. Jos se poistaa osan /holyarrs, jokainen sivu kertoo, ettei sivua löydy.

Vaihtoehdot

Mistä polun voi asettaa

Missä	Tulee voimaan
HOLYARRS_URL_BASE	Käynnistyksessä. Voittaa muut.
Valitsin -url-base /holyarrs	Käynnistyksessä, kun muuttujaa ei ole asetettu.
Settings > This app	Seuraavassa käynnistyksessä, vain kun sekä muuttuja että valitsin ovat asettamatta.

Proxy-esimerkit

nginx-proxy-manager. Tee domainillesi proxy host ja lisää sitten custom location:

• Location: /holyarrs
• Forward hostname holyarrs, port 6262. Ei vinoviivaa loppuun, tai polku poistuu.
• Kyseisen locationin rataskentässä:

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. Älä lisää StripPrefix-middlewarea.

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

Caddy. Käytä handle. handle_path poistaa polun.

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

Isäntänimet ja proxyn osoitteet

• Jos ihmiset käyttävät HolyArrsia isäntänimellä, lisää se muuttujaan HOLYARRS_ALLOWED_HOSTS.
• Jos proxy lisää otsakkeen X-Forwarded-For, lisää proxyn osoite muuttujaan HOLYARRS_TRUSTED_PROXIES. Ilman sitä kirjautuminen ei erota, kuka on kotiverkossasi.

Jos se ei toimi

Oire	Syy	Ratkaisu
Jokainen sivu kertoo, ettei sivua löydy	Proxy poistaa polun	Poista polun poistava asetus tai loppuvinoviiva.
Live-päivitykset eivät koskaan saavu	Proxy puskuroi vastaukset	Poista puskurointi käytöstä (proxy_buffering off, flush_interval -1).
Tallennettu polku lukitsi sinut ulos	Tallennettu polku on väärä	Käynnistä komennolla HOLYARRS_URL_BASE=/, niin se ohitetaan.
Kirjautuminen pitää sinua kotiverkon ulkopuolisena	Proxyyn ei luoteta	Lähetä X-Real-IP ja X-Forwarded-For ja aseta HOLYARRS_TRUSTED_PROXIES.

Lisää ratkaisuja: Vianmääritys.

Asiantuntijoille

Polkusäännöt

• Sallitut merkit: kirjaimet, numerot, -, _, . ja /. Ei .. eikä //.
• holyarrs, /holyarrs ja /holyarrs/ tarkoittavat kaikki polkua /holyarrs.
• Tallennettu polku, joka ei kelpaa, ohitetaan.
• Kaikki siirtyy polun alle: sivut, API, live-päivitykset, kirjautuminen ja HolyArrsin rakentamat linkit (kutsulinkit, kalenterisyöte).
• /healthz ja /readyz vastaavat myös juuressa, jotta imagen oma kuntotarkistus toimii edelleen.
• Mikä tahansa muu osoite polun ulkopuolella vastaa, ettei sivua löydy.

Mitä proxyn täytyy tehdä

Tarve	Syy
Välitä polku muuttamattomana	HolyArrs ohjaa koko polun perusteella.
Säilytä Host-otsake	Isäntätarkistukset ja rakennetut linkit käyttävät sitä.
Ei vastausten puskurointia	Live-päivitykset virtaavat yhden avoimen vastauksen kautta.
Pitkä lukuaikaraja (1 h)	Live-päivitysten virta pysyy auki.

Aiheesta lisää

• Asennus
• Kirjautuminen
• Ympäristömuuttujat