블로그 만들기 08 - 점검하고 고치기
만들어 두고 한동안 손대지 않은 블로그를 처음부터 다시 점검했다. 동작하지 않던 기능, 보안 구멍, 느린 페이지, 빠진 SEO를 찾아 단계별로 고친 과정과 그 과정에서 세운 기준을 정리했다.
- #블로그
- #Nextjs
- #Vercel
- #SEO
- #보안
- #리팩터링
🧠 요약
- 기능을 더하기 전에 "지금 무엇이 동작하지 않는가"부터 목록으로 만들었다.
- 한 번에 다 고치지 않고 버그 → 성능 → SEO → UX → 정리 순서로 PR을 나눴다.
- 외부 URL을 대신 불러오는 API는 SSRF 방어를 따로 붙였다.
- 방문 기록 API에는 IP 기준 요청 제한을 걸었다.
- 마지막으로 CI를 붙여서, 다음부터는 깨진 채로 배포되지 않게 했다.
0. 왜 다시 점검했나
블로그 만들기 01~07에서 기능을 하나씩 붙여 왔다. 그런데 기능을 붙이는 동안에는 "되는지"만 확인했지, 만들어 둔 것들이 서로 부딪히지 않는지는 제대로 본 적이 없었다. 오랜만에 블로그를 열어 보니 본문 끝이 잘리는 글이 있었고, 인기 글 목록이 비어 있었고, 모바일 메뉴는 키보드로 닫을 수 없었다.
그래서 이번에는 새 기능 없이 점검 → 우선순위 → 단계별 수정만 했다.
1. 점검 목록 만들기
점검은 네 갈래로 나눴다.
| 구분 | 본 것 |
|---|---|
| 동작 | 페이지마다 실제로 열어 보고, 콘솔 오류와 잘못된 HTML을 확인 |
| 보안 | 외부 입력을 받는 API(이미지 프록시, 링크 미리보기, 방문 기록) |
| 성능 | 페이지 JS 크기, 클라이언트에서 하던 마크다운 렌더링, 이미지 |
| SEO·UX | sitemap, robots, RSS, 페이지별 메타데이터, 목차, 검색, 모바일 메뉴 |
목록을 만든 다음에는 "사용자가 지금 겪고 있는 문제"를 먼저, "있으면 좋은 것"을 나중으로 미뤘다.
2. 버그와 보안 먼저
2-1. 이미지 프록시와 링크 미리보기의 SSRF
07편에서 만든 링크 카드는 서버가 남의 URL을 대신 불러온다. 이 말은 누군가 http://169.254.169.254/ 같은 내부 주소를 넣으면 서버가 그대로 요청한다는 뜻이다. 그래서 요청 전에 다음을 확인하는 safeFetch를 만들었다.
http,https만 허용한다.- 호스트 이름을 DNS로 직접 풀어서, 사설·루프백·링크 로컬 IP면 막는다.
- 리다이렉트는 자동으로 따라가지 않고, 매번 위 검사를 다시 거친다.
- 시간 제한과 응답 크기 상한을 둔다.
이미지 프록시는 SVG를 받지 않고, 응답에 Content-Security-Policy: sandbox를 붙였다. SVG 안의 스크립트가 블로그 도메인에서 실행되는 걸 막기 위해서다.
2-2. 방문 기록 API에 요청 제한
04편·06편에서 만든 방문 기록은 누구나 호출할 수 있는 API였다. 반복 호출 한 번이면 방문자 수와 인기 글이 쉽게 흔들린다.
Upstash Redis에 IP를 SHA-256으로 해시한 키를 두고 INCR + EXPIRE로 고정 창 카운터를 만들었다.
- 10분에 60회를 넘으면
429와Retry-After를 돌려준다. - 한 IP가 하루에 새 방문자로 잡힐 수 있는 수에도 상한을 뒀다.
IP 원문은 저장하지 않는다. 제한에 필요한 건 "같은 사람인지"뿐이기 때문이다.
2-3. 자잘하지만 눈에 띄던 것들
- 본문 잘림:
remark-directive가"og:XXX"나:00같은 글자를 directive 문법으로 읽어서 문단이 중간에 잘렸다. directive를 쓰는 글이 없어서 플러그인을 뺐다. - 잘못된 HTML: 태그에
node="[object Object]"속성이 그대로 찍히고, 코드 블록은<pre>안에<pre>가 또 들어가 있었다. 마크다운 컴포넌트에서node를 걸러 내고 코드 블록 렌더링을 한 곳으로 모았다. - 인기 글: 인기 글 목록이 코드에서 빈 배열로 고정돼 있었다. 글 조회를 방문자·글·하루 단위로 한 번만 세고(
SET NX), 조회 수 상위 글을 사이드바에 보여 주도록 바꿨다. - 정의되지 않은 스타일: Tailwind v4로 옮기면서
bg-background같은 클래스가 정의되지 않은 채 남아 있었다. CSS 변수 클래스로 바꿨다. - 본문 안의
h1이 글 제목과 겹쳐서, 본문h1은h2로 낮춰 렌더링했다.
3. 성능
- 마크다운 서버 렌더링:
react-markdown을 서버 컴포넌트에서 돌리도록 바꿨다. 글을 읽는 데 필요 없는 파서가 클라이언트 번들에서 빠졌다. - 목차를 서버에서: 목차를 만들려고
jsdom으로 HTML을 다시 파싱하던 걸, 마크다운 처리 중에 나온 트리(hast)에서 바로 뽑도록 바꿨다. - 이미지: 본문 이미지에
loading="lazy"와 Next 이미지 최적화 주소로 만든srcset을 붙였다. - 그래프: 별자리 그래프의 노드 객체를 캐시하고, 페이지를 떠날 때 three.js 리소스를
dispose했다.
4. SEO
sitemap.xml,robots.txt,rss.xml을 추가했다.- 모든 페이지에 제목·설명·canonical을 따로 붙였다.
- canonical을 레이아웃에 두면 자기 canonical이 없는 하위 페이지까지 홈 주소를 물려받는다. 그래서 홈 canonical은 홈 페이지에만 뒀다.
- 마찬가지로 페이지 메타데이터의
alternates가 레이아웃의 RSS 링크를 덮어써서, RSS 링크는 레이아웃<head>에 직접 넣었다.
5. UX
- 넓은 화면에서는 목차를 항상 펼쳐 두었다.
- 카테고리 페이지에 전체 글 검색을 넣었다.
- 태그 페이지는 글이 적은 태그를 접어서 보여 준다.
- 모바일 메뉴는 열릴 때 포커스를 메뉴 안으로 옮기고,
Esc로 닫히게 했다. 메뉴가 열리는 애니메이션 중에는 포커스가 들어가지 않아서,requestAnimationFrame으로 몇 번 다시 시도하게 했다.
6. 정리와 CI
쓰지 않는 의존성 17개와 파일을 지우고, lint를 next lint에서 ESLint CLI로 옮겼다. 그리고 GitHub Actions로 PR마다 lint, 빌드, 타입 검사를 돌리게 했다.
CI를 처음 붙였을 때 두 번 실패했다.
- 타입 검사가 이미지 import를 못 찾았다. 이미지 타입을 선언하는
next-env.d.ts가 git에 없고 빌드할 때 생기기 때문이다. 타입 검사를 빌드 뒤로 옮겼다. - 빌드 중에 OpenAI 키가 없다는 오류가 났다. 모듈을 불러오는 순간 클라이언트를 만들고 있었다. 첫 요청 때 만들도록 바꿨다.
둘 다 로컬에서는 .env.local과 이전 빌드 결과물 덕분에 가려져 있던 문제였다.
🔄 회고 및 인사이트
새로 알게 된 점
- 외부 URL을 대신 불러오는 기능은 편한 만큼 위험하다. "URL 문자열 검사"로는 부족하고, 실제로 연결할 IP를 확인해야 한다.
- 메타데이터는 레이아웃과 페이지가 합쳐지는 방식(덮어쓰기)을 알고 써야 한다.
관점의 변화
기능을 붙일 때는 "된다"에서 멈추기 쉽다. 이번에는 PR을 작게 나누고, PR마다 운영 화면에서 직접 확인한 뒤 다음 단계로 넘어갔다. 느리지만 되돌아가는 일이 없었다.
다음에 할 것
- 글이 늘어나면 검색을 서버 쪽으로 옮기기
- 방문 통계 화면 만들기