Reverse proxy og URL base

Settu HolyArrs á vistfang eins og https://home.example/holyarrs á bak við reverse proxy.

Reverse proxy er web server fyrir framan forritin þín sem sendir hvert vistfang á réttan container. URL base er slóðin sem HolyArrs er undir.

Stilla slóðina

1. Bættu slóðinni við Compose-skrána þína:

   services:
     holyarrs:
       environment:
         - HOLYARRS_URL_BASE=/holyarrs

2. Endurræstu container-inn.

3. Bættu við proxy-reglu úr Dæmi um proxy.

4. Opnaðu https://home.example/holyarrs/. Þú ættir að sjá innskráningarsíðuna. Settings > This app (stillingar > þetta forrit) sýnir slóðina sem er í notkun.

Caution

Proxy þinn verður að senda slóðina áfram óbreytta. Ef hann fjarlægir /holyarrs segir hver síða „not found“.

Valkostir

Hvar á að stilla slóðina

Hvar	Tekur gildi
HOLYARRS_URL_BASE	Við ræsingu. Gildir umfram hin.
-url-base /holyarrs færibreyta	Við ræsingu, þegar breytan er ekki stillt.
Settings > This app	Við næstu ræsingu, aðeins þegar hvorki breytan né færibreytan er stillt.

Dæmi um proxy

nginx-proxy-manager. Búðu til proxy host fyrir lénið þitt og bættu svo við sérsniðinni staðsetningu:

• Location: /holyarrs
• Forward hostname holyarrs, port 6262. Ekkert skástrik í lokin, annars er slóðin fjarlægð.
• Í stillingarglugganum (tannhjólinu) fyrir þá staðsetningu:

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. Ekki bæta við 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. Notaðu handle. handle_path fjarlægir slóðina.

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

Hýsilnöfn og proxy-vistföng

• Ef fólk nær í HolyArrs með hýsilnafni skaltu bæta því við HOLYARRS_ALLOWED_HOSTS.
• Ef proxy bætir við X-Forwarded-For skaltu bæta vistfangi proxy við HOLYARRS_TRUSTED_PROXIES. Án þess getur innskráning ekki greint hver er á heimanetinu þínu.

Ef það virkar ekki

Einkenni	Orsök	Lausn
Hver síða segir „not found“	Proxy fjarlægir slóðina	Fjarlægðu stillinguna sem fjarlægir slóðina eða skástrikið í lokin.
Lifandi uppfærslur berast aldrei	Proxy geymir svör í buffer	Slökktu á buffering (proxy_buffering off, flush_interval -1).
Vistuð slóð læsti þig úti	Vistaða slóðin er röng	Ræstu með HOLYARRS_URL_BASE=/ til að hunsa hana.
Innskráning telur þig utan netsins þíns	Proxy er ekki treyst	Sendu X-Real-IP og X-Forwarded-For og stilltu HOLYARRS_TRUSTED_PROXIES.

Fleiri lausnir: Bilanaleit.

Fyrir sérfræðinga

Slóðareglur

• Leyfðir stafir: bókstafir, tölustafir, -, _, . og /. Ekkert .. eða //.
• holyarrs, /holyarrs og /holyarrs/ þýða allt /holyarrs.
• Vistuð slóð sem er ekki gild er hunsuð.
• Allt færist undir slóðina: síður, API, lifandi uppfærslur, innskráning og tenglar sem HolyArrs býr til (boðstenglar, dagatalsstraumurinn).
• /healthz og /readyz svara líka á rótinni, svo heilsuathugun image sjálfs heldur áfram að virka.
• Öllum öðrum vistföngum utan slóðarinnar er svarað með „not found“.

Hvað proxy þarf að gera

Þörf	Ástæða
Senda slóðina óbreytta	HolyArrs beinir eftir fullri slóð.
Halda Host haus	Host-athuganir og tenglar sem eru búnir til nota hann.
Engin buffering á svörum	Lifandi uppfærslur streyma yfir eitt opið svar.
Langur read timeout (1 klst.)	Straumur lifandi uppfærslna helst opinn.

Tengt efni

• Uppsetning
• Innskráning
• Umhverfisbreytur