Show HN: Kage - 웹사이트를 오프라인 열람용 단일 바이너리로 섀도잉

8 hours ago 2

kage는 실제 headless Chrome에서 페이지를 열고 안정화될 때까지 기다린 뒤 사람이 본 최종 DOM을 저장하며, JavaScript를 제거하고 CSS·이미지·폰트를 로컬 경로로 내려받아 오프라인에서 탐색 가능한 폴더를 만드는 도구임
kage clone <url>은 스크립트 없는 미러를 만들고, kage serve [dir]는 복제된 폴더를 로컬 HTTP 서버로 미리 보며, kage pack <mirror-dir>는 미러를 ZIM 아카이브 또는 자체 포함 뷰어 바이너리로 묶고, kage open <file.zim>은 ZIM을 오프라인 열람용으로 서빙함
복제는 너비 우선 크롤링으로 동작하며 robots.txt를 읽고 sitemap.xml에서 시드를 얻고, 기본적으로 시드 호스트 안에 머물며, 같은 페이지가 http/https 또는 trailing slash 차이로 도달돼도 한 번만 가져오는 구조임
--max-pages, --max-depth, --scope-prefix, --subdomains, --exclude, --scroll, --workers, --refresh, --force, --chrome 같은 옵션으로 페이지 수, 깊이, 경로 범위, 서브도메인, 지연 로딩 스크롤, 동시 렌더링 수, 재렌더링, Chrome 경로를 조정함
kage pack은 미러를 ZIM 파일로 만들 수 있으며, ZIM은 압축·색인·읽기 전용 파일 형식이고 Kiwix 생태계에서 열 수 있으나 kage가 만든 아카이브는 Kiwix 자체 팩처럼 전체 텍스트 검색 색인을 만들지는 않음
--format binary는 아카이브를 kage 실행 파일에 붙여 실행하면 사이트를 오프라인으로 서빙하는 단일 실행 파일을 만들며, 수신자는 kage나 ZIM 리더를 설치할 필요가 없고 바이너리 크기는 사이트 크기와 별개로 kage 약 13 MiB를 포함함
기본 빌드는 pure Go와 CGO_ENABLED=0이며 사전 빌드 릴리스 바이너리는 시스템 브라우저를 열고, webview 태그로 빌드하면 macOS의 WKWebView, Windows의 WebView2, Linux의 WebKitGTK 기반 네이티브 창으로 열람함
설치는 go install github.com/tamnd/kage/cmd/kage@latest로 가능하며, releases에서 아카이브와 .deb/.rpm/.apk를 받을 수 있고, Chromium을 포함한 컨테이너 이미지는 ghcr.io/tamnd/kage로 실행함
호스트에서 실행할 때 Chrome 또는 Chromium이 필요하며, 시스템 설치를 자동으로 찾거나 --chrome 또는 KAGE_CHROME 환경 변수로 경로를 지정하고, 컨테이너 이미지는 추가 설치가 필요 없음
소스 구성은 clone, browser, sanitize, asset, urlx, zim, pack, viewer 등으로 나뉘며, 렌더링, DOM 스냅샷, 스크립트·핸들러·javascript: URL 제거, 자산 로컬화, URL-경로 매핑, ZIM 읽기·쓰기, 오프라인 HTTP 핸들러를 담당함
라이선스는 MIT임

Read Entire Article

Show HN: Kage - 웹사이트를 오프라인 열람용 단일 바이너리로 섀도잉

Related

Show GN: tradingcodex - 코덱스를 자산운용사로 바꿔주는 하네스

리우데자네이루의 “자체 개발” LLM이 기존 모델의 병합으로 보임

ReactOS “오픈소스 Windows”, Half-Life 실행 가능이라는 이정표에 도달

Show GN: AI 답변 복붙하면 이모지·마크다운을 깔끔하게 정리해주는 도구

Show GN: Gukhanmun: 국한문을 한글 전용으로 바꾸는 Rust/JavaScript 라이브러리

M1 Max 컴퓨터와 로컬 ML 모델로 669GB GoPro 영상을 인덱싱함

당신의 ePub은 정상입니다

Show GN: 예/아니오 질문으로 사건을 푸는 AI 추리 퀴즈 앱 CaseRoom을 만들었습니다

Tips

Trending

Popular

트럼프 “美·나이지리아군, ‘IS 2인자’ 제거… 글로벌 작전 능력 축소”

“트럼프, 中이 원하는 대만 발언 안해…양측 긴장 유지될 것”

What's new in Chrome from Google I/O 2026

'통한의 극장골 실점 패배' 주승진 김천 감독 "뒷심이 부족했다" [전주 현장]

[전화성의 기술창업 Targeting] 〈395〉 [AC협회장 주간록105] 마이클 잭슨 자산과 스타트업 경...

React Doctor — AI가 생성한 React 코드를 정적 분석으로 검증하는 진단 도구

테슬라, 로봇택시 사고 17건 경위 공개…원격 조종자 개입도 사유?

[헬스캡슐]은행잎 추출물, ‘베타아밀로이드 응집 억제’ 효과 확인 外

현대엔지니어링, 굿윌스토어와 10년 동행… 발달장애인 자립 지원 확대

'마이클 잭슨을 넘어섰다'...드레이크 14번째 빌보드 1위, 솔로 남성 최다 신기록