Reverse proxy ir URL base

Padaryk, kad HolyArrs būtų pasiekiamas adresu, pavyzdžiui, https://home.example/holyarrs, už tavo reverse proxy.

Reverse proxy yra žiniatinklio serveris prieš tavo programas, kuris kiekvieną adresą nukreipia į reikiamą konteinerį. URL base yra kelias, po kuriuo veikia HolyArrs.

Nustatyk kelią

1. Pridėk kelią į savo Compose failą:

   services:
     holyarrs:
       environment:
         - HOLYARRS_URL_BASE=/holyarrs

2. Paleisk konteinerį iš naujo.

3. Pridėk proxy taisyklę iš Proxy pavyzdžių.

4. Atidaryk https://home.example/holyarrs/. Turėtum pamatyti prisijungimo puslapį. Settings > This app (nustatymai > ši programa) rodo naudojamą kelią.

Caution

Tavo proxy turi perduoti kelią nepakeistą. Jei jis nupjauna /holyarrs, kiekvienas puslapis rodo, kad nerasta.

Pasirinkimai

Kur nustatyti kelią

Kur	Kada įsigalioja
HOLYARRS_URL_BASE	Paleidžiant. Svarbesnis už kitus.
-url-base /holyarrs vėliavėlė	Paleidžiant, kai kintamasis nenustatytas.
Settings > This app	Kitą kartą paleidžiant, tik kai kintamasis ir vėliavėlė abu nenustatyti.

Proxy pavyzdžiai

nginx-proxy-manager. Sukurk proxy host savo domenui, tada pridėk custom location:

• Location: /holyarrs
• Forward hostname holyarrs, port 6262. Be pasvirojo brūkšnio gale, kitaip kelias nupjaunamas.
• Tos location krumpliaračio lauke:

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. Nepridėk StripPrefix middleware.

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

Caddy. Naudok handle. handle_path nupjauna kelią.

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

Pagrindinių kompiuterių vardai ir proxy adresai

• Jei žmonės HolyArrs pasiekia per pagrindinio kompiuterio vardą, pridėk jį į HOLYARRS_ALLOWED_HOSTS.
• Jei proxy prideda X-Forwarded-For, pridėk proxy adresą į HOLYARRS_TRUSTED_PROXIES. Be jo prisijungimas negali atpažinti, kas yra tavo namų tinkle.

Jei neveikia

Požymis	Priežastis	Sprendimas
Kiekvienas puslapis rodo, kad nerasta	Proxy nupjauna kelią	Pašalink nupjovimo nustatymą arba pasvirąjį brūkšnį gale.
Gyvi atnaujinimai niekada neateina	Proxy kaupia atsakymus buferyje	Išjunk buferį (proxy_buffering off, flush_interval -1).
Išsaugotas kelias tave užrakino	Išsaugotas kelias neteisingas	Paleisk su HOLYARRS_URL_BASE=/, kad jis būtų ignoruojamas.
Prisijungimas laiko tave esant ne savo tinkle	Proxy nepatikimas	Siųsk X-Real-IP ir X-Forwarded-For ir nustatyk HOLYARRS_TRUSTED_PROXIES.

Daugiau sprendimų: Triktys ir sprendimai.

Pažengusiems

Kelio taisyklės

• Leidžiami simboliai: raidės, skaitmenys, -, _, . ir /. Be .. ar //.
• holyarrs, /holyarrs ir /holyarrs/ visi reiškia /holyarrs.
• Išsaugotas kelias, kuris negalioja, ignoruojamas.
• Viskas pereina po keliu: puslapiai, API, gyvi atnaujinimai, prisijungimas ir nuorodos, kurias sukuria HolyArrs (kvietimų nuorodos, kalendoriaus srautas).
• /healthz ir /readyz taip pat atsako šaknyje, todėl paties image būklės patikra toliau veikia.
• Bet kuris kitas adresas už kelio atsako, kad nerasta.

Ką turi daryti proxy

Poreikis	Kodėl
Perduoti kelią nepakeistą	HolyArrs nukreipia pagal pilną kelią.
Palikti Host antraštę	Ją naudoja pagrindinio kompiuterio patikros ir sukurtos nuorodos.
Be atsakymų buferio	Gyvi atnaujinimai teka per vieną atvirą atsakymą.
Ilgas skaitymo timeout (1 val.)	Gyvų atnaujinimų srautas lieka atviras.

Susiję puslapiai

• Diegimas
• Prisijungimas
• Aplinkos kintamieji