웹사이트를 통째로 ‘실행파일 하나’에 담는다 — 오프라인 뷰어 Kage

인터넷 없이 웹사이트를 본다는 것

비행기 안이나 지하실 서버실처럼 인터넷이 안 되는 곳에서, 평소 보던 문서 사이트가 갑자기 필요해진 적 있으신가요? 혹은 ‘이 사이트가 언젠가 사라지면 어쩌지’ 싶어 통째로 보관해 두고 싶었던 적은요? 이런 갈증을 아주 깔끔하게 긁어주는 도구가 등장했어요. 바로 Go 언어로 만들어진 Kage인데요, 이름처럼(かげ, ‘그림자’) 어떤 웹사이트든 그 ‘분신’을 떠서 단 하나의 실행파일 안에 통째로 담아줍니다.

핵심은 ‘하나의 실행파일’

Kage가 하는 일을 한 문장으로 요약하면 이래요. 대상 사이트의 주소를 주면, 페이지들을 차례로 훑어서(크롤링) HTML·CSS·이미지 같은 자원을 전부 긁어오고, 그 결과물을 통째로 하나의 실행파일(바이너리) 안에 구워 넣어요. 그 파일을 실행하면 내 컴퓨터 안에서 작은 웹서버가 떠서, 마치 진짜 그 사이트에 접속한 것처럼 브라우저로 오프라인 탐색을 할 수 있는 거죠.

여기서 ‘왜 굳이 실행파일이지?’ 싶을 텐데, 이게 Go라는 언어의 매력 포인트예요. Go에는 embed라는 기능이 있어서, 파일들을 프로그램 안에 아예 박아 넣어 한 덩어리로 컴파일할 수 있거든요. 그래서 결과물이 폴더 한가득의 파일 뭉치가 아니라 ‘파일 딱 하나’예요. 별도 설치나 의존성 없이, 그 파일만 USB에 담아 건네줘도 어디서든 바로 실행됩니다. 게다가 Go는 윈도우·맥·리눅스용으로 손쉽게 따로 뽑아낼 수 있어서, 플랫폼별 배포도 간단해요.

기존 도구들과 뭐가 다를까

‘사이트 통째로 저장’이라고 하면 떠오르는 고전들이 있죠. wget --mirror나 HTTrack 같은 도구는 사이트를 폴더째로 복사해 줘요. 브라우저 확장 SingleFile은 페이지 하나를 단일 HTML로 묶어주고, ArchiveBox는 본격적인 웹 아카이빙 서버를 띄워주고요.

Kage의 차별점은 결과물이 ‘열어보는 파일 더미’가 아니라 ‘실행하면 서버가 되는 단일 프로그램’이라는 데 있어요. 폴더 구조가 깨질 걱정도, 의존성을 챙길 걱정도 없이, 파일 하나가 곧 완결된 오프라인 뷰어가 되는 거죠. 배포와 휴대가 압도적으로 간편하다는 게 가장 큰 매력이에요. 대신 동적으로 서버와 실시간 통신하는 사이트(로그인 후 개인화 페이지 같은)는 정적 스냅샷의 특성상 한계가 있다는 점은 감안해야 해요.

한국 개발자에게 주는 시사점

실무에서 바로 떠오르는 쓰임새가 많아요. 망분리(인터넷이 차단된 폐쇄망) 환경에서 일하는 분들에게 오프라인 문서 뷰어로 딱이고요, 외부 클라이언트에게 ‘서버 없이도 바로 돌아가는’ 데모 사이트를 건넬 때, 또는 곧 사라질지 모를 레퍼런스 문서를 안전하게 박제해 둘 때도 유용해요.

그리고 Go를 쓰시는 분이라면 embed로 정적 자원을 바이너리에 묶는 이 패턴 자체를 배워둘 가치가 충분해요. 설정 파일이든 웹 프론트엔드 빌드 결과물이든 통째로 바이너리에 넣어 ‘단일 파일 배포’를 만드는 건, 운영을 단순하게 만드는 아주 강력한 기법이거든요. Kage는 그 아이디어를 ‘웹사이트 복제’라는 재미있는 문제에 적용한 좋은 사례예요.

한 줄 정리: Kage는 웹사이트를 크롤링해 Go의 embed로 ‘실행하면 서버가 되는 단일 바이너리’에 통째로 담아, 오프라인 보관과 배포를 극단적으로 간단하게 만들어 주는 도구예요.

여러분이라면 이 ‘단일 실행파일 오프라인 뷰어’를 어디에 가장 먼저 써보고 싶으신가요?