Repolode
perber

perber/leafwiki

SQLite와 디스크의 Markdown 파일을 사용하는 단일 Go 바이너리로 실행되는 셀프 호스팅 위키로, 외부 데이터베이스가 필요 없습니다.

대체할 수 있는 제품:ConfluenceNotion

스타
1,215
포크
101
열린 이슈
48
마지막 커밋
그저께

어떤 프로젝트인가요?

LeafWiki는 런북, 엔지니어링 노트, 홈랩 문서처럼 체계적으로 관리하며 오래 보존할 문서를 위한 셀프 호스팅 위키입니다. 메타데이터에는 SQLite를 사용하고 페이지 콘텐츠는 데이터 디렉터리에 Markdown 파일로 저장하는 단일 Go 바이너리로 제공되므로 Node.js, Redis, Postgres를 운영할 필요가 없습니다. 페이지는 직접 순서를 지정할 수 있는 명시적인 트리로 구성되며, 백업은 앱을 중지한 뒤 데이터 디렉터리를 복사하면 됩니다.

편집기에는 실시간 미리보기, 키보드 단축키, 내부 링크 자동 완성 기능이 제공되며, 페이지에서 태그, 전문 검색, 백링크, 깨진 링크 점검을 지원합니다. Markdown 확장 기능으로 표, 작업 목록, 콜아웃, 접을 수 있는 블록, Mermaid 다이어그램, KaTeX 수식, PDF 임베드도 사용할 수 있습니다. 접근 권한은 내부 전용, 로그인한 사용자만 편집할 수 있는 공개 읽기, 로그인 없이 모두 이용 가능한 방식으로 설정할 수 있으며, 관리자·편집자·뷰어 역할을 지원합니다.

수정 이력, 페이지 이름 변경 시 링크 수정, SMTP 이메일, Git 백업, 리버스 프록시 헤더 인증 같은 기능은 플래그를 통해 선택적으로 활성화할 수 있습니다. UI는 영어, 독일어, 스페인어로 제공됩니다.

핵심 기능

  • 01SQLite를 사용하는 단일 Go 바이너리로 제공되며, 페이지 콘텐츠는 디스크에 일반 Markdown 파일로 저장됩니다.
  • 02수동으로 페이지 순서를 지정할 수 있는 트리 탐색, 태그, 전문 검색, 백링크를 지원합니다.
  • 03실시간 미리보기와 내부 링크 자동 완성 기능을 갖춘 Markdown 편집기가 내장되어 있습니다.
  • 04내부 전용, 공개 읽기, 공개 편집의 세 가지 접근 모드와 관리자·편집자·뷰어 역할을 지원합니다.
  • 05수정 이력, 페이지 이름 변경 시 링크 수정, SMTP 이메일, Git 백업을 선택적으로 사용할 수 있습니다.
  • 06Linux, macOS, Windows, Raspberry Pi에서 실행되며 Docker와 systemd 설치 프로그램을 제공합니다.

활용 사례

  • 체계적인 트리 구조로 팀 런북과 엔지니어링 노트를 관리합니다.
  • 데이터베이스 서버 없이 내부 문서나 홈랩 지식 베이스를 호스팅합니다.
  • 기존 Markdown 또는 Obsidian 보관함에 체계적인 위키 UI를 제공합니다.
  • 독자는 자유롭게 열람하고 편집자만 페이지를 수정할 수 있는 공개 문서 사이트를 운영합니다.

빠른 시작

  1. 1

    Docker로 LeafWiki 실행하기

    docker run -p 8080:8080 -v ~/leafwiki-data:/app/data ghcr.io/perber/leafwiki:latest --jwt-secret=yoursecret --admin-password=yourpassword --allow-insecure=true
  2. 2

    브라우저에서 http://localhost:8080을 열고 admin으로 로그인하기

사용 전 알아둘 점

  • API 키는 아직 개발 중이며 사용할 수 없습니다.
  • Git 백업은 실험 단계입니다.
  • 실시간 공동 편집은 지원되지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

leafwiki은(는) 무엇인가요?
SQLite와 디스크의 Markdown 파일을 사용하는 단일 Go 바이너리로 실행되는 셀프 호스팅 위키로, 외부 데이터베이스가 필요 없습니다. LeafWiki는 런북, 엔지니어링 노트, 홈랩 문서처럼 체계적으로 관리하며 오래 보존할 문서를 위한 셀프 호스팅 위키입니다. 메타데이터에는 SQLite를 사용하고 페이지 콘텐츠는 데이터 디렉터리에 Markdown 파일로 저장하는 단일 Go 바이너리로 제공되므로 Node.js, Redis, Postgres를 운영할 필요가 없습니다. 페이지는 직접 순서를 지정할 수 있는 명시적인 트리로 구성되며, 백업은 앱을 중지한 뒤 데이터 디렉터리를 복사하면 됩니다.
leafwiki은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
leafwiki은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
leafwiki은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. leafwiki의 마지막 커밋은 2026년 11월 4일입니다.
leafwiki은(는) 어디에 사용할 수 있나요?
체계적인 트리 구조로 팀 런북과 엔지니어링 노트를 관리합니다. 데이터베이스 서버 없이 내부 문서나 홈랩 지식 베이스를 호스팅합니다. 기존 Markdown 또는 Obsidian 보관함에 체계적인 위키 UI를 제공합니다. 독자는 자유롭게 열람하고 편집자만 페이지를 수정할 수 있는 공개 문서 사이트를 운영합니다.
leafwiki는 어떻게 설치하나요?
Docker로 LeafWiki 실행하기: docker run -p 8080:8080 -v ~/leafwiki-data:/app/data ghcr.io/perber/leafwiki:latest --jwt-secret=yoursecret --admin-password=yourpassword --allow-insecure=true 브라우저에서 http://localhost:8080을 열고 admin으로 로그인하기
leafwiki은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/perber/leafwiki

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트