Componente servidor STUN para Delphi y C++ Builder | eSeGeCe

STUN Server

Ejecuta tu propio servidor STUN (RFC 8489) en Delphi. Responde a los binding requests con la respuesta canónica XOR-MAPPED-ADDRESS — útil en redes privadas, despliegues on-premise y bootstrapping de ICE.

TsgcSTUNServer

Un servidor STUN tipado conforme a RFC 8489 — procesa mensajes Binding / Indication, responde con XOR-MAPPED-ADDRESS y, opcionalmente, exige MESSAGE-INTEGRITY para autenticación long-term.

Clase del componente

TsgcSTUNServer

Protocolo

STUN (RFC 8489)

Plataformas

Windows, macOS, Linux, iOS, Android

Edición

Enterprise

Coloca, configura el puerto y tendrás un endpoint STUN

Configura Port (por defecto 3478), Active := True — tu servidor responderá a las Binding requests con la respuesta canónica XOR-MAPPED-ADDRESS de RFC 8489.

uses
  sgcP2P;

var
  STUNServer: TsgcSTUNServer;
begin
  STUNServer := TsgcSTUNServer.Create(nil);
  STUNServer.Port := 3478;

  // opcional: credenciales long-term
  STUNServer.Authentication.Enabled  := True;
  STUNServer.Authentication.Realm    := 'example.com';
  STUNServer.OnSTUNAuthenticate := procedure(Sender: TObject;
    const aUsername: string; var aPassword: string;
    var Accept: Boolean)
  begin
    aPassword := LookupPassword(aUsername);
    Accept    := aPassword <> '';
  end;

  STUNServer.Active := True;
end;
// uses: sgcP2P
TsgcSTUNServer *STUNServer = new TsgcSTUNServer(this);
STUNServer->Port = 3478;
STUNServer->Active = true;

Qué incluye

Un servidor STUN autoalojado — ideal para despliegues WebRTC on-premise y pruebas en cloud privada.

Manejador de Binding request

A los Binding requests entrantes se les responde con XOR-MAPPED-ADDRESS, MAPPED-ADDRESS (legado) y FINGERPRINT — replicando la forma de respuesta estándar de RFC 8489.

Autenticación long-term / short-term

Activa Authentication.Enabled para exigir MESSAGE-INTEGRITY. OnSTUNAuthenticate expone el nombre de usuario de la petición para que devuelvas la contraseña correspondiente desde tu almacén.

Límite por IP

Combínalo con TsgcWSRateLimiter para limitar las peticiones STUN entrantes por IP de origen — protección útil contra abusos de amplificación.

IPv4 / IPv6

Asocia a cualquier familia o dual-stack mediante IPVersion. La respuesta XOR-MAPPED-ADDRESS usa la familia del transporte entrante.

TLS sobre TCP (RFC 8489 §5)

Para la variante STUN sobre TLS, configura el listener TCP subyacente con opciones SSL — útil cuando UDP está bloqueado en la salida de red.

Diagnóstico

OnSTUNRequest / OnSTUNResponse registran cada transacción, incluyendo Method, MessageType y la lista de atributos parseados — perfectos para depurar despliegues.

Especificaciones y referencias

Fuentes autorizadas del protocolo que implementa este componente.

Documentación y demos

Accede a la referencia del componente, descarga el proyecto demo listo para ejecutar y la versión de prueba.

Ayuda en línea — TsgcSTUNServer Referencia completa de propiedades, métodos y eventos de este componente.
Proyecto demo — Demos\35.P2P\02.STUN Proyecto de ejemplo listo para ejecutar. Se incluye dentro del paquete sgcWebSockets — descarga la prueba abajo.
Documento técnico (PDF) Características, inicio rápido, ejemplos de código para Delphi y C++ Builder y referencias a fuentes primarias — solo este componente.
Manual de usuario (PDF) Manual completo que cubre cada componente de la biblioteca.

Preguntas frecuentes sobre el servidor STUN

Preguntas habituales sobre la ejecución de un servidor STUN autoalojado en Delphi y C++ Builder.

Coloca un componente TsgcSTUNServer, establece Port (por defecto 3478) y pon Active := True. El servidor responde entonces a las solicitudes Binding entrantes con la respuesta canónica XOR-MAPPED-ADDRESS. Opcionalmente habilita Authentication y maneja OnSTUNAuthenticate para exigir MESSAGE-INTEGRITY con credenciales de largo plazo.
Implementa STUN según RFC 8489, procesando mensajes Binding e Indication y respondiendo con XOR-MAPPED-ADDRESS, el MAPPED-ADDRESS heredado y FINGERPRINT. Soporta IPv4 e IPv6, STUN-over-TLS opcional, y referencia el RFC 5780 para el descubrimiento del comportamiento del NAT.
No. TsgcSTUNServer es un servidor STUN autoalojado que integras directamente en tu propia aplicación Delphi o C++ Builder, así que no necesitas desplegar y operar una instancia de coturn separada. Es ideal para redes privadas, despliegues de WebRTC on-premise y arranque de ICE bajo tu propio control.
El servidor STUN forma parte de la edición Enterprise de sgcWebSockets y es compatible desde Delphi 7 hasta la última versión de Delphi y las versiones de C++ Builder correspondientes, en Windows, macOS, Linux, iOS y Android. Descarga la prueba gratuita para levantar un endpoint STUN en tu propio proyecto.

¿Listo para ejecutar tu propio servidor STUN?

Descarga la prueba gratuita y levanta un endpoint STUN en Delphi.