본문으로 바로가기
ARCHIVE

블로그 만들기 08 - 점검하고 고치기

만들어 두고 한동안 손대지 않은 블로그를 처음부터 다시 점검했다. 동작하지 않던 기능, 보안 구멍, 느린 페이지, 빠진 SEO를 찾아 단계별로 고친 과정과 그 과정에서 세운 기준을 정리했다.

  • #블로그
  • #Nextjs
  • #Vercel
  • #SEO
  • #보안
  • #리팩터링

🧠 요약

  • 기능을 더하기 전에 "지금 무엇이 동작하지 않는가"부터 목록으로 만들었다.
  • 한 번에 다 고치지 않고 버그 → 성능 → SEO → UX → 정리 순서로 PR을 나눴다.
  • 외부 URL을 대신 불러오는 API는 SSRF 방어를 따로 붙였다.
  • 방문 기록 API에는 IP 기준 요청 제한을 걸었다.
  • 마지막으로 CI를 붙여서, 다음부터는 깨진 채로 배포되지 않게 했다.

0. 왜 다시 점검했나

블로그 만들기 01~07에서 기능을 하나씩 붙여 왔다. 그런데 기능을 붙이는 동안에는 "되는지"만 확인했지, 만들어 둔 것들이 서로 부딪히지 않는지는 제대로 본 적이 없었다. 오랜만에 블로그를 열어 보니 본문 끝이 잘리는 글이 있었고, 인기 글 목록이 비어 있었고, 모바일 메뉴는 키보드로 닫을 수 없었다.

그래서 이번에는 새 기능 없이 점검 → 우선순위 → 단계별 수정만 했다.

1. 점검 목록 만들기

점검은 네 갈래로 나눴다.

구분본 것
동작페이지마다 실제로 열어 보고, 콘솔 오류와 잘못된 HTML을 확인
보안외부 입력을 받는 API(이미지 프록시, 링크 미리보기, 방문 기록)
성능페이지 JS 크기, 클라이언트에서 하던 마크다운 렌더링, 이미지
SEO·UXsitemap, 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를 처음 붙였을 때 두 번 실패했다.

  1. 타입 검사가 이미지 import를 못 찾았다. 이미지 타입을 선언하는 next-env.d.ts가 git에 없고 빌드할 때 생기기 때문이다. 타입 검사를 빌드 뒤로 옮겼다.
  2. 빌드 중에 OpenAI 키가 없다는 오류가 났다. 모듈을 불러오는 순간 클라이언트를 만들고 있었다. 첫 요청 때 만들도록 바꿨다.

둘 다 로컬에서는 .env.local과 이전 빌드 결과물 덕분에 가려져 있던 문제였다.


🔄 회고 및 인사이트

새로 알게 된 점

  • 외부 URL을 대신 불러오는 기능은 편한 만큼 위험하다. "URL 문자열 검사"로는 부족하고, 실제로 연결할 IP를 확인해야 한다.
  • 메타데이터는 레이아웃과 페이지가 합쳐지는 방식(덮어쓰기)을 알고 써야 한다.

관점의 변화

기능을 붙일 때는 "된다"에서 멈추기 쉽다. 이번에는 PR을 작게 나누고, PR마다 운영 화면에서 직접 확인한 뒤 다음 단계로 넘어갔다. 느리지만 되돌아가는 일이 없었다.

다음에 할 것

  • 글이 늘어나면 검색을 서버 쪽으로 옮기기
  • 방문 통계 화면 만들기