Agent herunterladen

Container starten

Docker wählt das passende Image für Ihren Rechner. Das Volume bewahrt die Identität des Agenten über Updates hinweg.

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

Code ablesen

Der Agent zeigt einen achtstelligen Code an und wartet dann auf Ihre Bestätigung.

docker logs -f portlatch-agent

Im Dashboard bestätigen

Geben Sie den Code ein und benennen Sie den Rechner. Der Tunnel steht wenige Sekunden später: Legen Sie Ihre erste Route an.

Erstellen Sie zuerst ein kostenloses Konto oder melden Sie sich an.

Archiv herunterladen

Ohne Docker: in einem Proxmox-LXC-Container, auf einem minimalen Raspberry Pi.

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

Ersetzen Sie auf einem Raspberry Pi amd64 durch arm64 für ein 64-Bit-System oder durch armv7 für ein 32-Bit-System.

Programm und Dienst installieren

Der Dienst läuft unter einem nur für ihn angelegten Benutzer ohne Rechte und legt seine Daten in /var/lib/portlatch-agent ab. Der Code erscheint in seinen Logs.

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

Im Dashboard bestätigen

Geben Sie den Code ein und benennen Sie den Rechner. Der Tunnel steht wenige Sekunden später: Legen Sie Ihre erste Route an.

Erstellen Sie zuerst ein kostenloses Konto oder melden Sie sich an.

Im laufenden Betrieb

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

Herunterladen und entpacken

Legen Sie portlatch-agent.exe in einen Ordner, in dem es bleibt, auf einem beliebigen Laufwerk: Der Dienst startet es von dort. Zum Beispiel C:\Program Files\Portlatch.

In einer Administrator-PowerShell koppeln

Klicken Sie mit der rechten Maustaste auf die Start-Schaltfläche und öffnen Sie das Terminal als Administrator (unter Windows 10 die Windows PowerShell als Administrator). Der Code erscheint im Fenster. Nach der Bestätigung installiert sich der Agent als Dienst, der mit Windows startet.

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

Das Programm ist noch nicht signiert: Windows warnt eventuell vor einem unbekannten Herausgeber, was es nicht aufhält. Blockiert SmartScreen es, wählen Sie Weitere Informationen und dann Trotzdem ausführen.

Im Dashboard bestätigen

Geben Sie den Code ein und benennen Sie den Rechner. Der Tunnel steht wenige Sekunden später: Legen Sie Ihre erste Route an.

Erstellen Sie zuerst ein kostenloses Konto oder melden Sie sich an.

Im laufenden Betrieb

Get-Service portlatch-agent

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

.\portlatch-agent.exe uninstall