Proxy / WebSocket trasy

Proxy / WebSocket trasy

Proxy trasa přesměruje veřejnou adresu (cestu nebo subdoménu vaší domény) přes HTTPS na port procesu, který běží přímo ve vašem hostingu – typicky Node.js server pro WebSockety (Laravel Reverb, Pusher-kompatibilní server, chat, real-time notifikace a podobně). Cíl je vždy interní adresa uvnitř vašeho hostingu (127.0.0.1:<port>) – vy zadáváte jen port, na kterém váš proces naslouchá.

Kde ji najdete

V https://panel.cloudweb.sk otevřete hosting, kartu Vývoj a v ní podzáložku Proxy / WS. Záložka je dostupná, pokud máte na hostingu oprávnění „Domény a subdomény“ – pro vlastníka vždy, pro pozvaného spolupracovníka jen pokud mu bylo toto oprávnění přiděleno (viz spolupracovníci). U vizitkového hostingu (statická webová vizitka) tato záložka není k dispozici.

Dva typy trasy

• Cesta (Path) – například /ws. Funguje vždy, bez ohledu na nastavení subdomén. Cesta nesmí být kořen „/“, nesmí končit na .php a nesmí začínat /.well-known/acme-challenge (ta je vyhrazena pro vydávání SSL certifikátů).
• Subdoména (Subdomain) – například ws, čímž vznikne ws.vasedomena.sk. Vyžaduje, aby měl hosting na kartě Domény → Subdomény zapnutý jeden z režimů se zástupným (wildcard) certifikátem: Všechno na hlavní, Přesměrovat vše na hlavní, Složkové nebo Smíšené. V režimu Manuální zástupný certifikát aktivní není, a subdoménovou proxy trasu proto nelze přidat – panel ji v takovém případě odmítne a nabídne jako alternativu cestu (například /ws). Při prvním vytvoření subdoménové trasy panel automaticky doplní odpovídající DNS A záznam na adresu serveru (pokud DNS dané domény spravujeme my); pokud už existuje, nic nemění.

Nastavení trasy

• Port – 1 až 65535. Porty 80, 443, 9000, 22, 3306, 6379 nelze zadat – jsou vyhrazené pro webserver, PHP-FPM, SSH a databáze a proxování na ně by je vystavilo veřejně.
• WebSocket – zapne hlavičky Upgrade/Connection potřebné pro WebSocket handshake a prodlouží timeout na 24 hodin (86 400 s) místo standardních 60 sekund. Vlastní timeout lze zadat i ručně (1 až 86 400 s).
• Odříznutí prefixu (jen u typu Cesta) – pokud backend očekává požadavky od kořene (například Laravel Reverb/Pusher, který dělá handshake na /app/<klíč>), zapněte tento přepínač: /ws/app/x se pak na backend odešle jako /app/x.
• Zapnuto/vypnuto – trasu lze kdykoli dočasně vypnout, aniž byste ji museli smazat.

Po přidání, úpravě nebo smazání trasy panel okamžitě pošle aktuální seznam tras na server, který je ověří a načte přímo do běžícího hostingu bez restartu. Pokud se to z nějakého důvodu nepodaří, trasa zůstává uložená a panel upozorní, že hosting bude potřeba znovu překonfigurovat – kontaktujte v takovém případě podporu.

Vztah k Background Processes

Proxy trasa jen přesměrovává veřejný provoz na port – samotný proces uvnitř hostingu musí běžet sám. Aby váš Node.js server (nebo jiný dlouhoběžící proces) běžel trvale a restartoval se po pádu, nastavte ho v Background Processes (Supervisor) a teprve pak mu přidejte proxy trasu na jeho port.