{"id":1685,"date":"2026-05-06T20:28:50","date_gmt":"2026-05-06T20:28:50","guid":{"rendered":"https:\/\/wayhope.kro.kr\/?p=1685"},"modified":"2026-08-31T07:32:42","modified_gmt":"2026-08-31T07:32:42","slug":"node-js-websocket-%ec%84%9c%eb%b2%84-%ea%b0%9c%eb%b0%9c-%ed%95%b5%ec%8b%ac-%ec%a0%95%eb%a6%ac","status":"publish","type":"post","link":"https:\/\/wayhope.kro.kr\/?p=1685","title":{"rendered":"Node.js WebSocket \uc11c\ubc84 \uac1c\ubc1c \ud575\uc2ec \uc815\ub9ac"},"content":{"rendered":"\n

Node.js WebSocket \uc11c\ubc84 \uac1c\ubc1c \ud575\uc2ec \uc815\ub9ac<\/h1>\n\n\n\n

WebSocket\uc740 \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84 \uc0ac\uc774\uc5d0 \uc9c0\uc18d\uc801\uc778 \uc5f0\uacb0\uc744 \uc720\uc9c0\ud558\uba74\uc11c \uc591\ucabd\uc5d0\uc11c \uc790\uc720\ub86d\uac8c \ub370\uc774\ud130\ub97c \uc8fc\uace0\ubc1b\uc744 \uc218 \uc788\uac8c \ud574\uc8fc\ub294 \ud1b5\uc2e0 \ud504\ub85c\ud1a0\ucf5c\uc774\ub2e4.<\/p>\n\n\n\n

\uc77c\ubc18\uc801\uc778 REST API\ub294 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc694\uccad\uc744 \ubcf4\ub0b4\uba74 \uc11c\ubc84\uac00 \uc751\ub2f5\ud558\ub294 \uad6c\uc870\ub2e4.<\/p>\n\n\n\n

Client -> Request -> Server\nClient <- Response <- Server\n<\/code><\/pre>\n\n\n\n
\uc11c\ubc84\uac00 \uba3c\uc800 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uac8c \ub370\uc774\ud130\ub97c \ubcf4\ub0b4\ub824\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ubcc4\ub3c4\uc758 \uc694\uccad\uc744 \ubcf4\ub0b4\uac70\ub098 \ub2e4\ub978 \ud1b5\uc2e0 \ubc29\uc2dd\uc744 \uc0ac\uc6a9\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
WebSocket\uc740 \uc774 \uad6c\uc870\uac00 \ub2e4\ub974\ub2e4.<\/p>\n\n\n\n
Client <-> WebSocket Connection <-> Server\n<\/code><\/pre>\n\n\n\n
\uc5f0\uacb0\uc774 \ud55c\ubc88 \uc131\ub9bd\ub418\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84 \uc5b4\ub290 \ucabd\uc5d0\uc11c\ub3c4 \ub370\uc774\ud130\ub97c \ubcf4\ub0bc \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc774 \ud2b9\uc131 \ub54c\ubb38\uc5d0 \ucc44\ud305, \uc2e4\uc2dc\uac04 \uc54c\ub9bc, \uac8c\uc784, \uc8fc\uc2dd \uc2dc\uc138, \ud611\uc5c5 \ub3c4\uad6c\ucc98\ub7fc \uc11c\ubc84\uc758 \uc0c1\ud0dc \ubcc0\ud654\ub97c \uc2e4\uc2dc\uac04\uc73c\ub85c \uc804\ub2ec\ud574\uc57c \ud558\ub294 \uc11c\ube44\uc2a4\uc5d0\uc11c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n
Node.js\ub294 \ub124\ud2b8\uc6cc\ud06c I\/O\ub97c \ube44\ub3d9\uae30 \ubc29\uc2dd\uc73c\ub85c \ucc98\ub9ac\ud558\uae30 \ub54c\ubb38\uc5d0 WebSocket \uc11c\ubc84\ub97c \uad6c\uc131\ud558\uae30\uc5d0 \uc801\ud569\ud558\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
WebSocket\uc740 \uc5b4\ub5bb\uac8c \uc5f0\uacb0\ub418\ub294\uac00<\/h2>\n\n\n\n
WebSocket \uc5f0\uacb0\uc740 \ucc98\uc74c\ubd80\ud130 \ubcc4\ub3c4\uc758 TCP \uc5f0\uacb0\uc744 \ub9cc\ub4dc\ub294 \ubc29\uc2dd\uc774 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
\uc77c\ubc18\uc801\uc73c\ub85c HTTP \uc5f0\uacb0\uc5d0\uc11c WebSocket \uc5f0\uacb0\ub85c \uc804\ud658\ud558\ub294 Handshake \uacfc\uc815\uc744 \uac70\uce5c\ub2e4.<\/p>\n\n\n\n
Client -> HTTP Upgrade Request -> Node.js Server -> 101 Switching Protocols -> WebSocket Connection\n<\/code><\/pre>\n\n\n\n
\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc11c\ubc84\uc5d0 WebSocket \uc5f0\uacb0\uc744 \uc694\uccad\ud558\uba74 HTTP Upgrade \uc694\uccad\uc744 \ubcf4\ub0b8\ub2e4.<\/p>\n\n\n\n
\uc11c\ubc84\uac00 \uc774\ub97c \ubc1b\uc544\ub4e4\uc774\uba74 101 Switching Protocols<\/code> \uc751\ub2f5\uc744 \ubc18\ud658\ud558\uace0 \uc774\ud6c4 \ud574\ub2f9 \uc5f0\uacb0\uc744 WebSocket \ud1b5\uc2e0\uc5d0 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n
\uadf8 \uc774\ud6c4\uc5d0\ub294 \uc77c\ubc18\uc801\uc778 HTTP Request\/Response \ubc29\uc2dd\uc774 \uc544\ub2c8\ub77c WebSocket Frame\uc744 \uc774\uc6a9\ud574\uc11c \ub370\uc774\ud130\ub97c \uc8fc\uace0\ubc1b\ub294\ub2e4.<\/p>\n\n\n\n
Client <====================> Server\n          WebSocket Frame\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
REST API\uc640 WebSocket\uc758 \ucc28\uc774<\/h2>\n\n\n\n
\ub450 \uae30\uc220\uc740 \uc11c\ub85c \ub300\uccb4 \uad00\uacc4\ub77c\uae30\ubcf4\ub2e4\ub294 \ubaa9\uc801\uc774 \ub2e4\ub974\ub2e4.<\/p>\n\n\n\n
REST API\ub294 \uc694\uccad \ub2e8\uc704\uc758 \ub370\uc774\ud130 \ucc98\ub9ac\uc5d0 \uc801\ud569\ud558\ub2e4.<\/p>\n\n\n\n
GET \/users\nGET \/users\/10\nPOST \/users\nDELETE \/users\/10\n<\/code><\/pre>\n\n\n\n
\ubc18\uba74 WebSocket\uc740 \uc9c0\uc18d\uc801\uc778 \uc5f0\uacb0\uc744 \uc720\uc9c0\ud558\uba74\uc11c \uc774\ubca4\ud2b8\ub97c \uc8fc\uace0\ubc1b\ub294 \ub370 \uc801\ud569\ud558\ub2e4.<\/p>\n\n\n\n
Client -> \"chat message\"\nServer -> \"new message\"\nServer -> \"notification\"\nClient -> \"typing\"\n<\/code><\/pre>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \ucc44\ud305 \uc11c\ube44\uc2a4\ub97c REST API\ub9cc\uc73c\ub85c \uad6c\ud604\ud55c\ub2e4\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uacc4\uc18d \uc11c\ubc84\uc5d0 \uc0c8\ub85c\uc6b4 \uba54\uc2dc\uc9c0\uac00 \uc788\ub294\uc9c0 \ud655\uc778\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
Client -> GET \/messages -> Server -> messages\nClient -> GET \/messages -> Server -> messages\nClient -> GET \/messages -> Server -> messages\n<\/code><\/pre>\n\n\n\n
WebSocket\uc744 \uc0ac\uc6a9\ud558\uba74 \uc11c\ubc84\uac00 \uc0c8\ub85c\uc6b4 \uba54\uc2dc\uc9c0\uac00 \ubc1c\uc0dd\ud55c \uc21c\uac04 \uc5f0\uacb0\ub418\uc5b4 \uc788\ub294 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uac8c \ubc14\ub85c \uc804\ub2ec\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client <-> WebSocket <-> Server -> New Message -> Client\n<\/code><\/pre>\n\n\n\n
\uadf8\ub798\uc11c \uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 REST API\uc640 WebSocket\uc744 \uac19\uc774 \uc0ac\uc6a9\ud558\ub294 \uacbd\uc6b0\ub3c4 \ub9ce\ub2e4.<\/p>\n\n\n\n
REST API -> \ub85c\uadf8\uc778 -> \uc0ac\uc6a9\uc790 \uc815\ubcf4 -> \uac8c\uc2dc\uae00 \uc870\ud68c -> \ub370\uc774\ud130 \uc0dd\uc131\/\uc218\uc815\nWebSocket -> \uc2e4\uc2dc\uac04 \ucc44\ud305 -> \uc54c\ub9bc -> \uc2e4\uc2dc\uac04 \uc0c1\ud0dc \ubcc0\uacbd\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
Node.js\uc5d0\uc11c WebSocket \uc11c\ubc84 \ub9cc\ub4e4\uae30<\/h2>\n\n\n\n
Node.js\uc5d0\uc11c WebSocket \uc11c\ubc84\ub97c \uad6c\ud604\ud558\ub294 \ubc29\ubc95\uc740 \uc5ec\ub7ec \uac00\uc9c0\uac00 \uc788\ub2e4.<\/p>\n\n\n\n
\ub300\ud45c\uc801\uc73c\ub85c ws<\/code> \uac19\uc740 WebSocket \ub77c\uc774\ube0c\ub7ec\ub9ac\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
npm install ws\n<\/code><\/pre>\n\n\n\n
\uac04\ub2e8\ud55c \uc11c\ubc84\ub294 \ub2e4\uc74c\ucc98\ub7fc \ub9cc\ub4e4 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
const WebSocket = require('ws');\n\nconst wss = new WebSocket.Server({\n    port: 3000\n});\n\nwss.on('connection', (socket) => {\n    console.log('Client connected');\n\n    socket.on('message', (message) => {\n        console.log(message.toString());\n    });\n\n    socket.on('close', () => {\n        console.log('Client disconnected');\n    });\n});\n<\/code><\/pre>\n\n\n\n
\uc5ec\uae30\uc11c \uc911\uc694\ud55c \uac83\uc740 HTTP \uc11c\ubc84\ucc98\ub7fc \uc694\uccad \ud558\ub098\ub97c \ubc1b\uace0 \uc751\ub2f5\ud558\ub294 \uac83\uc774 \uc544\ub2c8\ub77c connection<\/code> \uc774\ubca4\ud2b8\ub97c \ud1b5\ud574 \uc5f0\uacb0 \uc790\uccb4\ub97c \uad00\ub9ac\ud55c\ub2e4\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n
WebSocket Server -> Client A\nWebSocket Server -> Client B\nWebSocket Server -> Client C\n<\/code><\/pre>\n\n\n\n
\uac01 \uc5f0\uacb0\uc740 \ud558\ub098\uc758 WebSocket \uac1d\uccb4\ub85c \uad00\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\uba54\uc2dc\uc9c0 \ucc98\ub9ac<\/h2>\n\n\n\n
\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ub370\uc774\ud130\ub97c \ubcf4\ub0b4\uba74 message<\/code> \uc774\ubca4\ud2b8\uac00 \ubc1c\uc0dd\ud55c\ub2e4.<\/p>\n\n\n\n
socket.on('message', (message) => {\n    console.log(message.toString());\n});\n<\/code><\/pre>\n\n\n\n
\uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 \ubb38\uc790\uc5f4 \ud558\ub098\ub97c \uadf8\ub300\ub85c \ubcf4\ub0b4\uae30\ubcf4\ub2e4\ub294 JSON \ud615\ud0dc\ub85c \uba54\uc2dc\uc9c0 \uad6c\uc870\ub97c \uc815\uc758\ud558\ub294 \uacbd\uc6b0\uac00 \ub9ce\ub2e4.<\/p>\n\n\n\n
{\n    \"type\": \"chat\",\n    \"data\": {\n        \"message\": \"Hello\"\n    }\n}\n<\/code><\/pre>\n\n\n\n
\uc11c\ubc84\uc5d0\uc11c\ub294 \uba54\uc2dc\uc9c0 \ud0c0\uc785\uc744 \uae30\uc900\uc73c\ub85c \ucc98\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
socket.on('message', (message) => {\n    const packet = JSON.parse(message);\n\n    switch (packet.type) {\n        case 'chat':\n            handleChat(socket, packet.data);\n            break;\n\n        case 'ping':\n            handlePing(socket);\n            break;\n    }\n});\n<\/code><\/pre>\n\n\n\n
\uc774\ub7f0 \uad6c\uc870\ub97c \uc0ac\uc6a9\ud558\uba74 \ud558\ub098\uc758 WebSocket \uc5f0\uacb0\uc5d0\uc11c \uc5ec\ub7ec \uc885\ub958\uc758 \uc774\ubca4\ud2b8\ub97c \ucc98\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\uc11c\ubc84\uc5d0\uc11c \ud074\ub77c\uc774\uc5b8\ud2b8\ub85c \uba54\uc2dc\uc9c0 \ubcf4\ub0b4\uae30<\/h2>\n\n\n\n
WebSocket\uc758 \ud575\uc2ec\uc740 \uc11c\ubc84\ub3c4 \uc5f0\uacb0\ub41c \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uac8c \uba3c\uc800 \uba54\uc2dc\uc9c0\ub97c \ubcf4\ub0bc \uc218 \uc788\ub2e4\ub294 \uc810\uc774\ub2e4.<\/p>\n\n\n\n
socket.send(JSON.stringify({\n    type: 'notification',\n    data: {\n        message: 'New message'\n    }\n}));\n<\/code><\/pre>\n\n\n\n
REST API\uc5d0\uc11c\ub294 \uc11c\ubc84\uac00 \uba3c\uc800 \uc751\ub2f5\uc744 \ubcf4\ub0bc \uc218 \uc5c6\uc9c0\ub9cc WebSocket\uc5d0\uc11c\ub294 \uc5f0\uacb0\uc774 \uc720\uc9c0\ub418\uace0 \uc788\uae30 \ub54c\ubb38\uc5d0 \uc11c\ubc84\uac00 \uc6d0\ud558\ub294 \uc2dc\uc810\uc5d0 \ub370\uc774\ud130\ub97c \uc804\uc1a1\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc774\uac83\uc774 \uc2e4\uc2dc\uac04 \ud1b5\uc2e0\uc744 \uad6c\ud604\ud558\ub294 \uae30\ubcf8 \uad6c\uc870\ub2e4.<\/p>\n\n\n\n
Server -> Client\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
Broadcast<\/h2>\n\n\n\n
\ucc44\ud305 \uc11c\ubc84\ucc98\ub7fc \ud558\ub098\uc758 \uba54\uc2dc\uc9c0\ub97c \uc5ec\ub7ec \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uac8c \uc804\ub2ec\ud574\uc57c \ud558\ub294 \uacbd\uc6b0\uac00 \uc788\ub2e4.<\/p>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 A\uac00 \ucc44\ud305 \uba54\uc2dc\uc9c0\ub97c \ubcf4\ub0c8\ub2e4\uace0 \ud558\uc790.<\/p>\n\n\n\n
Client A -> \"Hello\" -> Server -> Client B\n                            -> Client C\n                            -> Client D\n<\/code><\/pre>\n\n\n\n
ws<\/code>\uc5d0\uc11c\ub294 \uc5f0\uacb0\ub41c \ud074\ub77c\uc774\uc5b8\ud2b8\ub97c \uc21c\ud68c\ud558\uba74\uc11c \uba54\uc2dc\uc9c0\ub97c \uc804\uc1a1\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
wss.clients.forEach((client) => {\n    if (client.readyState === WebSocket.OPEN) {\n        client.send(message);\n    }\n});\n<\/code><\/pre>\n\n\n\n
\uc774\uac83\uc774 \uae30\ubcf8\uc801\uc778 Broadcast\ub2e4.<\/p>\n\n\n\n
\ub2e4\ub9cc \uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 \ubaa8\ub4e0 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uac8c \ubcf4\ub0b4\ub294 \uac83\uc774 \uc544\ub2c8\ub77c \ud2b9\uc815 \ucc44\ud305\ubc29\uc774\ub098 \uac8c\uc784\ubc29\uc5d0 \uc18d\ud55c \uc0ac\uc6a9\uc790\uc5d0\uac8c\ub9cc \ubcf4\ub0b4\ub294 \uacbd\uc6b0\uac00 \ub9ce\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
Room<\/h2>\n\n\n\n
\ucc44\ud305\uc774\ub098 \uac8c\uc784 \uc11c\ubc84\uc5d0\uc11c\ub294 \uc5f0\uacb0\ub41c \ubaa8\ub4e0 \uc0ac\uc6a9\uc790\ub97c \ud558\ub098\uc758 \uadf8\ub8f9\uc73c\ub85c \ucde8\uae09\ud558\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \ucc44\ud305\ubc29\uc774 \uc788\ub2e4\uba74 \ub2e4\uc74c\uacfc \uac19\uc774 \uad00\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Room A -> Client 1 -> Client 2 -> Client 3\nRoom B -> Client 4 -> Client 5\nRoom C -> Client 6\n<\/code><\/pre>\n\n\n\n
\uc11c\ubc84\ub294 Room\ub9c8\ub2e4 \uc5f0\uacb0\ub41c \ud074\ub77c\uc774\uc5b8\ud2b8\ub97c \uad00\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n
const rooms = new Map();\n\nfunction joinRoom(roomId, socket) {\n    if (!rooms.has(roomId)) {\n        rooms.set(roomId, new Set());\n    }\n\n    rooms.get(roomId).add(socket);\n}\n<\/code><\/pre>\n\n\n\n
\uba54\uc2dc\uc9c0\ub97c \ubcf4\ub0bc \ub54c\ub3c4 \ud2b9\uc815 Room\uc758 \ud074\ub77c\uc774\uc5b8\ud2b8\ub9cc \uc21c\ud68c\ud55c\ub2e4.<\/p>\n\n\n\n
function broadcastRoom(roomId, message) {\n    const clients = rooms.get(roomId);\n\n    if (!clients) {\n        return;\n    }\n\n    for (const client of clients) {\n        if (client.readyState === WebSocket.OPEN) {\n            client.send(message);\n        }\n    }\n}\n<\/code><\/pre>\n\n\n\n
\uac8c\uc784 \uc11c\ubc84\ub77c\uba74 Room\uc774 \ud558\ub098\uc758 \uac8c\uc784 \uc138\uc158\uc774 \ub420 \uc218\ub3c4 \uc788\ub2e4.<\/p>\n\n\n\n
Game Room 101 -> Player A -> Player B -> Player C -> Player D\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
\uc5f0\uacb0 \uc0c1\ud0dc \uad00\ub9ac<\/h2>\n\n\n\n
WebSocket \uc11c\ubc84\ub294 \uc5f0\uacb0 \uc790\uccb4\ub97c \uad00\ub9ac\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\ub300\ud45c\uc801\uc778 \uc774\ubca4\ud2b8\ub294 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
connection -> message -> close -> error\n<\/code><\/pre>\n\n\n\n
\uc5f0\uacb0\uc774 \uc0dd\uc131\ub418\uba74 \uc0ac\uc6a9\uc790 \uc815\ubcf4\ub97c \uc5f0\uacb0 \uac1d\uccb4\uc5d0 \uc5f0\uacb0\ud560 \uc218\ub3c4 \uc788\ub2e4.<\/p>\n\n\n\n
wss.on('connection', (socket) => {\n    socket.userId = null;\n    socket.roomId = null;\n});\n<\/code><\/pre>\n\n\n\n
\uc778\uc99d\uc774 \ub05d\ub09c \ub4a4 \uc0ac\uc6a9\uc790 ID\ub97c \uc800\uc7a5\ud55c\ub2e4.<\/p>\n\n\n\n
Socket -> userId -> roomId -> authenticated\n<\/code><\/pre>\n\n\n\n
\uc774\ub807\uac8c \ud558\uba74 \uba54\uc2dc\uc9c0\uac00 \ub4e4\uc5b4\uc654\uc744 \ub54c \uc5b4\ub5a4 \uc0ac\uc6a9\uc790\uac00 \ubcf4\ub0b8 \uac83\uc778\uc9c0 \ud655\uc778\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc5f0\uacb0\uc774 \uc885\ub8cc\ub418\uba74 Room\uc5d0\uc11c\ub3c4 \uc81c\uac70\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
socket.on('close', () => {\n    leaveRoom(socket);\n});\n<\/code><\/pre>\n\n\n\n
\uc774 \ubd80\ubd84\uc744 \ucc98\ub9ac\ud558\uc9c0 \uc54a\uc73c\uba74 \uc774\ubbf8 \uc5f0\uacb0\uc774 \ub04a\uc5b4\uc9c4 \uc18c\ucf13\uc774 \uc11c\ubc84\uc758 \uc790\ub8cc\uad6c\uc870\uc5d0 \ub0a8\uc544 \uba54\ubaa8\ub9ac\ub098 \uc0c1\ud0dc \uad00\ub9ac\uc5d0 \ubb38\uc81c\uac00 \uc0dd\uae38 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
WebSocket \uc778\uc99d<\/h2>\n\n\n\n
WebSocket\ub3c4 \uacb0\uad6d \uc678\ubd80\uc5d0\uc11c \ub4e4\uc5b4\uc624\ub294 \uc5f0\uacb0\uc774\ub2e4.<\/p>\n\n\n\n
\ub530\ub77c\uc11c \uc778\uc99d \uc5c6\uc774 \uc5f0\uacb0\ub9cc \ud5c8\uc6a9\ud558\uba74 \ub204\uad6c\ub098 \ud574\ub2f9 \uc11c\ubc84\uc5d0 \uc811\uc18d\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc77c\ubc18\uc801\uc73c\ub85c \ub85c\uadf8\uc778\uc740 REST API\ub85c \ucc98\ub9ac\ud558\uace0 \uc778\uc99d \uacb0\uacfc\ub97c \uc774\uc6a9\ud574 WebSocket \uc5f0\uacb0\uc744 \uc778\uc99d\ud558\ub294 \uad6c\uc870\ub97c \ub9ce\uc774 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n
Login -> REST API -> Access Token -> WebSocket Connect -> Authentication -> WebSocket Session\n<\/code><\/pre>\n\n\n\n
\ud1a0\ud070\uc744 WebSocket \uc5f0\uacb0 \uacfc\uc815\uc5d0\uc11c \uc804\ub2ec\ud558\uace0 \uc11c\ubc84\uac00 \uac80\uc99d\ud558\ub294 \ubc29\uc2dd \ub4f1\uc744 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc911\uc694\ud55c \uac83\uc740 WebSocket \uc5f0\uacb0\uc774 \ub9cc\ub4e4\uc5b4\uc84c\ub2e4\uace0 \ud574\uc11c \uc0ac\uc6a9\uc790\uac00 \uc790\ub3d9\uc73c\ub85c \uc778\uc99d\ub41c \uac83\uc740 \uc544\ub2c8\ub77c\ub294 \uc810\uc774\ub2e4.<\/p>\n\n\n\n
\uc778\uc99d\uacfc \uad8c\ud55c \uac80\uc0ac\ub294 \ubcc4\ub3c4\ub85c \uad6c\ud604\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
Ping \/ Pong\uacfc \uc5f0\uacb0 \uc0c1\ud0dc \ud655\uc778<\/h2>\n\n\n\n
\ub124\ud2b8\uc6cc\ud06c \uc5f0\uacb0\uc740 \ud56d\uc0c1 \uc815\uc0c1\uc801\uc73c\ub85c \uc720\uc9c0\ub41c\ub2e4\uace0 \uac00\uc815\ud560 \uc218 \uc5c6\ub2e4.<\/p>\n\n\n\n
\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ube44\uc815\uc0c1\uc801\uc73c\ub85c \uc885\ub8cc\ub418\uac70\ub098 \ub124\ud2b8\uc6cc\ud06c\uac00 \ub04a\uacbc\ub294\ub370 \uc11c\ubc84\uac00 \uc989\uc2dc \uc774\ub97c \uc54c\uc9c0 \ubabb\ud558\ub294 \uacbd\uc6b0\ub3c4 \uc788\ub2e4.<\/p>\n\n\n\n
\uadf8\ub798\uc11c WebSocket\uc5d0\ub294 \uc5f0\uacb0 \uc0c1\ud0dc\ub97c \ud655\uc778\ud558\uae30 \uc704\ud55c Ping\/Pong \uba54\ucee4\ub2c8\uc998\uc774 \uc874\uc7ac\ud55c\ub2e4.<\/p>\n\n\n\n
Server -> Ping -> Client -> Pong -> Server\n<\/code><\/pre>\n\n\n\n
\uc11c\ubc84\uac00 \uc77c\uc815 \uc2dc\uac04 \ub3d9\uc548 \uc751\ub2f5\uc744 \ubc1b\uc9c0 \ubabb\ud558\uba74 \ud574\ub2f9 \uc5f0\uacb0\uc744 \uc885\ub8cc\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Connection -> Ping -> Pong -> Connection \uc720\uc9c0\nConnection -> Ping -> Timeout -> Connection \uc885\ub8cc\n<\/code><\/pre>\n\n\n\n
\uc2e4\uc2dc\uac04 \uc11c\ubc84\uc5d0\uc11c\ub294 \uc5f0\uacb0 \uc0c1\ud0dc \uad00\ub9ac\uac00 \uc0c1\ub2f9\ud788 \uc911\uc694\ud558\ub2e4.<\/p>\n\n\n\n
\ud2b9\ud788 \ubaa8\ubc14\uc77c \ud658\uacbd\ucc98\ub7fc \ub124\ud2b8\uc6cc\ud06c\uac00 \uc790\uc8fc \ubcc0\uacbd\ub418\ub294 \ud658\uacbd\uc5d0\uc11c\ub294 \ub354 \uadf8\ub807\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
WebSocket\uacfc Event Loop<\/h2>\n\n\n\n
Node.js WebSocket \uc11c\ubc84\ub97c \uc774\ud574\ud558\ub824\uba74 Event Loop\uc640 \ube44\ub3d9\uae30 I\/O\ub97c \uac19\uc774 \ubd10\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\uc218\ub9ce\uc740 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc5f0\uacb0\ub418\uc5b4 \uc788\uc5b4\ub3c4 \uac01\uac01\uc758 \uc5f0\uacb0\ub9c8\ub2e4 JavaScript \uc2a4\ub808\ub4dc\ub97c \ud558\ub098\uc529 \ub9cc\ub4dc\ub294 \ubc29\uc2dd\uc740 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
Node.js Process -> Event Loop -> Socket A\n                             -> Socket B\n                             -> Socket C\n                             -> Socket D\n                             -> ...\n<\/code><\/pre>\n\n\n\n
\ub124\ud2b8\uc6cc\ud06c I\/O\uac00 \ubc1c\uc0dd\ud558\uba74 Node.js\uac00 \uc774\ubca4\ud2b8\ub97c \ucc98\ub9ac\ud558\uace0 \ud574\ub2f9 Callback\uc744 \uc2e4\ud589\ud55c\ub2e4.<\/p>\n\n\n\n
\uc774 \uad6c\uc870\ub294 \ub9ce\uc740 \uc5f0\uacb0\uc744 \uc720\uc9c0\ud574\uc57c \ud558\ub294 I\/O \uc911\uc2ec \uc11c\ubc84\uc5d0 \uc801\ud569\ud558\ub2e4.<\/p>\n\n\n\n
\ud558\uc9c0\ub9cc WebSocket\uc774\ub77c\uace0 \ud574\uc11c CPU \uc791\uc5c5\uc774 \uc790\ub3d9\uc73c\ub85c \ubcd1\ub82c \ucc98\ub9ac\ub418\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \uba54\uc2dc\uc9c0\ub97c \ubc1b\uc744 \ub54c\ub9c8\ub2e4 \ub9e4\uc6b0 \ubb34\uac70\uc6b4 \uacc4\uc0b0\uc744 \uc218\ud589\ud558\uba74 Event Loop\uac00 \ud574\ub2f9 \uc791\uc5c5\uc5d0 \ubd99\uc7a1\ud78c\ub2e4.<\/p>\n\n\n\n
Client A -> Heavy CPU Calculation -> Event Loop \uc810\uc720 -> Client B \/ Client C \/ Client D\n<\/code><\/pre>\n\n\n\n
\ub530\ub77c\uc11c WebSocket \uc11c\ubc84\uc5d0\uc11c\ub3c4 CPU \uc5f0\uc0b0\uacfc \ub124\ud2b8\uc6cc\ud06c I\/O\ub97c \uad6c\ubd84\ud574\uc11c \uc0dd\uac01\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\uba54\uc2dc\uc9c0 \ucc98\ub9ac \uad6c\uc870<\/h2>\n\n\n\n
\uc2e4\uc81c \uc11c\ubc84\uc5d0\uc11c\ub294 message<\/code> \uc774\ubca4\ud2b8 \ud558\ub098\uc5d0 \ubaa8\ub4e0 \ub85c\uc9c1\uc744 \uc791\uc131\ud558\uc9c0 \uc54a\ub294 \ud3b8\uc774 \uc88b\ub2e4.<\/p>\n\n\n\n
socket.on('message', (message) => {\n    const packet = JSON.parse(message);\n\n    handleMessage(socket, packet);\n});\n<\/code><\/pre>\n\n\n\n
\uadf8\ub9ac\uace0 \uba54\uc2dc\uc9c0 \ud0c0\uc785\uc5d0 \ub530\ub77c Handler\ub97c \ubd84\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n
function handleMessage(socket, packet) {\n    switch (packet.type) {\n        case 'join_room':\n            return handleJoinRoom(socket, packet);\n\n        case 'chat':\n            return handleChat(socket, packet);\n\n        case 'move':\n            return handleMove(socket, packet);\n    }\n}\n<\/code><\/pre>\n\n\n\n
\uad6c\uc870\uc801\uc73c\ub85c \ubcf4\uba74 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
WebSocket -> Message Parser -> Message Router -> Chat Handler\n                                              -> Room Handler\n                                              -> Game Handler\n                                              -> Notification Handler\n<\/code><\/pre>\n\n\n\n
REST API\uc5d0\uc11c Router\uc640 Controller\ub97c \ubd84\ub9ac\ud558\ub294 \uac83\uacfc \ube44\uc2b7\ud55c \uac1c\ub150\uc774\ub2e4.<\/p>\n\n\n\n
WebSocket\uc5d0\uc11c\ub3c4 \uacb0\uad6d \ud1b5\uc2e0 \uacc4\uce35\uacfc \uc2e4\uc81c \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc744 \ubd84\ub9ac\ud558\ub294 \uac83\uc774 \uad00\ub9ac\ud558\uae30 \ud3b8\ud558\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
WebSocket\uc5d0\uc11c \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc740 \uc5b4\ub514\uc5d0 \uc788\ub294\uac00<\/h2>\n\n\n\n
WebSocket \uc790\uccb4\ub294 \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc744 \uc81c\uacf5\ud558\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \uac8c\uc784 \uc11c\ubc84\uc5d0\uc11c \ub2e4\uc74c\uacfc \uac19\uc740 \uaddc\uce59\uc774 \uc788\ub2e4\uace0 \ud558\uc790.<\/p>\n\n\n\n
Player\uac00 \uc774\ub3d9 \uc694\uccad -> \uc774\ub3d9 \uac00\ub2a5\ud55c \uc704\uce58\uc778\uc9c0 \uac80\uc0ac -> \uac8c\uc784 \uc0c1\ud0dc \ubcc0\uacbd -> \uc8fc\ubcc0 \ud50c\ub808\uc774\uc5b4\uc5d0\uac8c \uc0c1\ud0dc \uc804\ub2ec\n<\/code><\/pre>\n\n\n\n
WebSocket\uc740 \uc774 \uacfc\uc815\uc5d0\uc11c \ub370\uc774\ud130\ub97c \uc804\ub2ec\ud558\ub294 \ud1b5\uc2e0 \uacc4\uce35\uc5d0 \uac00\uae5d\ub2e4.<\/p>\n\n\n\n
Client -> Move Packet -> WebSocket -> Game Service -> \uc774\ub3d9 \uac80\uc99d -> \uac8c\uc784 \uc0c1\ud0dc \ubcc0\uacbd -> Broadcast\n<\/code><\/pre>\n\n\n\n
WebSocket \ub77c\uc774\ube0c\ub7ec\ub9ac\uac00 \uac8c\uc784 \uaddc\uce59\uc744 \uc54c\uace0 \uc788\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
\uac8c\uc784 \ub85c\uc9c1, \ucc44\ud305\ubc29 \uaddc\uce59, \uad8c\ud55c, \ub9e4\uce6d, \uc544\uc774\ud15c \ucc98\ub9ac \uac19\uc740 \uac83\uc740 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc774 \uc9c1\uc811 \uad6c\ud604\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\uc774 \uad6c\ubd84\uc744 \ud574\ub450\uba74 WebSocket \uc11c\ubc84\uc758 \uc5ed\ud560\uc744 \ud6e8\uc52c \uba85\ud655\ud558\uac8c \ubcfc \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
REST API\uc640 WebSocket\uc744 \uac19\uc774 \uc0ac\uc6a9\ud558\ub294 \uad6c\uc870<\/h2>\n\n\n\n
\uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 REST API\uc640 WebSocket \uc911 \ud558\ub098\ub9cc \uc120\ud0dd\ud574\uc57c \ud558\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
\uac01\uac01 \uc798\ud558\ub294 \uc77c\uc774 \ub2e4\ub974\uae30 \ub54c\ubb38\uc5d0 \uac19\uc774 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> REST API -> Request \ucc98\ub9ac -> Business Logic -> Database\nClient -> WebSocket -> \uc2e4\uc2dc\uac04 \uc774\ubca4\ud2b8 -> Business Logic -> Database\n<\/code><\/pre>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \uac8c\uc784 \uc11c\ube44\uc2a4\ub77c\uba74 \ub2e4\uc74c\ucc98\ub7fc \ub098\ub20c \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
REST API -> \ud68c\uc6d0\uac00\uc785 -> \ub85c\uadf8\uc778 -> \uce90\ub9ad\ud130 \uc815\ubcf4 -> \uc778\ubca4\ud1a0\ub9ac \uc870\ud68c -> \uac8c\uc784 \uae30\ub85d \uc870\ud68c\nWebSocket -> \uac8c\uc784 \uc785\uc7a5 -> \ud50c\ub808\uc774\uc5b4 \uc774\ub3d9 -> \uacf5\uaca9 -> \uac8c\uc784 \uc0c1\ud0dc \ub3d9\uae30\ud654 -> \uc2e4\uc2dc\uac04 \uc774\ubca4\ud2b8\n<\/code><\/pre>\n\n\n\n
\ucc44\ud305 \uc11c\ube44\uc2a4\ub3c4 \ube44\uc2b7\ud558\ub2e4.<\/p>\n\n\n\n
REST API -> \ub85c\uadf8\uc778 -> \ucc44\ud305\ubc29 \ubaa9\ub85d -> \uacfc\uac70 \uba54\uc2dc\uc9c0 \uc870\ud68c\nWebSocket -> \ucc44\ud305\ubc29 \uc5f0\uacb0 -> \uba54\uc2dc\uc9c0 \uc804\uc1a1 -> \uba54\uc2dc\uc9c0 \uc218\uc2e0 -> \uc0ac\uc6a9\uc790 \uc0c1\ud0dc \ubcc0\uacbd\n<\/code><\/pre>\n\n\n\n
REST API\uac00 \ub370\uc774\ud130\ub97c \uc870\ud68c\ud558\uace0 \uad00\ub9ac\ud558\ub294 \ud1b5\uc2e0 \ubc29\uc2dd\uc774\ub77c\uba74 WebSocket\uc740 \uc9c0\uc18d\uc801\uc778 \uc5f0\uacb0\uc744 \uae30\ubc18\uc73c\ub85c \uc2e4\uc2dc\uac04 \uc774\ubca4\ud2b8\ub97c \uc804\ub2ec\ud558\ub294 \ud1b5\uc2e0 \ubc29\uc2dd\uc73c\ub85c \ubcfc \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\ub2e8\uc77c \uc11c\ubc84\uc5d0\uc11c \uc5ec\ub7ec WebSocket \uc11c\ubc84\ub85c \ud655\uc7a5\ud558\uae30<\/h2>\n\n\n\n
\uac1c\ubc1c \ucd08\uae30\uc5d0\ub294 \ud558\ub098\uc758 Node.js \ud504\ub85c\uc138\uc2a4\uc5d0\uc11c \ubaa8\ub4e0 \uc5f0\uacb0\uc744 \uad00\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> Node.js -> WebSocket -> Business Logic -> Database\n<\/code><\/pre>\n\n\n\n
\uc0ac\uc6a9\uc790\uac00 \ub298\uc5b4\ub098\uba74 \uc11c\ubc84\ub97c \uc5ec\ub7ec \uac1c \uc2e4\ud589\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Load Balancer -> Server A\nLoad Balancer -> Server B\nLoad Balancer -> Server C\n<\/code><\/pre>\n\n\n\n
\ubb38\uc81c\ub294 WebSocket \uc5f0\uacb0\uc774 \ud2b9\uc815 \uc11c\ubc84\uc5d0 \ubd99\uc5b4 \uc788\ub2e4\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \uc0ac\uc6a9\uc790 A\uac00 Server A\uc5d0 \uc5f0\uacb0\ub418\uc5b4 \uc788\uace0 \uc0ac\uc6a9\uc790 B\uac00 Server B\uc5d0 \uc5f0\uacb0\ub418\uc5b4 \uc788\ub2e4\uace0 \ud558\uc790.<\/p>\n\n\n\n
User A -> Server A\nUser B -> Server B\n<\/code><\/pre>\n\n\n\n
A\uac00 B\uc5d0\uac8c \uba54\uc2dc\uc9c0\ub97c \ubcf4\ub0b4\ub824\uba74 Server A\uac00 Server B\uc5d0 \ud574\ub2f9 \uba54\uc2dc\uc9c0\ub97c \uc804\ub2ec\ud560 \ubc29\ubc95\uc774 \ud544\uc694\ud558\ub2e4.<\/p>\n\n\n\n
\uc774\ub54c Redis Pub\/Sub\uc774\ub098 Kafka \uac19\uc740 \uba54\uc2dc\uc9d5 \uc2dc\uc2a4\ud15c\uc744 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
User A -> Server A -> Message Broker -> Server B -> User B\n<\/code><\/pre>\n\n\n\n
\uc774 \uad6c\uc870\ub97c \uc0ac\uc6a9\ud558\uba74 \uc5ec\ub7ec Node.js \uc11c\ubc84 \uc0ac\uc774\uc5d0\uc11c \uc774\ubca4\ud2b8\ub97c \uc804\ub2ec\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\ub2e4\ub9cc \uc5b4\ub5a4 \uba54\uc2dc\uc9d5 \uc2dc\uc2a4\ud15c\uc744 \uc0ac\uc6a9\ud560\uc9c0\ub294 \uc11c\ube44\uc2a4\uc758 \uc694\uad6c\uc0ac\ud56d\uc5d0 \ub530\ub77c \ub2ec\ub77c\uc9c4\ub2e4. \ub2e8\uc21c\ud55c \uc2e4\uc2dc\uac04 \uc774\ubca4\ud2b8 \uc804\ub2ec\uacfc \uba54\uc2dc\uc9c0 \uc601\uc18d\uc131, \uc21c\uc11c \ubcf4\uc7a5, \uc7ac\ucc98\ub9ac \uc694\uad6c\uc0ac\ud56d\uc740 \uc11c\ub85c \ub2e4\ub978 \ubb38\uc81c\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
WebSocket \uc11c\ubc84\uc5d0\uc11c \uc790\uc8fc \ubc1c\uc0dd\ud558\ub294 \ubb38\uc81c<\/h2>\n\n\n\n
WebSocket \uc11c\ubc84\ub294 \uc5f0\uacb0\uc744 \uc624\ub798 \uc720\uc9c0\ud55c\ub2e4\ub294 \ud2b9\uc131 \ub54c\ubb38\uc5d0 \uc77c\ubc18\uc801\uc778 REST API \uc11c\ubc84\uc640 \uad00\ub9ac\ud574\uc57c \ud558\ub294 \ubb38\uc81c\uac00 \uc870\uae08 \ub2e4\ub974\ub2e4.<\/p>\n\n\n\n
\ub300\ud45c\uc801\uc73c\ub85c \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
Connection Management -> Authentication -> Heartbeat -> Reconnect -> Room Management -> Broadcast -> Message Validation -> Rate Limiting -> Memory Management -> Multi Server Synchronization\n<\/code><\/pre>\n\n\n\n
\ud2b9\ud788 \uc5f0\uacb0\uc774 \ub04a\uacbc\uc744 \ub54c \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc5b4\ub5bb\uac8c \ub2e4\uc2dc \uc5f0\uacb0\ud560 \uac83\uc778\uc9c0\ub3c4 \uc911\uc694\ud558\ub2e4.<\/p>\n\n\n\n
Connected -> Network Error -> Disconnected -> Reconnect -> Authentication -> Join Room -> Connected\n<\/code><\/pre>\n\n\n\n
\uc7ac\uc5f0\uacb0\ub9cc \ud55c\ub2e4\uace0 \ub05d\ub098\ub294 \uac83\ub3c4 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
\uc5f0\uacb0\uc774 \ub04a\uae34 \ub3d9\uc548 \ubc1c\uc0dd\ud55c \uc774\ubca4\ud2b8\ub97c \uc5b4\ub5bb\uac8c \ucc98\ub9ac\ud560\uc9c0 \uacb0\uc815\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\ub2e8\uc21c\ud55c \uc2e4\uc2dc\uac04 \uc0c1\ud0dc\ub77c\uba74 \ucd5c\uc2e0 \uc0c1\ud0dc\ub97c \ub2e4\uc2dc \ubc1b\uc73c\uba74 \ub420 \uc218\ub3c4 \uc788\uace0, \uc911\uc694\ud55c \uc774\ubca4\ud2b8\ub77c\uba74 \uc11c\ubc84\uc5d0\uc11c \ubcc4\ub3c4\ub85c \uae30\ub85d\ud558\uace0 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ub204\ub77d\ub41c \ub370\uc774\ud130\ub97c \uc694\uccad\ud558\ub3c4\ub85d \uc124\uacc4\ud560 \uc218\ub3c4 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
WebSocket\uacfc \uac8c\uc784 \uc11c\ubc84<\/h2>\n\n\n\n
\uac8c\uc784\uc5d0\uc11c WebSocket\uc744 \uc0ac\uc6a9\ud560 \ub54c\ub294 \ud2b9\ud788 \ud1b5\uc2e0\uacfc \uac8c\uc784 \ub85c\uc9c1\uc744 \uad6c\ubd84\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \ud50c\ub808\uc774\uc5b4\uac00 \uc774\ub3d9\ud55c\ub2e4\uace0 \ud558\uc790.<\/p>\n\n\n\n
Client -> Move(x, y) -> WebSocket Server -> Game Logic -> \uc774\ub3d9 \uac00\ub2a5 \uc5ec\ubd80 \uac80\uc0ac -> \uac8c\uc784 \uc0c1\ud0dc \ubcc0\uacbd -> \ub2e4\ub978 \ud50c\ub808\uc774\uc5b4 \uc0c1\ud0dc \ubcc0\uacbd -> Broadcast -> Client A \/ Client B \/ Client C\n<\/code><\/pre>\n\n\n\n
\uc5ec\uae30\uc11c WebSocket\uc740 Move(x, y)<\/code>\ub77c\ub294 \ub370\uc774\ud130\ub97c \uc804\ub2ec\ud558\uace0 \uacb0\uacfc\ub97c \ub2e4\uc2dc \ubcf4\ub0b4\ub294 \uc5ed\ud560\uc744 \ud55c\ub2e4.<\/p>\n\n\n\n
\uc2e4\uc81c \uc774\ub3d9 \uac00\ub2a5 \uc5ec\ubd80, \ucda9\ub3cc, \ub370\ubbf8\uc9c0, \uac8c\uc784 \uaddc\uce59 \uac19\uc740 \uac83\uc740 \uac8c\uc784 \uc11c\ubc84\uc758 \ucc45\uc784\uc774\ub2e4.<\/p>\n\n\n\n
\ub610\ud55c \uac8c\uc784\uc758 \uc2e4\uc2dc\uac04\uc131 \uc694\uad6c\uac00 \ub192\uc544\uc9c8\uc218\ub85d WebSocket\ub9cc\uc73c\ub85c \ucda9\ubd84\ud55c\uc9c0 \ub530\uc838\ubd10\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
WebSocket\uc740 TCP \uae30\ubc18\uc758 \uc591\ubc29\ud5a5 \ud1b5\uc2e0\uc774\uace0 \ub370\uc774\ud130 \uc804\ub2ec\uc758 \uc2e0\ub8b0\uc131\uacfc \uc21c\uc11c\ub97c \ubcf4\uc7a5\ud558\ub294 \ub300\uc2e0 \ub124\ud2b8\uc6cc\ud06c \uc9c0\uc5f0\uc774\ub098 Head-of-Line Blocking \uac19\uc740 TCP \ud2b9\uc131\uc758 \uc601\ud5a5\uc744 \ubc1b\ub294\ub2e4.<\/p>\n\n\n\n
\ub530\ub77c\uc11c \ube60\ub978 \uc0c1\ud0dc \ub3d9\uae30\ud654\uac00 \ud575\uc2ec\uc778 \ub300\uaddc\ubaa8 \uc2e4\uc2dc\uac04 \uac8c\uc784\uc5d0\uc11c\ub294 UDP \uacc4\uc5f4 \ud504\ub85c\ud1a0\ucf5c\uc774\ub098 \ubcc4\ub3c4\uc758 \ub124\ud2b8\uc6cc\ud06c \uad6c\uc870\ub97c \uace0\ub824\ud558\uae30\ub3c4 \ud55c\ub2e4.<\/p>\n\n\n\n
WebSocket\uc774 \uac8c\uc784 \uc11c\ubc84\uc758 \ubaa8\ub4e0 \uc0c1\ud669\uc5d0 \uc801\ud569\ud55c \uac83\uc740 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\uc804\uccb4 \uad6c\uc870<\/h2>\n\n\n\n
Node.js WebSocket \uc11c\ubc84\ub97c \uc804\uccb4\uc801\uc73c\ub85c \ubcf4\uba74 \ub2e4\uc74c \uad6c\uc870\ub85c \uc815\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> WebSocket -> WebSocket Server -> Authentication -> Message Router -> Chat \/ Room \/ Game Logic -> Data \/ State -> Database \/ Redis\n<\/code><\/pre>\n\n\n\n
\uc11c\ubc84\uac00 \uc5ec\ub7ec \ub300\ub77c\uba74 \uba54\uc2dc\uc9c0 \ube0c\ub85c\ucee4\uac00 \ucd94\uac00\ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> Load Balancer -> Server A \/ Server B \/ Server C -> Redis \/ Kafka -> Database\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
\uc815\ub9ac<\/h2>\n\n\n\n
Node.js WebSocket \uc11c\ubc84\uc758 \ud575\uc2ec\uc740 \uc5f0\uacb0\uc744 \uc720\uc9c0\ud558\uba74\uc11c \uc591\ubc29\ud5a5\uc73c\ub85c \uc774\ubca4\ud2b8\ub97c \uc8fc\uace0\ubc1b\ub294 \uad6c\uc870<\/strong>\ub97c \uc774\ud574\ud558\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n
REST API\uac00<\/p>\n\n\n\n
Request -> Response\n<\/code><\/pre>\n\n\n\n
\ub97c \uae30\ubcf8 \ub2e8\uc704\ub85c \ud55c\ub2e4\uba74 WebSocket\uc740<\/p>\n\n\n\n
Connection <-> Event\n<\/code><\/pre>\n\n\n\n
\ub97c \uae30\ubcf8 \ub2e8\uc704\ub85c \uc0dd\uac01\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Node.js\ub294 Event Loop\uc640 \ube44\ub3d9\uae30 I\/O\ub97c \uae30\ubc18\uc73c\ub85c \ub9ce\uc740 \ub124\ud2b8\uc6cc\ud06c \uc5f0\uacb0\uc744 \ucc98\ub9ac\ud558\uace0, WebSocket \ub77c\uc774\ube0c\ub7ec\ub9ac\ub294 \uc5f0\uacb0\uacfc \uba54\uc2dc\uc9c0 \uc1a1\uc218\uc2e0\uc744 \uad00\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n
\uadf8 \uc704\uc5d0 \uc9c1\uc811 \uad6c\ud604\ud574\uc57c \ud558\ub294 \uac83\uc774 \ub9ce\ub2e4.<\/p>\n\n\n\n
WebSocket -> Authentication -> Message Protocol -> Room -> Broadcast -> Business Logic -> Connection Management -> Reconnect -> Server Scaling\n<\/code><\/pre>\n\n\n\n
WebSocket \uc790\uccb4\uac00 \ucc44\ud305 \uc11c\ubc84\ub098 \uac8c\uc784 \uc11c\ubc84\ub97c \ub9cc\ub4e4\uc5b4\uc8fc\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4. WebSocket\uc740 \ud1b5\uc2e0 \ucc44\ub110\uc774\uace0, \uadf8 \uc704\uc5d0 \uc5b4\ub5a4 \uba54\uc2dc\uc9c0 \uaddc\uaca9\uacfc \uc0c1\ud0dc \uad00\ub9ac, \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc744 \uad6c\uc131\ud560\uc9c0\ub294 \uc11c\ubc84 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc758 \ucc45\uc784\uc774\ub2e4.<\/p>\n\n\n\n
Node.js REST API\uc640 WebSocket \uc11c\ubc84\ub97c \ube44\uad50\ud574\uc11c \ubcf4\uba74 \uc5ed\ud560 \ucc28\uc774\uac00 \ub354 \uba85\ud655\ud558\ub2e4.<\/p>\n\n\n\n
REST API -> Client -> HTTP Request -> Server -> HTTP Response -> Client\nWebSocket -> Client <=========================> Server -> Persistent Connection\n<\/code><\/pre>\n\n\n\n
\uacb0\uad6d \ub458\uc758 \uc120\ud0dd \uae30\uc900\uc740 \uac04\ub2e8\ud558\ub2e4. \uc694\uccad\uc774 \ub4e4\uc5b4\uc654\uc744 \ub54c \ub370\uc774\ud130\ub97c \ucc98\ub9ac\ud558\uace0 \uc751\ub2f5\ud558\uba74 \ub418\ub294 \uae30\ub2a5\uc740 REST API\ub85c \ucda9\ubd84\ud55c \uacbd\uc6b0\uac00 \ub9ce\uace0, \uc11c\ubc84\uc640 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc9c0\uc18d\uc801\uc73c\ub85c \uc0c1\ud0dc\ub97c \uc8fc\uace0\ubc1b\uc544\uc57c \ud55c\ub2e4\uba74 WebSocket\uc774 \uc801\ud569\ud558\ub2e4.<\/p>\n\n\n\n
\uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 \ub458 \uc911 \ud558\ub098\ub97c \uace0\ub974\ub294 \uac83\uc774 \uc544\ub2c8\ub77c REST API\ub294 \uc77c\ubc18\uc801\uc778 \ub370\uc774\ud130 \ucc98\ub9ac\uc5d0 \uc0ac\uc6a9\ud558\uace0 WebSocket\uc740 \uc2e4\uc2dc\uac04 \uc774\ubca4\ud2b8 \uc804\ub2ec\uc5d0 \uc0ac\uc6a9\ud558\ub294 \ubc29\uc2dd\uc73c\ub85c \uc870\ud569\ud558\ub294 \uacbd\uc6b0\uac00 \ub9ce\ub2e4.<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"
Node.js WebSocket \uc11c\ubc84 \uac1c\ubc1c \ud575\uc2ec \uc815\ub9ac WebSocket\uc740 \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84 \uc0ac\uc774\uc5d0 \uc9c0\uc18d\uc801\uc778 \uc5f0\uacb0\uc744 \uc720\uc9c0\ud558\uba74\uc11c \uc591\ucabd\uc5d0\uc11c \uc790\uc720\ub86d\uac8c \ub370\uc774\ud130\ub97c \uc8fc\uace0\ubc1b\uc744 \uc218 \uc788\uac8c \ud574\uc8fc\ub294 \ud1b5\uc2e0 \ud504\ub85c\ud1a0\ucf5c\uc774\ub2e4. \uc77c\ubc18\uc801\uc778 REST API\ub294 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc694\uccad\uc744 \ubcf4\ub0b4\uba74 \uc11c\ubc84\uac00 \uc751\ub2f5\ud558\ub294 \uad6c\uc870\ub2e4. \uc11c\ubc84\uac00 \uba3c\uc800 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uac8c \ub370\uc774\ud130\ub97c \ubcf4\ub0b4\ub824\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ubcc4\ub3c4\uc758 \uc694\uccad\uc744 \ubcf4\ub0b4\uac70\ub098 \ub2e4\ub978 \ud1b5\uc2e0 \ubc29\uc2dd\uc744 \uc0ac\uc6a9\ud574\uc57c \ud55c\ub2e4. WebSocket\uc740 \uc774 \uad6c\uc870\uac00 \ub2e4\ub974\ub2e4. \uc5f0\uacb0\uc774 \ud55c\ubc88 \uc131\ub9bd\ub418\uba74 \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84 \uc5b4\ub290 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[49],"tags":[],"class_list":["post-1685","post","type-post","status-publish","format-standard","hentry","category-server"],"_links":{"self":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/1685","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1685"}],"version-history":[{"count":3,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/1685\/revisions"}],"predecessor-version":[{"id":1969,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/1685\/revisions\/1969"}],"wp:attachment":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1685"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1685"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1685"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}