Inicio rápido
Pon tu servidor local en línea en menos de 2 minutos.
-
Crea una cuenta
Regístrate en voidport.app/register y elige un plan.
-
Crea un túnel en el dashboard
Ve a Dashboard > Tunnels > Crear túnel. Elige qué alojas y una región.
-
Instala la CLI
$ curl -fsSL https://dl.voidport.app/install.sh | shx64 y ARM64. Funciona en Debian, Ubuntu, Fedora, Arch y la mayoría de las demás (no en Alpine).
-
Inicia tu túnel
$ voidport connect <token>Consigue tu token en tu túnel del dashboard. Añade
--port 8080o--host 192.168.1.20para 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
-
Instala la CLI
$ curl -fsSL https://dl.voidport.app/install.sh | shx64 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
- Inicia sesión en tu dashboard
- Haz clic en «Crear túnel»
- Elige qué alojas, o «Puerto personalizado» con TCP, UDP o ambos
- Ponle un nombre (p. ej. «minecraft») y elige una región (Núremberg, Helsinki, Ashburn o Hillsboro)
- Si el servidor se ejecuta en otro equipo, indica su host de destino
- 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.
- Crea el túnel en el panel de control y copia su token.
- 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).
- 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.
- 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.
- Abre tu túnel en el panel y ve a Ajustes
- Activa Insignia de estado
- Copia el código para Markdown, HTML o BBCode
 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, ...).
- 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.
- En tu proveedor de DNS, crea el registro TXT
_voidport-challenge.app.example.comcon el valor indicado y haz clic en Verificar. Mantén el registro TXT mientras uses el dominio con VoidPort. - 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). - Crea un CNAME de
app.example.comal 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.onlineotestX-VoidPort-Timestamp: hora Unix en segundosX-VoidPort-Signature:sha256=seguido del HMAC-SHA256 (hex) detimestamp + "." + 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.
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> ...] 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 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> ...] 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
| Protocolo | Uso | Ejemplos |
|---|---|---|
| TCP | Entrega fiable y ordenada | Minecraft Java, servidores web, SSH, FTP |
| UDP | Baja latencia, tiempo real | Chat de voz, servidores de juegos |
| Ambos | Juegos que usan ambos protocolos | Minecraft 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ística | Gamer | Pro | Hosting |
|---|---|---|---|
| Precio | 3 €/mes | 8 €/mes | 19 €/mes |
| Túneles | 3 | 10 | 25 |
| Ancho de banda | 20 GB | 100 GB | 500 GB |
| Conexiones | 10 | 50 | 500 |
| Dominios propios (HTTPS) | 1 | 3 | 10 |
| Puertos fijos | Sí | 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