Net

[안정성: 2 - 안정적]

소스 코드: lib/net.js

node:net 모듈은 스트림 기반 TCP 또는 IPC 서버(net.createServer()) 및 클라이언트(net.createConnection())를 만들기 위한 비동기 네트워크 API를 제공합니다.

다음을 사용하여 액세스할 수 있습니다.

ESMCJS

import net from 'node:net';

const net = require('node:net');

IPC 지원

[기록]

버전	변경 사항
v20.8.0	`\0abstract`와 같은 추상 Unix 도메인 소켓 경로에 바인딩하는 지원. Node.js `\< v20.4.0`의 경우 '\0'에 바인딩할 수 있습니다.

node:net 모듈은 Windows에서는 명명된 파이프를, 다른 운영 체제에서는 Unix 도메인 소켓을 사용하는 IPC를 지원합니다.

IPC 연결 경로 식별

net.connect(), net.createConnection(), server.listen() 및 socket.connect()는 IPC 엔드포인트를 식별하기 위해 path 매개변수를 사용합니다.

Unix에서는 로컬 도메인을 Unix 도메인이라고도 합니다. 경로는 파일 시스템 경로 이름입니다. 경로 이름의 길이가 sizeof(sockaddr_un.sun_path)의 길이보다 크면 오류가 발생합니다. 일반적인 값은 Linux에서는 107바이트, macOS에서는 103바이트입니다. Node.js API 추상화가 Unix 도메인 소켓을 생성하는 경우 Unix 도메인 소켓도 연결 해제합니다. 예를 들어 net.createServer()는 Unix 도메인 소켓을 생성할 수 있고 server.close()는 연결을 해제합니다. 그러나 사용자가 이러한 추상화 외부에서 Unix 도메인 소켓을 생성하는 경우 사용자가 제거해야 합니다. Node.js API가 Unix 도메인 소켓을 생성했지만 프로그램이 충돌하는 경우에도 마찬가지입니다. 요약하자면, Unix 도메인 소켓은 파일 시스템에 표시되고 연결이 해제될 때까지 유지됩니다. Linux에서는 경로 시작 부분에 \0을 추가하여 Unix 추상 소켓을 사용할 수 있습니다(예: \0abstract). Unix 추상 소켓 경로는 파일 시스템에 표시되지 않으며 소켓에 대한 모든 열린 참조가 닫히면 자동으로 사라집니다.

Windows에서는 로컬 도메인이 명명된 파이프를 사용하여 구현됩니다. 경로는 \\?\pipe\ 또는 \\.\pipe\의 항목을 참조해야 합니다. 모든 문자가 허용되지만 후자는 .. 시퀀스 해결과 같은 파이프 이름에 대한 일부 처리를 수행할 수 있습니다. 보이는 것과는 달리 파이프 네임스페이스는 평면적입니다. 파이프는 유지되지 않습니다. 파이프에 대한 마지막 참조가 닫히면 제거됩니다. Unix 도메인 소켓과 달리 Windows는 소유 프로세스가 종료될 때 파이프를 닫고 제거합니다.

JavaScript 문자열 이스케이프를 사용하려면 다음과 같이 추가 백슬래시 이스케이프를 사용하여 경로를 지정해야 합니다.

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

클래스: `net.BlockList`

추가됨: v15.0.0, v14.18.0

BlockList 객체는 특정 IP 주소, IP 범위 또는 IP 서브넷에 대한 인바운드 또는 아웃바운드 액세스를 비활성화하기 위한 규칙을 지정하기 위해 일부 네트워크 API와 함께 사용할 수 있습니다.

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

추가됨: v15.0.0, v14.18.0

address <string> | <net.SocketAddress> IPv4 또는 IPv6 주소.
type <string> 'ipv4' 또는 'ipv6'. 기본값: 'ipv4'.

지정된 IP 주소를 차단하는 규칙을 추가합니다.

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

추가됨: v15.0.0, v14.18.0

start <string> | <net.SocketAddress> 범위의 시작 IPv4 또는 IPv6 주소.
end <string> | <net.SocketAddress> 범위의 끝 IPv4 또는 IPv6 주소.
type <string> 'ipv4' 또는 'ipv6'. 기본값: 'ipv4'.

start(포함)에서 end(포함)까지의 IP 주소 범위를 차단하는 규칙을 추가합니다.

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

추가됨: v15.0.0, v14.18.0

net <string> | <net.SocketAddress> 네트워크 IPv4 또는 IPv6 주소.
prefix <number> CIDR 프리픽스 비트 수. IPv4의 경우 0에서 32 사이의 값이어야 합니다. IPv6의 경우 0에서 128 사이여야 합니다.
type <string> 'ipv4' 또는 'ipv6'. 기본값: 'ipv4'.

서브넷 마스크로 지정된 IP 주소 범위를 차단하는 규칙을 추가합니다.

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

Added in: v15.0.0, v14.18.0

address <string> | <net.SocketAddress> 확인할 IP 주소
type <string> 'ipv4' 또는 'ipv6'. 기본값: 'ipv4'.
반환: <boolean>

주어진 IP 주소가 BlockList에 추가된 규칙과 일치하면 true를 반환합니다.

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'));  // Prints: true
console.log(blockList.check('10.0.0.3'));  // Prints: true
console.log(blockList.check('222.111.111.222'));  // Prints: false

// IPv4 주소에 대한 IPv6 표기법이 작동합니다:
console.log(blockList.check('::ffff:7b7b:7b7b', 'ipv6')); // Prints: true
console.log(blockList.check('::ffff:123.123.123.123', 'ipv6')); // Prints: true

`blockList.rules`

Added in: v15.0.0, v14.18.0

타입: <string[]>

블록리스트에 추가된 규칙 목록입니다.