Reverse proxy ja URL base

Pane HolyArrs oma reverse proxy taha aadressile nagu https://home.example/holyarrs.

Reverse proxy on veebiserver sinu rakenduste ees, mis suunab iga aadressi õigesse konteinerisse. URL base on tee, mille all HolyArrs asub.

Määra tee

1. Lisa tee oma Compose-faili:

   services:
     holyarrs:
       environment:
         - HOLYARRS_URL_BASE=/holyarrs

2. Taaskäivita konteiner.

3. Lisa proxy reegel jaotisest Proxy näited.

4. Ava https://home.example/holyarrs/. Näed sisselogimislehte. Leht Settings > This app (seaded > see rakendus) näitab kasutusel olevat teed.

Caution

Sinu proxy peab tee edasi andma muutmata. Kui see eemaldab /holyarrs, ütleb iga leht, et lehte ei leitud.

Valikud

Kus teed määrata

Kus	Jõustub
HOLYARRS_URL_BASE	Käivitusel. Võidab teised.
Lipp -url-base /holyarrs	Käivitusel, kui muutuja pole seatud.
Settings > This app	Järgmisel käivitusel, ainult siis, kui muutuja ja lipp on mõlemad seadmata.

Proxy näited

nginx-proxy-manager. Tee oma domeenile proxy host, seejärel lisa kohandatud asukoht (custom location):

• Asukoht: /holyarrs
• Edastuse hostinimi holyarrs, port 6262. Lõppu ei tohi kaldkriipsu panna, muidu eemaldatakse tee.
• Selle asukoha hammasratta aknas:

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. Ära lisa StripPrefix middleware’i.

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

Caddy. Kasuta handle. handle_path eemaldab tee.

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

Hostinimed ja proxy aadressid

• Kui inimesed jõuavad HolyArrsi hostinime kaudu, lisa see muutujasse HOLYARRS_ALLOWED_HOSTS.
• Kui proxy lisab päise X-Forwarded-For, lisa proxy aadress muutujasse HOLYARRS_TRUSTED_PROXIES. Ilma selleta ei suuda sisselogimine eristada, kes on sinu koduvõrgus.

Kui see ei tööta

Sümptom	Põhjus	Lahendus
Iga leht ütleb, et lehte ei leitud	Proxy eemaldab tee	Eemalda tee eemaldamise säte või lõpukaldkriips.
Reaalajas uuendused ei jõua kunagi kohale	Proxy puhverdab vastuseid	Lülita puhverdamine välja (proxy_buffering off, flush_interval -1).
Salvestatud tee lukustas sind välja	Salvestatud tee on vale	Käivita muutujaga HOLYARRS_URL_BASE=/, et seda eirata.
Sisselogimine peab sind väljaspool oma võrku olijaks	Proxyt ei usaldata	Saada X-Real-IP ja X-Forwarded-For ning sea HOLYARRS_TRUSTED_PROXIES.

Veel lahendusi: Tõrkeotsing.

Asjatundjale

Tee reeglid

• Lubatud märgid: tähed, numbrid, -, _, . ja /. Ilma .. ja //.
• holyarrs, /holyarrs ja /holyarrs/ tähendavad kõik /holyarrs.
• Kehtetut salvestatud teed eiratakse.
• Kõik liigub tee alla: lehed, API, reaalajas uuendused, sisselogimine ja lingid, mida HolyArrs koostab (kutselingid, kalendrivoog).
• /healthz ja /readyz vastavad ka juurtasandil, nii et image’i oma tervisekontroll töötab edasi.
• Iga muu aadress väljaspool teed vastab, et lehte ei leitud.

Mida proxy peab tegema

Vajadus	Põhjus
Anna tee edasi muutmata	HolyArrs marsruutib kogu tee järgi.
Hoia päis Host alles	Hosti kontrollid ja koostatud lingid kasutavad seda.
Vastuseid ei puhverdata	Reaalajas uuendused voogavad ühe avatud vastuse kaudu.
Pikk lugemise ajalõpp (1 h)	Reaalajas uuenduste voog püsib avatud.

Seotud lehed

• Paigaldamine
• Sisselogimine
• Keskkonnamuutujad