跳至主要内容

Hoarder (Karakeep)：AI 驅動的書籤與筆記收集工具

Hoarder 是一款專為資訊收集者設計的現代化自託管書籤應用。它不只是一個單純存網址的工具，而是能自動爬取網頁全文、拍攝完整網頁快照，並透過 AI（支援本地 Ollama 或 OpenAI）自動替你的書籤打上標籤與生成摘要。

主要特色​

  1. AI 自動標籤與摘要：儲存網址或圖片時，AI 會自動辨識內容主題並自動上 Tag，省去手動分類的繁瑣。
  2. 全文存檔與離線閱讀：透過內建的 Headless Chrome 自動將網頁內容轉為乾淨的閱讀模式並保存全文快照，即使原網頁下架依然能閱讀。
  3. 極速全文檢索：整合 Meilisearch 搜尋引擎，支援在毫秒內全文檢索標題、筆記、網頁內文與 PDF。
  4. 多端收集擴充：支援 iOS / Android App 與 Chrome / Firefox 瀏覽器擴充套件，在手機或電腦上一鍵收藏。

部署步驟 (Docker Compose)​

Hoarder 由 Web 主程式、Chrome 快照渲染引擎與 Meilisearch 搜尋引擎組成。

1. 建立目錄​

sudo mkdir -p /opt/stacks/hoarder/data /opt/stacks/hoarder/meilisearch
cd /opt/stacks/hoarder

2. 建立 .env 環境變數​

# 產生一組隨機 Secret (openssl rand -base64 36)
NEXTAUTH_SECRET=請替換為隨機字串

# 網頁存取網址 (若有反向代理請填寫實際網址，如 https://hoarder.yourdomain.com)
NEXTAUTH_URL=http://localhost:3000

# 產生 Meilisearch 主金鑰 (openssl rand -base64 36)
MEILI_MASTER_KEY=請替換為隨機金鑰字串

# 關閉公開註冊 (建立首位管理員後建議設為 true)
DISABLE_SIGNUPS=false

# --- AI 推論設定 (以本地 Ollama 為例) ---
OLLAMA_BASE_URL=http://192.168.1.10:11434
INFERENCE_TEXT_MODEL=gemma2:latest
INFERENCE_IMAGE_MODEL=llava:latest
INFERENCE_LANG=traditional-chinese
INFERENCE_JOB_TIMEOUT_SEC=60

# 若使用 OpenAI API，可改填以下：
# OPENAI_API_KEY=sk-...

3. 建立 compose.yaml​

services:
  web:
    image: ghcr.io/hoarder-app/hoarder:release
    container_name: hoarder-web
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    env_file:
      - .env
    environment:
      MEILI_ADDR: http://meilisearch:7700
      BROWSER_WEB_URL: http://chrome:9222
      DATA_DIR: /data
    depends_on:
      - meilisearch
      - chrome

  chrome:
    image: gcr.io/zenika-hub/alpine-chrome:123
    container_name: hoarder-chrome
    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.6
    container_name: hoarder-meilisearch
    restart: unless-stopped
    env_file:
      - .env
    environment:
      MEILI_NO_ANALYTICS: "true"
    volumes:
      - ./meilisearch:/meili_data

4. 啟動服務​

sudo docker compose up -d

初始設定​

  1. 在瀏覽器前往 http://<VM_IP>:3000。
  2. 註冊第一組管理員帳號。
  3. 登入後至系統設定確認 AI 推論連線狀態，並可安裝瀏覽器擴充功能開始收藏網頁。

相關連結​