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])`

추가된 버전: 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')) // 출력: true
console.log(blockList.check('10.0.0.3')) // 출력: true
console.log(blockList.check('222.111.111.222')) // 출력: false

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

`blockList.rules`

추가된 버전: v15.0.0, v14.18.0

유형: <string[]>

차단 목록에 추가된 규칙 목록입니다.