Astro 무료 블로그 세팅 가이드
실제로 사용할 블로그를 만들 때 도움이 많이된 자료. 필요한 부분만 잘 걸러서 읽으면 쉽게 세팅 가능
이 문서를 왜 보는가?
블로그를 만드는 방법은 인터넷에 수만 개 있지만, 대부분은 두 가지 중 하나로 끝납니다.
- “티스토리에 가입하세요” 끝. — 5분이면 끝나지만 본인 자산이 아닙니다. 카카오가 정책 바꾸면 끝.
- “Next.js 풀스택 SaaS 만들기” 100시간. — 너무 무겁습니다. 블로그 하나 만들겠다고 풀스택 배우는 건 과합니다.
이 문서는 그 중간 지점입니다.
본인이 평생 소유하는 블로그를 0원으로 시작 → 광고 수익 가능 → 미래에 결제·앱 기능까지 확장 가능한 구조.
학습 후 갖게 되는 것
이 가이드를 끝까지 따라하면 다음을 얻습니다.
| 결과물 | 설명 |
|---|---|
| 본인 도메인 블로그 (또는 무료 서브도메인) | yourname.com 또는 yourname.pages.dev |
| 마크다운으로 글 쓰는 환경 | .md 파일 만들면 자동으로 웹페이지 생성 |
| GitHub에 코드·글 백업 | 본인 컴퓨터 망가져도 안전 |
| 자동 배포 파이프라인 | git push 하면 30초 후 사이트 반영 |
| 광고 수익 받을 수 있는 구조 | 글 누적 후 애드센스 신청 가능 |
| 평생 자산화된 콘텐츠 | 다른 곳에 옮기고 싶으면 마크다운 파일 그대로 이전 가능 |
왜 이 조합인가?
Astro + GitHub + Cloudflare Pages 3개를 사용합니다. 각각 왜 필요한지:
Astro = 사이트를 만드는 도구
Astro = “별/우주”를 뜻하는 영어 어원. 별처럼 빠르게 동작한다는 의미로 명명됨. 정적 사이트 생성기 (Static Site Generator) — 글을 미리 HTML로 변환해두는 도구.
왜 Astro인가:
- 마크다운 파일 = 글 1개. 글 쓰기 매우 쉬움
- 정적 HTML로 변환 → 페이지 매우 빠름 → SEO 가산점
- 디자인 자유 (워드프레스 같은 스킨 제약 없음)
- 무료 오픈소스
- 1인 개발자 표준 (Marc Lou, Tony Dinh 등 사용)
대안과 비교:
| 도구 | 장점 | 단점 |
|---|---|---|
| Astro | 빠름, SEO, 마크다운, 자유로움 | 코드 셋업 1~2시간 필요 |
| 워드프레스 | 플러그인 다양 | 무거움, 보안 부담 |
| Next.js | 풀 SaaS 가능 | 블로그용으론 과함 |
| 티스토리 | 5분 셋업 | 카카오 종속 |
→ “본인 자산 + 미래 확장 + 합리적 시간”이면 Astro.
GitHub = 코드와 글을 저장하는 창고
Git = “분산 버전 관리 시스템”의 이름. GitHub = Git을 클라우드에서 사용하게 해주는 서비스.
왜 필요한가:
- 본인 컴퓨터가 망가져도 글이 안전 (클라우드 백업)
- 글 수정 이력 자동 저장 (실수해도 되돌리기 가능)
- Cloudflare Pages가 GitHub의 코드를 보고 자동 배포
비유:
Google Drive에 파일 올려두면 어디서든 접근 가능. GitHub은 코드와 글의 Google Drive.
Cloudflare Pages = 사이트를 인터넷에 띄우는 호스팅
Cloudflare = 미국의 대형 인터넷 인프라 회사. 전 세계에 서버 네트워크 있음. Pages = 정적 사이트를 무료로 호스팅해주는 서비스.
왜 Cloudflare Pages인가:
- 무료 + 상업적 사용 OK (광고 붙여도 약관 위반 X)
- 빠름 (전 세계 CDN — Content Delivery Network)
- GitHub 연동 자동 배포
- HTTPS 자동 (보안 인증서 무료)
왜 Vercel 아닌가:
- Vercel 무료 플랜 (Hobby)은 비상업적 용도만 허용
- 광고 수익이 발생하면 약관상 Pro 플랜 ($20/월) 필요할 수 있음
- 광고 모델이면 Cloudflare Pages가 안전
전체 흐름 한눈에 보기
[본인 컴퓨터]
│
│ ① Astro로 블로그 코드 작성
│ ② 마크다운 파일에 글 작성
▼
[Git push]
│
▼
[GitHub] ─── 코드 + 글 클라우드 저장
│
│ ③ Cloudflare가 GitHub 변경 감지
▼
[Cloudflare Pages]
│
│ ④ 자동 빌드 (Astro가 마크다운을 HTML로 변환)
│ ⑤ 전 세계 CDN에 배포
▼
[독자] ─── yourname.pages.dev 접속 → 본인 글 봄→ 한 번 셋업 후 글 추가 = 마크다운 파일 1개 + git push. 30초 후 사이트 반영.
목차 (학습 순서)
이 가이드는 7개 문서로 구성됩니다. 순서대로 따라가세요.
| # | 문서 | 시간 | 무엇을 배우는가 |
|---|---|---|---|
| 1 | 01-prerequisites.md | 30분 | Node.js·Git·계정 준비 (사전 준비물) |
| 2 | 02-create-astro.md | 60분 | Astro 프로젝트 생성·로컬 실행·본인 정보 수정 |
| 3 | 03-deploy.md | 30분 | GitHub 저장소 + Cloudflare Pages 배포 |
| 4 | 04-daily-write.md | 30분 | 글 쓰기·자동 배포·마크다운 사용법 |
| 5 | 05-monetize.md | 선택 | 애드센스 광고 + 본인 도메인 연결 |
| 6 | 06-troubleshooting.md | 참고용 | 자주 막히는 문제·에러 해결 |
총 셋업 시간: 약 2~3시간. 한 번 끝내면 평생 글만 쓰면 됩니다.
선수 지식
이 가이드를 따라하기 위해 미리 알면 좋은 것:
| 지식 | 필요도 | 모르면? |
|---|---|---|
| 터미널/명령줄 사용 (cd, ls 정도) | 필수 | 명령어 따라 입력만 해도 됨 |
| 마크다운 (Markdown) 문법 | 권장 | 문서 안에 5분 설명 포함 |
| Git 기본 (commit, push) | 권장 | 명령어 그대로 따라하면 됨 |
| HTML/CSS | 불필요 | Astro가 다 해줌 |
| 프로그래밍 언어 | 불필요 | 코드 한 줄 안 짜도 됨 |
→ 사실상 터미널 입력만 할 줄 알면 가능합니다.
핵심 원칙 (시작 전 읽기)
이 가이드 전체를 관통하는 5가지 원칙:
1. 완벽한 디자인보다 첫 글 1편이 중요
블로그를 1주일 디자인하다가 글 0편으로 끝나는 사례가 가장 흔합니다. 못생긴 사이트라도 글 30편이 있는 게 예쁜 사이트에 글 0편보다 100배 낫습니다.
2. 셋업은 한 번, 글은 매주
이 가이드 전체 셋업은 한 번만 합니다. 그 후엔 글 쓸 때마다 마크다운 파일 만들고 git push 두 단계만 반복합니다.
3. 막히면 AI에게 물어보세요
Cursor·Claude·ChatGPT 등 AI에게 에러 메시지를 그대로 붙여넣으면 거의 답을 줍니다. 모르는 게 부끄럽다고 1시간 헤매지 마세요.
4. 도메인은 나중에 사도 됩니다
yourname.pages.dev 무료 주소로 평생 운영 가능합니다. 본인 도메인은 사이트가 자리 잡은 후 결정해도 늦지 않습니다.
5. 한 번에 다 이해 못 해도 OK
“이게 왜 이렇게 동작하는지” 처음엔 100% 안 와닿습니다. 일단 따라하고 글 5편 정도 쓰다 보면 자연스럽게 이해됩니다.
다음 단계
01-prerequisites.md부터 시작하세요. Node.js·Git·필요한 계정을 준비합니다.
관련 자료 (선택)
| 자료 | 설명 |
|---|---|
| Astro 공식 docs | 영문, 매우 친절 |
| Cloudflare Pages docs | 영문 |
| GitHub 가이드 | 한국어 일부 지원 |
| Markdown 가이드 | 영문, 짧음 |