Alles, was Client und Dashboard heute können. Inhalt: Schnellstart · Link absichern · Webhooks · Feste URLs · Anfrageprotokoll · Limits · Fehlercodes · So funktioniert es
Benötigt Linux oder macOS (x86_64 oder arm64), bash, curl und python3. Der Installer legt frpc (den Open-Source-frp-Client, v0.61.1) und das ot-Skript in ~/.local/bin.
curl -fsSL https://app.overnight.technology/install.sh | bash export PATH="$PATH:$HOME/.local/bin" ot login --token YOUR_API_TOKEN # steht nach der Registrierung im Dashboard ot http 3000 --slug demo # Ihre App auf localhost:3000
Sie erhalten https://demo.overnight.technology. Token und Einstellungen liegen in ~/.config/ot-tunnels/. Beenden Sie den Tunnel mit Strg+C.
Jeder Tunnel verlangt einen Zugangsschutz. Anfragen, die ihn nicht bestehen, bekommen 401 und erreichen Ihren Rechner nie.
| Modus | Befehl | So kommen Besucher hinein |
|---|---|---|
| Token (Standard) | ot http 3000 --slug demo | Header X-OT-Tunnel: <secret> oder Aufruf von https://demo.overnight.technology/?ot=<secret> |
| basic | ot http 3000 --slug demo --basic client:s3cret | Der Browser fragt nach Benutzername und Passwort |
| eigenes Secret | ot http 3000 --slug demo --secret my-long-secret | Token-Modus mit einem selbst gewählten statt einem erzeugten Secret |
| IP-Freigabeliste | ot http 3000 --slug demo --allow 203.0.113.7,10.0.0.0/8 | Nur diese IPs oder CIDRs, und auch sie brauchen Token oder Passwort |
Dieselben Optionen gibt es im Dashboard unter „Tunnel anlegen“.
Webhook-Absender können kein Passwort eintippen. Nutzen Sie deshalb den Token-Modus und setzen Sie das Secret in die URL, die Sie dort hinterlegen:
ot http 4242 --slug hooks --secret a-long-random-string # als Webhook-URL hinterlegen: https://hooks.overnight.technology/your/webhook/path?ot=a-long-random-string
Der Query-String wird unverändert an Ihre App durchgereicht, ignorieren Sie dort also den Parameter ot. Jede Zustellung erscheint mit Statuscode im Anfrageprotokoll.
Ein Slug gehört dem Konto, das ihn angelegt hat. Wenn Sie ot http mit demselben Slug erneut starten, bleibt die URL gleich und es gelten die Optionen, die Sie diesmal angeben. So können Sie den Laptop neu starten oder den Port wechseln, ohne einen neuen Link zu verschicken. Ohne --secret bleibt das bisherige Secret. Ein Start ohne --allow leert die Freigabeliste.
Das Dashboard zeigt die letzten 200 Anfragen pro Tunnel: Zeit, Methode, Pfad, Status, Client-IP, Browser und Bytes ein und aus, auch Anfragen, die mit 401 abgewiesen wurden. Inhalte von Anfragen und Antworten werden nicht gespeichert. Die API ist GET https://app.overnight.technology/api/tunnels/<slug>/logs mit Authorization: Bearer <API token>.
| Tarif | Preis | Tunnel | Anfragen pro Tag (UTC) | Transfer pro Monat |
|---|---|---|---|---|
| Starter | €9/Monat | 1 | 10.000 | 1 GB |
| Builder | €19/Monat | 3 | 50.000 | 5 GB |
| Team | €29/Monat | 10 | 200.000 | 20 GB |
Anfrageinhalte bis 20 MB. Ihre App hat 60 Sekunden pro Antwort. Nach Erreichen des Tageslimits bekommen Anfragen bis Mitternacht UTC eine 429.
| 401 | Token oder Passwort fehlt oder ist falsch, oder die IP des Besuchers steht nicht auf der Freigabeliste. |
| 404 unknown tunnel | Es gibt keinen Tunnel mit diesem Slug. |
| 409 slug taken | Der Slug gehört einem anderen Konto. Wählen Sie einen anderen. |
| frpc: start proxy error | Der Tunnel-Server lässt Ihr Konto nur eigene Slugs belegen. „this slug does not belong to your account“: zuerst mit ot http anlegen. „client too old“: Clients, die vor dem 7. November 2026 installiert wurden, brauchen den Installationsbefehl noch einmal. |
| 429 | Tageslimit Ihres Tarifs erreicht. |
| 502 / 404 von frp | Zugangsschutz bestanden, aber ot http läuft nicht oder am lokalen Port lauscht nichts. |
frpc auf Ihrem Rechner hält eine ausgehende Verbindung zu ctrl.overnight.technology:7000, eingehende Ports oder Router-Änderungen sind also nicht nötig. Unsere DNS-Einträge sind reines DNS ohne vorgeschalteten CDN-Proxy, öffentliches HTTPS endet mit Let's-Encrypt-Zertifikaten auf unserem eigenen Server in der EU, läuft dort durch unser Auth-Gateway und erst dann über frps zu Ihrem Rechner. Dienstprüfungen laufen alle 60 Sekunden auf der Statusseite. Fragen: hello@overnight.technology.