怎么自托管 Karakeep 0.33 (Linux 2026 实测)

如果你的浏览器书签栏已经变成”以后一定会看”的标签墓地,稍后读队列不
断溢到邮件草稿和便签里,那你大概率已经意识到:自托管书签管理器才是
正解。问题是选哪个。2026 年有一个值得关注的开源新选项 —— Karakeep
(原名 Hoarder)0.33 版,8 月初发布。它能跑在任何装了 Docker 的
Linux 机器上,用 AI 给扔进去的每条内容自动打标签,而且是记忆中第一款
用起来接近 Raindrop.io 或 Pocket 这种商业产品的自托管书签工具。

本文带你走完在 Linux 服务器(以 Ubuntu 26.04 LTS 为基准,任何能跑
Docker 的发行版都行)上安装 Karakeep 0.33.1、从 Chrome / Firefox /
Pocket / Linkwarden / Omnivore / Tab Session Manager 导入已有书签、
配置 AI 标签(用托管 API 或本地 Ollama 模型都行)、以及上 HTTPS
防止 TOTP 令牌泄露的全过程。

图:Karakeep 网页端浅色主题首页。左侧列表栏(Inbox、收藏、自定义列
表),右侧是卡片网格,展示每个链接的标题、描述、AI 标签和缩略图。真实
截图,源自项目官方文档。

Karakeep 到底是什么

Karakeep 是一款 AGPL-3.0 许可的自托管”书签一切”应用,由
karakeep-app/karakeep
GitHub 仓库背后的社区维护,星标数今年早些时候已经突破 28k。核心能
力:

• AI 自动打标签 — 喂给它链接、笔记、PDF 或图片,Karakeep 会调用
  LLM(OpenAI、Anthropic、Gemini、Groq 或本地 Ollama 模型)生成一组
  一致的标签和一段简短的摘要。0.33 版本新增了语义搜索,可以按意
  思而不是标题里的字面词找到书签。
• 全文搜索 + OCR — 每条保存的书签都会被抓取、解析并建索引,包
  括截图和 PDF 里的文字。
• 高亮与批注 — 每条书签可以保存多条高亮并按颜色分类,适合把书
  签当成研究草稿本用。
• 浏览器扩展 — Chrome、Firefox、Safari 全都有,另有 iOS 和
  Android 应用。移动端在 0.33 获得了离线阅读 —— 飞机上也能读
  缓存的文章。
• 批量导入 — 支持 Chrome、Firefox、Pocket、Linkwarden、
  Omnivore、Tab Session Manager。
• REST API + CLI + 官方 agent skill — 可以把 Karakeep 接进任何
  自动化流程。

一句话:Karakeep 就是 Mozilla 没杀死 Pocket 之前 Pocket 应该长成的
样子,而且数据、AI 和存储全归你管。

图:同一首页切换到深色模式。Karakeep 的 UI 是它最”成品”的部分 —— 大
多数自托管书签工具用起来像后台管理界面,这个用起来像正式产品。

硬件和系统要求

Karakeep 本体不算重。Web 端是 Next.js 客户端,背后是 Node.js API,
再后面是 Postgres(可选 Meilisearch 做全文检索)。2026 年的常见
Linux 主机:

如果打算跑本地 Ollama 做 AI 标签(隐私优先方案),再预算 4-8 GB 内存
跑 7B 模型。如果用托管 LLM,Karakeep 服务器本身可以保持轻量。

本文的参考部署跑在一台 Hetzner CX22(4 GB / 2 vCPU)的 Ubuntu 26.04
LTS 上,Ollama 装在同一台机器做本地标签,Meilisearch 和主服务一起
跑在同一个 docker-compose 里。备份通过内置归档 worker 写到
Backblaze B2 桶里。

步骤一:装 Docker,克隆 compose 文件

Karakeep 自带一份官方 docker-compose.yml,把 Web、API worker、
Postgres、Meilisearch 全串起来。最快的安装路径:

sudo apt update
sudo apt install -y docker.io docker-compose-plugin git curl
sudo usermod -aG docker $USER
newgrp docker

然后克隆到稳定路径:

sudo mkdir -p /opt/karakeep
sudo chown $USER:$USER /opt/karakeep
git clone https://github.com/karakeep-app/karakeep.git /opt/karakeep
cd /opt/karakeep

docker-compose.yml 在仓库根目录。复制示例 .env 并编辑:

cp .env.example .env
$EDITOR .env

最少要设置的变量:

• DATA_DIR — Karakeep 存放 SQLite/Postgres 数据、抓取的页面存档、
  上传截图的目录,默认是仓库内的 ./data。服务器上几乎肯定要挪到
  /var/lib/karakeep 之类的位置。
• MEILI_MASTER_KEY — 生成一串随机 32 字节字符串。Meilisearch 实例
  只能在 docker 内部网络访问,但也别留默认值。
• NEXTAUTH_SECRET — 用来签 session cookie,openssl rand -hex 32
  就行。
• OLLAMA_BASE_URL(可选) — 想用本地 AI 标签的话,指向宿主机的
  Ollama,例如 http://host.docker.internal:11434。

步骤二:启动整组服务

在 /opt/karakeep 目录下:

docker compose pull
docker compose up -d
docker compose logs -f web

大约 30 秒后 Next.js 会在 3000 端口启动。访问
http://<server-ip>:3000,Karakeep 会引导你创建第一个用户 —— 这是唯
一能注册新账号的账号,之后所有新账号必须从管理面板邀请。

仓库根目录还提供了一个 karakeep-linux.sh 安装脚本,一行命令搞定
Docker、compose 文件、可选的 systemd unit。如果想省事直接用它也
行,本质上就是上面这些步骤的 shell 封装。

图:单条书签详情面板。注意右侧的 AI 自动生成标签列表(“kubernetes”
、”monitoring”、”homelab”)、高亮区、以及”Archive”按钮。每次回头看一
条保存的链接,你都会重复这个流程。

步骤三:配置 AI 标签

打开 Web UI,点齿轮图标进入 AI。Karakeep 开箱支持:

• OpenAI(gpt-4o-mini 是性价比之选 —— 便宜、标签质量够用)
• Anthropic(claude-haiku,同上)
• Gemini(gemini-1.5-flash)
• Groq(高速 Llama 推理)
• Ollama(本地 —— 完全私有,数据不出本机)
• OpenAI 兼容(任何暴露 /v1/chat/completions 接口的服务 ——
  DeepSeek、OpenRouter、vLLM 等)

隐私优先方案:在宿主机装 Ollama,拉一个 7B 模型,然后让 Karakeep 指
向它:

curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.1:8b-instruct-q5_K_M

Karakeep 的 AI 设置里,Provider 选 “Ollama”,Base URL 填
http://host.docker.internal:11434(也可以用网桥 IP
http://172.17.0.1:11434),Model 填你拉下来的模型名。第一批导入的
书签会比较慢,因为 Ollama 要先把模型热起来,后面就快了。

如果更愿意花钱买托管推理,OpenAI key 配 gpt-4o-mini 是最便宜的
路径。Karakeep 在后台跑标签,即使响应要好几秒也不会卡 UI。

步骤四:从已有书签库导入

Karakeep 内置 Chrome、Firefox、Pocket、Linkwarden、Omnivore、
Tab Session Manager 的导入器。最干净的方式是 Web UI 内操作:
Settings → Import → 选来源,把导出的 HTML/JSON 文件拖进去,确定。

Chrome:打开 chrome://bookmarks,进管理器,点右上角三点菜单选
“Export bookmarks”,把生成的 bookmarks.html 拖进导入器。

Firefox:Bookmarks → Show All Bookmarks → Import and Backup → Backup…

Pocket:2026 年 Pocket 的 CSV 导出只对付费用户开放,但 Karakeep 社区
有个小脚本能从 Pocket 的官方 API 导出(Pocket 关闭账号前通过删除
表单申请)。

每条导入的书签,Karakeep 会:

1. 抓取 URL,提取标题、描述、og:image。
2. 如果是图片就跑 OCR。
3. 把内容送进你选的 LLM,生成标签和一句话摘要。
4. 存进 Postgres,把内容排进 Meilisearch 索引队列。

导入 500 条书签,在一台中规中矩的机器上,即使让 Ollama 跑标签,十
分钟左右基本就完事了。

图:导入 500+ 条书签后,你的”全部标签”页就长这样。每个标签是带颜色
的圆角色块,右侧数字是该标签下的书签数,顶部搜索框能让你折叠到只看
自己真正常用的标签。

步骤五:装浏览器扩展

Karakeep 给三大浏览器都出了官方扩展:

• Chrome:在
  Chrome Web Store
  安装。
• Firefox:在
  Mozilla Add-ons
  安装。
• Safari:扩展打包在 iOS app 里。

装好后点工具栏的 Karakeep 图标,填入服务器地址(例如
https://karakeep.example.com),用 Settings → API Tokens 里生成的
token 验证。以后保存书签就一键 —— 扩展还会做”已存在?”检查,批量导
入也不会产生重复。

步骤六:加固部署

把 Karakeep 暴露到公网之前,有几件事得做:

1. 套反向代理 + HTTPS。Caddy 是 2026 年最简单的方案 —— 10 行
   Caddyfile 搞定自动 Let’s Encrypt 证书和 HTTP/3。
2. 配备份。DATA_DIR 和 Postgres 卷是仅有的不可替代数据。一
   晚一次 pg_dump 加一次 DATA_DIR 快照就够了,都扔到启用了版本
   控制的 Backblaze B2 桶。
3. 关闭公开注册。默认第一位用户是 admin,其他人都要邀请,别
   改这个。
4. 需要的话开 SSO。Karakeep 支持 OIDC,可以接到 Authentik、
   Keycloak 或 Google Workspace。
5. 轮换密钥,如果你曾不小心把 .env 提交到仓库的话。
   MEILI_MASTER_KEY 和 NEXTAUTH_SECRET 是最关键的两个。

结论:2026 年还值得自托管 Karakeep 吗?

Karakeep 0.33 是我记忆中第一款用起来像”成品”而不是”凑合用的后台”
的自托管书签管理器。AI 标签是真有用 —— 导入一批积灰好几年的链接后,
我开始能按主题(“二月份收藏的那个 kubernetes operator”)而不是字面
词找到它们。深色 UI 是这个品类里我见过最干净的。

注意事项:

• 成熟度。Karakeep 0.33 仍是 0.x 版本,备份和升级偶尔需要手动
  介入,升级前看 release notes。
• AI 成本或算力。托管 LLM 给 1000 条书签打标签,每月只要几美分
  OpenAI 账单。本地 Ollama 多吃几 GB 内存。
• 移动 app。iOS 和 Android 都能用,但 95% 的时间你还是会待在
  Web UI 里。

如果你一直在等一款自托管的 Pocket 替代,今天就装吧。官网
karakeep.app,源码在
github.com/karakeep-app/karakeep,
本文截图出自的文档站是
docs.karakeep.app。不想自己托管的话,
同一团队也开了托管云服务
cloud.karakeep.app,订阅收入直接反哺
开发。