Primeros pasos

Antes de empezar

Necesitas:

1. Un token de túnel — créalo desde el panel de Nubulus en la sección Tunnels → Nuevo túnel.
2. Docker y Docker Compose en tu servidor.
3. El servicio que quieres exponer corriendo localmente (en el mismo servidor o accesible desde él).

Instalación en 3 pasos

1. Crea el fichero docker-compose.yml

services:
  nubulus-tunnel:
    image: code.as210469.net/nubulusnetworkopensource/tunnel:latest
    container_name: nubulus-tunnel
    environment:
      TUNNEL_TOKEN: "tun_xxxxxxxxxxxxxxxxxxxxxxxxx"
    restart: unless-stopped
    networks:
      - tunnel-network

networks:
  tunnel-network:
    driver: bridge

Sustituye tun_xxxxxxxxxxxxxxxxxxxxxxxxx por tu token real.

2. Añade tu servicio a la misma red

Añade el servicio que quieres exponer a la red tunnel-network para que el agente pueda alcanzarlo:

services:
  mi-app:
    image: mi-app:latest
    networks:
      - tunnel-network

  nubulus-tunnel:
    image: ghcr.io/nubulusnetwork/tunnel-agent:latest
    container_name: nubulus-tunnel
    environment:
      TUNNEL_TOKEN: "tun_xxxxxxxxxxxxxxxxxxxxxxxxx"
    restart: unless-stopped
    networks:
      - tunnel-network

networks:
  tunnel-network:
    driver: bridge

3. Arranca el agente

docker compose up -d

Comprueba que el túnel está conectado:

docker compose logs nubulus-tunnel

Deberías ver:

{"level":"info","message":"túnel activo"}
{"level":"info","message":"túnel conectado"}

Configura las rutas en el panel

Una vez el agente está corriendo, ve al panel de Nubulus y configura las rutas de tu túnel:

1. Abre tu túnel en Tunnels → tu túnel.
2. En la sección Rutas, pulsa Añadir ruta.
3. Especifica el hostname, el path y el servicio al que debe llegar el tráfico.

El agente aplica los cambios automáticamente en menos de 30 segundos, sin reiniciar.

Verifica que funciona

Abre en el navegador el dominio configurado en tu ruta. Si ves la respuesta de tu servicio, todo está funcionando.

Si algo no va bien, revisa los logs:

docker compose logs -f nubulus-tunnel