웹사이트 검색

저는 이 셀프 호스팅 도구가 모든 것을 정리해 주기 때문에 브라우저 즐겨찾기 사용을 중단했습니다

저는 브라우저 북마크를 정리하는 데 항상 서툴렀고, 그게 부분적으로는 도구의 문제라고 받아들였습니다. 링크를 저장하고 폴더에 넣은 뒤에는 잊어버리게 되니까요. 정확히 어디에 넣었는지 기억하지 않으면 아무것도 찾을 수 없고, 전용 크롬 북마크 대안들도 이 문제를 완전히 해결하지 못합니다.

결국 저는 Karakeep으로 옮겼습니다. Karakeep은 링크, 메모, 이미지, PDF를 한 곳에 저장하고 AI 기반 태깅 기능을 제공하는 무료 오픈소스 셀프호스팅 앱입니다. 브라우저 북마크가 처음부터 했어야 할 일을 이 앱이 해줍니다.

카라킵은 링크 이상의 것을 저장합니다

URL, 메모, 이미지, PDF를 북마크합니다

브라우저 즐겨찾기는 URL만 저장합니다. 그게 다입니다. 컨텍스트도 없고, 미리보기 기능도 없으며, 3주 후에 왜 링크를 저장했는지 기억나게 하는 아무것도 없습니다. Karakeep은 링크, 일반 텍스트 노트, 이미지, PDF를 한 곳에 저장할 수 있게 하여 다른 접근 방식을 취합니다.

Karakeep에 URL을 넣으면 페이지 제목, 설명, 미리보기 이미지를 자동으로 가져옵니다. 이 하나만으로도 일반 북마크 폴더보다 더 유용한데, 각 저장 항목이 무엇인지 링크를 하나씩 클릭하지 않고도 한눈에 알 수 있기 때문입니다.

모든 것을 맞춤 목록으로 정리할 수 있습니다 — 저는 연구, 튜토리얼, 나중에 참고하고 싶은 기사들을 위해 각각 별도의 목록을 유지합니다. 간단한 기능이지만, 모든 것이 하나의 관리가 어려운 피드로 쌓이는 것을 방지합니다.

Karakeep는 블로그나 뉴스 사이트에서 새 콘텐츠를 수동으로 노력하지 않고도 가져오는 자동 RSS 가져오기 기능도 지원합니다. 게다가 전체 웹 페이지를 아카이브하여 원래 링크가 사라져도 여전히 복사본을 보관할 수 있습니다. 이전에 깨진 링크 때문에 유용한 참고 자료를 잃은 적이 있어서, 이것은 반가운 추가 기능입니다.

Karakeep을 실행하는 데 약 5분 정도 걸립니다

도커 컴포즈 파일은 설정을 처리합니다

“셀프 호스팅”은 겁을 줄 수 있지만, Karakeep은 Docker에서 실행되므로 무거운 작업을 처리합니다. PC에 Docker Desktop이 설치되어 있다면 설정은 약 5분 정도 걸립니다. 전용 서버나 Linux 경험이 필요하지 않으며, Windows 컴퓨터에서 로컬로 잘 실행됩니다.

다음은 그것을 실행하는 방법입니다:

  1. PowerShell을 열고 mkdir C:\karakeep-app로 Karakeep용 새 폴더를 만든 다음, cd C:\karakeep-app로 해당 폴더로 이동합니다.
  2. 다음 명령어를 실행하여 공식 Docker Compose 파일을 다운로드하세요: wget https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml.

  3. 다음 변수를 포함하여 같은 폴더에 .env 파일을 만드세요:

    @"
KARAKEEP_VERSION=release
NEXTAUTH_SECRET=$(openssl rand -base64 36)
MEILI_MASTER_KEY=$(openssl rand -base64 36)
NEXTAUTH_URL=http://localhost:3000
"@ | Out-File -Encoding UTF8 .env
  4. 시스템에 OpenSSL이 없으면, C:\karakeep-app로 이동하여 .env 파일을 열고 임의의 문자열을 실제 임의 값으로 교체하세요.
  5. Docker Desktop를 실행한 다음, 터미널에서 docker compose up -d를 실행하여 모든 것을 시작하세요.
  6. 브라우저에서 http://localhost:3000을 열고, 가입하면 완료됩니다.

이것은 세 개의 컨테이너를 실행합니다 — Karakeep 웹 앱, 페이지 크롤링을 위한 헤드리스 크롬 인스턴스, 그리고 전체 텍스트 검색을 위한 Meilisearch. 모든 것이 compose 파일에 사전 구성되어 있습니다.

어디서나 접근할 수 있습니다

앱이 실행되면 웹 인터페이스에 국한되지 않습니다. Karakeep에는 한 번의 클릭으로 페이지를 저장할 수 있는 Chrome 확장 프로그램과 Firefox 애드온이 있습니다. 다른 확장 프로그램과 마찬가지로 설치하기 전에 Chrome 확장 프로그램의 안전성을 확인하는 것이 좋습니다. 또한 iOS와 Android용 모바일 앱이 있어 로컬 인스턴스와 동기화할 수 있으므로 휴대전화에서 저장한 모든 내용이 데스크톱에도 표시되고 그 반대도 마찬가지입니다.

Chrome, Linkwarden 또는 Omnivore에서 기존 북마크를 가져올 수도 있으므로 전환한다고 해서 처음부터 시작해야 하는 것은 아닙니다. 브라우저의 북마크와 Karakeep를 자동으로 동기화하고 싶다면 Floccus도 이를 처리합니다.

AI 태깅과 전체 텍스트 검색은 내가 사물을 찾는 방식을 바꿨다

Karakeep은 북마크를 자동으로 태그합니다

책갈피에 수동으로 태그를 달기는 너무 번거로워서 대부분의 사람들은 생략합니다. 저도 그랬습니다. Karakeep은 AI를 사용하여 이를 자동으로 처리합니다. 무언가를 저장할 때마다, 내용물을 분석하여 관련 태그를 스스로 생성합니다. 예를 들어, Excel 수식에 대한 튜토리얼을 저장하면 '스프레드시트'와 '생산성'과 같은 용어로 태그를 달아줍니다.

저장된 각 항목에 대한 간단한 요약도 생성합니다. 이는 수십 개의 북마크를 스크롤하면서 특정 기사가 무엇을 다루었는지 기억하지 못할 때 유용합니다. 요약은 다시 확인할지 아니면 넘어갈지를 결정하는 데 충분한 정보를 제공합니다.

AI 태깅을 사용하려면 두 가지 옵션이 있습니다. 가장 쉬운 방법은 OpenAI API 키를 .env 파일에 추가하는 것입니다:

  1. platform.openai.com에서 OpenAI의 플랫폼으로부터 API 키를 받으세요.
  2. Karakeep 폴더에 있는 .env 파일을 열고 OPENAI_API_KEY=sk-your-key-here 라인을 추가하세요.
  3. PowerShell에서 docker compose up -d를 실행하여 Karakeep를 재시작하세요.

Karakeep은 기본적으로 GPT-4.1 미니 모델을 사용하기 때문에 비용은 최소화됩니다. 따라서 몇십 개의 북마크에 태그를 붙이는 정도는 청구서에 거의 영향을 주지 않습니다. 데이터를 OpenAI에 보내고 싶지 않다면, Ollama를 사용하면 AI 모델을 로컬에서 무료로 실행할 수 있습니다. ollama.com에서 설치한 후, 터미널에서 ollama pull llama3.1 및 ollama pull llava를 실행하여 필요한 모델을 가져오세요.

OpenAI 키 대신 .env 파일에 다음 줄을 추가하세요: OLLAMA_BASE_URL=http://host.docker.internal:11434, INFERENCE_TEXT_MODEL=llama3.1, INFERENCE_IMAGE_MODEL=llava. Karakeep를 시작하기 전에 Ollama가 실행 중인지 확인하세요.

Karakeep를 브라우저 즐겨찾기보다 사용하게 만드는 또 다른 기능은 Meilisearch가 제공하는 전체 텍스트 검색입니다. 제목이 아니라 저장한 모든 페이지의 실제 내용을 검색하는 것입니다. 기사에서 특정 문구는 기억하지만 이름을 잊어버렸다면, 이를 입력하기만 하면 Karakeep가 찾아줍니다.

태그에 따라 항목을 특정 목록으로 자동 분류하는 것과 같은 자동화된 워크플로우를 설정하기 위한 규칙 기반 엔진도 있습니다. 나는 아직 깊이 탐구해보지는 않았지만, 조직을 보다 세밀하게 제어하고 싶다면 사용할 수 있습니다.

셀프 호스팅은 내 데이터를 내 관리 하에 둡니다

내 즐겨찾기는 내 컴퓨터에 있습니다

제가 클라우드 기반 대안 대신 Karakeep를 선택한 주요 이유 중 하나는 제 북마크가 제 기기에 그대로 남아 있기 때문입니다. 또한, 제3자 서버가 데이터를 저장하는데, 이는 Mozilla가 Pocket을 종료했을 때 정확히 일어난 일입니다.

Karakeep는 AGPL 라이선스 하에 오픈소스로 제공되므로 코드가 투명하며 GitHub에서 활발히 관리됩니다. 명확히 하자면, 자체 호스팅한다고 해서 책상에만 붙어 있어야 하는 것은 아닙니다. 서버는 PC에서 로컬로 실행되지만 iOS와 Android 앱은 네트워크를 통해 서버에 연결됩니다. 컴퓨터가 켜져 있는 한, 휴대폰에서도 북마크에 접근할 수 있습니다. 집 외부 네트워크에서 접근하려면 Tailscale과 같은 도구를 사용하면 기기를 인터넷에 노출하지 않고 안전한 터널을 만들 수 있습니다.

이 중 어느 것도 마음에 들지 않고 Docker를 완전히 건너뛰고 싶다면 Karakeep은 cloud.karakeep.app에서 관리형 클라우드 옵션도 제공합니다. 자체 호스팅의 이점은 잃게 되지만 나머지는 모두 동일하게 작동합니다.

관련기사