Karakeep｜自托管AI书签系统保姆级教程

前言

是不是你的浏览器收藏夹早已堆满各类网页、教程、工具链接，却常年处于“收藏即吃灰”的状态？想要找往期保存的资料，只能翻遍密密麻麻的书签列表，耗时又费力。更让人头疼的是，很多珍藏的优质网页会遭遇删帖、链接失效、404打不开的问题，辛苦留存的学习资料、干货素材，转眼就彻底丢失，再也无法查阅。

普通浏览器书签、云端收藏工具功能单一，没有智能分类、没有内容检索、无法永久存档，而且数据托管在第三方平台，存在隐私泄露、数据丢失的风险。如果你想要一套完全私有化、可永久存档、AI智能管理的个人资料收纳系统，那 Karakeep 绝对是最优选择。

Karakeep（原 Hoarder）是一款开源轻量的自托管AI书签与网页归档工具，区别于传统书签工具，它不仅能一键保存网页、PDF、图片、视频链接，还自带AI自动摘要、智能打标、全文检索、图片OCR识别、网页快照永久存档等实用功能。搭配本地大模型使用，还能实现离线智能解析，所有数据本地化存储，完全掌控个人知识资产。

无需复杂配置，本次教程给大家带来零门槛保姆级Docker部署方案，适配服务器、NAS、Linux等各类设备，从环境准备、容器部署、基础配置到AI功能联动，一步不落地手把手教学，新手也能轻松搭建专属私人AI知识库，彻底告别链接失效、收藏杂乱的痛点。

image-20260917154051591

1.Karakeep是什么？

Karakeep（原名Hoarder）是一款开源、支持自托管的AI全能书签归档工具，采用AGPL-3.0协议，主打 “万物收藏”，可以把链接、笔记、图片、PDF统一收纳，搭配AI自动完成摘要、打标签，解决网页链接失效、收藏资料难以检索的痛点。

✨ 核心特性

  1. 多类型内容存储 不止网页链接，支持保存文字笔记、图片、PDF；还能自动抓取网页封面、标题与简介，生成卡片式预览。内置网页快照归档（Monolith），永久保存网页，防止原站删帖、404死链；支持yt-dlp自动存档视频。
  2. AI智能处理（亮点） 接入大模型自动生成内容摘要、智能打标签；支持两种方案：OpenAI API，或者本地Ollama离线AI，数据完全不出本地。图片自带OCR识别，提取图片内文字，配合Meilisearch实现全文检索 + 语义搜索，搜内容而不是只搜标题Karakeep。
  3. 多端快速收藏Chrome/Firefox/Safari浏览器插件一键保存；配套安卓、iOS移动端 App；提供REST API、RSS 订阅导入，还能从Pocket、Linkwarden、Chrome书签批量迁移旧收藏Karakeep。
  4. 私有化部署 原生支持Docker Compose一键部署，跑在服务器、NAS上。所有资料保存在你自己的设备，数据完全自主可控，没有第三方平台限制，适合自建个人知识库。

📌 适用场景

适合开发者、技术爱好者、知识收集党，用来沉淀教程、文章、素材；也可以作为个人第二大脑，长期管理学习资料、技术文档。

简单一句话总结：Karakeep ≈ 私有化Pocket + AI标签 + 网页永久归档 + 全文检索知识库

2.安装前提条件

2.1ssh远程连接到飞牛

  • 开启【SSH 服务】
  • 使用终端（Windows PowerShell / Mac Terminal）登录：

在设置—>SSH中开启SSH服务：

463c5f2aa280d7887420494b8b8f852e

27abe7f94baeaebc1738b60b1ba78933

e16c7480a399e50f627439329422c5a7

2.2验证docker是否开启

使用命令：

docker -v 
systemctl status -v

也可以直接在飞牛主页查看（其他机器也是这样的哦~）

bc2a0952beed8ca143a171bb000b2b23

3.安装Karakeep

首先创建一下安装的目录并进入到该目录：

mkdir -p /docker/Karakeep
cd /docker/Karakeep

image-20260917144420362

从网页上下载官方 docker-compose.yml文件：

wget https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml

image-20260917144521962

查看 docker-compose.yml文件：

配置项替换说明

  1. 端口：8088 与 NEXTAUTH_URL 端口保持同步。例：NAS IP 192.168.10.2，端口改为 9999，则 NEXTAUTH_URL=http://192.168.10.2:9999，该地址为 Karakeep 内网访问地址。
  2. MEILI_MASTER_KEY：配置两处，执行 openssl rand -base64 36 生成，两处值必须一致。
  3. NEXTAUTH_SECRET：openssl rand -base64 36 生成，密钥独立，不要和 Meilisearch 密钥相同。
  4. /path/to/your/karakeep：替换为 NAS 上存放 Karakeep 数据的文件夹完整路径。
  5. /path/to/your/melisearch：替换为 NAS 上存放 Meilisearch 索引数据的文件夹完整路径。
openssl rand -base64 36

image-20260917144843025

services:
  karakeep:
    image: ghcr.io/karakeep-app/karakeep:release
    restart: unless-stopped
    ports:
      - 8088:3000
    volumes:
      - /path/to/your/karakeep:/data
    environment:
      - DATA_DIR=/data
      - MEILI_ADDR=http://meilisearch:7700
      - MEILI_MASTER_KEY=random_meli_key
      - BROWSER_WEB_URL=http://chrome:9222
      - NEXTAUTH_URL=http://192.168.x.y:8088
      - NEXTAUTH_SECRET=another_random_key
    depends_on:
      - meilisearch
      - chrome
  meilisearch:
    image: getmeili/meilisearch:v1.13.3
    restart: unless-stopped
    volumes:
      - /path/to/your/meilisearch:/meili_data
    environment:
      - MEILI_MASTER_KEY=random_meli_key
      - MEILI_NO_ANALYTICS=true
  chrome:
    image: ghcr.io/zenika/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

启动容器：

docker compose up -d

image-20260917150426520

验证容器状态：

docker ps

image-20260917150547031

部署完成后，在浏览器中输入 http://飞牛IP:8081 就能看到Karakeep的界面：

f176fdfc1ee3c06404c5d2966265edee

4.使用Karakeep

打开完成后，我们先注册一个用户，然后登录：

30a7d6e8a9ea152fe0f37b8110c42881

登录成功：

image-20260917151706321

Karakeep 的主界面采用清爽卡片式布局，左侧是导航菜单，包含首页、搜索、标签、亮点、档案等功能入口；页面上方为全局搜索框，可以检索标题、文本、网址与标签。图中红框标出新项目输入框，支持粘贴网页链接、书写便签或者直接上传图片，填写完成后点击保存即可快速新建收藏条目，所有收藏内容会以卡片形式展示在页面主体区域，直观预览网页封面、标题与来源信息。

image-20260917153705532

Karakeep的标签管理页面，左侧导航栏选中「标签」菜单。页面将标签分为三大板块：你的标签（手动添加、已经挂载到书签上的标签）、AI标签（由AI自动生成并附加的标签）、未使用标签（已经创建但还没有关联任何书签的标签）。页面右上角支持新建标签、批量编辑、拖拽合并标签，还可以对标签进行搜索与排序，方便统一管理所有收藏内容，实现资料的归类整理。

image-20260917153849445

Karakeep 的档案页面，左侧导航栏选中「档案」选项。档案区用于存放归档封存的收藏内容，页面同样提供新项目输入框，可以粘贴链接、撰写便签或者上传图片，添加后保存到档案库，适合存放长期封存、不再日常浏览的资料，和首页活跃收藏做区分，实现资料分层管理。

image-20260917153929460

Karakeep 的「所有列表（All Lists）」英文界面，左侧导航栏选中 Lists 分类。页面展示内置的两个固定列表：Favourites（最爱），用于存放需要反复查阅的收藏；Archive（档案），作为冷存储归档库，存放不常访问的资料。右上角点击New List，可以自定义创建更多收藏列表，实现书签的分组管理，满足多样化的资料归类需求。

image-20260917153948000

Karakeep 的「Favourites（最爱）」收藏列表页面，左侧导航选中了 Favourites。该列表专门用来存放高频访问、需要反复查阅的书签。页面内提供 NEW ITEM 新建输入框，可以粘贴链接、撰写便签或者拖拽上传图片，填写完成点击 Save，就能把内容添加到这个收藏夹中，方便快速调取重要资料。

image-20260917154008318

Karakeep是一款自托管网页书签收藏工具，部署在NAS上可本地保存网页链接、便签与图片，搭配cpolar内网穿透，不用公网IP也能随时随地在外网访问你的个人书签库，远程新增、检索、管理收藏内容。

5.安装cpolar实现随时随地开发

5.1 什么是cpolar？

cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。

5.2 部署cpolar

cpolar可以将你本地电脑中的服务（如SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤：

官网在此：https://www.cpolar.com

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

image-20250725104019896

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

22e5adfaf290a17fc3384bb296055259

Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

8a6698b1bf26d64ba3645827fbfb1c29

6.配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

  • 隧道名称：可自定义，本例使用了：Karakeep，注意不要与已有的隧道名称重复
  • 协议：http
  • 本地地址：8081
  • 域名类型：随机域名
  • 地区：选择China Top

image-20260917160617849

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地)上，使用地址访问。

image-20260917161541853

访问成功。

image-20260917161556856

7.保留固定公网地址

使用cpolar为其配置二级子域名（cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站），该地址为固定地址，不会随机变化。

image-20250918151358733

点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是Karakeep，大家可以自定义。填写备注信息，点击保留。

image-20260917165335749

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。

image-20260917165956008

修改隧道信息，将保留成功的二级子域名配置到隧道中

  • 域名类型：选择二级子域名
  • Sub Domain：填写保留成功的二级子域名
  • 地区: China Top

点击更新

image-20260917170032917

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

image-20260917170103994

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

image-20260917170121069

总结

本文带来了Karakeep自托管AI书签系统的全套保姆级Docker部署教程，从工具定位、配置文件修改、环境部署到功能使用、外网穿透，完成了一站式落地教学。Karakeep作为轻量化开源私有化书签工具，彻底解决了传统浏览器收藏夹杂乱、链接失效、资料丢失、无法智能检索的痛点，支持网页链接、随笔笔记、图片、PDF等多类型素材收纳，搭配AI自动摘要、智能打标、图片OCR识别与全文语义检索功能，可高效整理个人学习资料与各类数字素材。相较于第三方收藏工具，Karakeep所有数据本地化存储，隐私性与自主性拉满，还可搭配Ollama实现离线AI解析，适配个人知识库搭建需求。同时教程配套cpolar内网穿透方案，解决了本地部署无法外网访问的难题，无需公网IP，即可随时随地远程管理、新增、检索书签资料，非常适合NAS、服务器、Linux设备部署，是个人搭建专属私有第二大脑的优质开源工具。

感谢您对本篇文章的喜爱，有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站

Share:

鸽子

鸽子

我是鸽子，是这个网站的文章编辑之一！喜欢研究各种有趣的开源项目。希望大家喜欢我的文章！

发表回复

目录

On Key

推荐文章