Karakeep 사용법: 링크 세 개를 저장하고 다시 찾아보기
공식 문서 링크 세 개로 Save, Manual List, 검색 조건과 AI 태그 확인을 배워요. 메뉴·설정 파일·예상 결과·문제 해결을 함께 설명해요.
마지막 업데이트
메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.

오늘은 공식 문서 링크 세 개를 저장하고 reading-test 목록에서 다시 찾는 것까지 해볼게요. 결과를 확인하기 쉬운 공개 문서로 시작하고, 개인 자료나 결제는 필요 없도록 구성했어요.
v0.34.1 소스와 공식 문서에 근거한 따라 하기예요. 이 환경에는 Docker가 없어 서비스를 직접 실행하지 못했어요. 따라서 아래 검색 결과와 태그 설명은 예상 결과이며 실제로 얻은 출력은 아니에요. 읽기 전용 공개 데모에서는 저장과 목록 생성이 막혀 있으니, 자기 Karakeep 인스턴스에서 진행해 주세요.
1. 저장할 장소부터 준비해요
이미 운영 중인 Karakeep이 있다면 그 주소에 로그인하고 다음 단계로 가세요. 새로 시작한다면 공식 Docker 설치 안내에서 Docker와 Docker Compose를 준비한 뒤, 별도 karakeep-app 폴더에 공식 docker-compose.yml을 저장해요. 이번 자료의 기준 버전은 2026년 10월 22일의 v0.34.1이에요.
그 폴더의 .env에는 KARAKEEP_VERSION=0.34.1, NEXTAUTH_URL=http://localhost:3000과 두 개의 서로 다른 비밀값 NEXTAUTH_SECRET, MEILI_MASTER_KEY가 필요해요. 비밀값은 공식 안내의 생성 방법으로 자기 기기에서 만들고 예시 문장을 그대로 쓰지 마세요. 여기에는 실제 키를 넣거나 공개 저장소로 올리지 않아요.
| 파일·저장 위치 | 하는 일 |
|---|---|
| docker-compose.yml | 웹앱·브라우저 수집기·검색 서비스의 실행 관계를 정해요 |
| .env | 버전, 서비스 주소, 비밀값과 선택한 AI 연결을 정해요 |
| data 볼륨 | 앱이 사용하는 데이터를 지속해서 보관해요 |
| meilisearch 볼륨 | 검색 서비스 데이터를 보관해요 |
공식 Compose 구성은 볼륨을 연결해요. 터미널의 실행 명령과 자료 저장 위치는 다르므로 폴더를 닫는 것과 저장 데이터를 지우는 것을 혼동하지 마세요. 설정을 맞춘 폴더에서 docker compose up -d를 실행하고 브라우저로 서비스 주소를 열면 Sign In 화면이 나오는 것이 예상 흐름이에요. 화면에 제공되는 가입 경로로 본인 계정을 준비하세요. 새 서버를 외부에 공개하는 설정은 이번 작업에 포함하지 않아요.
2. 링크를 한 개씩 저장해요
영문 UI 기준으로 Home → NEW ITEM 입력란에 아래 주소를 하나씩 붙여 넣고 Save를 누르세요. 한 번에 여러 줄을 붙여 넣는 경우의 가져오기 대화상자까지 섞지 않도록, 처음에는 한 개를 저장한 뒤 다음 주소로 넘어가요. 버튼 표기는 확인한 영문 UI 문자열을 기준으로 했어요.
https://docs.karakeep.app/using-karakeep/bookmarking/
https://docs.karakeep.app/using-karakeep/lists/
https://docs.karakeep.app/using-karakeep/tags/
예상 결과는 서로 다른 저장 항목 세 개예요. 카드를 열어 URL의 마지막 경로가 각각 bookmarking/, lists/, tags/인지 확인해요. 제목이나 미리보기 그림은 페이지를 수집한 시점에 따라 달라질 수 있어, 똑같은 그림이 나오는지를 성공 기준으로 잡지 않아요. 저장 항목의 종류
공개 데모에서 Save가 비활성화되거나 수정 불가 안내가 보이면 저장 기능의 고장으로 판단하지 마세요. 공식 README가 데모를 읽기 전용이라고 명시해요. 실제 작업은 수정 가능한 자기 계정에서 이어가야 해요. 데모 제한
3. reading-test라는 수동 목록을 만들어요
왼쪽 All Lists → New List를 열고 이름에 reading-test를 입력해요. List Type은 Manual List를 골라 Create로 만드세요. 처음에는 Smart List를 고르지 않아요. 수동 목록은 직접 넣은 항목을 묶고, 스마트 목록은 저장한 검색 조건에 맞는 항목을 자동으로 모으는 방식이에요. 목록 설명 · 목록 생성 화면 소스

각 북마크 카드의 … → Manage Lists를 열어 reading-test를 선택하고 Close로 닫아요. 같은 작업을 세 카드에 반복한 뒤 왼쪽 목록에서 세 URL이 모두 들어 있는지 확인해요. 이 선택은 원본 북마크를 복사해서 별도 파일을 만드는 작업이 아니에요. Manage Lists 동작
목록을 공개하는 기능도 있지만 이 연습에는 필요하지 않아요. 공유 설정에서 Public을 켜거나 협업자를 초대할 이유는 없어요. 공식 예제 그림에 Public 목록이 보이는 것은 개발자의 시연 구성이지 따라 켜야 하는 항목이 아니에요.
4. 검색창에 한 조건씩 넣어봐요
먼저 상단 Search에서 Keyword 모드를 기준으로 아래 조건을 입력해요. 목록 이름과 URL 일부가 정확히 정해져 있어, 모델이 어떤 태그를 만들어 주는지와 관계없이 확인할 수 있는 검색이에요. 검색 문법
list:reading-test
자기 목록에 넣은 세 문서가 포함되는 것이 예상 결과예요. 이미 다른 자료가 많다면 전체 검색 결과가 언제나 세 개라고 단정하지 말고, 해당 목록에 무엇을 넣었는지부터 확인하세요. 이어서 범위를 더 좁혀요.
list:reading-test url:using-karakeep/tags
이제 찾으려는 항목은 태그 설명서예요. 카드의 원래 URL을 열어 Tags 설명 페이지로 연결되는지 확인해 주세요. list:는 목록 이름, url:은 주소에 포함된 글자를 조건으로 쓰는 문법이고, 공백으로 나란히 적으면 두 조건을 함께 적용해요. 단어 몇 개를 자연어로 썼을 때의 의미 검색 정확도를 측정하는 실험과는 달라요.
5. AI 태그는 작은 입력에서 따로 확인해요
여기까지 되면 선택적으로 AI 연결을 확인해요. 셀프 호스팅에서는 OpenAI 호환 제공업체나 Ollama를 설정할 수 있어요. 모델 연결이 없으면 자동 태그는 건너뛰는 것이 문서상 동작이에요. 저장된 링크가 보인다는 이유만으로 AI도 작동한다고 생각하지 마세요. 모델 설정 · 태그 설정 조건
기존에 구성한 Ollama를 쓴다면 문서의 OpenAI 호환 /v1 경로나 네이티브 경로 중 하나를 골라야 해요. 컨테이너 안에서 localhost는 보통 그 컨테이너 자신을 가리키므로, 다른 곳에서 실행하는 모델 서버에 닿는 주소인지 확인해야 해요. 이 글은 모델을 새로 구매하거나 특정 모델의 한국어 품질을 보장하는 안내는 아니에요.
INFERENCE_ENABLE_AUTO_TAGGING의 문서상 기본값은 true이고 INFERENCE_LANG의 기본값은 english예요. 한국어 태그를 원한다면 언어 설정을 확인하되, 모델이 항상 원하는 표현으로 붙인다고 가정하지 마세요. .env를 바꾸면 공식 안내대로 서비스를 다시 적용해야 해요. 자동 요약은 INFERENCE_ENABLE_AUTO_SUMMARIZATION이라는 별도 설정이며 기본값은 false예요.
연결을 준비한 뒤 새 공개 링크 하나를 더 저장해 처리 결과를 살펴보세요. 왼쪽 Tags의 Your Tags / AI Tags 구분과 저장 항목에 붙은 태그를 확인해요. 자동 태그가 AI, 문서, 설치 중 무엇으로 나와야 한다는 정답은 정하지 않아요. 이 세 링크의 실제 모델 출력은 아직 검증하지 않았어요.

6. 닫았다가 돌아와도 찾을 수 있나요?
브라우저 탭을 닫았다가 같은 서버와 계정으로 다시 접속해 reading-test를 열고, 위 URL 검색을 반복해요. 저장 데이터가 같은 곳에 남아 있는지 확인하는 단계예요. 이것만으로 서버 장애 복구나 백업까지 시험한 것은 아니에요.
별도 메모 파일 reading-test-check.txt에는 세 URL, 목록 이름, 시도한 검색식과 실제로 확인한 결과를 적어 두세요. 이 파일은 사람이 남기는 확인 기록이고 Karakeep이 자동으로 내보낸 백업이 아니에요. 원래 페이지 링크, 저장된 항목, 서버 데이터 백업은 서로 다른 역할을 해요.
| 막힌 부분 | 먼저 볼 곳 |
|---|---|
| 저장 버튼을 못 눌러요 | 읽기 전용 데모인지, 수정 가능한 본인 계정인지 |
| 링크는 있지만 본문이 없어요 | 원본 페이지 접근과 수집 상태, 로그인 요구 여부 |
| 목록 검색에서 빠져요 | 항목의 Manage Lists와 정확한 목록 이름 |
| AI 태그가 없어요 | 모델 연결·네트워크·처리 오류·자동 태그 설정 |
| 태그가 영어로 나와요 | INFERENCE_LANG과 연결 모델의 언어 처리 |
| 앱을 다시 켰더니 자료가 없어요 | 같은 서버·계정인지, 기존 볼륨을 연결했는지 |
완료 기준은 세 URL 저장, 한 목록에서 재확인, 검색으로 Tags 문서 찾기, 재접속 후 다시 찾기예요. AI 태그가 제대로 동작했는지는 별도 항목으로 기록해 주세요. 저장·검색 성공과 AI 분류 성공을 섞지 않으면 어디서 막혔는지 훨씬 선명해져요.
이 도구의 다른 글
참고 자료
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/README.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/LICENSE
- https://github.com/karakeep-app/karakeep/releases/tag/v0.34.1
- https://github.com/karakeep-app/karakeep/releases/tag/v0.34.0
- https://karakeep.app/pricing/
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docs/docs/02-installation/01-docker.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docker/docker-compose.yml
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docs/docs/03-configuration/02-different-ai-providers.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docs/docs/03-configuration/01-environment-variables.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docs/docs/04-using-karakeep/bookmarking.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docs/docs/04-using-karakeep/lists.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docs/docs/04-using-karakeep/tags.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docs/docs/04-using-karakeep/search-query-language.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/docs/docs/05-integrations/03-mcp.md
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/apps/web/lib/i18n/locales/en/translation.json
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/apps/web/components/dashboard/lists/EditListModal.tsx
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/apps/web/components/dashboard/bookmarks/ManageListsModal.tsx
- https://github.com/karakeep-app/karakeep/blob/ebd122bb45b38d9dd45f7c6db55b5587bf6b1265/apps/web/components/dashboard/bookmarks/BookmarkOptions.tsx
- https://support.mozilla.org/en-US/kb/bookmarks-firefox
- https://api.github.com/repos/karakeep-app/karakeep