Socket.IO — 실시간 양방향 상호작용을 위한 라이브러리란

Socket.IO란?

Socket.IO는 클라이언트와 서버 간 양방향 이벤트 기반 통신을 위한 오픈 소스 JavaScript 라이브러리입니다. 2010년 개발자 Guillermo Rauch에 의해 만들어졌으며, 그 이후로 Node.js에서 실시간 애플리케이션의 사실상 표준이 되었습니다.

네이티브 WebSocket API와 달리 Socket.IO는 룸, 네임스페이스, 자동 재연결 및 바이너리 데이터 유형과 같은 추가 추상화를 제공합니다. 이 라이브러리는 WebSocket의 별도 구현이 아닙니다. 전송 계층으로 Engine.IO를 사용하며, 먼저 HTTP long-polling 연결을 설정한 다음 WebSocket으로 업그레이드를 시도합니다.

npm 통계(2025)에 따르면, socket.io 패키지가 주당 1,200만 개 이상 다운로드되어 Node.js 생태계에서 가장 인기 있는 라이브러리 중 하나가 되었습니다. Socket.IO는 브라우저, iOS, Android, React Native 및 데스크톱 애플리케이션 등 모든 최신 플랫폼에서 지원됩니다.

역사 및 버전

Socket.IO 버전 1.0은 2014년에 출시되었으며 단일 TCP 연결을 통해 여러 논리적 채널을 다중화할 수 있는 네임스페이스 개념을 도입했습니다. 버전 2.0(2017)은 바이너리 데이터 지원을 추가하고 구문 분석 성능을 개선했습니다. 현재 버전 4.x(2020~2025)는 TypeScript 완전 지원, 스케일링을 위한 플래그십 어댑터 모드 및 향상된 하위 호환성을 포함합니다.

각 주요 릴리스는 API 하위 호환성을 유지합니다. socket.io@2 클라이언트는 특수 호환성 모드를 통해 socket.io@4 서버에 연결할 수 있습니다. 이는 클라이언트 측 업그레이드가 점진적으로 이루어지는 장기 프로젝트에 중요합니다.

Socket.IO의 작동 방식

Socket.IO 아키텍처는 서버 모듈(npm 패키지 socket.io)과 클라이언트 모듈(npm 패키지 socket.io-client)의 두 가지 구성 요소로 구성됩니다. 서버는 Node.js HTTP(S) 서버 위에서 실행되며 전송 계층을 관리하기 위해 Engine.IO를 사용합니다.

초기 연결 시 클라이언트는 서버에 HTTP 요청을 보냅니다. Engine.IO가 응답하고 long-polling 연결을 설정합니다. 그 후 클라이언트는 전송 프로토콜을 WebSocket으로 업그레이드하는 요청을 보냅니다. 서버가 WebSocket을 지원하는 경우 업그레이드는 단일 TCP 세션 내에서 이루어집니다. 그렇지 않은 경우 연결은 long-polling 상태로 유지되며 애플리케이션 코드를 변경할 필요가 없습니다.

Socket.IO 성능 테스트(2024)에 따르면 WebSocket 사용 시 지연 시간은 메시지 전송당 2~5ms인 반면, long-polling은 HTTP 오버헤드로 인해 150~300ms가 추가됩니다. 전송 선택은 개발자에게 투명합니다.

Engine.IO 프로토콜

Engine.IO는 Socket.IO가 구축된 하위 수준 전송 계층입니다. 연결 설정, 전송 선택, 하트비트(ping/pong) 및 연결 종료를 처리합니다. 주요 Engine.IO 패킷 유형은 open(초기화), close(종료), ping/pong(연결 유지), upgrade(전송 변경) 및 message(데이터)입니다.

Socket.IO는 Engine.IO 위에 자체 이벤트 기반 모델을 구축합니다. 이것이 개발자가 작업하는 것입니다. 각 Socket.IO 메시지는 배달 확인을 위한 고유 식별자와 함께 Engine.IO 패킷으로 래핑됩니다.

Socket.IO의 주요 기능

Socket.IO는 네이티브 WebSocket API에는 없으며 실시간 애플리케이션 개발을 훨씬 쉽게 만드는 기능 세트를 제공합니다. 주요 기능을 살펴보겠습니다.

자동 재연결 — 클라이언트는 연결이 끊어지면 지수 백오프(100ms, 200ms, 400ms... 최대까지)로 자동으로 연결을 복원합니다. Socket.IO 문서(2024)에 따르면 재시도 설정은 reconnectionDelay 및 reconnectionAttempts 매개변수를 통해 사용할 수 있습니다. 이 옵션은 네트워크 변경 중에 연결이 중단될 수 있는 모바일 애플리케이션에 중요합니다.

룸 지원 — 서버는 소켓을 룸으로 그룹화하고 특정 룸의 참가자에게만 메시지를 보낼 수 있습니다. 룸은 명시적 생성을 필요로 하지 않습니다. 첫 번째 소켓이 참여할 때 생성됩니다. 룸은 프로세스 수준에서 구현되며 특수 어댑터 없이는 다른 서버 간에 공유되지 않습니다.

네임스페이스 — 단일 연결에서 통신 채널의 논리적 분리입니다. 예를 들어 채팅 메시지용 /chat 네임스페이스와 알림용 /notifications 네임스페이스가 있습니다. 각 네임스페이스에는 자체 룸, 미들웨어 및 핸들러가 있습니다. 네임스페이스는 단일 TCP 연결을 통해 다중화되어 리소스를 절약합니다.

배달 확인 — 메시지를 보낼 때 서버가 수신을 확인하면 호출되는 콜백 함수를 전달할 수 있습니다. 이는 각 패킷의 고유 식별자를 통해 구현됩니다. 확인 메커니즘은 중요한 메시지(예: 결제 트랜잭션)가 수신자에게 전달되도록 보장합니다.

Socket.IO vs WebSocket: 비교

Socket.IO와 네이티브 WebSocket 간의 선택은 프로젝트 요구 사항에 따라 다릅니다. WebSocket은 모든 최신 브라우저에서 지원되는 표준화된 프로토콜(RFC 6455)입니다. Socket.IO는 WebSocket을 전송으로 사용하지만 추가 기능을 추가하는 라이브러리입니다.

프로젝트에 최대 성능과 최소 클라이언트 크기가 필요한 경우 네이티브 WebSocket을 선택하세요. 안정적인 배달, 그룹화 및 이벤트 기반 모델이 필요한 경우 Socket.IO는 기성 추상화 덕분에 개발 시간을 2~3배 단축합니다.

State of JS 2024 설문 조사에 따르면 실시간 애플리케이션 개발자의 67%가 편리한 API와 에지 케이스(네트워크 연결 끊김, 재연결, 바이너리 데이터)의 내장 처리 때문에 Socket.IO를 선호합니다.

프로젝트에서 Socket.IO 연결 방법

Socket.IO 설치에는 서버 측과 클라이언트 측의 두 패키지가 필요합니다. Node.js 프로젝트의 기본 설정을 살펴보겠습니다. 서버는 HTTP 서버를 만들고 Socket.IO를 초기화하며 클라이언트 연결 및 연결 해제 이벤트를 처리합니다.

Socket.IO 문서(2024)에 따르면 서버는 내장 http 모듈을 사용하여 Express 없이 시작할 수 있지만 실제 프로젝트에서는 일반적으로 HTTP 요청 라우팅에 Express 또는 Fastify를 사용합니다.

Node.js 서버 측 코드

const express = require('express');
const http = require('http');
const Server = require('socket.io');

const app = express();
const server = http.createServer(app);
const io = new Server(server, {
    cors: { origin: '*' }
});

io.on('connection', (socket) => {
    console.log('클라이언트 연결됨:', socket.id);

    socket.emit('welcome', { message: 'Hello from server' });

    socket.on('disconnect', () => {
        console.log('클라이언트 연결 끊김');
    });
});

server.listen(3000, () => {
    console.log('서버가 포트 3000에서 실행 중');
});

브라우저 클라이언트 측 코드

import { io } from 'socket.io-client';

const socket = io('http://localhost:3000', {
    transports: ['websocket', 'polling'],
    reconnectionDelay: 1000
});

socket.on('welcome', (data) => {
    console.log(data.message);
});

socket.emit('chat message', {
    user: 'Alice',
    text: 'Hello everyone!'
});

Socket.IO의 이벤트 및 룸

Socket.IO 이벤트 모델은 명명된 이벤트를 기반으로 합니다. 서버와 클라이언트는 특정 이벤트 이름에 바인딩된 메시지를 보내고 받습니다. 페이로드는 문자열, JSON 객체 또는 바이너리 데이터(Buffer, ArrayBuffer, Blob)일 수 있습니다.

각 이벤트는 ACK(확인)를 지원합니다. 수신자가 이벤트를 처리한 후 발신자 측에서 실행되는 콜백 함수를 전달하는 것입니다. 이를 통해 이벤트 모델 위에 요청-응답 패턴을 구현할 수 있습니다. ACK는 수신자가 명시적으로 콜백을 호출하는 경우에만 작동합니다.

Socket.IO 문서(2024)에 따르면 최적의 성능을 위해 단일 메시지의 최대 크기는 1MB를 초과하지 않아야 합니다. 더 큰 메시지는 조각으로 분할하거나 별도의 채널을 통해 전송해야 합니다.

룸 작업

io.on('connection', (socket) => {
    socket.join('room-1');

    socket.to('room-1').emit('user joined', {
        userId: socket.id
    });

    io.to('room-1').emit('message', {
        text: 'Broadcast to room'
    });

    socket.leave('room-1');
});

Socket.IO 스케일링

수평 스케일링은 여러 서버 프로세스 간의 상태 공유 문제를 해결해야 합니다. 룸, 네임스페이스 및 연결된 소켓 목록은 단일 프로세스의 메모리에 저장되며 어댑터 없이는 다른 프로세스에서 볼 수 없습니다.

공식 Socket.IO 어댑터: redis(Redis Pub/Sub 통해), mongodb(MongoDB change streams 통해), cluster(Node.js 클러스터 멀티프로세스 모드용). 어댑터는 Socket.IO 인스턴스 간의 메시지 브로커 역할을 합니다. 이벤트가 룸으로 전송되면 어댑터가 이를 Redis에 게시하고 모든 서버가 알림을 받습니다.

Socket.IO 부하 테스트(2024)에 따르면 Redis 어댑터가 있는 4개 서버 클러스터는 10ms 미만의 지연 시간으로 최대 400,000개의 동시 연결을 처리합니다. 어댑터가 없으면 단일 Node.js 프로세스의 최대 용량은 1GB 메모리에서 약 100,000개의 연결입니다.

Redis 어댑터 구성

const Server = require('socket.io');
const RedisAdapter = require('@socket.io/redis-adapter');
const Redis = require('ioredis');

const pubClient = new Redis({ host: 'localhost', port: 6379 });
const subClient = pubClient.duplicate();
const io = new Server(server);
io.adapter(RedisAdapter(pubClient, subClient));

Kubernetes 또는 Docker Swarm을 사용할 때는 동일한 클라이언트의 요청이 동일한 서버로 전달되도록 세션 선호도(고정 세션)를 추가로 구성하는 것이 좋습니다. 그렇지 않으면 재연결할 때마다 할당이 변경될 수 있습니다.