Apparaatterminal
Gratis Desktop v8.6+ Windows, Linux en macOS
Op deze pagina 13 secties
- Hoe het werkt
- Voordat je begint
- Een apparaat toevoegen
- Open Apparaat toevoegen
- Kies het token
- Voer de opdracht uit op de computer
- Voer de code in en keur goed
- Zonder iemand bij de computer
- Opdrachtopties
- De apparatenlijst
- Een terminal openen in de browser
- Kies Terminal
- Voer je authenticatorcode in
- Verbinden met ssh
- SSH-sleutels
- Met de Localtonet-client
- Toegangssleutels voor scripts en AI-agents
- Elio
- Verbindingsgeschiedenis
- Een apparaat hernoemen, verwijderen of uitschakelen
- Beveiligingsopmerkingen
- Probleemoplossing
- Gerelateerde pagina's
Mijn apparaten toont je computers met hun CPU-, geheugen- en schijfgebruik en opent vanuit je browser een echte shell op elk van die computers. Je schakelt het in met één opdracht op de machine; er hoeft niets op de computer te luisteren op een openbare poort.
Hoe het werkt #
Je voert localtonet --terminal enable uit op de machine en keurt de korte code die de opdracht toont goed in je dashboard. Vanaf dan opent een knop Terminal een shell op die machine in een browsertabblad. Dezelfde shell is bereikbaar vanuit elke terminal met een ssh-opdracht die het dashboard toont.
- Het apparaat maakt alleen uitgaande verbindingen. Je hoeft geen inkomende poort te openen en geen SSH-server te installeren.
- Een shell openen vanuit de browser vereist elke keer een verse code uit je authenticator-app.
- Alleen de lokale opdracht kan de terminal inschakelen. Het kan niet vanuit het dashboard worden ingeschakeld.
Voordat je begint #
- Localtonet op de machine. Minimaal vereiste versie van de Localtonet-app voor deze functie: Desktop v8.6. Download de app op de pagina Downloads.
- Een AuthToken voor die machine. Geef elke computer een eigen token: als je één token op een tweede computer gebruikt, wordt de eerste losgekoppeld. De terminal werkt met tokens van je persoonlijke account, niet met teamtokens. Zie AuthTokens.
- Tweestapsverificatie. Voor het openen van een shell is een authenticator-app op je account nodig. Als die nog niet is ingesteld, toont Mijn apparaten Tweestapsverificatie inschakelen. Zie Account en beveiliging.
Mijn apparaten staat in het menu van je persoonlijke dashboard. Het wordt niet getoond als er een team is geselecteerd.
Een apparaat toevoegen #
-
Open Apparaat toevoegen #
Open Mijn apparaten en kies Apparaat toevoegen.
-
Kies het token #
Kies een bestaand token, of kies Nieuwe token genereren om er een te maken en in de opdracht te zetten. Als Localtonet al op deze computer draait, kies dan het token daarvan. De lijst markeert tokens die online zijn of al op een ander apparaat worden gebruikt. Een token dat op dit moment verbonden is, toont een waarschuwing: gebruik het alleen als Localtonet op ditzelfde apparaat draait.
-
Voer de opdracht uit op de computer #
Kopieer de opdracht uit het dialoogvenster en voer die uit in een terminal op de computer die je wilt toevoegen. Als Localtonet daar als service draait, gebruik dan een terminal met beheerdersrechten of
sudo.Op de computerlocaltonet --terminal enable --authtoken <YOUR_TOKEN>De opdracht toont een goedkeuringscode en wacht:
UitvoerApproval code: ABCD-EFGH Open https://localtonet.com/devices, choose Add device and enter this code. Waiting for approval...Als je de opdracht als beheerder of root uitvoert, vraagt die eerst Run shells as user: en stelt je eigen account voor. Zonder die rechten draaien shells onder het account waarmee de opdracht is uitgevoerd.
-
Voer de code in en keur goed #
Typ in het dialoogvenster de goedkeuringscode onder 2. Voer de getoonde code in. Hoofdletters en het streepje worden voor je toegevoegd, en je kunt de hele regel plakken die de opdracht heeft getoond. Voer de 6-cijferige code uit je authenticator-app in en kies Apparaat goedkeuren.
De opdracht op de computer toont daarna Terminal enabled. Shells will run as … en het apparaat verschijnt in de lijst. Het staat als online zolang Localtonet erop draait.
De goedkeuringscode is 15 minuten geldig. De code bestaat uit 8 tekens en bevat nooit de tekens I, L, O, U, 0 of 1. Als de code is verlopen, meldt de opdracht dat: voer de opdracht opnieuw uit.
Na goedkeuring gaat een opdracht die je handmatig in een console hebt gestart, verder als een gewone Localtonet-run. In een script, of als Localtonet al met dit token op het apparaat draait, stopt de opdracht zodra de terminal is ingeschakeld.
Zonder iemand bij de computer #
Gebruik voor een machine waar niemand een code kan aflezen, bijvoorbeeld een server die je met een script hebt ingericht, een eenmalige sleutel in plaats van de goedkeuringscode.
- Kies in het dialoogvenster Een apparaat toevoegen het token en voer je authenticatorcode in.
- Open Kan niemand op die computer een code aflezen? en kies Eenmalige sleutel maken. De sleutel is één uur geldig en werkt één keer.
- Kopieer de opdracht en vervang
ACCOUNTdoor het gebruikersaccount waaronder shells op die computer moeten draaien.
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>Met een geldige sleutel wordt het apparaat meteen goedgekeurd en wordt er geen code getoond.
Opdrachtopties #
| Optie | Wat het doet |
|---|---|
--terminal enable | Schakelt de externe terminal in voor deze computer en start het koppelen. |
--terminal disable | Schakelt de terminal op deze computer uit en verwijdert het apparaat uit je account. |
--terminal status | Toont of de terminal is ingeschakeld en onder welk account shells draaien. |
--terminal-user <ACCOUNT> | Het account waaronder shells draaien, wanneer je inschakelt als root of beheerder. In dat geval vereist wanneer de opdracht zonder console draait, bijvoorbeeld vanuit een script. |
--pairing-key <PAIRING_KEY> | De eenmalige sleutel uit het dashboard, zodat er geen goedkeuringscode nodig is. |
De apparatenlijst #
De lijst wordt automatisch vernieuwd zolang de pagina open is.
| Kolom | Wat het toont |
|---|---|
| Apparaat | De naam van de computer, het besturingssysteem en de architectuur, en het account waaronder shells draaien. |
| Status | Online betekent dat Localtonet op de computer draait en verbonden is. |
| CPU | Huidige processorbelasting. Wordt getoond zolang het apparaat online is. |
| Geheugen | Gebruikt geheugen ten opzichte van het totaal. Wordt getoond zolang het apparaat online is. |
| Schijf | Gebruikte schijfruimte ten opzichte van het totaal. Wordt getoond zolang het apparaat online is. |
| Acties | Terminal, Sleutels, verbindingsgeschiedenis, hernoemen en verwijderen. |
Een terminal openen in de browser #
-
Kies Terminal #
Kies Terminal in de rij van het apparaat. De knop werkt alleen terwijl het apparaat online is. Het dialoogvenster vertelt je onder welk account de shell draait.
-
Voer je authenticatorcode in #
Voer de 6-cijferige code uit je authenticator-app in en kies Terminal openen. De shell opent in een nieuw browsertabblad.
Verbinden met ssh #
Het dialoogvenster Terminal toont ook een opdracht onder Of vanuit elke terminal, zonder iets te installeren. Die werkt vanaf elke computer met een ssh-client. De opdracht heeft deze vorm, waarbij <DEVICE> de naam van je apparaat is en <NODE> de Localtonet-server waarmee het verbonden is:
ssh -p 24 <DEVICE>@<NODE>Kopieer de opdracht uit het dialoogvenster: die toont de exacte opdracht voor jouw apparaat.
- Het dialoogvenster toont de Vingerafdruk van de server. ssh toont een vingerafdruk wanneer je voor het eerst verbinding maakt. Als die overeenkomt, ben je bij Localtonet uitgekomen.
- Als je geen SSH-sleutel hebt toegevoegd, toont ssh een link om in je browser goed te keuren. De pagina Verbinding goedkeuren noemt het apparaat en het IP-adres waarvan het verzoek afkomstig is. Voer je authenticatorcode in en kies Verbinding toestaan, en ga dan terug naar je terminal. Het verzoek verloopt na 5 minuten.
Keur een verbinding alleen goed als je de ssh-opdracht zojuist zelf hebt uitgevoerd. Wie het verzoek heeft gedaan, krijgt een shell op die computer.
SSH-sleutels #
Voeg de publieke SSH-sleutel van je eigen computer toe, zodat ssh, scp en sftp verbinding maken zonder dat er goedkeuring in de browser nodig is.
- Kies op Mijn apparaten SSH-sleutels.
- Voer een Naam in en plak één regel uit je bestand met de publieke sleutel, bijvoorbeeld
~/.ssh/id_ed25519.pub, in Publieke sleutel. Plak nooit je privésleutel. - Voer je authenticatorcode in en kies Sleutel toevoegen.
Geaccepteerde sleuteltypen zijn ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521 en ssh-rsa. Een sleutel geldt voor alle apparaten van je account. Kies Verwijderen naast een sleutel om te voorkomen dat die nog werkt. Het dialoogvenster toont ook een scp-voorbeeld voor een van je apparaten:
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/Met de Localtonet-client #
Als Localtonet is geïnstalleerd op de computer waarvandaan je verbindt, maakt localtonet ssh ook verbinding, en blijft de sessie helemaal tot aan het apparaat versleuteld.
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptimeZonder sleutel toont de opdracht Approve this connection in your browser met een link en gaat verder zodra je goedkeurt. Alles na -- wordt als één opdracht op het apparaat uitgevoerd in plaats van een shell te openen.
Toegangssleutels voor scripts en AI-agents #
Met een toegangssleutel kan een script of een AI-agent zonder browser één computer bereiken. Wie de sleutel heeft, kan daar opdrachten uitvoeren, dus houd hem privé.
- Kies Sleutels in de rij van het apparaat.
- Voer een Naam in, stel Geldig voor (dagen) in en voer je authenticatorcode in. De sleutel werkt na dat aantal dagen niet meer, maximaal 3650.
- Kies Sleutel maken en kopieer de sleutel nu. Hij wordt niet opnieuw getoond.
Manieren om de sleutel te gebruiken:
- ssh. Voer de ssh-opdracht uit die het dialoogvenster toont. Plak de sleutel wanneer ssh erom vraagt.
- Localtonet-client. Geef de sleutel mee met de optie
--key, zoals in het onderstaande voorbeeld. - MCP. AI-agents die verbonden zijn met de MCP-server van Localtonet kunnen de sleutel doorgeven aan de tool
RunDeviceCommand.
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptimeHet dialoogvenster toont de sleutels van het apparaat met hun vervaldatum. Kies Verwijderen om er een in te trekken.
Elio #
De knop Elio op Mijn apparaten gaat over Elio, de gratis en opensource SSH-client van Localtonet. Je downloadt hem van elio.sh, meldt je aan vanuit Elio en keurt het verzoek in het dashboard goed met je tweestapscode. Elio ziet daarna de namen en de status van je apparaten. Voor het openen van een shell is nog steeds de toegangssleutel van dat apparaat of een goedkeuring nodig. Het dialoogvenster toont de aangemelde kopieën van Elio; als je er een verwijdert, wordt die afgemeld.
Verbindingsgeschiedenis #
Kies de klokknop in de rij van een apparaat om de laatste verbindingen te zien. Elke regel toont wanneer het gebeurde, hoe de verbinding is gemaakt en vanaf welk IP-adres. Het hoe is een van deze: de browserterminal, ssh met je SSH-sleutel, ssh met een toegangssleutel, ssh goedgekeurd in de browser, localtonet ssh met een toegangssleutel of goedgekeurd in de browser, en een AI-agent via MCP met een toegangssleutel. De lijst bevat de 50 meest recente verbindingen.
Localtonet bewaart alleen dit overzicht. De opdrachten die je typt en hun uitvoer worden niet opgeslagen. Gebruik de lijst om een verbinding op te sporen die je niet zelf hebt gemaakt: als je er een vindt, verwijder dan de toegangssleutels en SSH-sleutels die je niet meer nodig hebt.
Een apparaat hernoemen, verwijderen of uitschakelen #
| Actie | Waar | Resultaat |
|---|---|---|
| Hernoemen | De potloodknop in de rij. | Wijzigt de naam die in de lijst en in de ssh-opdracht wordt gebruikt. Gebruik letters, cijfers, punten, streepjes of underscores. |
| Verwijderen | De prullenbakknop in de rij. | Verwijdert de computer uit je account. De sleutels werken niet meer en het apparaat moet opnieuw worden goedgekeurd om terug te komen. |
| Uitschakelen | Op de computer zelf. | Schakelt de terminal lokaal uit en verwijdert het apparaat uit je account. |
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>Uitschakelen werkt altijd op de computer zelf, ook als het dashboard niet bereikbaar is. In dat geval meldt de opdracht dat je het apparaat ook in het dashboard moet verwijderen.
Beveiligingsopmerkingen #
- Een shell op een machine geeft volledige toegang tot alles wat het account kan doen. Kies het account waaronder shells draaien zorgvuldig; een account zonder bijzondere rechten beperkt wat een sessie kan wijzigen.
- Alles wat tot een shell kan leiden, vraagt om een verse authenticatorcode: een apparaat goedkeuren, een terminal openen, een toegangssleutel maken, een SSH-sleutel toevoegen en een ssh-verbinding goedkeuren.
- Een toegangssleutel of een toegevoegde SSH-sleutel maakt verbinding zonder die code. Geef sleutels een korte geldigheid, bewaar ze zoals wachtwoorden en verwijder de sleutels die je niet meer gebruikt.
- Na te veel pogingen in korte tijd antwoordt het dashboard met Te veel pogingen. Wacht een minuut en probeer het opnieuw.
- Bekijk af en toe de verbindingsgeschiedenis. Een verbinding die je niet herkent, betekent dat er een sleutel of goedkeuring is gebruikt die je niet verwachtte.
- Een apparaat verwijderen, of
--terminal disableerop uitvoeren, beëindigt de toegang voor al zijn sleutels.
Probleemoplossing #
Die goedkeuringscode is onjuist of verlopen
Vergelijk de code met die uit de uitvoer van de opdracht. Een code is 15 minuten geldig en hoort bij het account van het token in de opdracht. Voer de opdracht opnieuw uit om een nieuwe code te krijgen.
Remote terminal is available on personal tokens only
Het token in de opdracht hoort bij een team. Maak een token in je persoonlijke account en gebruik dat.
The pairing key is not valid or has expired
Een eenmalige sleutel werkt één keer en één uur lang. Maak een nieuwe in het dialoogvenster Een apparaat toevoegen.
Kies het account voor shells met --terminal-user
De opdracht draait als root of beheerder zonder console, dus kan niet vragen. Voeg --terminal-user <ACCOUNT> toe.
De knop Terminal is uitgeschakeld, of This device is offline
De terminal opent alleen terwijl het apparaat online is. Start Localtonet op die computer met hetzelfde token.
Die authenticatorcode is niet correct
Voer de 6-cijferige code in die je authenticator-app voor Localtonet toont. Het is niet je wachtwoord en niet de code op de computer, en hij verandert elke 30 seconden.
Dit verzoek is verlopen. Begin opnieuw vanuit Mijn apparaten
Een verzoek om een terminal te openen of een ssh-verbinding goed te keuren is kortlevend. Kies opnieuw Terminal, of voer de ssh-opdracht opnieuw uit.
Dat lijkt niet op een publieke SSH-sleutel
Plak de hele regel uit je .pub-bestand, beginnend met het sleuteltype.
De terminal is al ingeschakeld op dit apparaat
Niets te doen. Om de machine opnieuw te koppelen, voer je eerst --terminal disable uit en daarna --terminal enable.