Typesense — это высокопроизводительное и гибкое решение для полнотекстового поиска с открытым исходным кодом, предназначенное для быстрого и точного поиска информации в больших объёмах данных. Благодаря своей эффективности и простоте интеграции, Typesense широко применяется в веб-приложениях и системах электронной коммерции для организации удобного поиска и фильтрации товаров, документов и других типов данных.

Эта статья подробно описывает установку и настройку Typesense на операционной системе Ubuntu, включая шаги по установке официального DEB-пакета, созданию необходимого конфиг-файла и проверке работоспособности установленного решения.

Установка Typesense на Ubuntu выполняется посредством официального пакета DEB, что упрощает процесс установки и позволяет легко управлять сервером благодаря встроенной поддержке systemd.

Шаг 1: Обновление сервера и установка необходимых инструментов

Прежде всего, убедитесь, что списки пакетов обновлены и установите утилиты curl и wget, если они ещё отсутствуют.

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget

Шаг 2: Загрузка пакета DEB Typesense

Переместитесь в временную директорию и скачайте последнюю версию пакета DEB. Актуальный номер версии можно посмотреть на официальном сайте загрузки Typesense.

Например, для актуальной версии на конец 2025 года (версия 29.0 используется как демонстрационная):

cd /tmp
# Скачать пакет для архитектуры AMD64
curl -O https://dl.typesense.org/releases/29.0/typesense-server-29.0-amd64.deb
# Или для архитектуры ARM64, если требуется
# curl -O https://dl.typesense.org/releases/29.0/typesense-server-29.0-arm64.deb

Шаг 3: Установка пакета DEB

Установите загруженный пакет с помощью команды apt install. Во время установки автоматически создаётся служба systemd для управления сервером Typesense.

sudo apt install ./typesense-server-29.0-amd64.deb

Шаг 4: Настройка Typesense

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

sudo mkdir -p /etc/typesense
sudo nano /etc/typesense/typesense-server.ini

Скопируйте следующий шаблон файла конфигурации, заменив значение параметра api-key на собственный безопасный ключ:

[server]
api-address = 0.0.0.0
api-port = 8108
data-dir = /var/lib/typesense
api-key = ВАШ_ЗАЩИЩЁННЫЙ_API_КЛЮЧ
log-dir = /var/log/typesense

Сохраните изменения и закройте редактор.

Шаг 5: Запуск и проверка службы

Перезапустите службу Typesense, чтобы применить новые настройки, и проверьте её состояние:

sudo systemctl restart typesense-server
sudo systemctl status typesense-server

Вы можете убедиться, что Typesense запущен правильно, проверив точку здоровья сервиса:

curl http://localhost:8108/health

При успешном выполнении команда должна вернуть {"ok": true}.

Шаг 6: (Опционально) Настройка межсетевого экрана

Если на вашем сервере включен межсетевой экран (например, UFW), вероятно, потребуется разрешить доступ к порту API (по умолчанию 8108).

sudo ufw allow 8108/tcp
sudo ufw enable

Теперь ваша система готова к работе с Typesense.