Karakeep na VPS: vlastní archiv záložek s vyhledáváním a AI

6. 9. 20267 min čtení

Tropic

Karakeep na VPS: vlastní archiv záložek s vyhledáváním a AI

Language: cs

Karakeep: instalace osobního archivu záložek na VPS

Uložit odkaz je snadné. Najít ho o šest měsíců později je těžší — zvlášť pokud se stránka změnila, zmizela nebo se ztratila mezi stovkami záložek.

Karakeep neukládá jen URL, ale také obsah stránky, náhled, poznámky, obrázky a PDF. Archiv můžete prohledávat podle textu, organizovat položky do seznamů a automaticky je označovat pomocí AI. Běží na vlastním VPS a připojení jazykového modelu je volitelné.

Níže probereme možnosti Karakeep, požadavky na server a instalaci na Ubuntu 24.04 s Docker Compose, HTTPS a zálohami.

Karakeep v sedmi krocích

Vytvořte Linux VPS a nasměrujte na něj subdoménu, například keep.example.com.
Nainstalujte Docker Engine a Docker Compose.
Stáhněte oficiální docker-compose.yml.
Vygenerujte tajné klíče a spusťte Karakeep, Chrome a Meilisearch.
Uzavřete interní port 3000 a zapněte HTTPS přes Caddy.
Vytvořte první účet a poté zakažte otevřenou registraci.
Nainstalujte rozšíření prohlížeče nebo mobilní aplikaci a importujte záložky.

AI klíč není ke spuštění služby potřeba. Bez něj bude dál fungovat ukládání stránek, seznamy, poznámky, OCR a fulltextové vyhledávání. Automatické štítky a souhrny se však generovat nebudou.

Co je Karakeep

Karakeep je open-source aplikace pro vlastní hosting, která ukládá odkazy, textové poznámky, obrázky a PDF do jediné knihovny. Projekt se dříve jmenoval Hoarder.

Název pochází z arabského slova karakeeb, které označuje rozptýlené věci, jež vypadají jako nepořádek, ale mohou mít skrytou hodnotu. To přesně vystihuje typickou sbírku záložek: užitečného materiálu je hodně, ale najít správnou položku je obtížné.

Po přidání odkazu Karakeep načte jeho název a popis, extrahuje čitelný text, vytvoří náhled a v případě potřeby může uložit místní kopii stránky.

Funkce	Záložky prohlížeče	Karakeep
Co se ukládá	URL a název	Text, náhled, poznámky a přílohy
Vyhledávání	Podle názvu a adresy	Podle obsahu, štítků a poznámek
Když stránka zmizí	Zůstane nefunkční URL	Zůstane text, snímek nebo kompletní archiv
Organizace	Složky	Štítky, ruční a chytré seznamy
Přístup	V prohlížeči	Web, rozšíření, iOS a Android
Server	Profil prohlížeče nebo jeho cloudová služba	Váš VPS nebo domácí server

Hlavní funkce Karakeep

Odkazy, poznámky, obrázky a PDF

Každá položka může být odkaz, textová poznámka nebo nahraný soubor. OCR extrahuje text z obrázků a PDF, takže je lze také prohledávat. K položce můžete připojit poznámku, citaci nebo další soubor.

Vyhledávání obsahu

Meilisearch indexuje uložený text, poznámky a metadata. Nemusíte si pamatovat přesný název: stačí fráze nebo téma. Po nastavení embeddings je dostupné také sémantické vyhledávání podle významu.

Chytré a spolupracující seznamy

Jedna položka může patřit do několika seznamů současně bez duplikace. Seznam může zůstat soukromý, být sdílený přes odkaz nebo ho mohou upravovat další uživatelé.

Chytrý seznam je uložený vyhledávací dotaz, který se automaticky aktualizuje. Může například zobrazit všechny položky označené ai, které byly přidány během posledního týdne.

Archivace stránek

Ve výchozím nastavení Karakeep ukládá extrahovaný text a snímek viditelné části stránky. Dodatečně můžete zapnout snímek celé stránky, PDF nebo samostatný HTML archiv. Knihovna tak nebude závislá na nefunkčních odkazech, ale vzroste spotřeba disku.

Stránky za autentizací, s pokročilou ochranou proti botům a interaktivní aplikace se nemusí uložit úplně. Důležité materiály je lepší nahrát samostatně jako PDF nebo soubor.

Volitelné AI štítky

Karakeep může vytvářet štítky a krátká shrnutí přes externí API kompatibilní s OpenAI nebo lokální model Ollama. Bez AI zůstává aplikace plně funkčním správcem záložek.

Lokální model neposílá materiály externímu poskytovateli, ale vyžaduje výrazně více RAM. Z tohoto důvodu se Ollama často hostuje odděleně od hlavní instance Karakeep.

Požadavky Karakeep na server

Oficiální dokumentace neurčuje pevné minimum CPU a RAM. Kompletní instalace obsahuje tři kontejnery:

Karakeep ukládá databázi a poskytuje rozhraní;
headless Chrome otevírá stránky, spouští JavaScript a pořizuje snímky;
Meilisearch indexuje knihovnu.

Praktická konfigurace pro jednoho uživatele bez lokálního LLM:

2 vCPU;
2 GB RAM;
20–30 GB SSD nebo NVMe;
Ubuntu 24.04 LTS;
veřejná IP adresa a doména.

Pro několik uživatelů, velký import, mnoho RSS kanálů a PDF je pohodlnější 4 GB RAM. Požadavky na disk závisí na režimu archivace: text zabírá málo místa, zatímco snímky celých stránek, PDF a videa mohou knihovnu rychle zvětšit.

Jak nainstalovat Karakeep na VPS

V tomto příkladu používáme Ubuntu 24.04 a subdoménu keep.example.com.

1. Nastavte DNS a firewall

Vytvořte DNS záznam A ukazující na IP adresu serveru a potom se připojte přes SSH:

ssh root@SERVER_IP
apt update && apt upgrade -y

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw --force enable

Aktuální SSH relaci nezavírejte, dokud neověříte, že nové připojení funguje.

2. Nainstalujte Docker

apt install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

apt update
apt install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin
docker compose version

3. Stáhněte konfiguraci Karakeep

mkdir -p /opt/karakeep
cd /opt/karakeep

curl -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml

Vygenerujte dva různé tajné klíče:

openssl rand -base64 36
openssl rand -base64 36 | tr -dc 'A-Za-z0-9'

Vytvořte /opt/karakeep/.env:

KARAKEEP_VERSION=release
NEXTAUTH_SECRET=INSERT_THE_FIRST_SECRET
MEILI_MASTER_KEY=INSERT_THE_SECOND_SECRET
NEXTAUTH_URL=https://keep.example.com
DISABLE_SIGNUPS=false
DB_WAL_MODE=true
RATE_LIMITING_ENABLED=true

.env nezveřejňujte: první tajný klíč podepisuje autentizační tokeny, zatímco druhý chrání Meilisearch.

4. Uzavřete interní port

V docker-compose.yml nahraďte:

ports:
  - 3000:3000

tímto:

ports:
  - 127.0.0.1:3000:3000

Port 3000 tak nebude přímo dostupný z internetu.

5. Spusťte kontejnery

cd /opt/karakeep
docker compose up -d
docker compose ps

Služby web, chrome a meilisearch by měly běžet. Logy zobrazíte takto:

docker compose logs --tail=200

6. Zapněte HTTPS

apt install -y caddy

cat > /etc/caddy/Caddyfile <<'EOF'
keep.example.com {
    reverse_proxy 127.0.0.1:3000
}
EOF

caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy

Pokud je DNS nastavené a porty 80 a 443 otevřené, Caddy automaticky získá TLS certifikát. Potom otevřete https://keep.example.com.

7. Vytvořte administrátora a uzavřete registraci

První registrovaný uživatel se automaticky stane administrátorem. Po vytvoření účtu nastavte v .env:

DISABLE_SIGNUPS=true

Použijte změnu:

cd /opt/karakeep
docker compose up -d

Administrátor bude stále moci ručně vytvářet další účty.

Import dat, rozšíření a mobilní aplikace

Karakeep nabízí rozšíření pro Chrome, Firefox a Safari a také aplikace pro iOS a Android. V telefonu můžete odkaz poslat do archivu přes systémovou nabídku Sdílet.

Existující záložky lze importovat ze standardního HTML souboru prohlížeče, z Pocketu, Omnivore a dalších podporovaných služeb. Velký archiv je lepší přidávat po dávkách: server musí otevřít stránky, extrahovat text, vytvořit snímky a sestavit vyhledávací index.

Jak zapnout AI a archivaci celé stránky

Pro OpenAI přidejte do .env:

OPENAI_API_KEY=YOUR_API_KEY

Jiná služba kompatibilní s OpenAI může navíc vyžadovat OPENAI_BASE_URL. Pro lokální model použijte OLLAMA_BASE_URL s adresou dostupnou z kontejneru.

Kompletní lokální kopii stránky zapněte samostatně:

CRAWLER_FULL_PAGE_ARCHIVE=true

Dostupné jsou také možnosti CRAWLER_FULL_PAGE_SCREENSHOT=true a CRAWLER_STORE_PDF=true. Nezapínejte všechny režimy bez důvodu: výrazně zvýší spotřebu disku. Po změně .env spusťte docker compose up -d.

Zabezpečení, aktualizace a zálohy

Crawler Karakeep otevírá adresy uložené uživateli ze sítě vašeho serveru. Nenechávejte proto otevřenou registraci a přístup udělujte pouze důvěryhodným lidem. Základní ochrana SSRF je přítomná, ale pro veřejnou službu oficiální projekt doporučuje prohlížeč izolovat nebo ho směrovat přes omezenou proxy.

Používejte také HTTPS a silná hesla, nevystavujte port 3000 a kontejnery pravidelně aktualizujte:

cd /opt/karakeep
docker compose up --pull always -d

Hlavní databáze a uložené materiály jsou v Docker volume s názvem data. Před jeho kopírováním kontejnery zastavte:

mkdir -p /var/backups/karakeep
cd /opt/karakeep
docker compose stop

docker run --rm \
  -v karakeep_data:/source:ro \
  -v /var/backups/karakeep:/backup \
  alpine sh -c 'tar czf /backup/data-$(date +%F).tar.gz -C /source .'

cp .env docker-compose.yml /var/backups/karakeep/
docker compose start

Název karakeep_data předpokládá, že adresář projektu je /opt/karakeep; ověřit ho můžete pomocí docker volume ls. Index Meilisearch lze znovu sestavit, ale u velké knihovny je užitečné zálohovat také volume karakeep_meilisearch.

Archiv z /var/backups/karakeep odešlete na jiný server, NAS nebo do objektového úložiště. Kopie na stejném VPS nechrání před poruchou disku ani smazáním virtuálního stroje.

Jaký VPS zvolit pro Karakeep

Pro osobní knihovnu bez Ollamy je vhodný Linux VPS se 2 vCPU, 2 GB RAM a 20–30 GB NVMe. Pro velký import, několik uživatelů a úplnou archivaci zvolte 4 GB RAM a větší disk.

Karakeep můžete provozovat na VPS od tropic.host: trvalá IP adresa zjednodušuje nastavení domény a NVMe úložiště se hodí pro SQLite, vyhledávací index a mnoho malých souborů. Zdroje lze navyšovat s růstem archivu.

Zdroje pro lokální Ollamu plánujte samostatně: i malý jazykový model může vyžadovat více paměti než celý hlavní stack Karakeep.

Závěr

Karakeep promění roztříštěné odkazy v osobní prohledávatelnou knihovnu. Ukládá stránky, poznámky, obrázky a PDF a podporuje OCR, seznamy, rozšíření, mobilní aplikace i volitelné AI štítky.

Na začátek stačí malý VPS, Docker Compose, doména a HTTPS. Po instalaci uzavřete registraci, sledujte využití disku a udržujte externí zálohu.

FAQ

Je Karakeep zdarma?

Self-hosted verze je open source a nevyžaduje povinné předplatné. Platíte za VPS, doménu, úložiště záloh a případně externí AI API.

Je pro fungování Karakeep potřeba API klíč?

Ne. Ukládání a indexování materiálů, seznamy, poznámky, OCR a fulltextové vyhledávání fungují bez AI. Model je potřeba pro automatické štítky, souhrny a související funkce.

Kolik RAM Karakeep potřebuje?

Praktický začátek pro jednoho uživatele bez Ollamy jsou 2 GB RAM. Pro velké importy, více uživatelů a aktivní zpracování je pohodlnější 4 GB.

Mohu importovat záložky z prohlížeče nebo Pocketu?

Ano. Karakeep podporuje standardní HTML soubor záložek prohlížeče, Pocket, Omnivore a několik dalších formátů. Po importu Karakeep stránky zpracuje a přidá je do vyhledávání.

Zůstane článek dostupný, když původní web zmizí?

Karakeep ukládá extrahovaný text a snímek a při zapnuté úplné archivaci také místní kopii nebo PDF. Stránky za autentizací a složité webové aplikace se mohou uložit jen částečně.

Zpět na Blog