Durable Streams
lastmod 2026-11-16created 2025-12-243 edits
Durable Streams는 Electric(ElectricSQL) 팀이 공개한, HTTP 위에서 순서가 보장되고 다시 읽을 수 있는 스트림을 클라이언트 앱에 전달하는 오픈 프로토콜이다. 각 스트림은 고유한 URL 을 가진 append-only 로그이고, 클라이언트는 오프셋을 지정해 원하는 위치부터 읽거나 실시간으로 이어 받는다. Electric 의 Postgres 동기화 엔진 안에서 전달 계층으로 쓰던 것을 2025년 12월 독립 프로토콜로 떼어 냈고, 지금은 AI 에이전트 세션의 데이터 기반으로 내세운다.
About
- Electric 에서 1.5년간 실시간 Postgres 동기화에 쓰며 하루 수백만 건의 상태 변경을 전달해 온 구현이 바탕. 현재 베타
- 스트림 하나가 URL 하나. 같은 링크를 여러 사람·기기·탭이 동시에 보고, 새로 고침이나 앱 백그라운드 전환 뒤에도 끊긴 위치부터 이어 받음
- 클라이언트 연결이 끊겨도 LLM 생성 같은 비싼 작업을 다시 돌리지 않아도 됨. AI 토큰 스트림용 Durable Proxy, 상태 동기화용 Durable State, 스트림 안의 DB·파일 시스템(StreamDB, StreamFS)도 제공
- 클라이언트 라이브러리는 TypeScript, Python, Go, Elixir, .NET, Swift, PHP, Java, Rust, Ruby. TanStack AI, Vercel AI SDK, AnyCable 과 연동
- MIT 라이선스
프로토콜 특징
- 표준 HTTP 만 쓰므로 브라우저·모바일·IoT·엣지 워커 어디서나 동작. content-type 을 가리지 않는 바이트 스트림이고 JSON 메시지 모드가 있음
- 단조 증가하는 불투명 오프셋으로 아무 지점부터 읽고, long-poll·SSE 모드로 지난 구간 따라잡기와 실시간 tailing 을 한 방식으로 처리
성능 특성
- 지난 구간 요청이 오프셋 URL 이라 CDN·브라우저 캐시를 그대로 탐. Electric 에서는 Postgres 부터 클라이언트까지 15ms 미만이고, 한 스트림에 동시 클라이언트 수백만을 붙여도 성능이 떨어지지 않았다고 밝힘
백엔드 스트리밍 시스템과의 관계
- Kafka·RabbitMQ 같은 서버 간 메시징을 대체하지 않고 보완함. 백엔드(Kafka·DB·큐) → 애플리케이션 서버(인증·변환) → Durable Streams → 클라이언트 구성을 권장
SSE·WebSocket과의 차이점
- WebSocket·SSE 는 탭 정지, 네트워크 전환, 새로 고침 때 전송 중 데이터를 잃거나 저장·재개 로직을 따로 만들어야 함. Durable Streams 는 영속 로그라 재개와 기록 재생을 프로토콜이 맡음
구현 유연성
- 코드 하나가 아니라 여러 구현을 가진 명세가 목표. Node.js 참조 서버(개발·테스트용), 운영용 Caddy 플러그인, CLI, 서버·클라이언트 적합성 테스트와 벤치마크를 제공
주요 활용 사례
- LLM 토큰 스트리밍과 에이전트의 도구 출력·진행 이벤트, DB 변경 동기화, CRDT 협업 편집, 이벤트 소싱, 워크플로 상태 기록