글을 삭제하시겠습니까?

삭제한 글은 복구할 수 없습니다.

글로벌 타운 스퀘어를 처음부터 다시 만들기

작성일:2026.11.06|수정일:2026.11.14|조회수:8

글로벌 타운 스퀘어를 처음부터 다시 만들기

이 포스트는 X의 Principal Engineer Yagiz Nizipli가 X Engineering 블로그에 올린 Rebuilding the global town square from scratch 게시글을 번역한 것이다. 번역하는 과정에서 다소 의역이 있을 수 있으며, 일부 번역에는 사견이 포함되어있기도 하다.

느린 연결에서 X.com의 프로필을 열어 보자. 이전 웹 앱에서는 첫 게시물이 나타날 때까지 22초 넘게 X 로고를 바라봐야 했다. 새 웹 앱에서는 2.7초 만에 나타난다.

새 웹 앱은 사용자, 검색 크롤러, 링크 미리보기를 위해 운영하던 서버 세 대를 하나로 대체한다. 이미 로그아웃 상태의 X.com과 검색 엔진이 크롤링하는 페이지를 제공하고 있다. 다음은 로그인 상태의 X.com이다. lite.x.com에서 직원과 테스터를 대상으로 테스트했고, 이제 국가별로 로그인 사용자를 천천히 이전하고 있다.

Similarweb에 따르면 X.com은 세계에서 여섯 번째로 방문자가 많은 웹사이트다. 엔지니어 다섯 명이 AI 코딩 에이전트와 함께 6개월도 되지 않아 새 웹 앱의 첫 버전을 만들었다. 로그인 페이지 이전이 진행되면서 팀도 커졌고, 9월 말 이후 20명이 넘는 사람이 이 앱에 커밋했다.

X.com을 다시 만든 이유, 국가별 출시 방식, 현재 이전 앱과 새 앱의 차이를 차례로 다룬다. 로그아웃 트래픽을 이전한 뒤 진행한 성능 개선 작업도 함께 설명한다.

간단한 배경 이야기

x.com을 다시 만든 것은 이번이 처음이 아니다. 2017년에는 느린 연결을 사용하는 사람들을 위해 mobile.twitter.com에서 동작하는 프로그레시브 웹 앱 Twitter Lite를 출시했다(이 절에서 대문자로 표기한 용어의 정의는 해당 글에 있다). 작은 Node.js 서버가 HTML 애플리케이션 셸을 렌더링하고, 클라이언트 측에서 동작하는 React 애플리케이션이었다. 셸이 로드되면 브라우저가 API에서 직접 데이터를 가져왔다. 이 세부 사항을 기억해 두자. 뒤에서 살펴볼 느린 연결 문제의 뿌리가 여기에 있기 때문이다. 2019년에는 같은 코드베이스가 모든 기기를 위한 "하나의 코드베이스, 하나의 웹사이트"를 중심으로 만든 데스크톱용 새 Twitter.com이 되었다.

우리가 rweb(responsive web의 줄임말)이라고 부르는 이 앱은 지난 10년 대부분의 기간 동안 x.com을 제공했다. 세월이 흐르면서 각기 다른 목적을 가진 서버를 그 옆에 더했다.

각 서버는 자기 일을 잘했다. 문제는 서버가 세 대였다는 점이다. x.com의 페이지 하나가 서로 다른 세 가지 방식으로 만들어질 수 있었다.

서버 세 대를 하나로

재구축 전과 현재, 방문자 유형별로 어느 서버가 응답하는지 보여준다.

문제

x.com의 URL 하나에는 서로 매우 다른 세 종류의 방문자가 찾아온다. x.com/elonmusk를 예로 들어 보자.

휴대전화나 노트북을 사용하는 사람은 프로필과 최신 게시물을 최대한 빨리 본 다음, 스크롤하거나 가입하고 싶어 한다.

Googlebot이나 Bingbot 같은 검색 크롤러는 완전한 HTML을 원한다. 게시물, 게시물을 설명하는 구조화 데이터, 페이지의 모든 언어 버전으로 연결되는 링크, 계정이 없을 때의 올바른 상태 코드가 필요하다.

iMessage, Slack, Discord 등의 링크 미리보기를 만드는 봇은 페이지의 제목, 설명, 이미지를 원한다. 페이지의 나머지는 모두 그 봇에게 불필요한 작업이다.

이 세 종류의 방문자 모두에게 콘텐츠를 제공하기 어려운 이유는 x.com의 데이터가 그래프 형태이기 때문이다. 게시물에는 작성자가 있고, 작성자에게는 프로필이 있으며, 게시물이 다른 작성자와 미디어가 딸린 또 다른 게시물을 인용할 수도 있다. 브라우저는 데이터를 요청하는 코드를 다운로드해 실행한 뒤에야 이 그래프의 대부분을 발견한다. Twitter Lite의 애플리케이션 셸을 기억하는가? 바로 이 지점에서 문제가 된다. rweb에서 로그아웃 방문자의 브라우저는 셸을 다운로드하고, JavaScript를 다운로드하고, 이를 실행하고, GraphQL API에 데이터를 요청한 뒤에야 프로필을 렌더링했다. 연결이 빠르면 이 연쇄 과정을 거의 느끼지 못한다. 연결이 느리면 각 단계가 또 한 번의 왕복이 되고, 방문자는 그 시간 내내 스플래시 화면을 바라보게 된다.

첫 게시물이 나타나기 전까지의 작업

단계는 순서대로 표시했으며, 크기는 실제 비율과 무관하다.

rweb SSR과 Jetfuel SSR은 서버에서 HTML을 렌더링해 이 문제 중 크롤러와 관련된 절반을 해결했다. 다만 두 서버가 서로 별개로, 그리고 사람들이 사용하는 앱과도 별개로 문제를 해결했다는 함정이 있었다. 페이지의 메타 설명, 구조화 데이터, 404 동작을 수정하려면 세 코드베이스에 각각 변경을 반영해야 할 수도 있었다.

어떤 문제는 설계 문서에 나타나지 않는다. 시스템을 수년간 운영한 뒤에야 발견할 수 있다.

서버 세 대의 동작은 서로 어긋났다. SEO 수정 사항이 한 서버에는 반영되고 다른 서버에는 빠질 수 있었다. 세 서버를 일치시키는 일은 대부분 눈에 보이지 않지만 끊임없이 치러야 하는 비용이었다.

로그아웃 방문자는 가장 느린 경로를 거쳤다. 크롤러는 rweb SSR 또는 Jetfuel SSR에서 완성된 HTML을 받았다. 로그인하지 않은 사람은 rweb의 애플리케이션 셸을 받은 뒤 JavaScript가 페이지를 렌더링할 때까지 기다려야 했다. 봇이 더 나은 대우를 받은 셈이다.

스택은 고르지 않게 노후화되었다. rweb은 정규화된 Redux 스토어와 Relay를 함께 사용했고, React Native for Web을 통해 컴포넌트 스타일을 지정했으며, Flow로 타입을 검사하고, 모던 번들과 레거시 번들을 따로 배포했다. 각각은 도입 당시에는 합리적인 선택이었다. 하지만 이들이 합쳐지면서 일상적인 변경이 필요 이상으로 느려졌다. 우리는 이를 작은 상처가 수없이 쌓여 죽음에 이르는 것(death by a thousand cuts)이라고 부른다. 각각의 문제는 그 자체로는 작았지만, 합쳐지자 앱을 유지하기 어렵고 빠르게 지키기도 어렵게 만들었다.

결정

이 시점에서 선택지는 세 가지였다.

첫 번째는 rweb을 그 자리에서 계속 개선하는 것이었다. 수년 동안 많이 해 온 방식이고, 덕분에 사이트를 건전하게 유지할 수 있었다. 하지만 서버 세 대는 그대로 남는다. 로그아웃 방문자에게 서버 렌더링 HTML을 제공하려면 네 번째 렌더링 경로를 만들어야 했다. 네 번째 말이다.

두 번째는 한 단계 더 나아가 rweb의 아키텍처는 유지한 채 도구 체인을 교체하는 것이었다. Webpack과 Babel은 Vite로, Flow는 TypeScript로, Express 서버는 Fastify로 바꾸는 방식이다. 각각의 변경은 코드베이스에 있는 거의 모든 파일에 영향을 준다. 그렇게 끝까지 바꿔도 문제를 일으킨 아키텍처는 그대로 남는다.

세 번째는 하나의 서버에서 모든 방문자에게 콘텐츠를 제공하는 새 애플리케이션을 만들고, rweb이 나머지 트래픽을 계속 처리하는 동안 트래픽을 새 앱으로 점진적으로 옮기며, 그 과정에서 두 SSR 서버를 새 앱으로 통합하는 것이었다. 우리가 선택한 방법이다.

2019년에 우리는 "이런 대규모 마이그레이션은 위험하고 제안하기도 어렵다"고 썼다. 지금도 맞는 말이다. 이번 마이그레이션이 가능했던 이유는 점진적으로 진행하기 때문이다. 먼저 로그아웃 방문자를 옮기고, 그다음 로그인 사용자를 국가별로 이전하며, 모두가 이전할 때까지 기존 서버를 계속 운영한다.

이런 재구축에는 타당한 반론이 두 가지 있다.

"절대 처음부터 다시 만들지 말라." Joel Spolsky의 조언에는 그럴 만한 근거가 있다. 대규모 재구축은 기존 제품이 계속 발전하는 동안 정체되는 경우가 많다. 우리는 그동안에도 rweb을 계속 배포했고, 트래픽을 점진적으로 이전했으며, 기존 서버를 명세 삼아 새 앱을 테스트했다. 에이전트가 구현의 상당 부분을 맡으면서 재구축에 걸린 시간은 수개월에 그쳤고, 기존 제품이 앞서 나갈 시간도 거의 없었다.

"Webpack만 업그레이드하면 되지 않는가?" 빌드가 빨라지면 x.com을 만드는 사람들에게는 도움이 된다. 하지만 느린 연결을 쓰는 방문자에게 서버 렌더링 HTML을 제공하지는 못하고, 서버 세 대를 하나로 만들지도 못한다. 새 앱을 만들 가치가 있었던 문제는 이 두 가지였다.

유지한 것

재구축 이야기를 하다 보면 이전 코드가 실제보다 나빴던 것처럼 들리기 쉽다. 이전 스택에서 잘 동작했던 많은 부분이 새 앱에도 들어갔다.

rweb은 제품 모델을 올바르게 잡았다. 화면 크기, 입력 방식, 네트워크 상태에 적응하는 하나의 반응형 코드베이스는 여전히 우리가 웹을 만드는 방식이다. rweb은 x.com을 GraphQL과 Relay로 이전하기도 했고, 새 앱은 이를 직접 기반으로 삼는다.

rweb SSR은 x.com URL이 실제 환경에서 어떻게 망가지는지 알고 있었다. rweb SSR은 수년에 걸쳐 망가진 형태로 들어오는 URL을 다루는 규칙을 모았다. 끝에 문장 부호가 붙은 검색 쿼리, 쿼리에 붙어 버린 언어 매개변수, 채팅 앱이 여분의 문자로 감싼 인텐트 링크 등이었다.

Jetfuel SSR은 검색을 진지하게 다뤘다. Jetfuel SSR 페이지에는 상세한 구조화 데이터가 있었고, 각 페이지의 모든 언어 버전을 연결했으며, 존재하지 않는 콘텐츠에는 실제 404를 반환했다.

재구축은 무언가를 버릴 기회이고, 너무 많이 버리고 싶은 유혹도 생긴다. 우리는 다음을 유지했다.

새로운 스택

새 앱은 Vite, React, Fastify, Platformatic Watt, GraphQL과 함께 사용하는 Relay, 그리고 새 컴포넌트 라이브러리인 XDS로 만들었다. 우리가 만든 서버 패키지가 이들을 하나로 묶는다.

모든 방문자를 위한 하나의 서버

새 서버는 누가 요청했는지에 따라 각 요청을 어떻게 렌더링할지 결정한다.

사람은 스트리밍 HTML을 받는다. 서버는 페이지 셸이 준비되는 즉시 전송하고, 페이지의 각 부분은 데이터가 도착하는 대로 스트리밍한다. 서버가 받은 각 GraphQL 응답은 페이지에 한 번씩 담기므로, 브라우저는 API에 다시 요청하지 않고 이를 재사용할 수 있다.

검증된 검색 크롤러는 완전한 문서를 받는다. 검색 엔진의 요청이라면 서버는 페이지의 모든 부분이 렌더링될 때까지 기다렸다가, 구조화 데이터를 포함하고 모든 Suspense 경계가 제자리에서 해결된 전체 문서를 한 번에 보낸다. 이 판단은 엣지에서 크롤러의 IP 주소를 검증한 결과를 바탕으로 한다. 흔히 쓰는 방식인 User-Agent 헤더를 확인하지 않는 이유는 무엇일까? 두 가지 이유가 있다. 첫째, 그렇게 하면 실제 크롤러뿐 아니라 Lighthouse 같은 성능 도구의 응답도 버퍼링한다. 둘째, 누구나 헤더를 바꾸는 것만으로 더 비싼 경로를 요청할 수 있다. 검증된 IP 주소를 사용하면 Lighthouse 실행도 사람들이 받는 것과 같은 스트리밍 페이지를 측정한다.

크롤러용 문서는 절대 하이드레이션하지 않으므로 클라이언트 번들, 라우터 상태, JavaScript만이 교체할 플레이스홀더를 포함하지 않는다. 여기서는 크기가 생각보다 더 중요하다. Googlebot은 응답의 처음 2MB만 읽는데, 긴 스레드의 HTML은 그보다 커질 수 있다. 성능 절에서 이 문서를 다시 한도 아래로 줄인 방법을 살펴본다.

링크 미리보기 봇은 자신이 읽는 것만 받는다. Slack, iMessage, Discord, WhatsApp, Signal, Facebook, LinkedIn, Telegram, Snapchat 등 링크를 펼쳐 보여 주는 봇들이다. 이 봇을 위해 서버는 라우트의 데이터 로딩과 head 태그 처리를 실행하지만 페이지 본문은 렌더링하지 않는다. 로더 역시 본문에만 필요한 타임라인과 대화 요청은 건너뛴다. 응답에는 봇이 읽는 제목, 설명, 카드 이미지가 담긴다. 엣지에서 검증하지 않은 다른 모든 크롤러는 로그아웃 방문자와 정확히 같은 응답을 받는다. 검색 엔진이라고 주장하지만 검증되지 않은 IP 주소에서 온 요청도 여기에 포함된다.

카드 이미지는 Rust 서비스에서 만든다. 게시물 링크 미리보기의 이미지는 요청 시 그려지는 PNG다. 이전에는 Jetfuel이 JavaScript 서비스로 이 카드를 그렸다. 코어를 더 사용하려면 메모리를 공유하지 않는 인스턴스를 더 실행하는 방법밖에 없었고, 장애가 발생했을 때 응답에 약 2분이 걸린 적도 있었다. 그래서 Rust로 다시 만들었다. 새 서비스는 새 앱과 같은 모노레포에 있으며 게시물, 미디어 미리보기, 구독, 캐시태그(cashtag) 차트, Money 등 같은 라우트에 응답한다. 기록 후 재생하는 테스트 하네스가 모든 카드를 커밋된 기준 이미지와 비교하고, 두 번째 하네스는 새 카드와 이전 서비스의 카드를 픽셀 단위로 비교한다.

데이터와 내비게이션

모든 라우트는 필요한 데이터를 미리 선언한다. 요청이 들어오면 서버가 아직 렌더링 중인 동안 라우트 로더가 페이지에 필요한 GraphQL 요청을 시작한다. 서버가 받은 각 GraphQL 응답은 JSON 텍스트로 페이지에 한 번씩 담긴다. 브라우저는 빈 Relay 스토어에서 시작해 이 응답을 스토어에 재생하므로, 서버가 이미 가져온 데이터를 컴포넌트가 요청하면 네트워크 요청 없이 서버의 응답을 받는다. 브라우저는 스트림이 끝난 뒤 30초 동안 아직 아무도 읽지 않은 응답을 보관하므로, 곧이어 연 탭이나 다이얼로그에서도 그 응답을 찾을 수 있다.

클라이언트 측 내비게이션도 같은 방식으로 동작한다. 누군가 링크 위에 마우스를 올리거나 포커스해 방문 의도를 보이면 링크가 라우트의 코드와 데이터를 미리 로드한다. 타임라인의 게시물은 일반 링크가 아니므로, 마우스가 게시물 위로 이동해 100밀리초 동안 머물거나 게시물을 누르면 미리 로드한다. 정지해 있는 포인터 아래로 게시물이 스크롤되어 지나갈 때는 미리 로드하지 않는다. 9월 이후 21개의 라우트가 메인 쿼리를 라우트 로더에서 시작하도록 바뀌어, 마우스를 올려 미리 로드할 때 코드와 데이터도 함께 가져온다.

rweb에는 우리가 아직 따라잡는 중인 장점이 하나 있다. 클라이언트 측 캐시에 워낙 많은 데이터를 보관했기 때문에 화면 사이를 이동할 때 즉시 전환되는 것처럼 느껴지는 경우가 많았다. 의도 기반 미리 로딩으로 이 격차를 줄이고 있다.

소규모 팀이 만든 방법

그렇다면 엔지니어 다섯 명도 안 되는 팀은 어떻게 6개월도 되지 않아 첫 버전을 만들었을까? 짧게 답하면 AI 코딩 에이전트다.

엔지니어는 아키텍처를 정하고, 무엇을 만들지 결정했으며, 모든 변경 사항을 검토했다. 에이전트는 구현의 상당 부분을 맡았다. 이전 서버의 동작을 옮기고, 페이지를 변환하고, 테스트를 작성하고, CI와 검토자가 지적한 문제를 수정했다. 이 방식은 에이전트가 만드는 결과를 신뢰할 수 있을 때만 가능하다. 세 가지가 그 신뢰를 만들었다.

공유 지침. 저장소 루트의 AGENTS.md 파일 하나가 모든 에이전트에게 코드 작성 방식을 알려 준다. 이름 있는 내보내기, 배럴 파일 금지, 신뢰 경계에서 외부 데이터 검증, 작성할 가치가 있는 테스트의 종류, 린트·타입 검사·관련 테스트를 통과하기 전에는 아무것도 커밋하지 않는다는 규칙이 담겨 있다. 모든 에이전트와 새 엔지니어는 같은 규칙에서 출발한다.

저장소 안의 스킬. 에이전트가 단계별로 따르는 반복 작업 절차를 코드 옆에 스킬로 두었으며, 그 수가 25개를 넘는다. 커밋 작성, 풀 리퀘스트 열기와 쌓기, 코드 검토, 풀 리퀘스트가 CI를 통과하도록 관리하기, 의존성 변경, 번역 추가, Relay와 라우터를 사용한 작업 등이 있다. 작업 절차가 바뀌면 해당 스킬을 한 번만 업데이트하면 되고, 모든 에이전트가 이를 적용한다.

모든 커밋에 적용되는 가드레일. 우리 규칙을 린트 규칙으로 만들었다. 커스텀 oxlint 플러그인이 Relay 사용, Tailwind 클래스, 테스트, 번역을 검사한다. 그렇다. "anti-slop" 플러그인도 있다. 연쇄 타입 단언, unknown으로 타입을 지정한 매개변수, 빈 객체를 조건부로 펼치는 코드처럼 에이전트가 자주 만드는 패턴을 거부한다. pre-commit 훅은 모든 변경 사항이 반영되기 전에 포맷팅, 린트, 타입 검사를 실행하고, pre-push 훅은 해당 패키지를 가져오는 패키지들을 린트한다.

마이그레이션 자체도 에이전트에 잘 맞았다. rweb SSR과 Jetfuel SSR이라는 동작하는 명세가 있었기 때문이다. 에이전트는 이전 서버가 URL이나 페이지 유형을 처리하는 방식을 읽고, 그 동작을 옮기고, 동작을 고정하는 테스트를 작성할 수 있었다. 검토자는 그 결과를 원본과 대조할 수 있었다.

엔지니어의 업무는 달라졌다. 코드를 작성하는 시간은 줄고, 시스템이 무엇을 해야 하는지 결정한 뒤 실제 브라우저에서 정말 그렇게 동작하는지 확인하는 시간은 늘었다.

트래픽 이전

검색 크롤러부터

검색 엔진은 모든 것을 알아차리므로 크롤러 트래픽을 이전하는 일은 어떤 웹 마이그레이션에서든 가장 위험하다. 구조화 데이터 필드 하나가 빠진 것, canonical URL이 바뀐 것, 이전에는 리디렉션이던 요청이 404를 반환하는 것까지 알아챈다.

우리는 두 SSR 서버 모두를 명세로 다뤘다. 각 페이지 유형에 대해 Jetfuel SSR 또는 rweb SSR이 반환하는 결과를 새 앱의 결과와 비교하고, 구조화 데이터 주석, 메타 설명, 언어 대체 링크, 404 페이지, 리디렉션, URL 정리의 차이를 하나씩 없앴다. 이런 동작 중 많은 부분이 이제 출처가 된 서버의 이름을 명시한 테스트와 함께 공유 컴포넌트에 들어 있다.

작은 동등성 스크립트로 이 비교를 반복할 수 있게 했다. 검증된 Googlebot으로서 두 서버에 같은 경로를 요청하고 검색 엔진이 읽는 내용을 비교한다. 상태 코드와 리디렉션, 제목, 설명, canonical URL, robots 태그, Open Graph 및 X 카드 태그, 언어 대체 링크 수, 구조화 데이터 유형을 비교한다.

크롤러 트래픽은 새 앱으로 점진적으로 이전했다.

그다음은 사용자, 국가별로

로그인 상태의 x.com을 국가별로 이전하고 있다. 모든 요청에 대해 엣지가 경로와 요청자를 기준으로 어느 서버가 응답할지 결정한다. 덕분에 한 사용자 집단을 새 앱으로 옮겼다가 문제가 생기면 다시 돌려보낼 수 있다.

경로 정보는 앱 자체에서 나온다. 앱 옆의 설정 파일(ngroutes)이 앱의 파일 기반 라우트 트리에서 라우트를 찾아내고, 배포할 때마다 엣지에 게시한다. 새 앱에 없는 경로는 rweb으로 간다.

누가 새 앱을 받을지는 기능 스위치가 결정한다. 앱을 배포하지 않고도 포함 대상을 바꿀 수 있으며, 대상에서 제외한 사용자는 즉시 rweb으로 돌아간다.

로그아웃 페이지를 먼저 이전했다. 작업이 진행되는 동안 새 앱은 lite.x.com에서도 사용할 수 있었고, 이를 통해 x.com과 나란히 비교할 수 있었다. 현재 새 앱은 로그아웃 상태의 x.com을 제공하고 있으며, 로그인 상태의 x.com도 출시 중이다. 로그인 페이지는 먼저 lite.x.com에서 다시 만들고 테스트하며, 직원과 테스터가 그곳에서 로그인 앱을 사용한다. 최근 사례로는 NFL, MLB, 대학 미식축구 허브가 있다. 첫 번째 국가에서는 로그인 사용자를 대상으로 실험을 진행한다. 일부는 새 앱을 받고 나머지는 rweb에 남겨, 실제 트래픽에서 두 앱을 비교한다.

일부 기능은 한 번만 만든 뒤 마이그레이션 양쪽에서 공유한다. 가장 분명한 사례는 X Chat이다. rweb과 새 앱 모두 Module Federation을 통해 chat.x.com에서 런타임에 X Chat을 로드하므로, 양쪽 모두 chat.x.com이 배포한 채팅을 실행한다. 새 앱은 X Calls와 Money도 같은 방식으로 로드한다. 또한 페이지가 사용하는 React와 기타 공유 라이브러리를 Money에 제공해, 첫 Money 페이지에서 다운로드하는 코드를 gzip 압축 기준 590KB에서 509KB로 줄였다. 공유 기능 패키지에는 분석 기능과 Grok Imagine처럼 두 앱이 모두 가져오는 코드가 여전히 들어 있다.

결과

차이를 확인하는 가장 쉬운 방법은 두 앱이 나란히 로드되는 모습을 보는 것이다.

2026년 11월 3일, 양쪽에서 같은 계정으로 로그인한 상태로 이를 녹화했다. x.com에서는 rweb을, lite.x.com에서는 새 앱을 사용했다. 네트워크는 Lighthouse의 기본 Slow 4G 프로필인 왕복 150ms, 다운로드 1.6Mbps, 업로드 750Kbps로 제한했다. CPU 속도는 낮추지 않았고, 캐시는 비웠으며, 서비스 워커는 껐다. 각 앱을 따로 세 번씩 녹화한 뒤 앱별 중앙값 실행 결과를 사용했다. 양쪽 아래의 타이머는 브라우저 자체 타이밍 API의 값이다.

같은 계정으로 로그인한 rweb과 새 앱의 나란히 로딩한 녹화 화면이다.

스플래시 화면만 22초 넘게 보이는 셈이다. 이는 실험실 녹화이므로 격차를 보여 주는 사례로 봐야 한다. 실제 기기와 네트워크에서는 달라질 수 있다. 하지만 차이가 나는 양상은 아키텍처에서 직접 비롯된다. 새 앱은 첫 응답에 콘텐츠를 보내지만, rweb은 데이터를 요청하기도 전에 JavaScript를 다운로드하고 실행해야 한다.

다른 결과는 구조적이다. 이전에 서버 세 대에서 실행되던 x.com의 로그아웃 웹이 이제 서버 하나에서 실행된다. 과거 rweb SSR과 Jetfuel SSR이 처리하던 크롤러 트래픽은 새 앱이 제공한다. 이제 SEO 수정은 한 번만 반영하면 된다. 트래픽을 이전하면서 데이터 센터당 rweb 로그아웃 인스턴스 수를 1,400개에서 700개로 절반 줄였고, rweb SSR도 종료 전에 2,400개에서 1,200개로 절반 줄였다.

빠르게 만들기

2.7초라는 결과를 공짜로 얻은 것은 아니다. 그림 2의 6월 녹화는 새 앱의 출발점을 보여 준다. 당시에도 느린 연결에서 rweb보다 약 6배 빨랐지만, 고칠 부분이 많이 남아 있었다. 그 뒤로 성능 개선이 작업에서 큰 비중을 차지했다. 9월 1일 이후 perf 레이블이 붙은 커밋 80개 이상이 앱을 변경했다. 서버와 브라우저에서 가장 큰 효과를 낸 변경 사항은 다음과 같다. 아래의 모든 수치는 해당 변경을 만든 풀 리퀘스트에서 가져왔다. 단, 스타일시트 변경은 이 글을 위해 다시 측정했다. 각 항목에는 측정 환경도 명시했다. 실험실의 프로덕션 빌드, 개발 서버, 또는 변경 전 프로덕션 플릿 가운데 하나다.

서버에서

렌더링 워커 확장. 로그아웃 렌더링은 워커의 이벤트 루프 때문에 제한을 받았다. 10월 프로덕션 플릿에서 측정했을 때 각 워커의 이벤트 루프는 중앙값 기준 약 67%, p95 기준 84%의 시간 동안 바빴다. 사용량이 가장 많을 때 가장 긴 정지는 중앙값 기준 약 1.9초, p95 기준 3.7초였다. 교묘한 부분은 이벤트 루프가 멈추면 이미 도착한 응답을 처리하기 전에 타이머를 실행할 수 있다는 것이다. 그 결과 한 업스트림 요청에 설정한 1초 타임아웃이 로그아웃 렌더링의 1~9%에서 발생했다. 뒤의 서비스가 약 25ms 만에 응답했는데도 그랬다. 각 워커는 하나의 스레드에서 렌더링하므로, 같은 트래픽을 더 많은 워커로 분산해 각 이벤트 루프가 맡는 비중을 줄였다.

게스트 토큰을 기다리지 않기. 로그아웃 렌더링에는 게스트 토큰과 방문자의 기능 플래그가 필요하다. 이전에는 게스트 토큰 요청이 반환된 뒤에야 기능 플래그를 요청했다. 기능 스위치 요청은 토큰을 사용하지 않는데도 그랬다. 이제 두 요청을 동시에 시작한다. 로그아웃 렌더링에서 직렬 왕복 한 번이 사라졌고, 게스트 토큰 요청이 느리거나 사용량 제한에 걸려도 기능 플래그가 지연되지 않는다.

스토어 레코드 대신 페이지에 GraphQL 응답 담기. 이전에는 서버의 Relay 스토어를 페이지에 직렬화한 뒤, 스토어의 모든 업데이트를 스트리밍했다. 정규화된 레코드는 원본 GraphQL 응답보다 네다섯 배 컸다. 이제 페이지에는 각 응답을 JSON 텍스트로 한 번만 담고, 브라우저가 응답을 자체 스토어에 재생할 때 JSON.parse로 파싱한다.

크롤러 문서를 Google의 2MB 한도 아래로 줄이기. Googlebot의 2MB 한도를 기억하는가? 긴 스레드의 HTML은 2.2~3.5MB까지 커져 Google은 잘린 지점 뒤의 답글을 잃었고, 구조화 데이터는 Google이 보지 못한 게시물을 가리켰다. 세 가지 변경으로 이 문서를 줄였다. 모두 로컬 렌더링에서 요청을 검증된 크롤러로 표시한 뒤 측정했다.

브라우저에서

셸을 즉시 하이드레이션하기. 이전의 엔트리 스크립트는 브라우저가 문서 전체를 파싱한 뒤에야 실행하는 지연 모듈이었다. 스트리밍 문서는 마지막 Suspense 경계가 도착해야 파싱이 끝나므로, 하이드레이션은 페이지에서 가장 느린 부분을 기다렸다. 이제 엔트리는 비동기 모듈이다. 로드되는 즉시 실행되고, React가 셸을 하이드레이션하며, 각 경계는 해당 HTML이 도착할 때 하이드레이션된다. 대화 쿼리에 5초의 서버 측 지연을 준 테스트에서 React는 589ms에 페이지에 연결되었다. 문서 파싱이 6,017ms에 끝나기 훨씬 전이었다.

시작 시 파일 수 줄이기. 엔트리의 정적 import 그래프에 있는 모든 파일이 도착해야 페이지를 하이드레이션할 수 있다. Rolldown의 기본 청크 분할을 사용했을 때 로그인 엔트리는 754개, 로그아웃 엔트리는 582개 파일이 필요했고, 로그인 시작 파일 대부분에는 모듈이 하나씩만 들어 있었다. Chrome은 하나의 HTTP/2 연결에서 한 번에 최대 약 100개의 요청을 실행하고, 자산 CDN은 100개의 동시 스트림을 허용한다. 따라서 브라우저가 모든 파일을 한꺼번에 요청해도 약 여덟 번의 왕복이 필요했다. 이제 빌드 플러그인이 모든 엔트리가 시작 시 로드하는 모듈을 세 개의 청크로 묶는다. 의존성, 자체 코드, 그리고 지연 로드 청크의 이름을 담은 코드다. 마지막 청크의 파일 이름은 배포할 때마다 거의 항상 바뀐다. 로그인 엔트리의 시작 파일은 754개에서 182개로, 로그아웃 엔트리는 582개에서 단 10개로 줄었다. 각 페이지는 이전과 정확히 같은 모듈을 로드한다. x.com 사용자의 왕복 시간 p90 정도인 275ms를 모든 JavaScript 응답에 추가한 실험실 테스트에서, 로그인 홈 타임라인은 6.63초 대신 4.95초에 나타났다.

스타일시트 먼저 받기. 느린 연결에서는 진행 중인 모든 다운로드가 렌더링을 차단하는 스타일시트와 대역폭을 나눠 쓴다. 이전에는 페이지의 JavaScript도 동시에 다운로드를 시작했으므로, 첫 렌더링이 페이지에 아직 필요하지 않은 코드를 기다렸다. 이제 작은 인라인 스크립트가 스타일시트 로드를 마친 뒤 엔트리 스크립트와 서버가 렌더링한 청크의 preload를 추가한다. 느린 프로필(CPU 4배 감속, 왕복 150ms, 1.6Mbps)의 실험실 실행에서 로그아웃 프로필의 최초 콘텐츠풀 페인트는 3,064ms에서 1,984ms로 줄었다. 로그아웃 게시물은 7,216ms에서 1,804ms로 줄었다. 비용도 있다. 스크립트가 더 늦게 시작하고, 느린 페이지 다섯 개 중 두 개에서는 하이드레이션 완료가 각각 0.3%, 0.6% 조금 늦어졌다.

느린 프로필에서의 최초 콘텐츠풀 페인트

JavaScript가 스타일시트를 기다리도록 바꾸기 전과 후의 실험실 중앙값이다. 낮을수록 좋다.

바이트 줄이기. 여러 변경으로 페이지가 다운로드하는 양을 줄였다.

측정 방법. 앱에 영향을 줄 수 있는 풀 리퀘스트에는 Lighthouse CI를 실행한다. @jack의 프로필과 그의 첫 게시물을 데스크톱 및 모바일 설정으로 측정한다. 위 변경 사항을 적용한 풀 리퀘스트는 프로덕션 빌드에서 측정했으며, 지연 시간을 추가하는 HTTP/2 프록시 뒤에서 측정한 경우가 많았다. 개선점과 함께 회귀도 보고했다. 스타일시트 변경은 이 글을 위해 같은 방법으로 다시 측정했다. 페이지마다 실행 쌍 11개를 번갈아 측정했고, 95% 부트스트랩 구간이 0을 제외할 때만 변화가 있다고 표시했다. 실제 환경에서 앱은 Core Web Vitals(LCP, INP, CLS)와 FCP, TTFB를 클라이언트 성능 파이프라인인 perftown에 보고하며, rweb과 같은 제품 네임스페이스를 사용한다.

현재 두 앱의 비교

이 글을 위해 2026년 11월 3일 두 앱을 벤치마크하기도 했다. 로그인 상태에서는 두 앱을 직접 비교할 수 있었다. 로그인 상태의 x.com은 대부분 여전히 rweb이 제공하고, lite.x.com은 새 앱의 로그인 버전을 제공하기 때문이다. 로그아웃 상태의 x.com은 이미 새 앱에서 실행되므로, 이 경우에는 새 앱만 측정했다.

모든 로드는 캐시가 비어 있고 서비스 워커가 꺼진 새로운 헤드리스 Chromium에서 시작했다. 따라서 어느 앱도 웜 캐시나 서비스 워커의 도움을 받지 않았다. 앱과 설정별로 각 페이지를 일곱 번 로드하면서 두 앱을 번갈아 실행했다. 설정은 두 가지였다. 하나는 제한 없음이고, 다른 하나는 지연 시간 150ms 추가, 다운로드 1.6Mbps, 업로드 750Kbps, CPU 4배 감속을 적용한 느린 프로필이었다. 주요 메트릭은 첫 게시물이 화면에 나타나는 시점인 첫 게시물까지의 시간이다. 최초 콘텐츠풀 페인트만 보면 rweb에 유리하다. rweb의 첫 렌더링은 스플래시 화면이기 때문이다.

로그인 상태에서 첫 게시물까지 걸린 시간

첫 게시물이 화면에 나타날 때까지 걸린 시간의 중앙값이다. 낮을수록 좋다.

로그인 상태의 느린 연결에서 프로필과 게시물이 8~13배 빨리 나타난다. 느린 프로필에서 rweb은 시험한 모든 페이지의 첫 게시물을 약 22~25초 뒤에 보여 주었다. 새 앱은 @SpaceX 게시물을 1.7초, @SpaceX 프로필을 3.0초에 보여 주어 각각 12.8배와 8.2배 빨랐다. 제한이 없을 때 새 앱은 게시물에서 3.2배, 프로필에서 2.3배 빨랐다.

홈의 개선 폭이 가장 작다. 새 앱은 로그인 상태의 홈 타임라인을 브라우저에서만 렌더링하므로, 두 앱 모두 홈에서는 JavaScript를 기다린다. 느린 프로필에서 새 앱은 홈의 첫 게시물을 14.1초에 보여 주었고, rweb은 24.6초가 걸려 1.7배 빨랐다. 제한이 없을 때는 1.8초 대 2.2초로 1.2배 빨랐다. 홈은 새 앱이 가장 많이 개선해야 할 곳이다.

서버가 응답 전에 더 많은 작업을 한다. 로그인 상태에서 새 앱은 프로필과 게시물의 첫 바이트가 중앙값 430~560ms에 도착했고, rweb은 300ms 미만이었다. 서버가 응답하기 전에 데이터를 가져와 페이지를 렌더링하기 때문이다. rweb은 빈 셸로 더 빨리 응답한 뒤 브라우저에서 모든 것을 요청한다.

첫 게시물 전에 다운로드한 JavaScript

첫 게시물이 나타나기 전에 다운로드가 끝난 스크립트의 압축된 바이트 수다.

대부분의 페이지는 JavaScript가 도착하기 전에 게시물을 보여 준다. 느린 프로필에서 rweb은 모든 페이지에서 첫 게시물을 보여 주기 전에 압축된 JavaScript 3.0MB에서 3.6MB를 다운로드했다. 새 앱은 게시물이 이미 HTML에 들어 있으므로 프로필이나 게시물을 보여 주기 전에 아무것도 다운로드하지 않았다. 홈에서는 먼저 1.9MB를 다운로드했다. 전체 페이지 로드에서 새 앱은 로그인 페이지마다 압축된 JavaScript 1.3MB에서 2.3MB를 다운로드했고, rweb은 4.1MB에서 4.8MB를 다운로드했다.

로그아웃 상태에서 첫 게시물까지 걸린 시간

x.com의 새 앱에서 첫 게시물이 화면에 나타날 때까지 걸린 시간의 중앙값이다.

로그아웃 상태의 x.com은 느린 프로필에서 약 2초 만에 게시물을 보여 준다. 느린 프로필에서 로그아웃 상태의 새 앱은 @SpaceX 게시물의 첫 게시물을 1.7초, @SpaceX 프로필의 첫 게시물을 2.2초에 보여 주었다. 제한이 없을 때는 각각 442ms와 792ms가 걸렸다. 6월 녹화와 같은 네트워크 제한을 적용하고 CPU는 감속하지 않았을 때, @SpaceX 프로필은 중앙값 2.1초에 첫 게시물을 보여 주었다. 6월 녹화(그림 2)에서는 로그아웃 프로필의 첫 게시물이 새 앱에서 약 3초, rweb에서 약 18초에 나타났다. 화면 녹화와 브라우저 타이밍 API가 정확히 같은 순간을 표시하지는 않으므로 대략적인 비교로 봐야 한다.

이는 한 대의 노트북에서 얻은 실험실 수치이며, 실제 기기와 네트워크에서는 달라질 수 있다. 로그인 상태에서는 두 앱에 같은 계정을 사용했다.

배운 점

돌이켜 보면 세 가지 교훈이 두드러진다.

이전 서버는 우리가 가진 최고의 명세였다. rweb SSR과 Jetfuel SSR이 수년에 걸쳐 축적한 동작의 상당 부분이 새 앱의 테스트가 되었고, 동등성 스크립트로 결과를 원본과 비교했다. 이 점 때문에 에이전트에도 아주 잘 맞는 작업이었다.

점진적인 이전이 재구축을 안전하게 만들었다. 크롤러와 로그아웃 페이지를 먼저 옮겼고, rweb이 나머지 모든 사용자에게 콘텐츠를 제공하는 동안 로그인 사용자를 국가별로 이전하고 있다. 이전한 어떤 집단이든 즉시 되돌릴 수 있다.

실험실 수치 옆에는 실제 환경 수치가 필요하다. 이 글에 나온 수치 대부분은 실험실에서 얻었다. 실제 기기와 네트워크는 언제나 달라지므로 앱은 실제 방문에서 얻은 Core Web Vitals도 보고한다.

다음 단계

현재 로그인 상태의 x.com을 국가별로 출시하고 있다. 로그아웃 페이지를 제공하는 것과 같은 엣지 라우트 및 기능 스위치를 사용한다. 출시가 끝나면 지난 10년 대부분의 기간 동안 x.com을 제공한 rweb을 폐기한다. X에서는 지난 1년 동안 재구축 작업이 이어졌다. 7월에는 Android 앱도 처음부터 다시 만들었다.

Twitter Lite는 느리거나 불안정하거나 비용이 많이 드는 연결에서 Twitter를 사용하는 최고의 방법이 되겠다는 목표로 2017년에 시작했다. 9년이 지난 지금도 목표는 같다. 새 x.com은 사용자, 검색 엔진, 링크 미리보기라는 세 종류의 방문자 모두에게 그 목표를 이어 간다.

감사의 말

다음 사람들이 없었다면 이 작업은 불가능했을 것이다. Alex Abraham, Jonas Badalic, Robert Balicki, Louis Barthonet, Vinayak Bector, Tom Blacknell, Lachlan Geoffrey Bradford, Nicolas Duc-Dodon, Benjamin Erichsen, Klara Jemelik, Ray Li, Yagiz Nizipli, Saurin Patel, Darshan Raju, Jainam Chirag Shah, Mridul Singhai, Hugo Striedinger, Benji Taylor, Zachary Warunek. 감사드린다.

댓글

댓글을 삭제하시겠습니까?

삭제한 댓글의 내용은 복구할 수 없습니다.

댓글을 불러오는 중...