Karakeep на VPS: букмарк-менеджер с AI, который сам раскладывает ссылки по полкам

1. Что такое Karakeep и зачем он нужен

Представьте, что вы сохранили 500 закладок в браузере. Теперь попробуйте что-нибудь в них найти. Karakeep решает эту проблему: он сохраняет не просто ссылку, а полное содержимое страницы — текст, скриншот, PDF-версию. И AI автоматически решает, в какую папку это положить.

Проект начинался под названием Hoarder, в 2025 году переименован в Karakeep. На сентябрь 2026 актуальна версия 0.33.2, но следить за номером не нужно: compose тянет тег release, который всегда указывает на последний стабильный выпуск.

2. Требования к серверу

Karakeep запускает три контейнера: само приложение, Meilisearch (поиск) и Chromium (скриншоты). Основной едок памяти — само приложение: на свежей установке в покое оно занимает около 650 МБ, тогда как Meilisearch с пустым индексом — считанные десятки мегабайт, а Chromium без работы — около 40 МБ. Пики дают Chromium при снятии скриншотов и Meilisearch по мере роста индекса.

3. Установка Docker

Если Docker ещё не установлен — официальный скрипт сделает всё за вас:

curl -fsSL https://get.docker.com | sh

Проверьте, что Docker запущен:

docker --version
# Docker version 26.x.x, build ...

4. docker-compose.yml и .env

Создадим директорию и скачаем официальный файл конфигурации:

mkdir ~/karakeep && cd ~/karakeep
wget https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml

Посмотрите содержимое файла — там три сервиса. Ничего менять не нужно, всё уже настроено. Ниже — как он выглядит на сентябрь 2026; если у вас скачалось что-то другое, доверяйте скачанному файлу, а не этой копии: разработчики обновляют его чаще, чем мы статью.

services:
  web:
    image: ghcr.io/karakeep-app/karakeep:${KARAKEEP_VERSION:-release}
    restart: unless-stopped
    volumes:
      - data:/data
    ports:
      - 3000:3000
    env_file:
      - .env
    environment:
      MEILI_ADDR: http://meilisearch:7700
      BROWSER_WEB_URL: http://chrome:9222
      DATA_DIR: /data

  chrome:
    image: ghcr.io/karakeep-app/karakeep-chrome:release
    restart: unless-stopped
    init: true
    command:
      - --disable-gpu
      - --disable-dev-shm-usage
      - --hide-scrollbars
      - --disable-blink-features=AutomationControlled
      - --window-size=1440,900

  meilisearch:
    image: getmeili/meilisearch:v1.41.0
    restart: unless-stopped
    env_file:
      - .env
    environment:
      MEILI_NO_ANALYTICS: "true"
    volumes:
      - meilisearch:/meili_data

volumes:
  meilisearch:
  data:

Создать файл .env

Сгенерируем случайные ключи и создадим файл переменных. Два случайных ключа — для безопасности хранилища и сессий:

echo "NEXTAUTH_SECRET=$(openssl rand -base64 36)"
echo "MEILI_MASTER_KEY=$(openssl rand -base64 36 | tr -dc 'A-Za-z0-9')"

# Пример вывода:
# NEXTAUTH_SECRET=abc123...
# MEILI_MASTER_KEY=XyZ456...

Создайте файл .env, вставив сгенерированные значения. Замените karakeep.ваш-домен.ru на реальный домен:

# Замените на ваш домен
NEXTAUTH_URL=https://karakeep.ваш-домен.ru

# Вставьте значения из команды выше
NEXTAUTH_SECRET=вставьте-сгенерированный-ключ
MEILI_MASTER_KEY=вставьте-сгенерированный-ключ

# AI-тегирование — добавим позже (можно оставить закомментированным)
# OPENAI_API_KEY=sk-...

# Запрет новых регистраций (включите после создания своего аккаунта)
# DISABLE_SIGNUPS=true

Ограничьте права на файл — в нём хранятся секретные ключи:

chmod 600 ~/karakeep/.env

Запустить контейнеры

cd ~/karakeep
docker compose up -d

Первый запуск занимает несколько минут: Docker скачивает около 2 ГБ образов — основной вес приходится на само приложение. Проверьте, что все три контейнера запустились:

docker compose ps

# Ожидаемый вывод:
# NAME                   STATUS
# karakeep-web-1         Up
# karakeep-chrome-1      Up
# karakeep-meilisearch-1 Up

5. Nginx + SSL

Прежде чем идти дальше — настройте домен. Добавьте A-запись у регистратора:

karakeep.ваш-домен.ru  →  A  →  IP_ВАШЕГО_СЕРВЕРА

Создайте конфиг Nginx. Karakeep — обычный HTTP-сервер, никаких WebSocket-заголовков не нужно:

server {
    listen 80;
    server_name karakeep.ваш-домен.ru;

    # Увеличиваем лимит для загрузки файлов (по умолчанию 50 МБ)
    client_max_body_size 50M;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

ln -s /etc/nginx/sites-available/karakeep /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

# Установить certbot если нет
apt install -y certbot python3-certbot-nginx

# Получить SSL-сертификат (certbot обновит конфиг Nginx автоматически)
certbot --nginx -d karakeep.ваш-домен.ru

Закрыть прямой доступ к порту 3000

Теперь, когда Nginx настроен, привяжите порт только к localhost. Отредактируйте docker-compose.yml:

# Было:
#   ports:
#     - 3000:3000

# Стало:
    ports:
      - 127.0.0.1:3000:3000

cd ~/karakeep && docker compose up -d

6. Первый запуск и регистрация

Откройте https://karakeep.ваш-домен.ru в браузере. Вы увидите форму регистрации — создайте первый аккаунт (он автоматически получает права администратора).

Запретить новые регистрации

Если Karakeep только для вас — заблокируйте возможность зарегистрировать новые аккаунты. Добавьте строку в .env:

DISABLE_SIGNUPS=true

cd ~/karakeep && docker compose up -d

После этого форма регистрации исчезнет, останется только вход для уже созданных пользователей.

7. AI-тегирование

Karakeep работает без AI — но именно с ним становится по-настоящему удобным. AI читает содержимое страницы и ставит теги автоматически: «python», «docker», «рецепт», «видео». Есть два варианта: OpenAI (платно, но качественно) или Ollama (бесплатно, локально, чуть хуже).

Вариант 1: OpenAI (рекомендуется)

Модель по умолчанию задаёт сам Karakeep, и она меняется от версии к версии (в документации на сентябрь 2026 — gpt-5.6-luna для текста и gpt-4o-mini для картинок). Если хотите другую — задайте её явно через INFERENCE_TEXT_MODEL и сверьте цену в прайсе OpenAI: тегирование одной закладки — это один короткий запрос, так что счёт выходит копеечный, но конкретная сумма зависит от выбранной модели.

OPENAI_API_KEY=sk-ваш-ключ-openai

# Необязательно: тегировать на русском языке
INFERENCE_LANG=russian

Вариант 2: Ollama (локально, без API-ключа)

Если у вас уже запущена Ollama на этом или другом сервере — используйте её. Нужна модель для текста (например, llama3.2) и мультимодальная для изображений (например, llava).

# Адрес Ollama (host.docker.internal если на том же хосте, или IP другого сервера)
OLLAMA_BASE_URL=http://host.docker.internal:11434

# Модель для анализа текста
INFERENCE_TEXT_MODEL=llama3.2

# Модель для анализа изображений (необязательно)
INFERENCE_IMAGE_MODEL=llava

После изменения .env перезапустите контейнеры:

cd ~/karakeep && docker compose up -d

8. Мобильное приложение и браузерное расширение

Браузерное расширение

Расширение есть для Chrome и Firefox. Установите из официального магазина, затем в настройках расширения:

Мобильное приложение (iOS / Android)

Найдите Karakeep в App Store или Google Play. После установки:

9. Полезные настройки

CRAWLER_FULL_PAGE_ARCHIVE=true

CRAWLER_VIDEO_DOWNLOAD=true
CRAWLER_VIDEO_DOWNLOAD_MAX_SIZE=100  # МБ, ограничение на размер

cd ~/karakeep
docker compose pull && docker compose up -d

10. Частые проблемы