Qdrant в Docker поднимается одной командой, но у быстрого запуска есть подвох: без явного монтирования тома все векторы пропадают при перезапуске контейнера. В этой статье разберем три уровня инфраструктуры для Qdrant: локальный Docker с сохранением…
10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.
Об авторе →Claude Code: новый CLI-агент от Anthropic
Anthropic выпустила Claude Code — терминальный AI-агент для разработчиков. Инструмент работает прямо в командной строке и умеет писать, редактировать и запускать код.
Zcode AI: Полный гид по визуальному интерфейсу для Claude Code и AI-агентов
Узнайте, как использовать Zcode для управления Claude Code, Gemini и Codex в едином GUI. Настройка провайдеров, MCP-серверов и визуальный вайбкодинг.
YouTube-канал с монетизацией из любой точки мира: Пошаговый гайд 2026
Инструкция по созданию YouTube-канала: обход блокировок SMS, настройка расширенных функций через виртуальные номера и правила безопасности для монетизации.
Windsurf Code Maps: Как глубоко понимать архитектуру проекта перед написанием кода
Полный гайд по Windsurf Code Maps, модели Sway 1.5 и Sway Grep. Узнайте, как визуализировать архитектуру кода и ускорить разработку в 13 раз.
Vk Fast Cash Strategy
Аудитория ВКонтакте — это те же люди, что и в Instagram, но 'социальный контракт' площадки другой. Если Instagram — это 'дорогой ресторан' с демонстрацией успеха, то VK — это 'душевная шашлычная'. Здесь не работает глянцевый 'успешный успех
Qdrant в Docker поднимается одной командой, но у быстрого запуска есть подвох: без явного монтирования тома все векторы пропадают при перезапуске контейнера. В этой статье разберем три уровня инфраструктуры для Qdrant: локальный Docker с сохранением данных, managed Qdrant Cloud и self-hosted кластер через Helm в Kubernetes, а также когда реально нужен переход с одной ноды на кластер.
Qdrant в Docker в 2026 году можно развернуть тремя способами: локальный контейнер с volume для разработки, Qdrant Cloud с бесплатным тиром на 1 ГБ RAM и 4 ГБ диска, или self-hosted кластер из нескольких нод через Helm chart. Ниже — рабочий Docker Compose файл, разбор цен Cloud и критерий, когда кластер действительно нужен, а когда это просто лишняя сложность.
Qdrant хранит все коллекции внутри контейнера в директории /qdrant/storage. Если эта директория не примонтирована на диск хоста, docker stop или падение контейнера стирает все векторы без возможности восстановления.
Это не баг, а стандартное поведение любого Docker-контейнера без volume. Официальная документация Qdrant прямо указывает на необходимость монтирования директории для постоянного хранилища. Разработчики, которые тестировали Qdrant в связке с Ollama и n8n для полностью локального AI-воркфлоу, регулярно упоминают этот момент в лайфхаках: постоянство данных настраивается монтированием тома, а не настройками самого Qdrant.
На практике это выглядит так: запустил контейнер командой docker run без флага -v, загрузил тестовую коллекцию, перезапустил контейнер для проверки конфига — и коллекция пропала. Обидно, если это происходит не на тесте, а с рабочими эмбеддингами.
Минимальный рабочий Docker Compose файл монтирует локальную папку в /qdrant/storage и пробрасывает порты 6333 (HTTP) и 6334 (gRPC). Этого достаточно для разработки с сохранением данных между перезапусками.
Для сертификатов и TLS-соединения к базовому конфигу добавляется еще один volume — с директорией /qdrant/tls. Именно так авторы обучающих видео по Qdrant показывают безопасное подключение Python и Node.js клиентов: сначала генерируют сертификаты через mkcert, потом монтируют папку с сертификатами в контейнер отдельным томом.
version: "3.8"
services:
qdrant:
image: qdrant/qdrant:v1.16.3
ports:
- "6333:6333"
- "6334:6334"
volumes:
- ./qdrant_storage:/qdrant/storage
environment:
- QDRANT__SERVICE__API_KEY=your-api-key-here
restart: unless-stoppedПара практических деталей. Версию образа лучше фиксировать (v1.16.3, а не latest) — иначе апдейт Qdrant может незаметно поменять поведение прямо в проде. И конфигурировать через переменные окружения удобнее, чем через YAML-файл конфига: не нужно пересобирать образ ради одной настройки.
Бесплатный тир Qdrant Cloud дает один узел на 0,5 vCPU, 1 ГБ RAM и 4 ГБ диска без ограничения по времени. Self-hosted версия бесплатна всегда по лицензии Apache 2.0, но требует своей инфраструктуры и администрирования.
Бесплатный тир Qdrant Cloud включает 1 ГБ RAM и 4 ГБ дискового пространства, а при росте данных можно перейти на платный Standard-тир с выделенным кластером (qdrant.tech/pricing). Для небольшого пет-проекта или прототипа этого хватает с запасом.
Self-hosted вариант через docker-compose.yml из раздела выше ничего не стоит, кроме аренды сервера. Разница в том, кто отвечает за бэкапы, обновления и мониторинг: в Cloud это делает Qdrant, в self-hosted — вы сами через cron-скрипты или Prometheus с Grafana.
| Параметр | Qdrant Cloud (Free) | Self-hosted Docker | Self-hosted Kubernetes |
|---|---|---|---|
| Стоимость | 0 ₽, лимит 1 ГБ RAM | Только аренда VPS | Аренда кластера машин |
| Настройка | Готово за 5 минут | 15-20 минут | Несколько часов |
| Отказоустойчивость | Нет (1 нода) | Нет (1 нода) | Да, реплики между узлами |
| Кому подходит | MVP, тесты, обучение | Разработка, малый прод | Прод с высокой нагрузкой |
| Кто следит за бэкапами | Qdrant | Вы | Вы или Helm-хуки |
Для Kubernetes у Qdrant есть официальный Helm chart, который через StatefulSet поднимает нужное количество нод и настраивает Persistent Volume для каждой из них автоматически.
Установка занимает три команды: добавить репозиторий, обновить его и выполнить upgrade с флагом -i для установки, если релиза еще нет.
helm repo add qdrant https://qdrant.github.io/qdrant-helm
helm repo update
helm upgrade -i my-qdrant-cluster qdrant/qdrantТонкий момент: чарт использует StatefulSet, а часть его полей неизменяема после создания. Если попытаться поменять такое поле апгрейдом, Kubernetes вернет ошибку патча StatefulSet, и придется вручную удалять поды кластера, начиная с node-0, чтобы Kubernetes пересоздал их с новой конфигурацией. На проде это короткий даунтайм, поэтому подобные изменения лучше планировать заранее, а не на живую.
Полную документацию по values.yaml и настройке снапшотов стоит держать под рукой: github.com/qdrant/qdrant-helm.
Одна нода Qdrant справляется с миллионами векторов для большинства проектов. Переход на кластер оправдан требованиями к отказоустойчивости в проде или объемом данных, который не помещается в память и диск одной машины.
DevOps-каналы, разбирающие production-ready кластеры Qdrant, сравнивают сценарии по масштабу: одна нода — нормально для старта, три ноды — небольшой прод, пять и семь нод — под серьезную нагрузку. Ключевая причина перехода на кластер — не "для солидности", а конкретный риск простоя при падении единственного сервера.
Тестировали кластер из трех нод с балансировщиком Nginx? Тогда важно помнить порядок операций при перезапуске. При остановке узлов сначала выключают followers, и только потом leader — иначе кластер теряет консистентность на момент переключения роли. Останавливать все ноды одновременно нельзя ни при каких условиях.
Максим: «Мог просто засесть до пяти ночи и просто там править одну какую-то функцию, которая не работала. Если бы не терпение, я бы все это закрыл в моменте. Но понимал, что это можно и нужно решить, чтобы идти дальше.»
Ровно так и с кластером Qdrant: первая настройка Helm chart или балансировщика редко проходит с первого раза. Логи StatefulSet, порядок рестарта нод, права на volume — все это дожимается терпением, а не одной попыткой.
Free-тир Qdrant Cloud постоянный и бесплатный. Платный Standard-тир считается по часам за фактически используемые ресурсы, без фиксированной подписки за место.
Self-hosted Qdrant бесплатен по лицензии Apache 2.0 в любой инфраструктуре, Managed Cloud берет оплату по фактическому использованию ресурсов без публичных фиксированных тарифов, а Hybrid и Private Cloud считаются индивидуально под задачу. Для команды из 1-2 инженеров при нагрузке от 5 млн векторов self-hosted вариант на VPS за 150-300 долларов в месяц обходится заметно дешевле managed-альтернатив, если не считать время на администрирование.
Здесь и есть развилка. Если у вас нет DevOps-ресурса на мониторинг и бэкапы, Cloud окупает разницу в цене экономией времени. Если инфраструктура уже есть и команда умеет в Kubernetes, self-hosted почти всегда выгоднее по деньгам.
Сильные стороны:
Слабые стороны:
| Сценарий | Что выбрать |
|---|---|
| Учусь, тестирую API | Локальный Docker с volume |
| MVP или пет-проект | Qdrant Cloud Free |
| Прод с небольшой нагрузкой | Self-hosted Docker Compose на VPS |
| Прод с требованием к отказоустойчивости | Kubernetes кластер через Helm, 3+ ноды |
| Данные обязаны оставаться в своей инфраструктуре | Self-hosted или Hybrid Cloud |
Почему данные Qdrant пропадают после перезапуска Docker?
Потому что коллекции хранятся внутри контейнера, а не на диске хоста. Без флага -v или volume в Docker Compose Docker удаляет все данные вместе с контейнером при его пересоздании.
Можно ли перейти с self-hosted Qdrant на Cloud без потери данных?
Да, у Qdrant есть официальный инструмент миграции и документация под этот сценарий. Экспортируете снапшот коллекции и восстанавливаете его в облачном кластере.
Нужен ли Kubernetes для маленького проекта на Qdrant?
Нет. Для тестов, обучения и небольших продакшн-нагрузок хватает одного Docker-контейнера с volume или бесплатного тира Qdrant Cloud.
Что будет, если остановить сразу все ноды кластера Qdrant?
Кластер потеряет консистентность данных на момент рестарта. Правильный порядок: сначала followers, затем leader, с паузой между остановками.
Сколько векторов выдерживает одна нода Qdrant?
Для большинства проектов одна нода спокойно обслуживает миллионы векторов. Переход на кластер нужен только при реальном требовании к отказоустойчивости или превышении памяти и диска одной машины.
Обязательно ли фиксировать версию образа Qdrant в проде?
Да. Использование тега latest в продакшене рискованно: новая версия может незаметно изменить поведение API. Для стабильности указывают конкретный номер версии, например v1.16.3.
Работает ли Qdrant без интернета в self-hosted режиме?
Да, полностью. Связка Qdrant с локальными LLM через Ollama и оркестрацией через n8n собирается без единого облачного сервиса, что подтверждено практикой разработчиков, тестировавших такие AI-воркфлоу.
Volume — механизм Docker для монтирования директории с диска хоста внутрь контейнера, чтобы данные не исчезали при его пересоздании.
StatefulSet — объект Kubernetes для приложений с состоянием (как база данных), который сохраняет за каждым подом собственное персистентное хранилище и стабильное имя.
Helm chart — упакованный набор конфигураций Kubernetes для установки приложения одной командой вместо ручного описания десятков YAML-файлов.
HNSW-индекс — структура данных для быстрого поиска ближайших векторов, которую Qdrant держит в памяти для низкой задержки запросов.
Failover — автоматическое переключение нагрузки на резервный узел кластера при падении основного, без остановки сервиса.
Разворачиваете AI-инфраструктуру и подбираете стек вокруг векторной базы? В каталоге AI-инструментов VibeCoderz собраны обзоры IDE и сервисов для вайбкодинга, а разобрать инфраструктуру конкретно под ваш проект можно на консультации с Максимом. Смежные материалы цикла: установка и первый поиск в Qdrant, AI-агент 24/7 на VPS, Langfuse self-hosted.
Обновлено: сентябрь 2026