OpenSource-Hub
K

kiwix-tools

855 stars·개발 도구·SHA-256 체크섬 확인됨

오프라인 ZIM 콘텐츠(예: 위키백과)를 관리, 검색 및 제공하는 명령줄 도구 모음입니다.

스마트 다운로드

프로젝트 홈페이지 방문

아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요

오프라인에서도 위키백과를 보고, 명령어 한 줄로 로컬 서버를 실행하세요.

주요 기능

  • kiwix-manage:ZIM 파일 라이브러리 추가·삭제·수정·조회, XML 관리 지원
  • kiwix-search:ZIM 파일 전문 검색, 콘텐츠를 빠르게 찾기
  • kiwix-serve:HTTP 서버 시작, 브라우저에서 바로 오프라인 탐색
  • Docker 배포 지원, 컴파일 없이 원클릭 실행
  • 크로스 플랫폼:Linux, macOS, Windows(컴파일 또는 Docker 사용 필요)

할 수 없는 것

  • •kiwix-serve는 기본적으로 모든 네트워크 인터페이스에서 수신하므로 보안을 위해 방화벽 설정에 주의하세요.
  • •컴파일하기 전에 libkiwix와 libzim 버전이 요구 사항을 충족하는지 확인해야 하며, 그렇지 않으면 오류가 발생할 수 있습니다.
  • •ZIM 파일은 별도로 다운로드해야 하며(예: kiwix.org에서 다운로드) 용량이 클 수 있습니다.
  • •-Dstatic-linkage=true를 사용하면 정적 링크 버전을 컴파일할 수 있어 이동식 배포에 편리합니다.

사용 사례

  • 인터넷이 없는 오지나 학교에서 로컬 위키백과 서버 구축
  • 개발자가 오프라인 콘텐츠 앱을 테스트할 때 백엔드 서비스를 빠르게 구축
  • 개인 지식 관리: 위키백과, Stack Overflow 등의 ZIM 파일을 중앙에서 관리하고 검색

Kiwix-tools는 kiwix-manage, kiwix-search, kiwix-serve라는 세 가지 핵심 프로그램을 포함하는 커맨드라인 도구 모음입니다. kiwix-manage는 ZIM 파일 라이브러리를 관리하고, kiwix-search는 전체 텍스트 검색을 수행하며, kiwix-serve는 HTTP 서비스를 시작하여 로컬 네트워크(LAN) 내에서 오프라인 위키백과와 같은 ZIM 콘텐츠를 직접 탐색할 수 있게 해줍니다. libkiwix와 libzim 라이브러리를 기반으로 하며, 크기가 작고 성능이 뛰어납니다. 소스 코드 컴파일과 Docker 이미지를 지원하여 서버, Raspberry Pi 또는 개인 컴퓨터에 배포하기에 적합하며, 인터넷 연결 없이도 방대한 지식을 누릴 수 있습니다.

태그

zimofflineweb-serversearchkiwixcommand-line

시작하기

1

설치 프로그램 다운로드

위 버튼을 클릭하여 시스템에 맞는 설치 프로그램을 다운로드

2

소프트웨어 설치

다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요

3

방법 1(권장): Docker를 사용하여 kiwix-serve 실행: docker run -p 8080:80 ghcr.io/kiwix/kiwix-serve -v /path/to/your.zim:/data/content.zim

4

방법 2: GitHub Releases 페이지에서 해당 플랫폼용 바이너리 패키지(예: Linux x86_64)를 다운로드한 후 압축을 풀고 바로 실행

5

방법 3: 소스 코드 컴파일에는 meson, ninja 및 libkiwix/libzim 설치가 필요하며, 이후 meson . build && ninja -C build 실행

설치 가이드
  1. 방법 1(권장): Docker를 사용하여 kiwix-serve 실행: docker run -p 8080:80 ghcr.io/kiwix/kiwix-serve -v /path/to/your.zim:/data/content.zim
  2. 방법 2: GitHub Releases 페이지에서 해당 플랫폼용 바이너리 패키지(예: Linux x86_64)를 다운로드한 후 압축을 풀고 바로 실행
  3. 방법 3: 소스 코드 컴파일에는 meson, ninja 및 libkiwix/libzim 설치가 필요하며, 이후 meson . build && ninja -C build 실행
파일 무결성

체크섬 없음

이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다

SHA256 체크섬

체크섬 없음

GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요

이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.

오픈소스 투명성

GitHub 소스 보기
환경 가이드

제거 정보

컴파일을 통해 설치한 경우 ninja -C build uninstall을 실행하고, 바이너리 패키지인 경우 실행 파일을 직접 삭제하면 됩니다. Docker 사용자는 docker rmi ghcr.io/kiwix/kiwix-tools를 실행하여 이미지를 삭제하세요.

추가 의존성 없음

다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.

프로젝트 정보
라이선스GPL-3.0
마지막 업데이트2026-10-15 04:41:53
GitHub 저장소공식 웹사이트

문제 발생? 아래 FAQ 확인

4 FAQs

유사한 프로젝트