Descargar
Descargar el agente
v1.0.2 Código abierto, Apache-2.0 Código fuente en GitHub
-
1
Inicia el contenedor
Docker elige la imagen para tu máquina. El volumen conserva la identidad del agente entre actualizaciones.
docker run -d \ --name portlatch-agent \ --restart unless-stopped \ -v portlatch:/.data \ portlatch/portlatch-agent:latest
-
2
Lee el código
El agente muestra un código de ocho caracteres y espera tu aprobación.
docker logs -f portlatch-agent
-
3
Apruébalo en tu panel
Escribe el código y ponle nombre a la máquina. El túnel se establece unos segundos después: añade tu primera ruta.
-
1
Descarga el archivo comprimido
Sin Docker: en un contenedor LXC de Proxmox, en una Raspberry Pi mínima.
curl -LO https://github.com/portlatch/portlatch-agent/releases/latest/download/portlatch-agent_linux_amd64.tar.gz
En una Raspberry Pi, cambia
amd64porarm64en un sistema de 64 bits, o porarmv7en uno de 32 bits. -
2
Instala el programa y su servicio
El servicio se ejecuta con un usuario sin privilegios creado solo para él y guarda sus datos en
/var/lib/portlatch-agent. El código aparece en sus registros.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
-
3
Apruébalo en tu panel
Escribe el código y ponle nombre a la máquina. El túnel se establece unos segundos después: añade tu primera ruta.
-
4
Una vez en marcha
Comprobarlo
systemd lo arranca con la máquina, y de nuevo tras un fallo. Sus registros van al diario de systemd:
journalctl -u portlatch-agent.systemctl status portlatch-agent
Actualizarlo
Descarga el nuevo archivo, reemplaza el programa y reinicia el servicio. El agente sigue vinculado.
sudo install -m 0755 portlatch-agent /usr/local/bin/ sudo systemctl restart portlatch-agent
Quitarlo
Eliminar el agente desde tu panel lo detiene, y systemd no vuelve a arrancarlo. Después, quita el servicio, su clave y su token, y el programa.
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
-
1
Descarga y descomprime
Pon
Descargar para Windowsportlatch-agent.exeen una carpeta donde vaya a quedarse, en cualquier unidad: el servicio lo ejecuta desde ahí.C:\Program Files\Portlatch, por ejemplo. -
2
Vincúlalo desde un PowerShell de administrador
Haz clic derecho en el botón Inicio y abre el Terminal como administrador (Windows PowerShell como administrador en Windows 10). El código aparece en la ventana. Cuando lo apruebes, el agente se instala como un servicio que arranca con Windows.
cd "C:\Program Files\Portlatch" .\portlatch-agent.exe enrol
El programa aún no está firmado: Windows puede avisar de un editor desconocido, lo que no lo detiene. Si SmartScreen lo bloquea, elige Más información y después Ejecutar de todas formas.
-
3
Apruébalo en tu panel
Escribe el código y ponle nombre a la máquina. El túnel se establece unos segundos después: añade tu primera ruta.
-
4
Una vez en marcha
Comprobarlo
El servicio
portlatch-agentarranca con Windows, y de nuevo tras un fallo. Sus registros están enC:\ProgramData\Portlatch\agent.log.Get-Service portlatch-agent
Actualizarlo
Desde un PowerShell de administrador: detén el servicio, reemplaza
portlatch-agent.exeen su carpeta y vuelve a iniciarlo. El agente sigue vinculado.Stop-Service portlatch-agent Start-Service portlatch-agent
Quitarlo
Eliminar el agente desde tu panel detiene el servicio para siempre. Después, desde un PowerShell de administrador,
uninstallquita el servicio, la clave y el token, y conserva los registros. La carpeta la borras tú..\portlatch-agent.exe uninstall
También funciona en Raspberry Pi Proxmox Todo lo que Go sepa compilar, desde el código fuente
Con Docker en Synology QNAP Unraid TrueNAS OpenMediaVault
Actualizaciones
Nada actualiza el agente a tus espaldas. Tu panel muestra «Actualización disponible» en cuanto sale una versión más reciente, y las versiones anteriores siguen funcionando mientras tanto.
Cómo actualizarQué necesita
UDP saliente para el túnel, HTTPS saliente para el panel. Nada entrante, nada que abrir en tu router.
Cuando no se conectaQué nos cuenta
Una señal cada 30 segundos con su versión y su plataforma. Nada sobre tu máquina, tu red o tu tráfico.
Leer el código fuente