> 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/sphinx.md).

# Sphinx

https\://sphinxsearch.com/

**Sphinx** (расшифровывается как SQL Phrase Index) — это система полнотекстового поиска, разработанная для работы с большими объёмами текстовых данных. Её ключевое преимущество — высокая скорость как индексации (создания индекса), так и самого поиска.

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

Используем готовые бинарные файлы Sphinx 3.4.1, RT-индекс и порт `9312`.

#### 1. Установить необходимые пакеты

Выполнить от имени `root`:

```bash
apt update
apt install -y curl tar
```

#### 2. Скачать и установить Sphinx 3.4.1

```bash
cd /tmp

curl -fsSL --connect-timeout 10 --retry 3 \
  -o sphinx.tar.gz \
  https://sphinxsearch.com/files/sphinx-3.4.1-efbcc65-linux-amd64.tar.gz

tar -xzf sphinx.tar.gz

SPHINX_DIR="$(find /tmp -maxdepth 1 -type d -name 'sphinx-*' | head -n 1)"

cp -f "${SPHINX_DIR}"/bin/* /usr/bin/

chmod 755 /usr/bin/searchd /usr/bin/indexer \
  /usr/bin/indextool /usr/bin/wordbreaker
```

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

```bash
mkdir -p /home/sphinxdata/{binlogs,dic,indexes,logs}
```

#### 4. Скачать словари морфологии

```bash
curl -fsSL --connect-timeout 10 --retry 3 \
  -o /home/sphinxdata/dic/ru.pak \
  https://sphinxsearch.com/files/dicts/ru.pak

curl -fsSL --connect-timeout 10 --retry 3 \
  -o /home/sphinxdata/dic/en.pak \
  https://sphinxsearch.com/files/dicts/en.pak

chmod 644 /home/sphinxdata/dic/*.pak
```

#### 4. Создать конфигурацию

Файл `/home/sphinxdata/sphinx.conf`:

```shell
index hostcms
{
    type = rt
    path = /home/sphinxdata/indexes/hostcms
    
    rt_mem_limit = 256M

    morphology = lemmatize_ru, lemmatize_en

    rt_field = title
    rt_field = text

    rt_attr_string = title
    rt_attr_string = url

    rt_attr_uint = datetime
    rt_attr_uint = size
    rt_attr_uint = inner
    rt_attr_uint = module
    rt_attr_uint = module_id
    rt_attr_uint = module_value_type
    rt_attr_uint = module_value_id
    rt_attr_uint = site_id
    rt_attr_uint = rest

    rt_attr_multi = siteuser_group_id
    
    # {SITE_DIR} указать полный путь до файла asmp_smartsearch_wordform_X
    # {SITE_Id} указать ID сайта
    # mappings = /{SITE_DIR}/hostcmsfiles/asmp_smartsearch/asmp_smartsearch_wordform_{SITE_Id}.txt
}

indexer
{
    mem_limit = 256M
    lemmatizer_cache = 128M
}

searchd
{
    listen = 9312:mysql41

    log = /home/sphinxdata/logs/searchd.log
    query_log = /home/sphinxdata/logs/query.log
    pid_file = /home/sphinxdata/searchd.pid
    binlog_path = /home/sphinxdata/binlogs

    read_timeout = 5
    max_children = 30
    seamless_rotate = 1
    preopen_indexes = 1
    unlink_old = 1
    workers = threads
}

common
{
    lemmatizer_base = /home/sphinxdata/dic
}
```

#### 5. Запустить Sphinx

После создания конфигурации:

```bash
searchd --config /home/sphinxdata/sphinx.conf
```

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

```bash
searchd --version
ss -lntp | grep 9312
mysql -h 127.0.0.1 -P 9312 -e "SHOW TABLES;"
```

#### Управление Sphinx

| Действие  | Команда                                              |
| --------- | ---------------------------------------------------- |
| Запуск    | `searchd -c /home/sphinxdata/sphinx.conf`            |
| Остановка | `searchd -c /home/sphinxdata/sphinx.conf --stopwait` |
| Логи      | `tail -f /home/sphinxdata/logs/searchd.log`          |

Примечание: без настройки системной службы Sphinx потребуется запускать вручную после перезагрузки сервера.
