Pobierz agenta

Uruchomić kontener

Docker sam wybiera obraz właściwy dla danego komputera. Wolumen przechowuje tożsamość agenta między aktualizacjami.

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

Odczytać kod

Agent wyświetla ośmioznakowy kod, a następnie czeka na zatwierdzenie.

docker logs -f portlatch-agent

Zatwierdzić agenta w panelu

Należy wpisać kod i nadać nazwę komputerowi. Tunel zostanie zestawiony kilka sekund później: można dodać pierwszą trasę.

Najpierw należy utworzyć bezpłatne konto albo się zalogować.

Pobrać archiwum

Bez Dockera: w kontenerze LXC w Proxmox, na minimalnym Raspberry Pi.

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

Na Raspberry Pi należy zastąpić amd64 przez arm64 w systemie 64-bitowym albo przez armv7 w systemie 32-bitowym.

Zainstalować program i jego usługę

Usługa działa jako nieuprzywilejowany użytkownik utworzony wyłącznie dla niej i przechowuje dane w /var/lib/portlatch-agent. Kod pojawia się w jej logach.

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

Zatwierdzić agenta w panelu

Należy wpisać kod i nadać nazwę komputerowi. Tunel zostanie zestawiony kilka sekund później: można dodać pierwszą trasę.

Najpierw należy utworzyć bezpłatne konto albo się zalogować.

Po uruchomieniu

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

Pobrać i rozpakować

Plik portlatch-agent.exe należy umieścić w folderze, w którym pozostanie, na dowolnym dysku: usługa uruchamia go z tego miejsca. Na przykład C:\Program Files\Portlatch.

Sparować agenta w PowerShellu uruchomionym jako administrator

Należy kliknąć prawym przyciskiem przycisk Start i otworzyć Terminal jako administrator (w Windows 10: Windows PowerShell jako administrator). Kod pojawi się w oknie. Po zatwierdzeniu agent zainstaluje się jako usługa uruchamiana razem z Windows.

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

Program nie jest jeszcze podpisany: Windows może ostrzec przed nieznanym wydawcą, co nie blokuje uruchomienia. Jeśli SmartScreen go zablokuje, należy wybrać Więcej informacji, a następnie Uruchom mimo to.

Zatwierdzić agenta w panelu

Należy wpisać kod i nadać nazwę komputerowi. Tunel zostanie zestawiony kilka sekund później: można dodać pierwszą trasę.

Najpierw należy utworzyć bezpłatne konto albo się zalogować.

Po uruchomieniu

Get-Service portlatch-agent

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

.\portlatch-agent.exe uninstall