Proxyscotch einfach selbst hosten
Yulei ChenProxyscotch ist ein schlanker CORS-Proxy-Server vom Hoppscotch-Team. Wenn du Hoppscotch zum Testen von APIs nutzt, bist du bestimmt schon mal auf CORS-Probleme gestoßen. Proxyscotch löst das, indem Requests über deinen eigenen Proxy laufen und Browser-CORS-Einschränkungen komplett umgangen werden.
Sliplane macht das Deployment von Proxyscotch super einfach. Mit One-Click-Deployment hast du in unter einer Minute einen laufenden CORS-Proxy - kein Server-Setup, keine Reverse-Proxy-Config, keine Infrastruktur zum Verwalten.
Voraussetzungen
Bevor du loslegst, brauchst du einen Sliplane-Account (kostenlose Testphase verfügbar).
Quick Start
Sliplane bietet One-Click-Deployment mit Presets.
Proxyscotch deployen >- Klick auf den Deploy-Button oben
- Wähl ein Projekt aus
- Wähl einen Server aus (bei Neuanmeldung bekommst du einen 48-Stunden-Testserver gratis)
- Klick auf Deploy!
Über das Preset
Das One-Click-Deploy oben nutzt Sliplane's Proxyscotch-Preset. Das ist enthalten:
- Proxyscotch v0.1.4 Image von Docker Hub
- Lauscht standardmäßig auf Port 9159
- Token-basierte Authentifizierung über
PROXYSCOTCH_TOKENgegen unbefugte Nutzung - CORS Origins auf
*(alle Origins erlaubt) als Standard - Kein persistenter Storage nötig, da Proxyscotch ein zustandsloser Proxy ist
Nächste Schritte
Sobald Proxyscotch läuft, erreichst du es über die Domain, die Sliplane bereitstellt (z.B. proxyscotch-xxxx.sliplane.app).
Hoppscotch verbinden
So nutzt du deine Proxyscotch-Instanz mit Hoppscotch:
- Öffne Hoppscotch im Browser
- Geh zu Settings
- Unter Proxy wähl Custom und gib deine Proxyscotch-URL ein (z.B.
https://proxyscotch-xxxx.sliplane.app) - Gib den Token aus deiner
PROXYSCOTCH_TOKENUmgebungsvariable ein
Jetzt laufen alle deine API-Requests in Hoppscotch über deinen eigenen Proxy.
Umgebungsvariablen
Du kannst Proxyscotch mit diesen Umgebungsvariablen anpassen:
| Variable | Beschreibung | Standard |
|---|---|---|
PROXYSCOTCH_TOKEN | Authentifizierungs-Token für Proxy-Requests | (zufällig generiert) |
PROXYSCOTCH_ALLOWED_ORIGINS | Kommagetrennte Liste erlaubter CORS-Origins | * |
PROXYSCOTCH_BANNED_OUTPUTS | Responses mit bestimmtem Inhalt blockieren | (leer) |
PROXYSCOTCH_BANNED_DESTS | Requests an bestimmte Ziele blockieren | (leer) |
Logging
Proxyscotch loggt standardmäßig auf STDOUT, was super mit Sliplane's eingebautem Log-Viewer funktioniert. Für allgemeine Tipps zum Umgang mit Container-Logs schau dir unseren Guide zu Docker Logs an.
Troubleshooting
Wenn Requests über den Proxy fehlschlagen, prüf diese häufigen Probleme:
- 401 Unauthorized: Achte drauf, dass der Token in deinen Hoppscotch-Settings mit der
PROXYSCOTCH_TOKENUmgebungsvariable übereinstimmt - CORS-Fehler weiterhin sichtbar: Prüf, ob die Origin, von der du aufrufst, in
PROXYSCOTCH_ALLOWED_ORIGINSerlaubt ist - Connection refused: Bestätige, dass der Service im Sliplane Dashboard als healthy angezeigt wird
Kostenvergleich
Du kannst Proxyscotch auch bei anderen Cloud-Anbietern selbst hosten. Hier ein Preisvergleich der gängigsten Anbieter:
| Anbieter | vCPU | RAM | Disk | Monatliche Kosten | Hinweis |
|---|---|---|---|---|---|
| Sliplane | 2 | 2 GB | 40 GB | €9 (~$10.65) | Flatrate, 1 TB Bandwidth, SSL inklusive |
| Fly.io | 2 | 2 GB | 40 GB | ~$18 | Disk und Bandwidth extra |
| Render | 1 | 2 GB | 40 GB | ~$35 | 100 GB Bandwidth, Disk extra |
| Railway | 2 | 2 GB | 40 GB | ~$67 + $20 Plan | Pro-Plan-Minimum, nutzungsbasiert, Bandwidth extra |
Klick hier, um die Berechnung zu sehen.
(Angenommen eine always-on Instanz mit 730 Stunden/Monat)
- Sliplane: Flat €9/Monat für den Base Server. Unbegrenzte Services auf demselben Server, 1 TB Egress und SSL inklusive.
- Fly.io:
shared-cpu-2x2 GB = $11.83/Monat + 40 GB Volume × $0.15/GB = $6 -> ~$17.83/Monat. Egress wird separat berechnet ($0.02/GB in der EU). - Render: Nächstliegendes Angebot ist Standard ($25, 1 vCPU / 2 GB) plus 40 GB Disk × $0.25/GB = $10 -> ~$35/Monat. Pro (2 vCPU / 4 GB) kostet $85/Monat + Disk.
- Railway (Pro Plan): CPU 2 × $0.00000772/s × 2,628,000 s = $40.57; RAM 2 × $0.00000386/s × 2,628,000 s = $20.29; Volume 40 × $0.00000006/s × 2,628,000 s = $6.31 -> ~$67/Monat Compute, plus $20/Monat Pro-Plan-Minimum und $0.05/GB Egress.
Bandwidth-Kosten können bei nutzungsbasierten Anbietern schnell steigen. Nutz unser Bandwidth-Kostenvergleichstool , um zu sehen, was dein Egress bei jedem Anbieter kosten würde.
FAQ
Wofür wird Proxyscotch verwendet?
Proxyscotch fungiert als CORS-Proxy. Damit können browserbasierte API-Clients wie Hoppscotch Requests an APIs senden, die sonst durch die Same-Origin-Policy des Browsers blockiert würden. Besonders nützlich zum Testen von Third-Party-APIs, die keine offenen CORS-Header setzen.
Wie schränke ich ein, welche Origins meinen Proxy nutzen dürfen?
Setz die PROXYSCOTCH_ALLOWED_ORIGINS Umgebungsvariable auf eine kommagetrennte Liste erlaubter Origins (z.B. https://hoppscotch.io,https://meineapp.com). Standardmäßig sind alle Origins erlaubt (*).
Wie update ich Proxyscotch?
Ändere den Image-Tag in deinen Service-Einstellungen auf Sliplane und deploye neu. Schau auf Docker Hub nach der neuesten stabilen Version.
Kann ich Proxyscotch ohne Hoppscotch nutzen?
Ja. Proxyscotch ist ein eigenständiger CORS-Proxy, der mit jedem HTTP-Client funktioniert. Du musst nur deine Requests mit dem richtigen Token durch den Proxy schicken. Es ist nicht auf Hoppscotch beschränkt.
Ist Proxyscotch sicher?
Proxyscotch unterstützt Token-basierte Authentifizierung, sodass nur Nutzer mit dem richtigen PROXYSCOTCH_TOKEN deinen Proxy verwenden können. Du kannst es weiter absichern, indem du PROXYSCOTCH_ALLOWED_ORIGINS auf bestimmte Domains setzt und PROXYSCOTCH_BANNED_DESTS nutzt, um Requests an sensible interne Endpoints zu blockieren.
