跳至主要內容

Karakeep（原 Hoarder）：AI 书签与稍后阅读

约 761 字大约 3 分钟...

Karakeep（原名 Hoarder）是一款自托管的书签与稍后阅读工具，支持链接、笔记、图片收藏，内置 AI 自动打标和全文搜索，适合作为个人知识库。

改名说明 项目因命名冲突于 2025 年从 Hoarder 改为 Karakeep，GitHub 仓库迁移至 karakeep-app/karakeep，Docker 镜像改为 ghcr.io/karakeep-app/karakeep。旧镜像 ghcr.io/hoarder-app/hoarder-web 已停止更新，建议尽快迁移。官方迁移指南见 https://docs.karakeep.app/guides/hoarder-to-karakeep-migration/。

Docker Compose 部署

推荐通过 Docker Compose 部署 Karakeep，详情请见 Docker Compose 部署教程。新版简化为 3 个服务（Web / Chrome / Meilisearch）：

services:
  web:
    image: ghcr.io/karakeep-app/karakeep:${KARAKEEP_VERSION:-release}
    restart: unless-stopped
    volumes:
      - data:/data
    ports:
      - 23000:3000
    env_file:
      - .env
    environment:
      MEILI_ADDR: http://meilisearch:7700
      BROWSER_WEB_URL: http://chrome:9222
      DATA_DIR: /data
      # OPENAI_API_KEY: ...
  chrome:
    image: gcr.io/zenika-hub/alpine-chrome:124
    restart: unless-stopped
    command:
      - --no-sandbox
      - --disable-gpu
      - --disable-dev-shm-usage
      - --remote-debugging-address=0.0.0.0
      - --remote-debugging-port=9222
      - --hide-scrollbars
  meilisearch:
    image: getmeili/meilisearch:v1.41.0
    restart: unless-stopped
    env_file:
      - .env
    environment:
      MEILI_NO_ANALYTICS: "true"
    volumes:
      - meilisearch:/meili_data

volumes:
  meilisearch:
  data:

.env 至少需要这些变量（全部建议用随机字符串）：

NEXTAUTH_SECRET=生成的随机字符串
MEILI_MASTER_KEY=生成的随机字符串
NEXTAUTH_URL=http://你的服务器IP或域名:23000
# OPENAI_API_KEY=sk-...   # 可选，启用 AI 打标时填

部署完成后访问 http://<你的服务器 IP 或域名>:23000 即可使用。

浏览器扩展

官方 Chrome 扩展已同步更名为 Karakeep，地址不变：

https://chromewebstore.google.com/detail/karakeep/kgcjekpmcjjogibpjebkhaanilehneje

从 Hoarder 旧版迁移

  1. 停止旧容器：docker compose down
  2. 将 compose 文件中的镜像替换为 ghcr.io/karakeep-app/karakeep（原 hoarder-app/hoarder-web + hoarder-app/hoarder-workers 合并成单容器）
  3. 删除 redis 与 workers 两个服务段（新版不再需要 Redis 和独立 Workers）
  4. 数据卷保持不变，运行 docker compose up -d 即可完成迁移

详细迁移步骤与兼容性说明见官方文档：https://docs.karakeep.app/guides/hoarder-to-karakeep-migration/

最近更新: