Базовый конфигурационный файл#

Представленный конфигурационный файл Config.yaml содержит все ключевые параметры для бинарной установки.

Совет

  1. Для параметров, помеченных как null - значение выбирается автоматически.

  2. Размеры в kb рассчитываются как 1kb = 1 вектор размерности 256.

  3. После изменения конфигурационного файла перезапустите процесс: sudo systemctl restart qdrant.

Основные настройки (service)#

Параметры запуска сервиса и сетевых интерфейсов.

Параметр

Значение по умолчанию

Описание выполняемой функции

service.http_port

6333

Порт для HTTP-API (REST)

service.grpc_port

6334

Порт для gRPC-API

service.host

0.0.0.0

IP-адрес для биндинга сервера (0.0.0.0 = все интерфейсы)

service.max_request_size_mb

32

Максимальный размер HTTP-запроса в мегабайтах

service.max_workers

num_cpu_cores

Количество рабочих потоков для обработки запросов

service.enable_cors

true

Активация CORS

service.enable_tls

false

Активация HTTPS

service.api_key

-

Ключ API

service.read_only_api_key

-

Ключ только для чтения

Хранение данных (storage)#

Настройки путей и поведения хранилища.

Параметр

Значение по умолчанию

Описание выполняемой функции

storage.storage_path

./storage

Основной путь хранения данных

storage.snapshots_path

./snapshots

Путь для снепшотов

storage.snapshots_config.snapshots_storage

local

Тип хранилища: local или s3

storage.temp_path

null

Путь для временных файлов

storage.on_disk_payload

true

Хранение payload на диске

storage.update_concurrency

null

Макс. concurrent-обновлений

storage.wal.wal_capacity_mb

32

Размер WAL-сегмента в MB

storage.wal.wal_segments_ahead

0

Резервные WAL-сегменты

storage.node_type

Normal

Тип узла: Normal или Listener

Кластерные настройки (cluster)#

Актуально только для кластерного режима.

Параметр

Значение по умолчанию

Описание выполняемой функции

cluster.enabled

false

Активация кластерного режима

cluster.peer_id

—

Уникальный ID узла (требуется при enabled: true)

cluster.consensus.tick_period_ms

100

Интервал синхронизации RAFT-консенсуса (в миллисекундах)

cluster.p2p.port

6335

Порт для связи между узлами (P2P)

cluster.p2p.enable_tls

false

TLS для P2P

cluster.initial_peer_addresses

[]

Список адресов других узлов ("node1:6335", "node2:6335")

Производительность (performance)#

Настройки оптимальной производительности.

Параметр

Значение по умолчанию

Описание выполняемой функции

performance.max_search_threads

0

Потоки для поиска (0=авто)

performance.max_optimization_threads

0

Потоки для оптимизации

performance.optimizer_cpu_budget

0

Лимит CPU для оптимизации

performance.update_rate_limit

null

Лимит частоты обновлений

performance.async_scorer

false

Использование io_uring

Оптимизаторы (optimizers)#

Настройки оптимизации запросов.

Параметр

Значение по умолчанию

Описание выполняемой функции

optimizers.deleted_threshold

0.2

Порог удаленных векторов

optimizers.vacuum_min_vector_number

1000

Мин. векторов для оптимизации

optimizers.default_segment_number

0

Целевое число сегментов

optimizers.max_segment_size_kb

null

Макс. размер сегмента

optimizers.memmap_threshold_kb

null

Порог перехода на mmap

optimizers.indexing_threshold_kb

20000

Порог индексации

optimizers.flush_interval_sec

5

Интервал записи на диск

Индексы (hnsw_index)#

Настройки индексации запросов.

Параметр

Значение по умолчанию

Описание выполняемой функции

hnsw_index.m

16

Количество связей

hnsw_index.ef_construct

100

Параметр построения графа

hnsw_index.full_scan_threshold_kb

10000

Порог полного сканирования

hnsw_index.max_indexing_threads

0

Потоки для построения индекса

hnsw_index.on_disk

false

Хранение индекса на диске

hnsw_index.payload_m

null

Параметр M для payload

Логирование (log_level)#

Управление детализацией логов.

Параметр

Значение по умолчанию

Описание выполняемой функции

logger.format

text

Формат логов: text или json

logger.on_disk.enabled

false

Запись логов в файл

logger.on_disk.log_file

-

Путь к файлу логов

logger.on_disk.log_level

INFO

Уровень логирования для файла

logger.on_disk.format

text

Формат файловых логов

Мониторинг (metrics)#

Настройки сбора метрик для Prometheus.

Параметр

Значение по умолчанию

Описание выполняемой функции

metrics.enabled

true

Активация метрик

metrics.address

0.0.0.0

IP-адрес для экспорта метрик

metrics.port

6333

Порт для метрик (совпадает с HTTP-портом, если не указан отдельно)

Безопасность (TLS)#

Настройки безопасности.

Параметр

Значение по умолчанию

Описание выполняемой функции

tls.cert

./tls/cert.pem

Сертификат

tls.key

./tls/key.pem

Приватный ключ

tls.ca_cert

./tls/cacert.pem

CA-сертификат

tls.cert_ttl

3600

TTL сертификата

Маппинг ролей на CN (cert_auth)#

Параметр

Значение по умолчанию

Описание выполняемой функции

cert_auth.subject_regex

"CN=([^,]+)"

Регулярное выражение для извлечения Common Name (CN) из сертификата

cert_auth.principals

{}

Сопоставление извлеченных имен (например, CN) с ролями

Коллекции (collection)#

Настройки коллекции.

Параметр

Значение по умолчанию

Описание выполняемой функции

collection.replication_factor

1

Фактор репликации

collection.write_consistency_factor

1

Фактор согласованности

collection.vectors.on_disk

null

Хранение векторов на диске

collection.quantization

null

Настройки квантования

Телеметрия (telemetry)#

Параметр

Значение по умолчанию

Описание выполняемой функции

telemetry_disabled

false

Деактивация телеметрии

Пример конфигурационного файла#

service:
  http_port: 6333
  grpc_port: 6334
  host: 0.0.0.0
  max_request_size_mb: 32

storage:
  storage_path: "/var/lib/qdrant/data"
  snapshots_path: "/var/lib/qdrant/snapshots"
  on_disk_payload: false
  perfomance:
    max_search_threads: 8

cluster:
  enabled: false
  p2p:
    port: 6335

optimizers:
  max_segment_number: 10
  memmap_threshold_kb: 1024
  indexing_threshold_kb: 2000

hnsw_config:
  m: 16
  ef_construct: 100
  ef_search: 128
  full_scan_threshold: 10000

log_level: INFO

metrics:
  enabled: true
  address: "0.0.0.0"

Важно

  1. Пути: указывайте абсолютные пути (/var/lib/qdrant вместо ./storage).

  2. Кластер: для cluster.enabled: true обязательны peer_id и initial_peer_addresses.

  3. Производительность:

    • Увеличьте hnsw_config.ef_search для точного поиска.

    • Для больших коллекций (>1M векторов) настройте optimizers.memmap_threshold_kb.

    • storage.on_disk_payload: true (если RAM < 32GB).