How to Deploy a Zola Blog to Cloudflare Pages

20 1월 2026
2 분 읽기
태그:
Cloudflare,
pages,
rust,
zola

🤔 왜 Zola인가?

사실 블로그 툴은 정말 많다. 하지만 나는 '속도'에 진심인 편이다. Zola는 무려 Rust로 만들어졌다. "Rust = 빠르다"는 공식은 개발자들 사이에서 거의 국룰 아닌가? 실제로 빌드를 돌려보면 눈 깜빡할 사이에 작업이 끝난다. 게다가 파이썬이나 노드처럼 복잡한 의존성 지옥에 빠질 필요 없이, 실행 파일 하나면 끝난다는 게 너무 매력적이었다. 실제로 과거에 썼던 hugo랑 비교해봐도 훨씬 빠르다.

🤑 왜 Cloudflare Pages인가?

많이들 처음엔 만만한 GitHub Pages를 생각할 것이다. 하지만 조금 더 찾아보면 Cloudflare Pages(CF Pages)가 제공량이 훨씬 혜자스럽다는 걸 알게 된다. 빌드 속도도 빠르고, 무엇보다 전 세계 어디서 접속해도 쾌적한 엣지 네트워크를 무료로 쓸 수 있다니 마다할 이유가 전혀 없었다.

🧳 준비물

준비물은 간단하다.

Git 관련 계정: (GitHub 등 소스코드를 올릴 곳)
Zola 엔진: 내 컴퓨터에 미리 설치해두기 (sudo pacman -S zola)
Cloudflare 계정: 우리 블로그의 새 보금자리

⚙️ 1단계: 로컬 설정

초기화: zola init zola-blog를 입력하면 기본 구조가 잡힌다.
옷 입히기: 나는 깔끔한 tabi 테마를 골랐다. git submodule로 테마를 추가해줬다. 나중에 업데이트 관리하기 편하니까!
디렉터리 정리: content, static 등 Zola가 정해준 규칙대로 폴더를 나눴다.
미리보기: zola serve를 입력하고 localhost:1111에 접속했다.

🫸 2단계: GIT PUSH 하기

내 컴퓨터에서만 보기엔 너무 아까우니 이제 세상 밖으로 보낼 차례다. git add ., git commit, git push... 명령어 세 줄에 내 소중한 블로그 코드가 GitHub 저장소로 안전하게 날아갔다. 이제 절반은 왔다.

☁️ 3단계: Cloudflare 삽질

이제 Cloudflare Pages 대시보드로 가서 새 프로젝트를 만들었다. GitHub 저장소를 연결하고 몇 가지 설정을 해줘야 하는데, 문제가 터졌다...!

바로 zola가 command not found가 떴다. 이 문제는 CF의 v3 이미지에 zola가 설치되지 않았기 때문에 발생한다. zola가 설치되어있는 v1로 바꿔서도 했지만 glibc 버전 문제로 오류가 터진다.

그래서 v3에서 UNSTABLE_PRE_BUILD: asdf plugin add zola https://github.com/salasrod/asdf-zola && asdf install zola 0.22.0 && asdf global zola 0.22.0 와 같이 환경변수를 넣어서 zola를 설치 해줬다. (zola버전은 바꿔도 된다)

🚀 4단계: 감동의 Success 로그 감상하기

설정을 마치고 '배포 시작' 버튼을 눌렀다. 잠시 후... [Success] 라는 글자가 보였다. 그 후 내 도메인을 연결하고 잠시 기다리니 블로그가 완성되었다.

👋 마무리

Zola와 Cloudflare Pages의 조합은 정말 강력하다. 설정도 간편하고, 무엇보다 결과물이 너무 가볍고 빠르다. 혹시 무거운 블로그 툴에 지쳤거나 Rust의 맛을 살짝 보고 싶은 분들이라면 적극 추천한다. ~~물론 rust 몰라도 된다...~~