Pubblica un server locale tramite un tunnel con PROXYSERVER() e PROXYCLIENT()

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

PROXY() inoltra una richiesta a un server che il proxy può raggiungere. Un tunnel serve nel caso opposto: il programma è su un portatile o dietro un firewall, quindi nessuno può connettersi ad esso, ma esso può connettersi verso l'esterno. PROXYSERVER() e PROXYCLIENT() lo ottengono con un solo WebSocket aperto dal lato privato:

PROXYSERVER([endpoint], [socketendpoint], [logger]) gira sul server pubblico. Ogni richiesta sotto endpoint (predefinito /) viene inviata attraverso il tunnel; socketendpoint (predefinito /) è l'indirizzo WebSocket dove si connette il client. Usa indirizzi diversi quando la stessa applicazione serve altro: un proxy su / prende ogni richiesta, anche quelle delle tue route (viene eseguito prima di esse). logger è una funzione (predefinito: stampa con la data); passa null per nessuno.
PROXYCLIENT(serverurl, port, [logger]) gira sul lato privato (in questo esempio l'indirizzo del server è costruito con CONF.$port, la porta dell'applicazione). serverurl è l'indirizzo WebSocket del server (ws:// o wss://; http viene cambiato in ws) e port è 3000 o ip:3000, il programma locale che riceve le richieste. Restituisce il client WebSocket.
Un client alla volta: quando si connette un secondo client, il server lo chiude con il codice 4001. Senza client la risposta del server è Not yet available..
Il programma locale riceve il percorso completo della richiesta originale, incluso l'endpoint (/tunnel/hello), le intestazioni del visitatore e un'intestazione x-proxy: Total.js, con host impostato sull'indirizzo locale.
La route WebSocket non ha un'autenticazione propria: non pubblicarla senza qualcosa davanti che decida chi può connettersi (l'indirizzo come segreto, un check tuo, un firewall).

Qui un'applicazione è entrambi i lati: un piccolo programma locale sulla porta 9511 (andrebbe bene qualsiasi programma), il server su /tunnel/ e il client che si connette alla stessa applicazione.

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 });
}