Reversais starpniekserveris un URL base

Novieto HolyArrs adresē, piemēram, https://home.example/holyarrs, aiz sava reversā starpniekservera.

Reversais starpniekserveris (reverse proxy) ir tīmekļa serveris tavu lietotņu priekšā, kas katru adresi nosūta uz pareizo konteineru. URL base ir ceļš, zem kura dzīvo HolyArrs.

Iestati ceļu

1. Pievieno ceļu savam Compose failam:

   services:
     holyarrs:
       environment:
         - HOLYARRS_URL_BASE=/holyarrs

2. Restartē konteineru.

3. Pievieno starpniekservera noteikumu no sadaļas Starpniekservera piemēri.

4. Atver https://home.example/holyarrs/. Tev vajadzētu redzēt pieteikšanās lapu. Settings > This app (Iestatījumi > Šī lietotne) rāda izmantoto ceļu.

Uzmanību

Tavam starpniekserverim ceļš jānodod nemainīts. Ja tas noņem /holyarrs, katra lapa saka, ka nav atrasta.

Izvēles

Kur iestatīt ceļu

Kur	Kad stājas spēkā
HOLYARRS_URL_BASE	Palaišanas brīdī. Uzvar pār pārējiem.
-url-base /holyarrs parametrs	Palaišanas brīdī, ja mainīgais nav iestatīts.
Settings > This app	Nākamajā palaišanā, tikai tad, ja mainīgais un parametrs abi nav iestatīti.

Starpniekservera piemēri

nginx-proxy-manager. Izveido proxy host savam domēnam, tad pievieno pielāgotu atrašanās vietu (custom location):

• Location: /holyarrs
• Forward hostname holyarrs, ports 6262. Beigās bez slīpsvītras, citādi ceļš tiek noņemts.
• Šīs atrašanās vietas zobrata lodziņā:

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. Nepievieno StripPrefix starpprogrammatūru.

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

Caddy. Izmanto handle. handle_path noņem ceļu.

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

Resursdatoru nosaukumi un starpniekservera adreses

• Ja cilvēki HolyArrs sasniedz pēc resursdatora nosaukuma, pievieno to pie HOLYARRS_ALLOWED_HOSTS.
• Ja starpniekserveris pievieno X-Forwarded-For, pievieno starpniekservera adresi pie HOLYARRS_TRUSTED_PROXIES. Bez tā pieteikšanās nevar atšķirt, kurš atrodas tavā mājas tīklā.

Ja tas nedarbojas

Simptoms	Cēlonis	Risinājums
Katra lapa saka, ka nav atrasta	Starpniekserveris noņem ceļu	Izslēdz ceļa noņemšanu vai noņem beigu slīpsvītru.
Reāllaika atjauninājumi nekad nenonāk	Starpniekserveris buferē atbildes	Izslēdz buferēšanu (proxy_buffering off, flush_interval -1).
Saglabātais ceļš tevi izslēdza	Saglabātais ceļš ir nepareizs	Palaid ar HOLYARRS_URL_BASE=/, lai to ignorētu.
Pieteikšanās uzskata, ka esi ārpus sava tīkla	Starpniekserveris nav uzticams	Sūti X-Real-IP un X-Forwarded-For un iestati HOLYARRS_TRUSTED_PROXIES.

Vairāk risinājumu: Problēmu novēršana.

Pieredzējušiem

Ceļa noteikumi

• Atļautās rakstzīmes: burti, cipari, -, _, . un /. Bez .. vai //.
• holyarrs, /holyarrs un /holyarrs/ visi nozīmē /holyarrs.
• Saglabātais ceļš, kas nav derīgs, tiek ignorēts.
• Viss pārceļas zem ceļa: lapas, API, reāllaika atjauninājumi, pieteikšanās un saites, ko veido HolyArrs (ielūgumu saites, kalendāra feed).
• /healthz un /readyz atbild arī saknē, lai attēla paša veselības pārbaude turpinātu darboties.
• Jebkura cita adrese ārpus ceļa atbild, ka nav atrasta.

Kas starpniekserverim jādara

Vajadzība	Kāpēc
Nodot ceļu nemainītu	HolyArrs maršrutē pēc pilnā ceļa.
Saglabāt Host galveni	Resursdatora pārbaudes un veidotās saites to izmanto.
Bez atbilžu buferēšanas	Reāllaika atjauninājumi plūst pa vienu atvērtu atbildi.
Garš lasīšanas taimauts (1 h)	Reāllaika atjauninājumu straume paliek atvērta.

Saistītais

• Uzstādīšana
• Pieteikšanās
• Vides mainīgie