> For the complete documentation index, see [llms.txt](https://support.morozovpimnev.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.morozovpimnev.ru/umnyi-poisk/qdrant.md).

# Qdrant

https\://qdrant.tech/

**Qdrant** — это векторная база данных с открытым исходным кодом, созданная для работы с данными в виде числовых векторов (эмбеддингов) и обеспечивающая высокопроизводительный поиск по их смысловой близости. Она написана на языке Rust, что обеспечивает высокую скорость и безопасность памяти. 

### Установка Qdrant на сервер (Debian 12/13, Ubuntu)

Для работы модуля «Умный поиск» рекомендуется установить Qdrant через Docker. Ниже приведён пример установки на тот же сервер, где размещена HostCMS.

#### 1. Установить Docker

Если Docker уже установлен, пропустите этот шаг.

```bash
apt update
apt install -y docker.io
systemctl enable --now docker
```

#### 2. Создать каталог для хранения данных

```bash
mkdir -p /opt/qdrant/storage
```

#### 3. Запустить Qdrant

```bash
docker run -d \
  --name qdrant \
  --restart unless-stopped \
  -p 127.0.0.1:6333:6333 \
  -v /opt/qdrant/storage:/qdrant/storage \
  qdrant/qdrant:v1.18.1
```

Параметры запуска:

* `--restart unless-stopped` — автоматический запуск после перезагрузки сервера.
* `127.0.0.1:6333:6333` — доступ к Qdrant только с локального сервера.
* `-v /opt/qdrant/storage:/qdrant/storage` — постоянное хранение индексов и векторов.
* `qdrant/qdrant:v1.18.1` — используемая версия Qdrant.

#### 4. Проверить работу

```bash
docker ps
```

Проверить ответ API:

```bash
curl http://127.0.0.1:6333/
```

При успешном запуске Qdrant вернёт JSON с информацией о сервисе.

Если HostCMS и Qdrant установлены на одном сервере, дополнительная настройка Nginx не требуется.

#### 6. Основные команды управления

| Действие            | Команда                         |
| ------------------- | ------------------------------- |
| Запустить           | `docker start qdrant`           |
| Остановить          | `docker stop qdrant`            |
| Перезапустить       | `docker restart qdrant`         |
| Посмотреть логи     | `docker logs --tail 100 qdrant` |
| Проверить состояние | `docker ps -a`                  |

Важно: порт `6333` не следует открывать для внешнего доступа без авторизации. При указанной конфигурации Qdrant доступен только локально.