Scarica l’agente

Avviare il container

Docker sceglie l’immagine adatta alla Sua macchina. Il volume conserva l’identità dell’agente tra un aggiornamento e l’altro.

docker run -d \
  --name portlatch-agent \
  --restart unless-stopped \
  -v portlatch:/.data \
  portlatch/portlatch-agent:latest

Leggere il codice

L’agente mostra un codice di otto caratteri, poi attende la Sua approvazione.

docker logs -f portlatch-agent

Approvarlo nella dashboard

Inserisca il codice e dia un nome alla macchina. Il tunnel si apre pochi secondi dopo: aggiunga la prima route.

Crei prima un account gratuito oppure acceda.

Scaricare l’archivio

Senza Docker: in un container LXC di Proxmox, su un Raspberry Pi minimale.

curl -LO https://github.com/portlatch/portlatch-agent/releases/latest/download/portlatch-agent_linux_amd64.tar.gz

Su un Raspberry Pi, sostituisca amd64 con arm64 per un sistema a 64 bit, o con armv7 per uno a 32 bit.

Installare il programma e il suo servizio

Il servizio gira con un utente senza privilegi creato solo per lui, e conserva i dati in /var/lib/portlatch-agent. Il codice compare nei suoi log.

tar -xzf portlatch-agent_linux_*.tar.gz
sudo install -m 0755 portlatch-agent /usr/local/bin/
sudo install -m 0644 portlatch-agent.service /etc/systemd/system/
sudo systemctl enable --now portlatch-agent
journalctl -u portlatch-agent -f

Approvarlo nella dashboard

Inserisca il codice e dia un nome alla macchina. Il tunnel si apre pochi secondi dopo: aggiunga la prima route.

Crei prima un account gratuito oppure acceda.

Una volta avviato

systemctl status portlatch-agent

sudo install -m 0755 portlatch-agent /usr/local/bin/
sudo systemctl restart portlatch-agent

sudo systemctl disable --now portlatch-agent
sudo systemctl clean --what=state portlatch-agent
sudo rm /etc/systemd/system/portlatch-agent.service
sudo rm /usr/local/bin/portlatch-agent
sudo systemctl daemon-reload

Scaricare e decomprimere

Metta portlatch-agent.exe in una cartella dove resterà, su qualsiasi unità: il servizio lo esegue da lì. Per esempio C:\Program Files\Portlatch.

Associarlo da un PowerShell amministratore

Faccia clic destro sul pulsante Start e apra il Terminale come amministratore (Windows PowerShell come amministratore su Windows 10). Il codice compare nella finestra. Una volta approvato, l’agente si installa come servizio che parte con Windows.

cd "C:\Program Files\Portlatch"
.\portlatch-agent.exe enrol

Il programma non è ancora firmato: Windows potrebbe avvisare di un autore sconosciuto, il che non lo blocca. Se SmartScreen lo blocca, scelga Ulteriori informazioni, poi Esegui comunque.

Approvarlo nella dashboard

Inserisca il codice e dia un nome alla macchina. Il tunnel si apre pochi secondi dopo: aggiunga la prima route.

Crei prima un account gratuito oppure acceda.

Una volta avviato

Get-Service portlatch-agent

Stop-Service portlatch-agent
Start-Service portlatch-agent

.\portlatch-agent.exe uninstall