CLI-Referenz
Ein einziges Binary, addtothese, ist alles, was Sie brauchen: anmelden, Tunnel öffnen und TCP-Ports weiterleiten. Ihre Anmeldung wird in ~/.addtothese/config.yaml gespeichert (unter Windows in %USERPROFILE%\.addtothese\config.yaml).
addtothese login
addtothese login --token att_...
Speichert ein API-Token. Ohne --token wird das Token über die Standardeingabe abgefragt. addtothese logout entfernt es wieder.
addtothese http
addtothese http <port|host:port|url> [--subdomain name]
Macht einen lokalen HTTP-Dienst erreichbar. Ohne --subdomain erhalten Sie einen zufälligen Endpunkt. Mit der Option nutzt der Tunnel einen Namen, den Sie im Dashboard reserviert haben. Die CLI verbindet sich nach Netzwerkabbrüchen selbst neu und erneuert ihre Zugangsdaten, bevor sie ablaufen.
| Option | Standard | Bedeutung |
|---|---|---|
| --subdomain | zufällig | Zu verwendender reservierter Name |
| --timeout | 10s | Timeout für die Weiterleitung jeder Anfrage an Ihren Dienst |
| --access-log | true | Jede weitergeleitete Anfrage ausgeben |
| --log-level | warn | debug, info, warn oder error |
Eine URL mit E-Mail-Codes schützen
addtothese http 4321 --allowed-email ana@gmail.com --allowed-email '*@company.com'
Nur die Personen, die Sie auflisten, können die URL öffnen. Ein Besucher gibt seine E-Mail-Adresse ein; steht sie auf der Liste, erhält er einen 6-stelligen Code, der 10 Minuten gültig ist, und bleibt 24 Stunden angemeldet. *@company.com erlaubt eine ganze Domain. Wiederholen Sie das Flag für jede Adresse oder Domain.
Ihr Dienst erhält die verifizierte Adresse im Header X-AddToThese-Email. Jeder Aufruf ersetzt die Liste, daher macht ein Aufruf ohne --allowed-email die URL wieder öffentlich. Sie können die Liste auch auf der Endpunktseite im Dashboard bearbeiten.
addtothese tcp
addtothese tcp 5432 --subdomain mydb
Macht einen rohen TCP-Port erreichbar, etwa Postgres, SSH oder RDP. Wer darauf zugreifen muss, startet auf seiner Seite den Forwarder, der einen lokalen Port öffnet und mit Ihrem Dienst verbindet:
addtothese forward tcp 5432 mydb --connect.url https://mydb.addtothese.com
Danach kann man sich mit localhost:5432 verbinden, als liefe die Datenbank auf dem eigenen Rechner.
Umgebungsvariablen
| Variable | Bedeutung |
|---|---|
| ADDTOTHESE_TOKEN | API-Token, hat Vorrang vor dem gespeicherten |
| ADDTOTHESE_CONFIG | Pfad zu einer alternativen Konfigurationsdatei |