birchholt 직접 해보고 남기는 기록

운영 기록

이 자리에 모인 글은 전부 제가 직접 걸려서 재본 것들입니다. 읽고 정리한 것이 아니라, 안 되는 화면을 앞에 두고 원인을 찾을 때까지 재본 기록입니다. 그래서 주제가 예쁘게 이어지지 않습니다. 티스토리 스킨 치환자 이야기 다음에 GitHub Actions 스케줄 이야기가 오고, 그 다음이 다시 도메인 이야기입니다. 막힌 순서대로 쌓았기 때문입니다.

쓸 때 지키는 것이 세 가지 있습니다. 첫째, 숫자는 어떻게 쟀는지 같이 적습니다. “느리다"가 아니라 몇 초였고 무엇으로 쟀는지를 적습니다. 둘째, 틀렸던 것은 지우지 않고 정정합니다. 처음에 세운 가설이 실측에서 깨지면 그 과정을 남깁니다 — 틀린 경로를 지워버리면 다음 사람이 같은 곳에 다시 들어갑니다. 셋째, 확인하지 못한 것은 확인하지 못했다고 적습니다. 그럴듯하게 채우면 읽는 사람이 검증하는 데 드는 시간이 제가 아낀 시간보다 커집니다.

공식 문서가 이미 잘 설명하는 것은 여기 없습니다. 문서와 실제가 어긋난 지점, 문서 문장을 제가 잘못 읽었던 지점, 그리고 로컬에서는 멀쩡한데 라이브에서만 깨지던 것들이 남았습니다. 같은 데서 막힌 사람이 검색으로 닿기를 바라며 적습니다.

2026년 10월 · Cloudflare

Hugo 블로그 링크를 카톡에 보내면 썸네일이 없을 때 — og:image와 카카오 캐시

카톡 미리보기에 그림이 붙으려면 og:image가 있어야 하는데, 제 블로그 글 head에는 그 태그가 아예 없었습니다. 대표 이미지를 og:image로 내보내고 WebP와 JPG 출력을 비교했고, 카카오 캐시를 지우는 곳까지 적었습니다.

읽기 →
2026년 10월 · Hugo

Hugo static/에 둔 이미지는 원본 그대로 나갑니다 — 빌드 때 줄이고 WebP로 바꾸기

static/ 의 이미지는 Hugo가 건드리지 않습니다. assets/ 로 옮겨 render-image 훅에서 Resize 하자 PNG 약 7.2MB가 1280px WebP 약 0.18MB가 됐습니다. 첫 빌드가 느린 이유와 resources/_gen 캐시도 봤습니다.

읽기 →
2026년 10월 · Cloudflare

커스텀 도메인을 붙여도 pages.dev 주소는 계속 열려 있습니다

커스텀 도메인을 붙인 뒤에도 프로젝트.pages.dev 주소가 같은 내용을 noindex 없이 내주고 있었습니다. _headers 규칙을 미리보기 배포로 먼저 시험하고, production에 넣은 뒤 두 주소의 헤더를 다시 찍었습니다.

읽기 →
2026년 10월 · Hugo

Hugo 0.146 이후 _default 와 partials 를 옮기다가 태그 페이지가 전부 비었습니다

옛 layouts 구조는 최신 Hugo 에서도 대부분 그대로 돕니다. 문제는 옮기는 도중입니다. 0.145.0 과 0.165.0 으로 한 단계씩 옮겨 빌드하며 무엇이 조용히 바뀌는지 쟀습니다.

읽기 →
2026년 10월 · Hugo

Hugo RSS에 lastBuildDate가 없고, 개인정보처리방침이 0001년 글로 섞여 있었습니다

Hugo 기본 RSS는 홈 페이지의 날짜가 비면 lastBuildDate를 빼는데, git 정보를 켜고 _index.md를 커밋하면 그 날짜가 빕니다. 날짜 없는 페이지가 0001년으로 피드에 들어가는 문제와 함께 내장 템플릿을 덮어써 고쳤습니다.

읽기 →
2026년 10월 · Cloudflare

Cloudflare Pages에 www를 붙였더니 522가 났습니다 — DNS만으로는 안 됩니다

www 레코드를 하나 추가했더니 522가 0.2초 만에 돌아왔습니다. Pages에 도메인을 따로 등록해야 열리고, 열린 www는 apex의 사본입니다. DNS, Pages, 리다이렉트 규칙을 한 단계씩 걸며 직접 쟀습니다.

읽기 →