Naar de inhoud
Localtonet Localtonet Dashboard

Localtonet installeren op macOS

Hulp bij deze pagina
Op deze pagina 9 secties
  1. Voordat je begint
  2. Installeren met Homebrew
  3. Voeg de Localtonet-tap toe en installeer
  4. De installatie controleren
  5. Handmatig installeren
  6. Downloaden en uitpakken
  7. Optioneel: verplaats hem naar je PATH
  8. De client starten
  9. Starten met je token
  10. De sessie controleren
  11. Uitvoeren als launchd-service
  12. De service installeren
  13. Controleren of de service draait
  14. Wat de installatie aanmaakt
  15. Servicecommando's
  16. Upgraden
  17. Verwijderen
  18. Probleemoplossing
  19. Gerelateerde pagina's

Op macOS is de Localtonet-client een consoleprogramma voor Macs met Intel en Apple Silicon. Installeer hem met Homebrew of vanuit een ZIP-archief, start hem met je AuthToken en installeer hem als launchd-service als hij bij elke opstart moet starten.

Voordat je begint #

  • Een Localtonet-account. Maak er gratis een aan als je er nog geen hebt.
  • Je AuthToken. Kies Kopiëren op de kaart AuthToken van het Dashboard, of kopieer een token uit Mijn tokens.
  • Voor de installatie met Homebrew: Homebrew.
  • Voor de launchd-service: een account dat sudo kan gebruiken.

Installeren met Homebrew #

  1. Voeg de Localtonet-tap toe en installeer #

    Een tap voegt een repository van derden toe aan Homebrew, zodat je er formules uit kunt installeren en bijwerken.

    Terminal
    brew tap localtonet/tap
    brew install localtonet
  2. De installatie controleren #

    Terminal
    localtonet --version

    De opdracht toont de versie van de client.

Handmatig installeren #

Als je liever rechtstreeks downloadt, neem dan het archief voor jouw Mac. De ZIP bevat één bestand, localtonet.

MacArchief
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. Downloaden en uitpakken #

    Apple Silicon
    curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
    unzip localtonet-osx-arm64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
    Intel
    curl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip
    unzip localtonet-osx-64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Optioneel: verplaats hem naar je PATH #

    Zonder deze stap start je de client via zijn pad, ~/localtonet/localtonet. Daarna kun je in elke map localtonet typen.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

De client starten #

  1. Starten met je token #

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    De client slaat de token lokaal op. De volgende keer kun je hem alleen met localtonet starten. Als je hem zonder opgeslagen token start, vraagt hij Please Enter AuthToken or PIN.

  2. De sessie controleren #

    De terminal toont Session Status: Connected boven een tabel met één rij per draaiende tunnel: IP/Url, Protocol, Client IP, Client Port, Ping en Status. De tabel is leeg totdat je een tunnel start in het dashboard, zie Snelstart.

    Druk op Ctrl + C om de client te stoppen. Druk op F12 om de opgeslagen token te verwijderen en af te sluiten.

Uitvoeren als launchd-service #

Een service start Localtonet bij elke opstart, houdt hem draaiende nadat je bent uitgelogd en heeft geen open terminal nodig. De serviceopdrachten hebben root nodig, dus voer ze uit met sudo.

  1. De service installeren #

    Terminal
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    De opdracht registreert een launchd-job voor het hele systeem voor deze token en start hem meteen. Hij antwoordt met de naam van de job:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> zijn de eerste 9 tekens van je token. Elke token krijgt zijn eigen job, dus de andere serviceopdrachten hebben dezelfde --authtoken nodig om hem te vinden.

  2. Controleren of de service draait #

    Terminal
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    Een draaiende job antwoordt [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. In het dashboard toont de token Online onder Mijn tokens.

Wat de installatie aanmaakt #

ItemLocatie
Definitie van de launchd-job/Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist
Standaarduitvoer van de client/var/log/Localtonet_<TOKEN_PREFIX>.out.log
Foutuitvoer van de client/var/log/Localtonet_<TOKEN_PREFIX>.err.log

De job start wanneer de Mac opstart, en launchd start de client opnieuw als hij met een fout stopt. De job voert het bestand localtonet uit op het pad dat het had toen je de service installeerde, met de token als onderdeel van de argumenten.

Servicecommando's #

Voer elke opdracht uit met sudo en voeg --authtoken <YOUR_TOKEN> toe.

OpdrachtWat het doet
--install-serviceSchrijft de jobdefinitie, laadt hem en start de client.
--start-serviceStart de job. Als hij al draait, herstart launchd hem.
--stop-serviceStopt de client. De job blijft geïnstalleerd en start bij de volgende opstart opnieuw.
--status-serviceToont de status, bijvoorbeeld Running, Stopped, NotFound of Error.
--remove-serviceStopt de job, ontlaadt hem en verwijdert de jobdefinitie.

De service wordt geïnstalleerd met de opties die je samen met --install-service meegeeft. De opties staan in de CLI-referentie.

Upgraden #

  • Homebrew: brew upgrade localtonet
  • Handmatige installatie: download het huidige archief en vervang het bestand localtonet.

Als Localtonet als service draait, installeer de service dan opnieuw na een Homebrew-upgrade: verwijder hem en installeer hem daarna met dezelfde token. Bij het installeren wordt hij ook gestart.

Terminal
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>

De job bewaart het pad van het bestand waarvan hij is geïnstalleerd. Na een handmatige upgrade waarbij de client op dezelfde plek blijft staan, volstaat het om de service te stoppen met --stop-service, het bestand te vervangen en de service te starten met --start-service. Uitvoeren als service beschrijft deze opdrachten.

Verwijderen #

  1. Als je de service hebt geïnstalleerd, verwijder hem dan: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Om de opgeslagen token te verwijderen, start je de client en druk je op F12.
  3. Verwijder de client. Met Homebrew: brew uninstall localtonet, en brew untap localtonet/tap om de tap te verwijderen. Verwijder na een handmatige installatie het bestand localtonet.

Probleemoplossing #

Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.

De opdracht is zonder root uitgevoerd. Herhaal hem met sudo.

sudo: localtonet: command not found

sudo vindt de client niet in zijn eigen zoekpad. Geef in plaats daarvan het volledige pad op. command -v localtonet toont het, bijvoorbeeld:

Bash
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>

Na een handmatige installatie zonder de PATH-stap is het pad ~/localtonet/localtonet.

Install failed: Plist already exists for 'Localtonet_…'

Er is al een service voor deze token geïnstalleerd. Controleer hem met --status-service. Om hem opnieuw te installeren, voer je eerst --remove-service uit.

De service is geïnstalleerd maar de token blijft Offline

Lees het foutlogboek van de job, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, en controleer of het bestand localtonet nog bestaat op het pad dat het had toen je de service installeerde.

Wrong Token!

De client verwacht de AuthToken van 33 tekens uit Mijn tokens, of een pincode van 6 cijfers die niet is verlopen. Kopieer de token opnieuw en voer hem in bij de prompt.

This token is used in another localtonet application!

Een andere Localtonet-client op deze Mac draait al met dezelfde token. Sluit hem af, of start deze met een andere token. Gebruik één draaiende client per token.

Support