FastAPI와 SQLite로 나만의 셀프 호스팅 마크다운 블로그 구축한 개발기 (.uk 도메인, 어드민 대시보드, SEO 최적화까지)
외부 플랫폼에 의존하지 않고 FastAPI, SQLite, Tailwind CSS를 활용해 모바일 반응형 셀프 호스팅 마크다운 블로그를 구축한 전체 개발 과정과 노하우를 공유합니다.

블로그를 운영하다 보면 광고 정책의 제약, 플랫폼의 폐쇄성, 그리고 내가 원하는 대로 커스텀할 수 없는 답답함에 부딪히곤 합니다. 네이버나 티스토리 같은 대형 플랫폼 대신 "내가 직접 제어할 수 있는 나만의 가벼운 블로그 시스템을 만들어보면 어떨까?"라는 생각에서 출발해, FastAPI와 SQLite를 기반으로 한 셀프 호스팅 마크다운 블로그 구축을 드디어 완성했습니다.
이번 글에서는 .uk 도메인 연결부터 모바일 반응형 레이아웃 최적화, 마크다운 원본 에디터, 그리고 구글 애드센스 승인을 위한 SEO 설정까지 그동안 진행했던 개발 스토리를 공유해 드립니다.
1. 기술 스택 선정: 왜 FastAPI와 마크다운인가?
블로그를 만들 때 가장 중요하게 생각한 원칙은 "가벼울 것, 그리고 관리하기 쉬울 것"이었습니다.
- FastAPI (Python): 속도가 매우 빠르고 비동기 처리를 지원하며, 파이썬 생태계의 풍부한 라이브러리(Markdown 파싱, YAML 처리 등)를 활용할 수 있어 백엔드 구축에 최적입니다.
- SQLite + SQLAlchemy: 복잡한 대형 데이터베이스 서버 구축 없이 파일 하나로 가볍게 구동되면서도, 블로그 포스트와 설정값 데이터를 안전하게 관리할 수 있습니다.
- Tailwind CSS (CDN): 별도의 빌드 도구(Node.js 등) 없이도 세련된 모바일 반응형 UI를 빠르게 구성할 수 있습니다.
- Markdown + Frontmatter: 글을 쓸 때 HTML 태그를 일일이 쓸 필요 없이, 마크다운 원본 파일 하나로 제목, 요약, 카테고리 메타데이터까지 한 번에 관리합니다.
2. 주요 구현 기능 및 개발 포인트
① Frontmatter 기반의 에디터 및 원본 복원 시스템
블로그 관리자 대시보드에서 글 제목을 클릭하면 곧바로 수정 모드로 진입할 수 있도록 구현했습니다.
* 저장 시에는 ---로 구분된 Frontmatter 메타데이터(제목, 설명, 카테고리, 상태 등)와 순수 마크다운 본문을 파싱하여 DB에 안전하게 분리 저장합니다.
* 반대로 에디터로 불러올 때는 DB에 저장된 데이터를 조합하여 다시 완벽한 Frontmatter 텍스트 형태로 자동 복원해 주어 글 수정이 매우 직관적입니다.
② 모바일 반응형 뷰포트 및 UI 최적화
모바일 환경에서 스마트폰으로 블로그를 보거나 관리할 때 화면이 깨지지 않도록 모든 템플릿에 반응형 그리드와 스크롤 처리를 적용했습니다.
* 퍼블릭 홈 화면부터 상세 페이지, 그리고 관리자 대시보드의 인라인 수정 테이블까지 모바일 화면에서 완벽하게 작동합니다.
③ 스마트 이미지 매칭 워크플로우 (temp:// 시스템)
글을 작성할 때 이미지를 일일이 업로드하고 링크를 따오는 번거로움을 줄이기 위해, 에디터에서는  형태로 임시 태그를 작성하면 시스템이 이를 감지하고 정식 이미지로 매칭·치환해 주는 워크플로우를 완성했습니다.
④ SEO 및 구글 애드센스 최적화
검색엔진 최적화(SEO)와 애드센스 승인을 위해 필수적인 요소들을 빠짐없이 탑재했습니다.
* 동적 sitemap.xml 생성: 발행된 모든 포스트의 URL과 수정일을 반영하여 검색엔진 봇이 원활하게 크롤링할 수 있도록 구현했습니다.
* 개인정보 처리방침 페이지: 애드센스 심사 필수 요건인 개인정보 처리방침을 마크다운으로 작성하고 푸터 하단에 고정 배치했습니다.
* 커스텀 HEAD/FOOTER 스크립트 주입: 어드민 설정 페이지에서 구글 애널리틱스(GA4), 네이버 서치콘솔, 애드센스 자동 광고 스크립트를 입력하면 모든 퍼블릭 페이지에 안전하게 주입되도록 시스템을 연동했습니다.
3. 개발을 마치며

어드민 대시보드에서 카테고리와 발행 상태를 드롭다운으로 즉시 변경하는 인라인 수정 기능부터, 보안이 강화된 관리자 인증(/docs 엔드포인트 보호 등)까지 탄탄하게 다져놓으니 이제는 글을 쓰는 재미와 시스템을 가꾸는 재미가 쏠쏠합니다.
외부 플랫폼의 정책 변경이나 광고 제한에 흔들리지 않고, 내 손으로 직접 빚어낸 나만의 공간(.uk 도메인)을 운영해보고 싶으시다면 FastAPI 기반의 셀프 호스팅 블로그 구축은 정말 추천할 만한 프로젝트입니다. 앞으로도 블로그를 운영하며 겪는 유용한 개발 팁과 일상 꿀팁들을 자주 공유해 보겠습니다!