Overnight.Technology

Dokumentation

Alles, was Client und Dashboard heute können. Inhalt: Schnellstart · Link absichern · Webhooks · Feste URLs · Anfrageprotokoll · Limits · Fehlercodes · So funktioniert es

Schnellstart

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.

Link absichern

Jeder Tunnel verlangt einen Zugangsschutz. Anfragen, die ihn nicht bestehen, bekommen 401 und erreichen Ihren Rechner nie.

ModusBefehlSo kommen Besucher hinein
Token (Standard)ot http 3000 --slug demoHeader X-OT-Tunnel: <secret> oder Aufruf von https://demo.overnight.technology/?ot=<secret>
basicot http 3000 --slug demo --basic client:s3cretDer Browser fragt nach Benutzername und Passwort
eigenes Secretot http 3000 --slug demo --secret my-long-secretToken-Modus mit einem selbst gewählten statt einem erzeugten Secret
IP-Freigabelisteot http 3000 --slug demo --allow 203.0.113.7,10.0.0.0/8Nur diese IPs oder CIDRs, und auch sie brauchen Token oder Passwort

Dieselben Optionen gibt es im Dashboard unter „Tunnel anlegen“.

Webhooks

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.

Feste URLs

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.

Anfrageprotokoll

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>.

Limits

TarifPreisTunnelAnfragen pro Tag (UTC)Transfer pro Monat
Starter€9/Monat110.0001 GB
Builder€19/Monat350.0005 GB
Team€29/Monat10200.00020 GB

Anfrageinhalte bis 20 MB. Ihre App hat 60 Sekunden pro Antwort. Nach Erreichen des Tageslimits bekommen Anfragen bis Mitternacht UTC eine 429.

Fehlercodes

401Token oder Passwort fehlt oder ist falsch, oder die IP des Besuchers steht nicht auf der Freigabeliste.
404 unknown tunnelEs gibt keinen Tunnel mit diesem Slug.
409 slug takenDer Slug gehört einem anderen Konto. Wählen Sie einen anderen.
frpc: start proxy errorDer 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.
429Tageslimit Ihres Tarifs erreicht.
502 / 404 von frpZugangsschutz bestanden, aber ot http läuft nicht oder am lokalen Port lauscht nichts.

So funktioniert es

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.

Zugang auf Anfrage, noch keine Online-Zahlung · Status · hello@overnight.technology · Impressum · Datenschutz · Widerruf · overnight.technology · overnight.holdings · overnight.host · noctis.industries