Karakeep：自托管网页内容管理与自动化工具部署指南

前言

浏览器收藏夹有个规律：存得越多，越找不到。

找了半天没找到那篇文章，又去 Google 搜一遍 —— 结果搜到的就是你半年前收藏的那个链接。

Karakeep 是开源的网页内容管理工具。你把链接丢进去，它帮你存下来、打标签、建索引。下次想找的时候，全文搜索秒出结果。

Karakeep 做什么

核心能力就三个：

  1. 收藏链接：浏览器扩展或手动添加
  2. AI 自动打标签：接 OpenAI 或 Ollama，自动分析内容生成标签
  3. 全文搜索：内置 Meilisearch，搜标题、描述、标签、正文

跟 Linkding 的区别在于：Linkding 是轻量书签管理器，Karakeep 更偏向「网页内容管理」—— 它会抓取网页正文存档，支持 AI 自动分类，适合构建个人知识库索引。

Docker 部署

所有参数通过环境变量配置，不需要配置文件：

services:
  karakeep:
    image: ghcr.io/karakeep/karakeep:latest
    container_name: karakeep
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    environment:
      NEXTAUTH_URL: https://karakeep.yourdomain.com
      NEXTAUTH_SECRET: your-secret-key
      DATA_DIR: /data
      # OAuth — 至少配一个
      AUTH_GITHUB_ID: your-github-client-id
      AUTH_GITHUB_SECRET: your-github-secret
7 collapsed lines
      # AI 自动标签（可选）
      OPENAI_API_KEY: sk-xxx
      # Meilisearch（可选，默认用内置搜索）
      MEILI_ENABLED: "true"
      MEILI_URL: http://meilisearch:7700
      MEILI_MASTER_KEY: your-meili-key
    restart: unless-stopped

Meilisearch 可选

默认用 SQLite 做搜索，数据量大了会慢。加一个 Meilisearch 容器：

  meilisearch:
    image: getmeili/meilisearch:latest
    volumes:
      - ./meili_data:/meili_data
    environment:
      MEILI_MASTER_KEY: your-meili-key
    restart: unless-stopped

AI 自动标签

Karakeep 支持接入 AI 模型自动分析收藏的文章内容并打标签。支持：

  • OpenAI（ChatGPT）
  • Ollama（本地模型）
  • 任何 OpenAI 兼容 API

配置了 OPENAI_API_KEY 后，每次新增链接会自动调用 AI 生成标签。不想用 AI 也可以手动打标签，或者两者结合。

浏览器扩展

Karakeep 提供了浏览器扩展（Chrome / Firefox），看到想收藏的页面点一下就行。支持选择收藏到哪个列表、添加备注。

总结

Karakeep 适合「不只是想存链接，还希望 AI 帮忙整理」的场景。AI 标签 + Meilisearch 全文搜索的组合，让你收藏的网页从「存了找不到」变成「搜一下就有」。

Docker Compose 两条命令部署，接上 GitHub OAuth 就能用。比 Linkding 重一些，但功能也多不少 —— 选哪个取决于你愿不愿意花多 5 分钟配置。