개발
2026.09.16 · 3분
이 블로그는 화면을 캐시한다. 글 목록도 글 본문도 한 번 만들어 두고 한동안 그대로 내보낸다. 빠르고 싸다.
그런데 방문자 수를 세려고 보니 셀 자리가 없었다.
당연한 이야기인데 부딪히기 전엔 생각 못 했다.
첫 방문 → 서버 코드 실행 → HTML 생성 → 캐시
이후 방문 → 캐시에서 바로 응답 (서버 코드 안 돎)
서버 컴포넌트 안에 "조회수 +1" 을 넣으면 첫 방문 한 번만 세어진다. 그다음 천 명이 와도 0 이다.
캐시를 끄면 셀 수는 있다. 그런데 그러면 캐시를 쓰는 이유가 없어진다. 조회수를 세려고 모든 방문자에게 느린 페이지를 주는 건 앞뒤가 바뀐 일이다.
화면마다 작은 신호를 하나 보낸다. 아무것도 그리지 않는 컴포넌트가 붙어서 화면이 뜨면 집계 경로를 한 번 두드린다.
보내는 것은 경로와 유입 주소 둘뿐이다. 화면 크기도 언어도 체류 시간도 안 보낸다. 서버가 그중 무엇도 저장하지 않기도 하고 모으는 순간 그 조합 자체가 지문(fingerprint)이 되기 때문이다 — 값 하나하나는 흔해도 여럿을 겹치면 사람을 가려낼 수 있다.
전송은 브라우저가 페이지를 떠나는 중에도 보장해 주는 방식을 먼저 쓴다. 응답을 기다리지 않아서 화면 이동을 붙잡지 않는다. 그게 실패할 때만 일반 요청으로 떨어진다.
실패는 전부 삼킨다. 집계가 비는 것보다 화면이 깨지는 것이 나쁘다.
여기서 한 번 걸렸다.
집계 요청에도 참조 헤더가 붙는다. 그걸 쓰면 될 줄 알았는데 그 값은 언제나 우리 페이지 주소다. 신호를 보낸 곳이 우리 페이지니까. 서버가 자기 도메인을 걸러내면 유입 통계가 영영 빈다.
그래서 브라우저가 알고 있는 원래 유입 주소를 본문에 실어 보낸다.
순방문을 세려면 같은 사람을 알아봐야 한다. 보통은 쿠키를 쓴다. 안 쓰기로 했다.
대신 이렇게 한다.
그날의 솔트 = HMAC(비밀키, 오늘 날짜)
방문자 지문 = HMAC(그날의 솔트, IP + 개행 + 브라우저 정보)
솔트(salt)는 해시에 섞어 넣는 값이다. 같은 입력이라도 솔트가 다르면 결과가 달라진다.
IP 와 브라우저 정보는 헤더에서 읽어 이 계산에만 쓰고 버린다. 저장하지 않는다. 남는 것은 되돌릴 수 없는 지문뿐이고 솔트가 날마다 바뀌니 어제 지문과 오늘 지문을 이어 붙일 수 없다. 그 지문도 7일 뒤에 지운다.
쿠키가 없으니 동의 배너도 필요 없다.
IP 와 브라우저 정보를 이어 붙일 때 사이에 개행을 넣는다. 그냥 붙이면 이런 충돌이 생긴다.
("1.2", "3.4") → "1.23.4"
("1.23", ".4") → "1.23.4"
서로 다른 두 방문자가 같은 지문을 갖는다. 구분자가 값에 나올 수 없는 문자여야 한다.
순방문 판정을 "이미 있나 보고, 없으면 넣고, 카운트를 올린다" 로 짜면 동시 요청에서 어긋난다. 두 요청이 동시에 "없다" 를 읽고 둘 다 넣는다.
그래서 먼저 넣어 보고, 실제로 들어갔는지를 DB 에게 묻는다.
INSERT OR IGNORE INTO seen (day, fp, path) VALUES (?, ?, ?);
-- 방금 실제로 들어갔으면 1, 이미 있었으면 0
INSERT INTO daily (day, path, views, uniques)
VALUES (?, ?, 1, changes())
ON CONFLICT(day, path) DO UPDATE
SET views = views + 1, uniques = uniques + excluded.uniques;
두 번째 문장의 changes() 가 첫 문장이 실제로 행을 넣었는지를 말해 준다.
넣었으면 1 이라 순방문이 하나 늘고 이미 있었으면 0 이라 조회수만 는다.
읽고 나서 쓰는 사이가 없다. 두 문장이 붙어 있어야 하고 순서를 바꾸면 조용히 망가진다. 그래서 테스트로 고정해 뒀다.
집계는 한국 시각으로 날짜를 자른다. UTC 로 자르면 한국 저녁 트래픽이 이틀로 갈린다. 밤 9시 이후 방문이 다음 날로 넘어간다.
화면에 날짜를 보여주는 쪽은 UTC 로 읽는다. 다른 이야기이고 같게 만들면 안 된다. 발행일은 저장된 값 그대로 보여야 하고 집계는 사람이 사는 시각으로 잘려야 한다.
신호를 보내는 컴포넌트는 공개 화면에만 붙어 있다. 최상위 레이아웃에 두면 관리자 화면까지 딸려 가서 내 방문이 통계를 오염시킨다. 글 쓰다가 미리보기를 열 때마다 조회수가 오르면 그 숫자는 아무 의미가 없다.
이 설계의 대가가 하나 있다. 그리고 이게 제일 중요하다.
순방문으로 세는 값은 (날짜, 경로, 방문자) 조합의 개수다. 한 사람이 글 셋을
읽으면 3 이다. 실제 방문자 수가 아니라 그 상한이다.
진짜 방문자 수를 구하려면 지문을 기간 내내 보관해서 "이 사람이 오늘 여러 글을 봤구나" 를 이어야 한다. 그걸 일부러 안 하기로 했다. 그게 곧 방문자를 따라다니는 일이니까.
유입도 마찬가지로 "그날 첫 접점" 만 센다. 같은 사람이 오전에 검색으로, 저녁에 다른 경로로 오면 두 번째는 안 잡힌다.
그래서 화면에 이 값을 "순방문자" 라고 쓰면 거짓말이 된다. 문서에 이렇게 적어 뒀다.
이 숫자는 방문자 수가 아니라 상한이다. 라벨은 "페이지별 순방문" 으로 쓴다.
정확한 숫자와 남기지 않는 것 사이에서 골라야 했고 후자를 골랐다. 개인 블로그에서 정확한 방문자 수를 알아서 할 일이 별로 없다. 어느 글이 읽히는지만 알면 된다.
다만 그 선택을 숫자 옆에 적어 두는 것이 중요하다. 안 적어 두면 6개월 뒤에 그 값을 방문자 수로 읽고 엉뚱한 판단을 한다. 개인정보처리방침에도 같은 내용을 적었다 — 방침과 실제가 어긋나는 건 방침이 없는 것보다 나쁘다.
이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다.