정적 사이트와 동적 사이트, 그리고 CDN

미리 만들어 둔 파일을 나눠 주기만 하는 정적 사이트와 요청마다 내용을 만드는 동적 사이트를 비교해요. 방문 1,000번에 몇 번 그리는지 세어 보고, 각각이 잘 맞는 곳과 둘을 섞는 방법을 정리해요. 전 세계 사용자 가까이에 사본을 두는 CDN이 기다리는 시간과 원본 서버의 일을 얼마나 줄이는지 계산하고, CDN 설정 하나를 잘못해서 다른 사람의 장바구니가 보이는 사고와 그 예방법, 파일 이름에 지문을 넣어 캐시 문제를 없애는 요령까지 다뤄요.

초급강의 2 / 6약 12분

앞 강의에서 요청마다 데이터베이스를 읽어 응답을 만드는 서버를 만들었어요. 그런데 모든 웹사이트에 그런 서버가 필요할까요? 블로그 글은 쓴 다음에는 거의 바뀌지 않고, 누가 읽든 내용이 같아요. 요청이 올 때마다 똑같은 페이지를 새로 만드는 건 낭비예요. 이번 강의에서는 정적 사이트와 동적 사이트의 차이를 보고, 사이트를 전 세계에 빠르게 전하는 CDN을 알아봐요.

미리 그려 두기와 그때그때 그리기

  • 정적 사이트: 배포할 때 페이지를 모두 HTML 파일로 만들어 두고, 서버는 요청이 오면 파일을 그대로 보내요. 서버가 생각할 일이 없어요.
  • 동적 사이트: 요청이 올 때마다 서버 프로그램이 데이터를 찾아 페이지를 새로 만들어요. 사람마다, 때마다 다른 내용을 보여 줄 수 있어요.

글 세 편짜리 사이트로 두 방식이 일하는 양을 세어 볼게요.

import html
import pathlib
import tempfile

posts = [
    {"slug": "keyboard", "title": "키보드 고르는 법", "body": "축과 배열을 먼저 정해요."},
    {"slug": "monitor", "title": "모니터 받침대 후기", "body": "목이 덜 아파졌어요."},
    {"slug": "hub", "title": "USB 허브 비교", "body": "전원 어댑터가 있는 쪽이 안정적이에요."},
]
renders = 0

def render(post):                                     # 글 하나를 HTML 페이지로 그려요
    global renders
    renders += 1
    return (f'<!DOCTYPE html><html lang="ko"><head><meta charset="utf-8">'
            f"<title>{html.escape(post['title'])}</title></head>"
            f"<body><h1>{html.escape(post['title'])}</h1><p>{html.escape(post['body'])}</p></body></html>")

site = pathlib.Path(tempfile.mkdtemp())               # 정적 사이트: 배포할 때 한 번 미리 그려 둬요
for post in posts:
    (site / f"{post['slug']}.html").write_text(render(post), encoding="utf-8")
print("만들어 둔 파일:", sorted(p.name for p in site.iterdir()), "| 그린 횟수:", renders)

for _ in range(1000):                                 # 방문 1,000번: 파일을 그대로 보내기만 해요
    (site / "keyboard.html").read_bytes()
print("정적 사이트, 방문 1,000번 뒤 그린 횟수:", renders)

renders = 0
def dynamic_page(slug):                               # 동적 사이트: 요청마다 데이터를 찾아 그려요
    post = next(p for p in posts if p["slug"] == slug)
    return render(post)
for _ in range(1000):
    dynamic_page("keyboard")
print("동적 사이트, 방문 1,000번 뒤 그린 횟수:", renders)
만들어 둔 파일: ['hub.html', 'keyboard.html', 'monitor.html'] | 그린 횟수: 3
정적 사이트, 방문 1,000번 뒤 그린 횟수: 3
동적 사이트, 방문 1,000번 뒤 그린 횟수: 1000

정적 사이트는 방문이 1,000번이든 100만 번이든 페이지를 그리는 건 배포할 때의 3번뿐이에요. 동적 사이트는 방문 수만큼 그려요. 실제로는 그릴 때마다 데이터베이스도 읽으니 차이가 더 커요. 이 차이가 곧 속도, 비용, 그리고 갑자기 사람이 몰렸을 때 버티는 힘의 차이예요.

이 가이드북도 정적 사이트예요. 강의를 마크다운으로 쓰고, 배포할 때 npm run build가 모든 강의를 HTML 파일로 만들어요. 그 파일들을 호스팅 서비스가 그대로 나눠 줘요. 프레임워크 강의에서 본 SSG가 바로 이 방식이에요.

무엇이 어디에 맞을까

구분정적 사이트동적 사이트
잘 맞는 곳블로그, 문서, 회사 소개, 포트폴리오, 행사 안내로그인, 장바구니, 검색 결과, 게시판, 관리자 화면
속도아주 빨라요. 파일만 보내요그릴 때마다 시간이 걸려요
비용무료 호스팅으로도 충분한 경우가 많아요서버와 데이터베이스를 계속 돌려야 해요
갑자기 몰리면파일 나눠 주기라 잘 버텨요서버가 버거워지면 느려지거나 멈춰요
보안공격받을 서버 코드가 거의 없어요코드, 데이터베이스, 로그인까지 지켜야 해요
내용을 바꾸려면다시 만들어 배포해요데이터만 바꾸면 바로 보여요

정적 사이트의 약점은 마지막 줄이에요. 글을 고칠 때마다 다시 빌드하고 배포해야 해요. 그리고 사람마다 다른 내용(로그인한 사람의 이름, 장바구니)은 미리 만들 수 없어요.

섞어서 쓰기

실제로는 둘을 섞는 경우가 많아요. 정적으로 만들 수 있는 건 최대한 정적으로, 꼭 필요한 부분만 동적으로 만드는 거예요.

  • 정적 페이지 + API: 페이지 뼈대는 정적 HTML로 보내고, 사람마다 다른 부분(로그인 상태, 장바구니 개수)만 웹 개발 트랙의 fetch로 API 서버에서 받아 채워요.
  • 외부 서비스 붙이기: 댓글, 검색, 문의 양식처럼 서버가 필요한 기능을 외부 서비스로 붙이면, 내 사이트는 정적으로 남을 수 있어요.
  • 미리 만들되 가끔 새로: 상품 목록처럼 하루 몇 번 바뀌는 페이지는 정해 둔 시간마다 다시 만들어요(ISR). 정적의 속도와 동적의 신선함을 절충해요.

CDN: 사용자 가까이에 사본을 두기

정적 파일이라도 서버가 지구 반대편에 있으면 느려요. 네트워크 트랙에서 본 것처럼 빛의 속도에도 한계가 있으니까요. CDN(Content Delivery Network)은 세계 곳곳에 서버(엣지)를 두고, 사용자와 가까운 엣지가 사본을 저장해 대신 답해요. 원본 서버는 미국에 있고, 세 도시에서 4번씩 방문하는 상황을 계산해 볼게요.

CITIES = {"서울": 150, "도쿄": 120, "프랑크푸르트": 100}   # 미국에 있는 원본 서버까지의 왕복(ms)
EDGE_RTT = 8                                            # 가까운 CDN 서버까지의 왕복(ms)
visits = [city for city in CITIES for _ in range(4)]    # 도시마다 4번씩 방문

no_cdn = [CITIES[city] for city in visits]

edge_cache, origin_hits, with_cdn = set(), 0, []
for city in visits:
    if city in edge_cache:                              # 그 도시의 CDN 서버에 이미 있어요
        with_cdn.append(EDGE_RTT)
    else:                                               # 처음이면 CDN 서버가 원본에서 가져와 저장해요
        origin_hits += 1
        with_cdn.append(EDGE_RTT + CITIES[city])
        edge_cache.add(city)

print(f"CDN 없이: 평균 {sum(no_cdn) / len(no_cdn):.0f}ms, 원본 서버가 받은 요청 {len(no_cdn)}번")
print(f"CDN으로: 평균 {sum(with_cdn) / len(with_cdn):.0f}ms, 원본 서버가 받은 요청 {origin_hits}번")
print("CDN에서 바로 답한 비율:", f"{(len(visits) - origin_hits) / len(visits):.0%}")
CDN 없이: 평균 123ms, 원본 서버가 받은 요청 12번
CDN으로: 평균 39ms, 원본 서버가 받은 요청 3번
CDN에서 바로 답한 비율: 75%
  • 도시마다 첫 방문은 엣지에 사본이 없어서(캐시 미스) 엣지가 원본에서 가져와요. 오히려 조금 더 걸려요.
  • 그다음부터는 엣지가 바로 답해요(캐시 히트). 평균 대기 시간이 3분의 1로 줄었어요.
  • 원본 서버가 받은 요청은 12번에서 3번으로 줄었어요. 방문이 많을수록 이 비율은 더 좋아져요. 인기 있는 사이트에서는 요청의 대부분을 CDN이 받아 내서, 원본 서버는 아주 작아도 돼요.

엣지가 사본을 얼마나 오래 들고 있을지는 HTTP 강의에서 본 Cache-Control 헤더로 정해요. max-age는 브라우저와 CDN 모두에, s-maxage는 CDN 같은 중간 저장소에만 적용돼요. 내용을 바꿨는데 엣지가 옛 사본을 들고 있으면, 배포할 때 사본을 지우라고 CDN에 요청해요(퍼지).

CDN 사고: 남의 장바구니가 보인다

CDN은 편하지만, 저장하면 안 되는 응답까지 저장하면 큰 사고가 나요. 사람마다 다른 장바구니 페이지를 원본 서버가 실수로 public이라고 답했다고 해 볼게요.

def origin_server(path, user, cache_control):
    return {"body": f"{user}님의 장바구니: 상품 3개", "cache_control": cache_control}

def make_cdn():
    store = {}
    def cdn(path, user, cache_control):
        if path in store:
            return store[path] + "   (CDN에 저장된 응답)"
        res = origin_server(path, user, cache_control)
        if not any(word in res["cache_control"] for word in ("private", "no-store")):
            store[path] = res["body"]                   # 주소만 보고 저장해요
        return res["body"]
    return cdn

cdn = make_cdn()
print("[public으로 응답할 때]")
print("민지:", cdn("/cart", "민지", "public, max-age=60"))
print("준호:", cdn("/cart", "준호", "public, max-age=60"))

cdn = make_cdn()
print("[private, no-store로 응답할 때]")
print("민지:", cdn("/cart", "민지", "private, no-store"))
print("준호:", cdn("/cart", "준호", "private, no-store"))
[public으로 응답할 때]
민지: 민지님의 장바구니: 상품 3개
준호: 민지님의 장바구니: 상품 3개   (CDN에 저장된 응답)
[private, no-store로 응답할 때]
민지: 민지님의 장바구니: 상품 3개
준호: 준호님의 장바구니: 상품 3개

준호의 화면에 민지의 장바구니가 나왔어요. CDN은 주소(/cart)만 보고 사본을 저장했으니, 같은 주소를 요청한 다음 사람에게 앞사람의 응답을 준 거예요. 장바구니가 아니라 이름, 주소, 주문 내역이었다면 개인정보 유출 사고예요. 실제로 이런 사고가 여러 번 일어났어요.

  • 사람마다 다른 응답에는 반드시 Cache-Control: private(브라우저만 저장 가능), 민감하면 no-store(아무도 저장 금지)를 붙여요.
  • CDN 설정에서 로그인한 사람의 응답, 쿠키가 붙은 요청은 저장하지 않게 해 둬요.
  • 반대로 누구에게나 같은 응답(공개 글, 이미지, CSS)만 public으로 길게 저장해요.

파일 이름에 지문 넣기

캐시는 오래 저장할수록 빨라지지만, 내용을 고쳤을 때 옛 사본이 남는 게 문제예요. 그래서 CSS나 자바스크립트 파일은 이름에 내용의 지문(해시)을 넣어요.

import hashlib

def fingerprint(name, content):
    digest = hashlib.sha256(content.encode()).hexdigest()[:8]
    stem, ext = name.rsplit(".", 1)
    return f"{stem}.{digest}.{ext}"

v1 = "body { color: #1f2937; }"
v2 = "body { color: #111827; }"
print("처음 배포:", fingerprint("style.css", v1))
print("내용을 고친 뒤:", fingerprint("style.css", v2))
print("내용이 같으면 이름도 같아요:", fingerprint("style.css", v1) == fingerprint("style.css", v1))
처음 배포: style.055fbb9f.css
내용을 고친 뒤: style.8bb8873e.css
내용이 같으면 이름도 같아요: True

색 하나만 바꿔도 이름이 완전히 달라져요. 내용이 바뀌면 주소가 바뀌니, 옛 이름의 파일은 1년이든 영원이든 저장해도 괜찮아요(max-age=31536000, immutable). HTML 파일은 새 이름을 가리키도록 짧게 저장하거나 매번 확인하게 해요. 그러면 배포하는 순간 모두가 새 파일을 받아요. 요즘 빌드 도구는 이 일을 알아서 해 줘요. 이 가이드북을 빌드할 때도 main-1c87a35c27697120.js 같은 이름의 파일이 만들어져요.

어떻게 고를까

  1. 사람마다, 때마다 내용이 달라야 하나요? 아니라면 정적 사이트로 시작해요.
  2. 일부만 다르다면 정적 페이지에 그 부분만 API나 외부 서비스로 붙여요.
  3. 대부분이 사람마다 다르다면(대시보드, 관리 도구) 동적 사이트예요. 그래도 CSS, 이미지, 자바스크립트 같은 파일은 정적으로 CDN에 두고, 페이지 응답만 서버가 만들어요.
  4. 방문자가 여러 나라에 있거나 갑자기 몰릴 수 있다면 CDN을 앞에 둬요. 많은 정적 호스팅 서비스는 CDN을 기본으로 붙여 줘요.

실습

  1. 정적 사이트 예제에 글을 하나 더 추가하면 다시 그리는 횟수는 몇 번인가요? 바뀐 글만 다시 그리게 하려면 무엇을 기억해 둬야 할까요?
  2. CDN 예제에서 도시마다 방문을 100번으로 늘리면 평균 대기 시간과 바로 답한 비율이 어떻게 바뀌나요?
  3. CDN 예제에 저장 기간(초)을 더하고, 방문 사이의 간격을 정해 기간이 지난 사본은 원본에서 다시 가져오게 해 보세요.
  4. 장바구니 예제의 CDN이 주소 대신 "주소와 사용자"를 함께 이름표로 쓰게 바꾸면 어떻게 되나요? 그래도 private을 붙이는 게 나은 이유는 무엇일까요?
  5. 자주 가는 사이트에서 개발자 도구 Network 탭을 열고, CSS와 자바스크립트 파일 이름에 지문이 들어 있는지, Cache-Control은 어떻게 되어 있는지 살펴보세요.

자주 하는 실수

  • 바뀌지 않는 페이지를 요청마다 서버에서 만든다. 정적으로 만들면 빠르고 싸고 튼튼해요.
  • 사람마다 다른 응답을 public으로 캐시한다. 다른 사람의 정보가 보이는 사고가 나요. private이나 no-store를 붙여요.
  • 파일 이름은 그대로 두고 캐시 기간만 길게 잡는다. 고친 내용이 사용자에게 안 보여요. 이름에 지문을 넣어요.
  • 배포하고 CDN의 옛 사본을 잊는다. HTML처럼 이름이 그대로인 파일은 짧게 저장하거나 배포할 때 사본을 지워요.
  • 동적 기능 하나 때문에 사이트 전체를 동적으로 만든다. 그 부분만 API나 외부 서비스로 붙일 수 있는지 먼저 봐요.

점검 문제

  1. 정적 사이트와 동적 사이트는 각각 언제 페이지를 만드나요?
  2. 방문이 1,000번일 때 두 방식이 페이지를 그리는 횟수가 다른 이유는?
  3. 정적 사이트의 약점 두 가지는?
  4. 정적 페이지에 로그인 상태처럼 사람마다 다른 정보를 보여 주는 방법은?
  5. CDN의 첫 방문(캐시 미스)이 오히려 조금 더 느린 이유와, 그래도 전체적으로 빨라지는 이유는?
  6. 장바구니 사고는 왜 일어났고, 어떻게 막나요?
  7. 파일 이름에 내용의 지문을 넣으면 캐시를 길게 잡아도 되는 이유는?

정답

  1. 정적 사이트는 배포할 때 한 번 미리, 동적 사이트는 요청이 올 때마다 만들어요.
  2. 정적 사이트는 미리 만든 파일을 그대로 보내기만 해서 배포할 때의 횟수로 끝나지만, 동적 사이트는 요청마다 새로 그리기 때문이에요.
  3. 내용을 바꾸려면 다시 만들어 배포해야 하고, 사람마다 다른 내용은 미리 만들 수 없어요.
  4. 페이지 뼈대는 정적으로 보내고, 사람마다 다른 부분만 자바스크립트로 API를 불러 채워요.
  5. 엣지에 사본이 없어서 엣지가 원본에서 가져오는 시간이 더해지기 때문이에요. 그다음 방문부터는 가까운 엣지가 바로 답해서, 방문이 쌓일수록 평균이 크게 줄어요.
  6. CDN이 주소만 보고 사람마다 다른 응답을 저장해, 같은 주소를 요청한 다른 사람에게 앞사람의 응답을 줬기 때문이에요. 사람마다 다른 응답에는 private이나 no-store를 붙이고, 로그인한 요청은 저장하지 않게 설정해요.
  7. 내용이 바뀌면 파일 이름도 바뀌어서, 옛 이름의 사본이 아무리 오래 남아도 새 내용을 가리는 일이 없기 때문이에요.

다음 강의

동적 사이트를 실제로 운영하려면 서버 프로그램 앞에 하나가 더 필요해요. HTTPS를 처리하고, 정적 파일을 빠르게 나눠 주고, 요청을 여러 서버 프로그램에 나눠 주는 웹 서버예요. 다음 강의에서는 Nginx를 예로 웹 서버와 리버스 프록시의 구조를 배워요.