Documentación

Empieza con VoidPort

Instala la CLI, crea un túnel y pon tu servidor local en línea.

Inicio rápido

Pon tu servidor local en línea en menos de 2 minutos.

  1. Crea una cuenta

    Regístrate en voidport.app/register y elige un plan.

  2. Crea un túnel en el dashboard

    Ve a Dashboard > Tunnels > Crear túnel. Elige qué alojas y una región.

  1. Instala la CLI

    $ curl -fsSL https://dl.voidport.app/install.sh | sh

    x64 y ARM64. Funciona en Debian, Ubuntu, Fedora, Arch y la mayoría de las demás (no en Alpine).

  2. Inicia tu túnel

    $ voidport connect <token>

    Consigue tu token en tu túnel del dashboard. Añade --port 8080 o --host 192.168.1.20 para cambiar el destino una sola vez.

Listo. Tu servidor ya es accesible en la dirección pública que aparece en el dashboard.

Guías para juegos concretos, con los puertos que necesitan: Minecraft, Terraria y más.

Instalación

  1. Instala la CLI

    $ curl -fsSL https://dl.voidport.app/install.sh | sh

    x64 y ARM64. Funciona en Debian, Ubuntu, Fedora, Arch y la mayoría de las demás (no en Alpine).

En Windows, el instalador coloca voidport.exe en %LOCALAPPDATA%\VoidPort y lo añade a tu PATH. En macOS y Linux se instala en /usr/local/bin, o en ~/.local/bin sin root ni sudo.

Descarga manual

Descarga los binarios directamente:

Comprobar la instalación

$ voidport --version

Crear un túnel

Desde el dashboard

  1. Inicia sesión en tu dashboard
  2. Haz clic en «Crear túnel»
  3. Elige qué alojas, o «Puerto personalizado» con TCP, UDP o ambos
  4. Ponle un nombre (p. ej. «minecraft») y elige una región (Núremberg, Helsinki, Ashburn o Hillsboro)
  5. Si el servidor se ejecuta en otro equipo, indica su host de destino
  6. Haz clic en «Crear túnel», inicia la CLI y luego haz clic en «Probar conexión»

Al crearlo, el dashboard muestra el token de tu túnel y el comando para iniciarlo. Puedes volver a encontrar ambos en la página del túnel. Mantén el token en secreto.

Iniciarlo

Ejecuta esto en el equipo que aloja tu servidor:

$ voidport connect <token>

Redirigir a otro puerto local solo esta vez:

$ voidport connect <token> --port 25566

Ejecutar varios túneles en una sola ventana, por ejemplo juego y chat de voz:

$ voidport connect <token1> <token2>

Con la CLI

También puedes crear y ejecutar túneles desde la terminal. Para ello necesitas hacer voidport login una vez.

$ voidport login
$ voidport tunnel --preset minecraft-java

voidport up inicia todos los túneles guardados en este equipo, voidport list los muestra.

Otros equipos y Docker

Por defecto, la CLI redirige al equipo en el que se ejecuta. Si tu servidor está en otro sitio, define el host de destino del túnel: en el formulario de creación, en la página del túnel en Ajustes, o con voidport tunnel --host. El comando de inicio sigue siendo voidport connect <token>; la CLI toma el host de destino por sí sola. --host en la línea de comandos tiene prioridad.

El host de destino es un nombre o una dirección IP tal como lo ve el equipo que ejecuta la CLI, sin http:// ni puerto:

Un dispositivo de tu red

Un NAS, un segundo PC o un servidor de consola en tu red local:

192.168.1.20
nas.local

El equipo que ejecuta la CLI debe poder alcanzarlo: prueba con ping 192.168.1.20 y comprueba que el servidor acepta conexiones de otros equipos (no solo de 127.0.0.1).

Docker

Si la CLI se ejecuta directamente en el host de Docker, publica el puerto del servidor (-p 25565:25565) y deja vacío el host de destino.

Si la CLI se ejecuta en su propio contenedor, en la misma red de Docker que tu servidor (por ejemplo como servicio en tu archivo Compose), usa el nombre del contenedor o del servicio del servidor como host de destino (consulta Contenedor Docker):

mc

Sitios web con HTTPS

Los túneles reenvían TCP/UDP sin procesar. Un sitio web con HTTPS mostrará un aviso de certificado, porque el navegador se conecta a <relay>.voidport.net y el certificado está emitido para otro nombre. El HTTP simple y los servidores de juegos no se ven afectados. HTTPS en tu propio dominio lo soluciona.

Contenedor Docker

La CLI también se ejecuta como contenedor junto a tu servidor, por ejemplo en el mismo archivo Compose. No se publica nada en el host: los jugadores se conectan a través del relay. Crea el túnel en el dashboard y pásale su token y el nombre del servicio del servidor:

services:
  mc:
    image: itzg/minecraft-server
    environment:
      EULA: "TRUE"
    volumes:
      - mc-data:/data

  voidport:
    image: ghcr.io/voidmind-io/voidport:latest
    environment:
      VOIDPORT_TOKEN: ${VOIDPORT_TOKEN}
      VOIDPORT_HOST: mc
    depends_on:
      - mc
    restart: unless-stopped

volumes:
  mc-data:
$ VOIDPORT_TOKEN=<token> docker compose up -d
$ docker compose logs voidport

El log muestra la dirección pública. VOIDPORT_TOKEN admite varios tokens separados por comas (p. ej. juego y chat de voz). VOIDPORT_HOST es el nombre del servicio de tu servidor; VOIDPORT_PORT sustituye el puerto local del túnel (solo con un token). VOIDPORT_TOKEN_FILE lee el o los tokens desde un archivo, p. ej. un secreto de Compose en /run/secrets/voidport_token. docker compose down desconecta el túnel limpiamente.

Minecraft Bedrock

Con itzg/minecraft-bedrock-server, crea el túnel con la plantilla de Bedrock. El log de voidport muestra una línea server-udp-ports=…: pon su valor como SERVER_UDP_PORTS en el servicio mc y reinícialo.

SERVER_UDP_PORTS: "<relay IP>:<public port>:19132"

Pterodactyl y Pelican

Si tus servidores funcionan en el panel Pterodactyl o Pelican, el túnel se ejecuta como un servidor propio en el mismo nodo, con el egg VoidPort Tunnel. No hace falta abrir puertos en el nodo.

  1. Crea el túnel en el panel de control y copia su token.
  2. Como administrador del panel, importa el egg egg-voidport-tunnel.json: en Pterodactyl en Admin > Nests > Import Egg, en Pelican en Admin > Eggs > Import (también desde la URL).
  3. Crea un servidor con el egg VoidPort Tunnel en el nodo de tu servidor de juego. El panel exige una asignación (allocation): sirve cualquiera libre, el túnel no la usa. Con 128 MB de memoria basta.
  4. Introduce el Tunnel Token y, como Target Port, el puerto de la asignación de tu servidor de juego, y arranca el servidor.

Target Host es por defecto 172.18.0.1, el nodo visto desde los contenedores de la red por defecto pterodactyl0. Llega a las asignaciones en 0.0.0.0. Si la asignación de tu servidor de juego está ligada a una IP concreta, introduce esa IP.

El Tunnel Token lo ve cualquiera en el panel que pueda ver las variables de inicio de este servidor (administradores y subusuarios con acceso a startup), y el token basta para usar el túnel. Usa un túnel solo para este servidor y, si cambia el acceso al panel, genera un token nuevo en el panel de control (Regenerar token) e introdúcelo en el panel.

La consola muestra la dirección pública y online, y el panel marca el servidor como iniciado. Al detener el servidor, el túnel se desconecta limpiamente. Varios tokens, separados por comas, funcionan juntos (p. ej. juego y chat de voz); deja entonces Target Port vacío, cada túnel usa su puerto local guardado.

Minecraft sin puerto

Minecraft Java consulta un registro SRV antes de conectarse, así que los jugadores no tienen que escribir el puerto. Ponle un nombre a tu túnel y los jugadores entran con survival.voidport.net en lugar de nbg1.voidport.net:30421.

Define el nombre en la página del túnel en Dirección sin puerto, en el formulario de creación al elegir Minecraft: Java Edition, o desde la CLI:

$ voidport tunnel --preset minecraft-java --address survival

Los nombres tienen de 3 a 32 caracteres (a-z, 0-9, guiones) y se asignan por orden de llegada. Un nombre nuevo puede tardar unos minutos en funcionar en todas partes. El nombre solo funciona en Minecraft Java: no es una dirección web.

Paso a paso: Servidor de Minecraft sin abrir puertos.

Bedrock Edition no consulta registros SRV. Los jugadores de Bedrock siguen necesitando la dirección con el puerto.

Tu propio dominio

Para usar un dominio tuyo, p. ej. play.example.com, crea un registro SRV en tu proveedor de DNS. La página del túnel muestra los valores exactos y tiene un botón Comprobar. Con los valores del ejemplo:

_minecraft._tcp.play.example.com. 300 IN SRV 0 5 30421 nbg1.voidport.net.

Nombre _minecraft._tcp.play (en la zona example.com), prioridad 0, peso 5, el puerto público de tu túnel y como destino el host del relay de tu túnel. Con Cloudflare, el registro debe estar en «Solo DNS». Si el túnel cambia de relay o de puerto, actualiza el registro.

IP reales de jugadores (PROXY protocol)

A través de un túnel, tu servidor ve todas las conexiones llegar desde el equipo que ejecuta la CLI. Con el PROXY protocol activado, el relay antepone la IP y el puerto reales del visitante a cada conexión TCP (PROXY protocol v2), para que tu servidor vea las direcciones reales de los jugadores.

Actívalo solo si tu servidor está configurado para esperarlo. Un servidor que no espera la cabecera rechaza todas las conexiones. Solo túneles TCP.

Actívalo en el formulario de creación, en la página del túnel en Ajustes, o con voidport tunnel --proxy-protocol para un túnel nuevo. Un cambio se aplica cuando la CLI se reconecta (reiníciala). Después actívalo en tu servidor:

Paper (config/paper-global.yml)

proxies:
  proxy-protocol: true

Velocity (velocity.toml, [advanced])

haproxy-protocol = true

BungeeCord / Waterfall (config.yml, en listeners)

proxy_protocol: true

nginx

listen 8080 proxy_protocol;

Con Velocity o BungeeCord, actívalo solo en el proxy, no en los servidores que hay detrás. Los servidores Vanilla y Spigot no pueden leer la cabecera: déjalo desactivado. En nginx la dirección está en $proxy_protocol_addr.

Insignia de estado de Minecraft

Muestra tu servidor de Minecraft: Java Edition en una web, un foro o un README de GitHub: una pequeña imagen con en línea/desconectado y jugadores, y un estado JSON. Sin plugin ni software adicional; VoidPort consulta el estado de tu servidor a través del túnel.

  1. Abre tu túnel en el panel y ve a Ajustes
  2. Activa Insignia de estado
  3. Copia el código para Markdown, HTML o BBCode
![Minecraft server status](https://api.voidport.app/badge/<id>.svg)

Formatos

.svg es la imagen (estado y jugadores), .json el estado completo con la versión y el mensaje del día, para tus scripts o tu web (CORS permitido).

Ejemplo JSON

{
  "name": "survival",
  "online": true,
  "address": "hel1.voidport.net:21234",
  "players": { "online": 3, "max": 20 },
  "version": "Paper 1.21.1",
  "motd": "A Minecraft Server",
  "checked_at": "2026-09-28T12:00:00Z"
}

El estado se actualiza como máximo una vez por minuto. Solo los túneles de Minecraft: Java Edition tienen insignia. Está desactivada por defecto y su enlace es aleatorio, no el ID de tu túnel; desactivarla la oculta.

HTTPS en tu propio dominio

Sirve un sitio web o una API como https://app.example.com en el puerto estándar 443, con un dominio que sea tuyo. El relay solo lee el nombre de host que pide el navegador (SNI) y reenvía la conexión cifrada sin cambios a tu túnel; nunca ve el contenido. TLS termina en la CLI de VoidPort, con un certificado automático, o en tu propio servidor (Caddy, nginx, Traefik, ...).

  1. En el panel, en Dominios, añade el nombre de host y elige quién gestiona el certificado: la CLI de VoidPort (automático) o tu propio servidor.
  2. En tu proveedor de DNS, crea el registro TXT _voidport-challenge.app.example.com con el valor indicado y haz clic en Verificar. Mantén el registro TXT mientras uses el dominio con VoidPort.
  3. Asigna el nombre de host a un túnel TCP, en la página Dominios o en la pestaña de ajustes del túnel. Si la CLI gestiona TLS, el destino del túnel es tu servidor HTTP simple (p. ej. 3000); con tu propio servidor, su puerto HTTPS (p. ej. 443).
  4. Crea un CNAME de app.example.com al relay del túnel (p. ej. nbg1.voidport.net). Para un dominio raíz, donde no se permite CNAME, usa en su lugar un registro A con la IP del relay.

Detrás de Cloudflare, pon el registro en Solo DNS (nube gris). El proxy naranja termina TLS por sí mismo y nunca llegaría a tu servidor. Solo se pueden usar dominios tuyos, nunca los de VoidPort.

Certificados

Con la CLI de VoidPort no hay nada que hacer: en cuanto el nombre de host está verificado y apunta al relay, la CLI obtiene un certificado de Let's Encrypt y lo renueva (actualiza a la última CLI). Con tu propio servidor: el puerto 80 no se reenvía, así que el desafío HTTP-01 no funciona; usa una de estas opciones:

  • TLS-ALPN-01 (automático, a través del túnel): Caddy lo hace por defecto en cuanto HTTP-01 está desactivado. Traefik: un certificate resolver con tlsChallenge.
  • DNS-01: funciona en cualquier sitio (certbot, acme.sh, plugins DNS de Caddy/Traefik).

Caddy (Caddyfile)

{
  # port 80 is not reachable through the tunnel
  auto_https disable_redirects
}

app.example.com {
  tls {
    issuer acme {
      disable_http_challenge
    }
  }
  reverse_proxy localhost:3000
}

El PROXY protocol también funciona aquí: si está activado, la conexión empieza con la cabecera antes del handshake TLS (nginx: listen 443 ssl proxy_protocol;). No se admiten HTTP simple en el puerto 80 ni nombres de host comodín.

Avisos de desconexión

Recibe un mensaje cuando un túnel se desconecte: su CLI o agente pierde la conexión y no vuelve dentro del tiempo de espera (2 minutos por defecto, de 1 a 60). Opcionalmente también cuando vuelve a estar en línea. Configúralo para cada túnel en la pestaña Ajustes, en Notificaciones, y luego envía una prueba.

Canales

  • Correo a la dirección de tu cuenta.
  • Discord: en Discord, abre los ajustes del canal, ve a Integraciones > Webhooks, crea un webhook y pega su URL (https://discord.com/api/webhooks/...).
  • Webhook: un POST HTTPS con un cuerpo JSON a tu propia URL, firmado para que puedas comprobar que viene de VoidPort.

Las caídas repetidas en poco tiempo se agrupan: como máximo una notificación cada 10 minutos. Los túneles detenidos porque terminó la suscripción, la cuenta está suspendida o se agotó la transferencia mensual no envían nada.

Formato del webhook

VoidPort envía un POST con Content-Type: application/json y estas cabeceras:

  • X-VoidPort-Event: tunnel.offline, tunnel.online o test
  • X-VoidPort-Timestamp: hora Unix en segundos
  • X-VoidPort-Signature: sha256= seguido del HMAC-SHA256 (hex) de timestamp + "." + cuerpo sin procesar, calculado con tu clave de firma
{
  "event": "tunnel.offline",
  "tunnel": {
    "id": "3f0c...",
    "name": "survival",
    "address": "nbg1.voidport.net:25565"
  },
  "since": "2026-09-28T12:00:00Z",
  "sent_at": "2026-09-28T12:02:05Z"
}

since es el momento en que el túnel se desconectó o volvió a estar en línea.

La clave de firma se muestra una sola vez, cuando guardas la primera URL de webhook. Puedes regenerarla en la misma pestaña de ajustes; la clave anterior deja de funcionar de inmediato.

Verificar la firma (Node.js)

import crypto from 'node:crypto';

// rawBody: the request body exactly as received (string or Buffer)
function verifyVoidPort(headers, rawBody, secret) {
  const timestamp = headers['x-voidport-timestamp'];
  const signature = headers['x-voidport-signature'] ?? '';
  // Reject requests older than 5 minutes
  if (!timestamp || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(timestamp + '.')
    .update(rawBody)
    .digest('hex');
  const a = Buffer.from(signature);
  const b = Buffer.from(expected);
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

Usa el cuerpo de la solicitud sin procesar, antes de cualquier análisis JSON. Rechazar marcas de tiempo antiguas evita solicitudes repetidas.

Cualquier respuesta 2xx cuenta como entregada. Las redirecciones no se siguen y una solicitud caduca a los 10 segundos. La URL debe usar HTTPS y apuntar a una dirección pública.

Control de acceso

Limita quién puede conectarse a un túnel, en la pestaña Ajustes del túnel, en Acceso. Las reglas se aplican al puerto público (TCP y UDP) y a HTTPS en tu propio dominio.

Lista de IP permitidas

Hasta 50 direcciones IPv4 o IPv6 o rangos CIDR, p. ej. 203.0.113.7 o 198.51.100.0/24; una dirección sola no necesita prefijo. Con la lista vacía cualquiera puede conectarse; si no, solo las direcciones de la lista. Añadir mi IP añade la dirección desde la que navegas.

Países

Elige Permitir solo estos países o Bloquear estos países. El país se determina por la dirección IP del visitante, lo que no siempre es exacto, por ejemplo con VPN o redes móviles.

Ambas reglas se aplican juntas: un visitante debe cumplir la lista de permitidas y la regla de países. Los cambios se aplican en pocos segundos, sin detener el túnel. Las conexiones abiertas que ya no están permitidas se cierran.

Geolocalización IP de DB-IP, con licencia CC BY 4.0.

Ejecutar como servicio

En un servidor, o en un PC que deba mantener el túnel activo sin nadie con sesión iniciada, instala la CLI como servicio del sistema. Arranca con el equipo y se reinicia solo si se detiene.

Linux y macOS

$ sudo voidport service install

Sin nombres, ejecuta todos los túneles que creaste en este equipo con voidport tunnel. Indica nombres para elegir algunos (sudo voidport service install mc), o usa tokens del dashboard: sudo voidport service install --token <token>.

Windows

Abre PowerShell con Ejecutar como administrador:

$ voidport service install --token <token>

Gestionarlo

$ voidport service status
$ voidport service logs -f
$ sudo voidport service update
$ sudo voidport service uninstall

El servicio ejecuta su propia copia de la CLI en una carpeta que solo pueden modificar los administradores. Después de voidport update, ejecuta service update (en Windows, en una terminal de administrador) para que el servicio también use la nueva versión.

El servicio guarda los tokens de los túneles en un archivo que solo pueden leer el servicio y los administradores (/etc/voidport/service.json, en Windows %ProgramData%\VoidPort). No necesita tu inicio de sesión. Vuelve a ejecutar service install para cambiar los túneles. En Linux el servicio usa systemd y se ejecuta como el usuario del sistema voidport; el log está en el journal. En macOS es un daemon de launchd que escribe en /var/log/voidport.log.

Comandos de la CLI

connect

Inicia uno o varios túneles con sus tokens del dashboard. No hace falta iniciar sesión.

$ voidport connect <token> [<token> ...]
--port
Redirigir a un puerto local distinto del configurado en el túnel
--host
Redirigir a otro equipo de tu red (por defecto: este equipo)

login

Inicia sesión desde el navegador. Solo necesario para los comandos de abajo.

$ voidport login

tunnel

Crea un túnel desde la CLI y lo inicia.

$ voidport tunnel --preset minecraft-java
<port>
Puerto local, en lugar de una plantilla
--preset
Plantilla de juego o aplicación, consulta voidport presets
--name
Nombre del túnel
--udp
UDP en lugar de TCP (--both para TCP y UDP)
--relay
Región del relay, consulta voidport relays
--proxy-protocol
Enviar las IP reales de los jugadores en una cabecera PROXY protocol (TCP; consulta IP reales de jugadores)
--address
Dirección de Minecraft Java sin puerto, p. ej. --address survival para survival.voidport.net (TCP)

up

Inicia los túneles guardados en este equipo (todos o los que indiques).

$ voidport up [<name> ...]

service

Ejecuta túneles como servicio del sistema que arranca con el equipo (consulta Ejecutar como servicio).

$ sudo voidport service install [<name> ...]
--token
Token de túnel del dashboard en lugar de un túnel guardado (se puede repetir)
--host
Redirigir a otro equipo de tu red
status, logs, update, uninstall
Comprobar, leer el log (-f para seguirlo), actualizar a esta versión de la CLI o quitar el servicio

list

Lista tus túneles.

$ voidport list

presets

Lista las plantillas de juegos y aplicaciones para voidport tunnel --preset.

Todos los presets con sus puertos: Juegos. Guías: Minecraft, Terraria.

$ voidport presets

relays

Lista las regiones de relay.

$ voidport relays

status

Muestra el estado de un túnel.

$ voidport status [<name>]

delete

Elimina un túnel.

$ voidport delete <name>

update

Actualiza la CLI a la última versión.

$ voidport update

TCP o UDP

ProtocoloUsoEjemplos
TCPEntrega fiable y ordenadaMinecraft Java, servidores web, SSH, FTP
UDPBaja latencia, tiempo realChat de voz, servidores de juegos
AmbosJuegos que usan ambos protocolosMinecraft Bedrock, algunos servidores de juegos, streaming

¿No sabes cuál elegir? La mayoría de las aplicaciones usan TCP. Minecraft Java usa TCP, Minecraft Bedrock (1.26.50 y posteriores) usa ambos.

Todos los presets con sus puertos: Juegos. Guías: Minecraft, Terraria.

Valheim: el servidor usa el puerto de juego y, justo después, el puerto de consulta de Steam (2456 y 2457). Con voidport tunnel --preset valheim el puerto de consulta se reenvía automáticamente, en el puerto público del túnel + 1. Comparte solo la dirección del túnel (relay:puerto, p. ej. nbg1.voidport.net:30420); el puerto de consulta (30421 en el ejemplo) no necesita otro túnel. Requiere la CLI 0.2.25 o posterior.

Planes y límites

CaracterísticaGamerProHosting
Precio3 €/mes8 €/mes19 €/mes
Túneles31025
Ancho de banda20 GB100 GB500 GB
Conexiones1050500
Dominios propios (HTTPS)1310
Puertos fijosSíSíSí

Puertos fijos: tu puerto público no cambia al reconectar, así que los jugadores no necesitan una dirección nueva.

Solución de problemas

La conexión falla

  • Abre el túnel en el dashboard y haz clic en «Probar conexión». Comprueba el relay, la CLI, tu servidor y la dirección pública, y te dice qué parte falla
  • Revisa el token. Después de «Regenerar token» solo funciona el nuevo
  • Comprueba que tu servidor local se está ejecutando en el puerto indicado
  • Asegúrate de que ningún firewall bloquea las conexiones salientes

Latencia alta

  • Elige el relay más cercano a tus jugadores: Núremberg o Helsinki para Europa, Ashburn (este) o Hillsboro (oeste) para EE. UU.
  • Para aplicaciones en tiempo real, usa UDP si es posible

Límite de conexiones alcanzado

  • Cada plan limita las conexiones simultáneas por túnel (Gamer 10, Pro 50, Hosting 500)
  • Cámbiate a un plan superior para tener más conexiones

Ancho de banda superado

  • El uso se reinicia cada mes en tu fecha de facturación
  • Cámbiate a un plan superior para tener más ancho de banda

¿Sigues teniendo problemas?

Contacta con soporte en support@voidport.app