Proxy / WebSocket trasy

Proxy / WebSocket trasy

Proxy trasa presmeruje verejnú adresu (cestu alebo subdoménu vašej domény) cez HTTPS na port procesu, ktorý bežia priamo vo vašom hostingu – typicky Node.js server pre WebSockety (Laravel Reverb, Pusher-kompatibilný server, chat, real-time notifikácie a podobne). Cieľ je vždy interná adresa vo vnútri vášho hostingu (127.0.0.1:<port>) – vy zadávate iba port, na ktorom váš proces počúva.

Kde ju nastavíte

V https://panel.cloudweb.sk otvorte hosting, kartu Vývoj a v nej podzáložku Proxy / WS. Záložka je dostupná, ak máte na hostingu oprávnenie „Domény a subdomény“ – teda pre vlastníka vždy, pre pozvaného spolupracovníka iba ak mu bolo toto oprávnenie pridelené (pozri spolupracovníkov). Pri vizitkovom hostingu (statická webová vizitka) táto záložka nie je k dispozícii.

Dva typy trasy

• Cesta (Path) – napríklad /ws. Funguje vždy, bez ohľadu na nastavenie subdomén. Cesta nesmie byť koreň „/“, nesmie končiť na .php a nesmie začínať /.well-known/acme-challenge (tá je vyhradená pre vydávanie SSL certifikátov).
• Subdoména (Subdomain) – napríklad ws, čo vytvorí ws.vasadomena.sk. Vyžaduje, aby mal hosting na karte Domény → Subdomény zapnutý jeden z režimov so zástupným (wildcard) certifikátom: Všetko na hlavnú, Presmerovať všetko na hlavnú, Podľa priečinkov alebo Zmiešané. Pri režime Manuálne zástupný certifikát nie je aktívny a subdoménovú proxy trasu preto nie je možné pridať – panel ju v takom prípade odmietne a ponúkne cestu (napríklad /ws) ako alternatívu. Pri prvom vytvorení subdoménovej trasy panel automaticky doplní príslušný DNS A záznam na adresu servera (ak DNS danej domény spravujeme my); ak už existuje, nič nemení.

Nastavenia trasy

• Port – 1 až 65535. Porty 80, 443, 9000, 22, 3306, 6379 nie je možné zadať – sú vyhradené pre webserver, PHP-FPM, SSH a databázy a proxovanie na ne by ich vystavilo verejne.
• WebSocket – zapne hlavičky Upgrade/Connection potrebné pre WebSocket handshake a predĺži timeout na 24 hodín (86 400 s) namiesto štandardných 60 sekúnd. Vlastný timeout môžete zadať aj ručne (1 až 86 400 s).
• Orezanie prefixu (iba pri type Cesta) – ak backend očakáva požiadavky od koreňa (napríklad Laravel Reverb/Pusher, ktorý robí handshake na /app/<kľúč>), zapnite toto prepínadlo: /ws/app/x sa potom na backend odošle ako /app/x.
• Zapnuté/vypnuté – trasu môžete kedykoľvek dočasne vypnúť bez toho, aby ste ju museli zmazať.

Po pridaní, úprave alebo zmazaní trasy panel okamžite pošle aktuálny zoznam trás na server, ktorý si ich overí a načíta priamo do bežiaceho hostingu (bez reštartu). Ak sa to z nejakého dôvodu nepodarí, trasa ostáva uložená a panel vás upozorní, že môže byť potrebné hosting znova prekonfigurovať – kontaktujte v takom prípade podporu.

Vzťah k Background Processes

Proxy trasa iba presmerováva verejnú prevádzku na port – samotný proces vo vnútri hostingu musí bežať sám. Na to, aby váš Node.js server (alebo iný dlhobežiaci proces) bežal trvalo a reštartoval sa pri páde, ho nastavte v Background Processes (Supervisor) a až potom mu pridajte proxy trasu na jeho port.