정적 사이트 구현

이 사이트는 빌드 때 만든 정적 파일을 Caddy 로 서빙합니다. 서버 런타임을 두지 않으면서 필요한 기능을 붙인 과정을 모았습니다. 헷갈리는 글자를 뺀 알파벳으로 조합 수와 충돌 확률을 계산해 단축링크를 6자리로 정했고, 등록한 기기에서만 열리는 비공개 페이지는 클라이언트 인증서(mTLS)와 산출물 분리로 막았습니다.

화면 쪽 구현도 같은 제약 안에 있습니다. 연락처는 텍스트로 보이되 크롤러에는 온전한 주소가 남지 않게 했고, 빌드 시점에 멈추는 수치는 10분마다 갱신되는 스냅샷 파일 하나로 바꾸었으며, mermaid 문법의 순서도는 브라우저 라이브러리 없이 빌드 때 SVG 로 그립니다.

이 주제의 글 5

순서도를 라이브러리 없이 정적 SVG 로 그리기

mermaid 문법으로 적은 순서도를 브라우저 라이브러리 없이 빌드 시점에 SVG 로 변환하도록 직접 구현했습니다. 지원할 문법 범위를 정하고, DOM 없이 글자 폭을 추정하고, 노드 배치를 층 단위로 계산한 기록입니다.

정적 사이트에 준실시간 수치 반영하기

빌드 시점에 코드로 포함한 수치는 수집기를 실행한 시점에서 멈춥니다. 서버 렌더링도 공개 API 도 도입하지 않고, 10분마다 갱신되는 스냅샷 파일 하나로 정적 페이지의 수치만 교체한 방법입니다.

이메일 주소를 노출하면서 크롤링 방어하기

연락처는 텍스트로 보여야 하고, 크롤러에는 온전한 주소가 남지 않아야 합니다. 주소를 조각으로 나누고 화면에 보이지 않는 미끼 문자열을 넣고 링크는 마운트 후에 추가하는 방식, 그리고 이 방법의 차단 범위와 한계를 정리했습니다.

정적 사이트에 비공개 페이지 추가하기

서버 런타임 없이, 등록한 기기에서만 열리는 페이지를 정적 사이트에 붙였습니다. 클라이언트 인증서(mTLS)로 막고 산출물 자체를 갈라 둔 과정과 실제로 걸렸던 것들입니다.

내부 문서용 6자리 단축링크의 설계 기준

정적 사이트에 서버 없이 단축링크를 붙였습니다. 알파벳에서 헷갈리는 글자를 빼고, 조합 수와 충돌 확률을 계산해 6자리로 정한 과정입니다.

관련 과제