Localtonet installeren op macOS
Op deze pagina 9 secties
- Voordat je begint
- Installeren met Homebrew
- Voeg de Localtonet-tap toe en installeer
- De installatie controleren
- Handmatig installeren
- Downloaden en uitpakken
- Optioneel: verplaats hem naar je PATH
- De client starten
- Starten met je token
- De sessie controleren
- Uitvoeren als launchd-service
- De service installeren
- Controleren of de service draait
- Wat de installatie aanmaakt
- Servicecommando's
- Upgraden
- Verwijderen
- Probleemoplossing
- 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
sudokan gebruiken.
Installeren met Homebrew #
-
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.
Terminalbrew tap localtonet/tap brew install localtonet -
De installatie controleren #
Terminallocaltonet --versionDe 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.
| Mac | Archief |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
Downloaden en uitpakken #
Apple Siliconcurl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip unzip localtonet-osx-arm64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonetIntelcurl -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 -
Optioneel: verplaats hem naar je PATH #
Zonder deze stap start je de client via zijn pad,
~/localtonet/localtonet. Daarna kun je in elke maplocaltonettypen.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
De client starten #
-
Starten met je token #
Terminallocaltonet --authtoken <YOUR_TOKEN>De client slaat de token lokaal op. De volgende keer kun je hem alleen met
localtonetstarten. Als je hem zonder opgeslagen token start, vraagt hijPlease Enter AuthToken or PIN. -
De sessie controleren #
De terminal toont
Session Status: Connectedboven een tabel met één rij per draaiende tunnel:IP/Url,Protocol,Client IP,Client Port,PingenStatus. 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.
-
De service installeren #
Terminalsudo 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--authtokennodig om hem te vinden. -
Controleren of de service draait #
Terminalsudo 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 #
| Item | Locatie |
|---|---|
| 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.
| Opdracht | Wat het doet |
|---|---|
--install-service | Schrijft de jobdefinitie, laadt hem en start de client. |
--start-service | Start de job. Als hij al draait, herstart launchd hem. |
--stop-service | Stopt de client. De job blijft geïnstalleerd en start bij de volgende opstart opnieuw. |
--status-service | Toont de status, bijvoorbeeld Running, Stopped, NotFound of Error. |
--remove-service | Stopt 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.
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 #
- Als je de service hebt geïnstalleerd, verwijder hem dan:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Om de opgeslagen token te verwijderen, start je de client en druk je op F12.
- Verwijder de client. Met Homebrew:
brew uninstall localtonet, enbrew untap localtonet/tapom de tap te verwijderen. Verwijder na een handmatige installatie het bestandlocaltonet.
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:
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.