Karakeep | 开源书签归档 – 全文搜索与网页存档 – Docker自托管

Karakeep 是可自托管的书签、稍后阅读与网页归档工具,前身为 Hoarder。它能保存链接、笔记、图片和 PDF,把内容抓取下来供后续阅读与搜索,也提供浏览器扩展、移动端和 REST API。项目采用 AGPL-3.0 许可,适合想长期积累资料、并愿意维护自己服务器的用户。

Karakeep 开源书签归档与全文搜索工具封面

它解决的不只是“网址放在哪里”,还有收藏之后如何找回,以及原网页失效后还能留下什么。全文搜索、归档和可选 AI 各自依赖不同组件,部署时要按真正需要的能力取舍。

保存地址与保存内容,是两回事

普通书签保留网址,原站点删除文章或改变访问方式以后,链接可能仍在,内容却已经看不到。Karakeep 可以抓取标题、描述和正文,并通过 Monolith 做完整页面归档,降低只留一个 URL 的脆弱性。截图适合保留视觉状态,网页副本则更适合后续阅读;两者用途不同,也都会增加磁盘占用。

抓取不是任何网页都能成功。动态加载、访问限制或登录状态都可能影响结果。导入一份研究清单后,应挑选静态文章和依赖脚本的页面分别查看保存结果,不能只凭收藏卡片出现就判断正文已完整归档。归档也不会改变原作者的版权和使用条件。

列表负责归组,标签负责交叉查找

例如准备一篇摄影教程,可以用“选题资料”列表集中收集相关内容,再用“光线、镜头、后期”标签跨列表查找。这是整理方式示例,不必把每个目录名都再做成同名标签。列表可以与别人共同维护,适合小范围协作收集资料。

全文搜索的价值,在于忘记标题后还能通过正文线索找回文章;划线与笔记则帮助留住“为什么收藏”。AI 自动标签和摘要是可选辅助,接入 OpenAI 或本地 Ollama 后才能使用相应能力。若已经有稳定的标签习惯,先保留人工分类,再看自动结果是否减少整理工作。

完整部署与精简部署会差在哪里

组件负责的能力省略后的变化
Karakeep 主服务收藏、列表、标签、账户及数据管理必须运行
Meilisearch搜索精简安装文档明确说明:不配置会关闭搜索
Chrome 抓取组件动态页面抓取和网页截图仍能进行部分抓取,但不能截图,脚本生成内容不能正确抓取
OpenAI / Ollama可选 AI 标签与摘要不配置模型可继续使用其他收藏功能

如果主要看中搜索正文和保留网页,完整安装更符合目标。只需要收集与人工整理,又受到机器资源限制时,可以选择精简安装,但应接受对应能力缺失。减少容器数量时,要确认保留了最需要的功能。

Docker 起步时先设置地址和持久化数据

官方 docker/docker-compose.yml 已连接主服务、Chrome 和 Meilisearch,并为主数据与搜索数据挂载卷。在已安装 Docker Compose 的环境里,把该文件放到独立目录,同目录创建 .env,按下面的顺序完成配置:

  1. 设置 KARAKEEP_VERSION。release 跟随稳定镜像,长期实例可选择已核对的具体标签来控制升级。
  2. 分别生成随机的 NEXTAUTH_SECRET 与 MEILI_MASTER_KEY,不要沿用说明中的示例字符串。
  3. 把 NEXTAUTH_URL 改成真实访问地址。正式域名使用 HTTPS;需要更严格的登录来源限制时,再按配置文档设置 AUTH_TRUSTED_ORIGINS。
  4. 在文件所在目录运行 docker compose up -d,打开实例,先建立自己的账户,再设置 DISABLE_SIGNUPS=true 限制后续注册,并重建服务使配置生效。
  5. 导入少量书签,确认抓取、搜索和附件保存符合需求后,再迁移大量资料。

调整宿主机存储位置时,改卷映射即可,容器内 DATA_DIR=/data 按官方配置保留。升级前保存主数据、归档附件及配置,并按文档处理搜索服务的版本变化。只留 Compose 文件可以重建程序,不能找回已丢失的收藏。

抓取服务会从自己的服务器访问网址

用户提交的 URL 会触发服务端访问。不受信任用户可能借此探测内网服务、消耗抓取资源,或通过自己控制的网站看见服务器的出口 IP。项目提供基础 SSRF 防护,但安全文档明确指出它只缓解部分风险;站点前方的 CDN 也不会隐藏服务器主动访问外站的出口。

个人实例限制为可信用户使用,团队则按需求隔离抓取网络或采用受限代理。AI 若使用外部提供商,参与处理的资料还会交给该服务,应按内容敏感程度选择。大量归档前,也要规划保留周期和异地备份,避免收藏越来越多却无法恢复。

要改页面和抓取流程,项目中的 apps/web 与 apps/workers 是不同入口;部署组件关系则看 docker/docker-compose.yml。先分清问题发生在保存、抓取还是搜索,再进入对应部分,更容易定位问题。

  • 项目仓库:https://github.com/karakeep-app/karakeep
  • Docker 安装说明:https://docs.karakeep.app/Installation/docker
  • 配置与安全说明:https://docs.karakeep.app/security-considerations
Karakeep | 开源书签归档 - 全文搜索与网页存档 - Docker自托管 - 杂货喵
Karakeep | 开源书签归档 – 全文搜索与网页存档 – Docker自托管
此内容为免费资源,请登录后查看
0积分
发布平台GitHub
编码语言TypeScript
支持语言中文等多语言
项目版本0.32.0
开源许可AGPL-3.0
运行方式Docker
免费资源
© 版权声明
THE END
喜欢就支持一下吧
点赞4 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容