Red

[Estable: 2 - Estable]

Código fuente: lib/net.js

El módulo node:net proporciona una API de red asíncrona para crear servidores TCP o IPC basados en flujos (net.createServer()) y clientes (net.createConnection()).

Se puede acceder utilizando:

ESMCJS

import net from 'node:net'

const net = require('node:net')

Soporte IPC

[Historial]

Versión	Cambios
v20.8.0	Soporte para enlazar a una ruta de socket de dominio Unix abstracta como `\0abstract`. Podemos enlazar '\0' para Node.js `\< v20.4.0`.

El módulo node:net admite IPC con tuberías con nombre en Windows y sockets de dominio Unix en otros sistemas operativos.

Identificación de rutas para conexiones IPC

net.connect(), net.createConnection(), server.listen() y socket.connect() toman un parámetro path para identificar los puntos finales de IPC.

En Unix, el dominio local también se conoce como dominio Unix. La ruta es un nombre de ruta del sistema de archivos. Generará un error cuando la longitud del nombre de ruta sea mayor que la longitud de sizeof(sockaddr_un.sun_path). Los valores típicos son 107 bytes en Linux y 103 bytes en macOS. Si una abstracción de API de Node.js crea el socket de dominio Unix, también desenlazará el socket de dominio Unix. Por ejemplo, net.createServer() puede crear un socket de dominio Unix y server.close() lo desenlazará. Pero si un usuario crea el socket de dominio Unix fuera de estas abstracciones, el usuario deberá eliminarlo. Lo mismo se aplica cuando una API de Node.js crea un socket de dominio Unix pero el programa luego falla. En resumen, un socket de dominio Unix será visible en el sistema de archivos y persistirá hasta que se desenlace. En Linux, puede usar un socket abstracto de Unix agregando \0 al comienzo de la ruta, como \0abstract. La ruta al socket abstracto de Unix no es visible en el sistema de archivos y desaparecerá automáticamente cuando se cierren todas las referencias abiertas al socket.

En Windows, el dominio local se implementa utilizando una tubería con nombre. La ruta debe hacer referencia a una entrada en \\?\pipe\ o \\.\pipe\. Se permite cualquier carácter, pero este último puede realizar algún procesamiento de nombres de tuberías, como resolver secuencias ... A pesar de cómo podría verse, el espacio de nombres de la tubería es plano. Las tuberías no persistirán. Se eliminan cuando se cierra la última referencia a ellas. A diferencia de los sockets de dominio Unix, Windows cerrará y eliminará la tubería cuando finalice el proceso propietario.

El escape de cadenas de JavaScript requiere que las rutas se especifiquen con un escape de barra invertida adicional como:

net.createServer().listen(path.join('\\\\?\\pipe', process.cwd(), 'myctl'))

Clase: `net.BlockList`

Agregado en: v15.0.0, v14.18.0

El objeto BlockList puede utilizarse con algunas API de red para especificar reglas para deshabilitar el acceso entrante o saliente a direcciones IP específicas, rangos IP o subredes IP.

`blockList.addAddress(address[, type])`

Agregado en: v15.0.0, v14.18.0

address <string> | <net.SocketAddress> Una dirección IPv4 o IPv6.
type <string> Ya sea 'ipv4' o 'ipv6'. Predeterminado: 'ipv4'.

Agrega una regla para bloquear la dirección IP dada.

`blockList.addRange(start, end[, type])`

Agregado en: v15.0.0, v14.18.0

start <string> | <net.SocketAddress> La dirección IPv4 o IPv6 inicial en el rango.
end <string> | <net.SocketAddress> La dirección IPv4 o IPv6 final en el rango.
type <string> Ya sea 'ipv4' o 'ipv6'. Predeterminado: 'ipv4'.

Agrega una regla para bloquear un rango de direcciones IP desde start (inclusive) hasta end (inclusive).

`blockList.addSubnet(net, prefix[, type])`

Agregado en: v15.0.0, v14.18.0

net <string> | <net.SocketAddress> La dirección de red IPv4 o IPv6.
prefix <number> El número de bits de prefijo CIDR. Para IPv4, este debe ser un valor entre 0 y 32. Para IPv6, debe estar entre 0 y 128.
type <string> Ya sea 'ipv4' o 'ipv6'. Predeterminado: 'ipv4'.

Agrega una regla para bloquear un rango de direcciones IP especificado como una máscara de subred.

`blockList.check(address[, type])`

Agregado en: v15.0.0, v14.18.0

address <string> | <net.SocketAddress> La dirección IP a verificar.
type <string> Ya sea 'ipv4' o 'ipv6'. Predeterminado: 'ipv4'.
Devuelve: <boolean>

Devuelve true si la dirección IP dada coincide con alguna de las reglas agregadas a la BlockList.

const blockList = new net.BlockList()
blockList.addAddress('123.123.123.123')
blockList.addRange('10.0.0.1', '10.0.0.10')
blockList.addSubnet('8592:757c:efae:4e45::', 64, 'ipv6')

console.log(blockList.check('123.123.123.123')) // Imprime: true
console.log(blockList.check('10.0.0.3')) // Imprime: true
console.log(blockList.check('222.111.111.222')) // Imprime: false

// La notación IPv6 para direcciones IPv4 funciona:
console.log(blockList.check('::ffff:7b7b:7b7b', 'ipv6')) // Imprime: true
console.log(blockList.check('::ffff:123.123.123.123', 'ipv6')) // Imprime: true

`blockList.rules`

Agregado en: v15.0.0, v14.18.0

Tipo: <string[]>

La lista de reglas agregadas a la lista de bloqueo.