Web Proxy med SSL

Simpel, sikker eksponering af en intern service til internettet

Denne skabelon giver en let måde for klienter at eksponere en intern service (HTTP eller WebSocket) til det offentlige internet via Trooper.AI router systemet. Den opretter automatisk et sikkert HTTPS endpoint med et gratis SSL-certifikat, samtidig med at trafikken videresendes til enhver intern port på klientens maskine.

Målet er enkelhed: installer en lille proxy, angiv den interne port og få øjeblikkeligt adgang til en sikker, eksternt nåelig URL.

Al trafik fra Webproxyens SSL-slutpunkt til din maskines offentlige port dirigeres i vores interne netværk og omgår fuldstændigt internettet. Dette er en væsentlig sikkerhedsfordel ved Trooper.AI.

Nøglefunktioner

1. Offentlig HTTPS-slutpunkt

Din interne service bliver tilgængelig under en *.secure.trooper.ai subdomæne, dirigeret gennem Trooper.AI-infrastrukturen med automatiske SSL-certifikater.

2. Fuld WebSocket-understøttelse

Skabelonen videresender både standard HTTP-trafik og WebSocket-forbindelser uden yderligere konfiguration.

3. Valgfri adgangskodebeskyttelse

Hvis et brugernavn og en adgangskode angives, sikres endepunktet med Basic Auth. Hvis begge værdier udelades, deaktiveres godkendelsen.

4. Ren og minimal opsætning

Hver installerede instans af SSL Web Proxy opretter en dedikeret proxy-endpoint, lytter på en automatisk tildelt ekstern port og leder trafikken videre til den konfigurerede interne tjänst.

Sådan fungerer det

Input

Du konfigurerer kun skabelonen før installationen.

Den eksterne port vil automatisk blive tildelt og vist ved siden af skabelonnavnet, ligesom med andre skabeloner.

🚨 Brug ikke port 443 og medbring ikke et selvsigneret certifikat på din port!

Intern Flow

1. Nginx er installeret (inklusive htpasswd support).
2. Hvis godkendelse er aktiveret, oprettes der en adgangskodefil.
3. En proxy-konfiguration er placeret under /etc/nginx/sites-available/trooperai-webproxy-<external_port>
4. Konfigurationen videresender al indgående trafik til http://127.0.0.1:<internal_port>.
5. WebSocket opgraderingsheaders videresendes automatisk.
6. Nginx genindlæses og endpointet aktiveres.

Timeout-klasser

Proxyen opgraderer også tidsudløb dynamisk på responsen (f.eks. hvis din server sender 206 eller Content-Disposition: attachment, så ændrer det til DOWNLOAD-tidsudløbet selvom anmodningen ikke oprindeligt blev klassificeret som en download).

Eksempel resultat

Givet et Trooper.AI-tildelt domæne som:

myapp123-husky-delta.secure.trooper.ai

og en automatisk tildelt ekstern proxy-port (f.eks., 12345), med en intern service der lytter på port 8080,

forbindelsesflowet vil være: https://myapp123-husky-delta.secure.trooper.ai -> 12345 -> 8080.

Dette videresender sikkert trafik fra det offentlige HTTPS-endepunkt til din interne service.

Fejlfinding

Vi har samlet svar på hyppige spørgsmål om webproxy-funktionen. Ved behov for individuel hjælp, kontakt venligst vores supportteam:

Hvor finder jeg mit HTTPS-domæne?

Sørg for, at din interne tjeneste kører på den ønskede port, og installer eller opdater derefter den tilsvarende Web Proxy SSL-instans. Den tilknyttede domæne og SSL-aktiveringsstatus (angivet med et låsesymbol) vil herefter blive vist.

Understøtter WebProxy UDP og WebSockets?

WebSocket er blot en opgradering af HTTP(S) – fuldt understøttet af WebProxy og gør det muligt med problemfri integration til bredt anvendte KI-applikationer med webbaserede grænseflader.

UDP er et tilstandsløst protokol, der ikke kræver certifikater; du kommunikerer direkte via hostname:port i stedet. Krypteringen håndteres på applikationsniveauet (f.eks. LiveKit ved hjælp af DTLS). Da WebProxy er baseret på HTTP og HTTP kører over TCP, kan det ikke videreformidle UDP – men du har egentlig heller ikke brug for en proxy for UDP. Åbn blot de nødvendige UDP-porte i din brandmur.

Er min interne service HTTP eller HTTPS?

Det er et gyldigt spørgsmål. Internt kører din tjeneste som en standard HTTP-tjeneste på en konfigurerbar port, såsom 8080. Denne port forbliver intern for din serverinstans. Webproxy-tjenesten installeret via denne skabelon håndterer SSL-kryptering, automatisk provisioning og administration af SSL-certifikatet for sikker ekstern adgang. Dybest set etablerer denne skabelon en sikker HTTPS-forbindelse mellem din interne port og det offentlige internet.

Eksisterende Nginx-konfigurationer

Denne skabelon installerer og konfigurerer Nginx til at route intern trafik på din GPU-server. Selvom den ikke vil overskrive eksisterende konfigurationer, anbefales det generelt ikke at administrere Nginx direkte på din GPU-server på grund af potentiel kompleksitet. Overvej om direkte Nginx-administration er nødvendig for dit workflow.

Flere webproxy-instanser med SSL kan køre parallelt. Hver instans opretter sin egen Nginx-konfiguration baseret på den tilknyttede eksterne port, så de enkelte proxykonfigurationer forbliver adskilte.

Håndtering af blokerede anmodninger og beskyttelse mod brute-force angreb

Vores Secure SSL Proxy indeholder beskyttelse på infrastrukturniveau for at holde ruteringslaget stabilt og beskytte din tjeneste mod misbrugtrafik. Den overvåger kontinuerligt forbindelseshåndteringen og trafikmønstre samt midlertidigt begrænser kilder, der forårsager gentagne fejlslag. På den måde kan proxyen skelne mellem en ægte nedetid og normal drift; din tjeneste skal tydeligvis melde reelle problemer ud — ved enten at afvise eller lukke forbindelsen, eller returnere en 5xx serverfejl, når den faktisk er utilgængelig.

Autentificering på applikationsniveau (f.eks. logind eller API-nøglekontroller, der returnerer 401/403) håndteres af din egen tjeneste. Proxyen blokerer ikke med vilje for disse tilfælde, så normale autentiseringsprocesser bliver aldrig forstyrret.

Fejlkoder (E-koder)

Hvis du støder på en fejlside ved adgang til dit endpoint, vil den vise en unik fejlkode (f.eks. e-code: TP3) i overskriften. Indsæt venligst denne kode, når du kontakter supporten – det hjælper os med at lokalisere årsagen øjeblikkeligt.

💡 Undgå aggressive automatiske genforsøg, når du ser en fejlside. Gentagne mislykkede anmodninger kan føre til midlertidig blokering (TP4).