Publica un servidor local a través de un túnel con PROXYSERVER() y PROXYCLIENT()

Total.js 5 · total5@0.0.19 proxytunnelwebsocketintegrations Ejecutada con Total.js 5

PROXY() reenvía una petición a un servidor al que el proxy puede llegar. Un túnel es para el caso contrario: el programa está en un portátil o detrás de un cortafuegos, así que nadie puede conectarse a él, pero él sí puede conectarse hacia fuera. PROXYSERVER() y PROXYCLIENT() lo consiguen con un solo WebSocket que abre el lado privado:

PROXYSERVER([endpoint], [socketendpoint], [logger]) se ejecuta en el servidor público. Cada petición por debajo de endpoint (por defecto /) se envía por el túnel; socketendpoint (por defecto /) es la dirección WebSocket donde se conecta el cliente. Usa direcciones distintas cuando la misma aplicación sirve otras cosas: un proxy en / se lleva todas las peticiones, también las de tus propias rutas (se ejecuta antes que ellas). logger es una función (por defecto: imprime con la fecha); pasa null para ninguno.
PROXYCLIENT(serverurl, port, [logger]) se ejecuta en el lado privado (en este ejemplo la dirección del servidor se construye con CONF.$port, el puerto de la aplicación). serverurl es la dirección del WebSocket del servidor (ws:// o wss://; http se cambia por ws) y port es 3000 o ip:3000, el programa local que recibe las peticiones. Devuelve el cliente WebSocket.
Un cliente a la vez: cuando se conecta un segundo cliente, el servidor lo cierra con el código 4001. Sin cliente la respuesta del servidor es Not yet available..
El programa local recibe la ruta completa de la petición original, incluido el endpoint (/tunnel/hello), las cabeceras del visitante y una cabecera x-proxy: Total.js, con host fijado a la dirección local.
La ruta WebSocket no tiene autenticación propia: no la publiques sin algo delante que decida quién puede conectarse (la dirección es el secreto, un check propio, un cortafuegos).

Aquí una aplicación es los dos lados: un pequeño programa local en el puerto 9511 (cualquier programa serviría), el servidor en /tunnel/ y el cliente que se conecta a la misma aplicación.

definitions/local.js

// The program that is "private": an ordinary HTTP server that only listens on the loopback address
require('http').createServer(function(req, res) {
	res.writeHead(200, { 'content-type': 'application/json' });
	res.end(JSON.stringify({ path: req.url, via: req.headers['x-proxy'] || null, host: req.headers.host }));
}).listen(9511, '127.0.0.1');

controllers/tunnel.js

exports.install = function() {
	ROUTE('GET /status/', status);
	ROUTE('POST /connect/', connect);
};

// The public side: /tunnel/* goes through the tunnel, the WebSocket of the client is /tunnel-socket/. No logger.
PROXYSERVER('/tunnel/', '/tunnel-socket/', null);

let client = null;

function connect($) {
	client = PROXYCLIENT('ws://127.0.0.1:' + CONF.$port + '/tunnel-socket/', '9511', null);
	$.json({ connecting: true });
}

function status($) {
	$.json({ connected: !!client });
}