Как установить Hister: персональный поиск для своих данных
Руководство по развертыванию Hister на VPS для индексации локальных файлов и истории браузера. Инструкция охватывает установку Docker, настройку TLS и подключение MCP.
Что такое Hister и чем он не является
Hister — это персональная поисковая система для самостоятельного хостинга. Она индексирует полный текст посещенных вами страниц и хранимых файлов, позволяя выполнять поиск по этой коллекции через веб-интерфейс, терминальный клиент, HTTP API или ИИ-ассистента. Hister отвечает на один вопрос: где я это читал.
Большинство пользователей знакомы с этой концепцией благодаря SearXNG, однако это разные инструменты. Если вам известно более старое название Searx, то этот проект больше не поддерживается, а его README теперь указывает на Hister как на новый проект автора. Searx и SearXNG остаются отдельными проектами, при этом SearXNG является поддерживаемым форком, поэтому именно его следует разворачивать для создания нового экземпляра метапоиска. SearXNG — это метапоисковый прокси. Ваш запрос поступает в него, он опрашивает другие поисковые системы от вашего имени и возвращает результаты, удалив из них трекеры. Индекс принадлежит этим поисковым системам. Hister создает собственный индекс из контента, который вы ему предоставили: страниц, захваченных расширением браузера, импортированной истории браузера, просканированных URL и файлов в указанных вами директориях. Самостоятельно развернутый экземпляр SearXNG обеспечивает приватный доступ к публичному вебу. Hister предоставляет поиск по тому, что читали вы сами. Задачи разные, поэтому запуск обоих инструментов на одном сервере — обычная практика. Если вы планируете это сделать, стоит знать, насколько SearXNG на самом деле скрывает ваш поиск, поскольку он подменяет ваш IP на IP вашего сервера при обращении к поисковым системам, а не скрывает сами запросы.
Hister — это свободное программное обеспечение, распространяемое по лицензии AGPLv3 (GNU Affero General Public License, версия 3) или более поздней. В нем нет телеметрии, и оно не требует облачных сервисов. В этом руководстве используется версия v0.17.0, которая была актуальным релизом на 2026-07-28. На 2026-10-12 актуальным релизом была версия v0.20.0. На 2026-10-29 актуальным релизом была версия v0.21.0. На 2026-11-19 актуальным релизом является v0.22.0 — первый релиз под новым названием проекта, Nogon. Приведенные ниже команды написаны для версии v0.17.0, а немногие упомянутые здесь функции, появившиеся позже, отмечены версией, в которой они были добавлены. Перед копированием команд проверьте страницу релизов, чтобы узнать актуальный тег, и используйте именно его.
Обновление до версии v0.22.0 требует большего, чем просто замена номера версии ниже. Новые загрузки используют имя бинарного файла nogon, config create заменяет create-config, а user create и user update заменяют create-user и update-user. Перед обновлением остановите сервер и выполните полное резервное копирование, сохранив существующие пути к данным и тома контейнеров. Существующие установки расширений для браузера получат переименование через обновления в магазине и сохранят свои настройки.
Почему стоит разместить Hister на собственном VPS
Индекс полезен только тогда, когда он полон, а полным он будет лишь в том случае, если сервер работал во время вашего чтения. Ноутбук находится в спящем режиме половину дня. Страницы, которые вы открываете на телефоне в это время, не попадают в индекс, а ночной импорт не запускается. VPS (виртуальный выделенный сервер) работает постоянно, поэтому каждое ваше устройство отправляет данные в один и тот же индекс, а индексатор продолжает работу, пока вы спите.
Вторая причина — изоляция. Настройка user_handling: true в секции app предоставляет каждой учетной записи собственные учетные данные и собственную коллекцию документов на одном экземпляре. Таким образом, один сервер может обслуживать семью или небольшую команду, при этом никто не сможет искать в истории чтения других пользователей.
Третья причина — инфраструктура. На VPS уже есть публичное имя хоста и сертификат. Они нужны расширению браузера, чтобы подключаться к серверу из сети, которой вы не управляете. На этом сервере та же пара выполняет и другую задачу: openGym регистрирует первый passkey для имени хоста, доступного в этот момент. Поэтому имя хоста и сертификат нужно настроить до создания первой учётной записи.
Установка первым способом: релизный бинарный файл
Hister поставляет один бинарный файл для каждой платформы. Загрузите его вместе с файлом контрольных сумм и выполните проверку перед установкой.
cd /tmp
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_linux_amd64
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_checksums.txt
sha256sum --ignore-missing -c hister_0.17.0_checksums.txtУспешным результатом является одна строка hister_0.17.0_linux_amd64: OK. Строка FAILED означает, что файл поврежден или изменен, поэтому загрузите его заново, прежде чем приступать к установке.
Установите бинарный файл, затем создайте системную учетную запись и каталоги, которые он будет использовать.
sudo install -m 755 /tmp/hister_0.17.0_linux_amd64 /usr/local/bin/hister
sudo useradd --system --home-dir /var/lib/hister --shell /usr/sbin/nologin hister
sudo install -d -o hister -g hister -m 750 /var/lib/hister
sudo install -d -m 755 /etc/hister
sudo hister create-config /etc/hister/config.ymlКоманда create-config создает файл конфигурации по умолчанию и подтверждает, что бинарный файл запускается на данной машине. Если загружена версия для неверной архитектуры, выполнение завершится ошибкой cannot execute binary file: Exec format error.
Отредактируйте несколько важных параметров. Остальную часть созданного файла можно оставить без изменений.
app:
directory: /var/lib/hister
access_token: 'paste-a-long-random-string-here'
server:
address: 127.0.0.1:4433
base_url: https://hister.example.comСгенерируйте токен с помощью openssl rand -hex 32. Теперь файл содержит учетные данные, поэтому ограничьте права доступа к нему до запуска службы.
sudo chown root:hister /etc/hister/config.yml
sudo chmod 640 /etc/hister/config.ymlЗапуск под управлением systemd
Создайте файл /etc/systemd/system/hister.service:
[Unit]
Description=Hister personal search engine
After=network-online.target
Wants=network-online.target
[Service]
User=hister
Group=hister
Environment=HISTER_CONFIG=/etc/hister/config.yml
ExecStart=/usr/local/bin/hister listen
Restart=on-failure
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ReadWritePaths=/var/lib/hister
[Install]
WantedBy=multi-user.targetHISTER_CONFIG — это документированная переменная окружения для пути к конфигурации, поэтому юнит не зависит от домашнего каталога учетной записи hister. Параметр ProtectSystem=strict делает всю файловую систему доступной только для чтения для этого сервиса, поэтому в ReadWritePaths необходимо указать каталог с данными. Параметр ProtectHome=yes скрывает /home от сервиса, поэтому отслеживаемый каталог внутри /home будет выглядеть пустым для индексатора. Удалите эту строку, если вам нужно индексировать файлы в этом месте.
sudo systemctl daemon-reload
sudo systemctl enable --now hister
systemctl status hister --no-pager
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:4433/Любой HTTP-код ответа, выведенный последней командой, означает, что процесс прослушивает порт. curl: (7) Failed to connect означает, что это не так, а journalctl -u hister -n 50 --no-pager укажет причину.
Вариант установки два: Docker Compose
Образ опубликован в GitHub container registry, по одному тегу на каждый релиз.
services:
hister:
image: ghcr.io/asciimoo/hister:v0.17.0
container_name: hister
user: '1000:1000'
restart: unless-stopped
environment:
- HISTER__SERVER__ADDRESS=0.0.0.0:4433
- HISTER__SERVER__BASE_URL=https://hister.example.com
- HISTER__APP__ACCESS_TOKEN=${HISTER_ACCESS_TOKEN}
volumes:
- ./data:/hister/data
ports:
- 127.0.0.1:4433:4433Каждый ключ конфигурации имеет переопределение через переменную окружения в формате HISTER__<SECTION>__<KEY>, где два символа подчеркивания используются в качестве разделителя, поэтому для развертывания контейнера не требуется монтировать файл конфигурации. Храните HISTER_ACCESS_TOKEN в файле .env рядом с файлом compose. Если вы предпочитаете редактировать файл, docker run --rm ghcr.io/asciimoo/hister:v0.17.0 create-config > config.yml выведет значения по умолчанию.
В двух строках выше легко допустить ошибку, и обе их стоит изучить.
Адрес внутри контейнера должен быть 0.0.0.0:4433. У контейнера собственное сетевое пространство имен, поэтому процесс, привязанный к 127.0.0.1 внутри него, доступен только изнутри этого контейнера, и опубликованному порту нечего перенаправлять.
Опубликованный порт записывается как 127.0.0.1:4433:4433, а не 4433:4433. Docker публикует порты, вставляя собственные правила netfilter, и эти правила оцениваются до правил ufw, поэтому обычный 4433:4433 остается доступным из интернета даже на сервере, где ufw status показывает, что порт закрыт. Привязка хостовой стороны к 127.0.0.1 оставляет обратный прокси единственным способом доступа. Эта же ловушка применима к любому контейнеру на сервере, а Docker Compose на VPS охватывает остальные аспекты этой темы.
Строка user: '1000:1000' запускает контейнер с UID 1000 и GID 1000, переопределяя значения по умолчанию UID и GID 65532 официального образа v0.17.0, поэтому ./data должен быть доступен для записи пользователем с UID 1000 и GID 1000. Если директория не существует, создайте ее с помощью mkdir -p ./data; sudo chown -R 1000:1000 ./data передает владение этой учетной записи. На хосте с включенным SELinux используйте ./data:/hister/data:Z, чтобы Docker назначил соответствующую метку. Если эти числа вам незнакомы, сначала прочитайте с какими UID и GID контейнер записывает файлы.
Почему персональный поисковый индекс опасно делать публичным
По умолчанию Hister прослушивает 127.0.0.1:4433, и это сделано намеренно. Подумайте, что содержит индекс после месяца использования: страницы внутренней вики, счета, тикеты в службу поддержки, открытые в авторизованном состоянии, страницы сброса паролей и полный текст всего остального, что вы читали. В документации проекта прямо сказано: «Hister передает всю вашу историю браузера, включая содержимое страниц, на сервер и обратно».
Утекшую базу паролей еще нужно взломать. Утекший персональный индекс — это открытый текст, по которому уже можно искать, поэтому он требует больше защиты, чем небольшое self-hosted приложение, на которое он похож.
Из этого следуют два факта. Hister «из коробки» не требует аутентификации, поэтому один лишь reverse proxy сделает копию вашей истории поиска доступной любому, кто узнает имя хоста. Конечная точка MCP также по умолчанию доступна по адресу /mcp, и без токена любой клиент, имеющий к ней доступ, может выполнять поиск по индексу.
Настройте аутентификацию до того, как сервис впервые выйдет за пределы localhost. Одному пользователю достаточно app.access_token — это общий секретный ключ, который используется расширением браузера, терминальным клиентом и любым MCP-клиентом. Для нескольких пользователей настройте user_handling: true и создайте учетные записи:
sudo -u hister hister create-user alice --admin --config /etc/hister/config.ymlКоманда запросит пароль длиной от 8 до 72 байт в кодировке UTF-8. Поскольку символ Unicode может занимать несколько байт, пароль может состоять менее чем из восьми символов. Каждая учетная запись получает свои документы и персональный API-токен, который владелец может пересоздать на странице профиля или с помощью флага --regen-token для hister update-user. Генерация нового токена немедленно аннулирует предыдущий, поэтому после этого потребуется обновить все устройства, использующие данную учетную запись.
Не меняйте app.public, если вы не уверены в своих действиях. Публичный режим разрешает неавторизованный поиск, просмотр превью, передачу файлов и поиск через MCP, но при этом блокирует запись, доступ к истории и административные операции.
Reverse proxy, TLS и межсетевой экран
Hister не поддерживает HTTPS самостоятельно, поэтому завершайте TLS (transport layer security) перед ним. Caddy — самый простой путь, так как он запрашивает и обновляет сертификаты автоматически через ACME (automatic certificate management environment).
hister.example.com {
reverse_proxy 127.0.0.1:4433
}Перезагрузите его с помощью sudo systemctl reload caddy. Для этой конфигурации DNS-записи для hister.example.com должны указывать на этот сервер: это может быть A-запись для IPv4, AAAA-запись для IPv6 или обе сразу. Caddy по умолчанию включает проверку HTTP-01 на 80 порту и TLS-ALPN-01 на 443 порту, поэтому 80 порт не обязателен, если проверка проходит через 443 порт. Let's Encrypt выполняет проверку как по IPv6, так и по IPv4, при этом сначала пытается использовать AAAA-адрес. Поэтому устаревшая AAAA-запись от предыдущего хоста может привести к сбою проверки, даже если A-запись верна. Если DNS настроен неверно или ни один из методов проверки не сработал, браузер выдаст ошибку TLS вместо страницы, а в логах Caddy будут повторяться сообщения о неудачной проверке.
Затем закройте всё остальное.
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw statusПорт 4433 намеренно отсутствует в этом списке. Публичное доменное имя — не единственный способ доступа, и onion-сервис, направленный на тот же loopback-порт, позволяет открывать ваш индекс с собственных устройств без DNS-записей и открытых входящих портов.
server.base_url должен совпадать с адресом, который вы вводите в браузере, включая схему. Неверный префикс пути в base_url нарушает ссылки на статические файлы, из-за чего интерфейс отображается без стилей и изображений. Тот же URL необходимо указать в расширении для браузера.
Наполнение индекса
Браузерное расширение является основным сборщиком данных. Установите его из Mozilla Add-ons или Chrome Web Store, откройте страницу параметров, укажите URL сервера в https://hister.example.com и вставьте токен доступа. Поддержка токенов в расширении появилась в версии v0.18.0; в версии v0.17.0 вместо этого используется сессия, полученная при входе в веб-интерфейс. Расширение захватывает заголовок, полный текст, HTML и favicon каждой посещаемой страницы и отправляет их на ваш сервер. Извлечение данных происходит на стороне клиента, внутри браузера. Расширение не взаимодействует с третьими лицами, единственный внешний запрос выполняется только для получения favicon страницы.
Извлечение данных на стороне клиента делает возможным создание приватного индекса. Расширение видит страницу в точности так же, как вы, после входа в систему и рендеринга, поэтому внутренняя страница вики или платная статья индексируются корректно, а серверу не требуются ваши учетные данные. Это также означает, что всё просматриваемое вами содержимое является кандидатом на индексацию, поэтому правила исключения (skip rules) имеют приоритет над добавлением контента.
Правила исключения хранятся в rules.json при однопользовательской установке или для каждого пользователя в базе данных; вкладка Rules в веб-интерфейсе — самый простой способ их редактирования. Это регулярные выражения Go, которые сопоставляются с полным URL:
^https://mail\.example\.com
^https://bank\.example\.comШаблон вида ^mail.example.com никогда не совпадет, так как проверяемая строка начинается с https://. Завершающий $ не сработает, если после нормализации остается строка запроса. Удаляются только параметры utm_*, поэтому /login$ может совпасть с https://example.com/login?utm_source=email, но не с https://example.com/login?auth=1.
Существующая история импортируется путем чтения собственной базы данных браузера, поэтому данная команда выполняется на машине, где находится профиль браузера — то есть на вашем ноутбуке, а не на VPS. Установите там тот же бинарный файл и укажите адрес сервера:
export HISTER_TOKEN='your-access-token'
hister import browser firefox -u https://hister.example.com -t "$HISTER_TOKEN"Импорт запускается как возобновляемая задача с именем browser-import-YYYY-MM-DD, поэтому вы можете прервать её и запустить снова позже. Сервисы закладок импортируются аналогичным образом. Версия v0.17.0 поддерживает Linkwarden, Karakeep и Shaarli, в v0.18.0 добавлены Linkding, Readeck и Wallabag, а в v0.20.0 — Raindrop.io. Повторный импорт из Linkwarden, Karakeep, Shaarli, Linkding, Readeck или Wallabag извлекает только те данные, которые новее предыдущего импорта.
Файлы на сервере индексируются путем указания директорий в конфигурации:
indexer:
directories:
- path: '/var/lib/hister/documents'
filetypes: ['pdf', 'docx', 'md', 'txt']PDF, DOCX, Markdown, Org mode и корректные текстовые файлы в кодировке UTF-8 считываются как полнотекстовые. Фотографии и видео в этот список не входят, поэтому для библиотеки изображений требуется сервер, который индексирует лица, места и даты, а не текст; для этой задачи обычно сравнивают PhotoPrism и Immich. Отдельная страница добавляется с помощью hister index https://example.com. Преобразование целых сайтов в чистый текст для других инструментов — это отдельная задача, решаемая с помощью самохостируемых краулеров, преобразующих страницы в чистый текст.
Поиск основан на полях, поэтому изучение языка запросов займет около десяти минут:
"connection reset" domain:github.com added:<30d
title:(wireguard|nftables) -tutorial sort:-visitsПоле sort: появилось в версии v0.18.0, поэтому не используйте его во втором запросе при работе с v0.17.0.
Использование агента для работы с собственным индексом через MCP
MCP (model context protocol) — это интерфейс, который ассистент использует для вызова инструментов на сервере. Hister предоставляет его по адресу POST /mcp с тем же базовым URL через транспорт streamable HTTP и открывает search, get_preview и get_history. Для аутентификации используется тот же bearer token, что и для остального API. Если вызов инструментов для вас в новинку, написать небольшой agent loop самостоятельно — самый быстрый способ понять, какие данные такой endpoint фактически передаёт ассистенту.
{
"mcpServers": {
"hister": {
"url": "https://hister.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
}
}
}Заголовок X-Access-Token работает как альтернатива Authorization.
Ценность этого подхода заключается в том, что именно ищет агент. Открытый веб-поиск возвращает то, что имеет высокий рейтинг сегодня, что для быстро развивающегося ПО часто означает документацию для версии, которую вы не используете. Ваш собственный индекс возвращает страницу, которую вы уже прочитали и решили сохранить, а get_preview предоставляет сохраненную копию, поэтому ответ остается доступным, даже если исходная страница исчезнет из сети. Предоставьте агенту оба источника, если вам нужны и публичные результаты: инструмент поиска в браузере на базе SearXNG добавляет открытый веб в качестве отдельного инструмента. Как только вы запустите более одного из этих эндпоинтов, стоит прочитать размещение MCP-серверов на VPS, так как каждый из них сталкивается с этой проблемой доступа.
Диск, резервное копирование и обслуживание
Согласно документации, одна проиндексированная страница занимает около 100 KB с учетом сжатого превью, поэтому сто тысяч страниц — это примерно 10 GB. Система квот отсутствует. Часто путают две настройки: indexer.max_file_size_mb (по умолчанию 1 MiB) ограничивает размер одного отслеживаемого файла, а server.max_batch_body_size (по умолчанию 40 MiB) ограничивает один запрос к batch API. Вторая настройка появилась после версии v0.17.0, в которой пакетный запрос был жестко ограничен 5 MiB.
В каталоге, указанном в app.directory, хранятся index.db с индексными файлами для каждого языка, db.sqlite3 для учетных записей и заданий, data/html/ для превью и rules.json. Резервная копия — это остановленный сервис плюс копия всего этого каталога и файла конфигурации. hister export backup.json записывает документы в формате JSON для миграции, это не является резервной копией сервера.
Следует знать две команды для обслуживания. hister reindex перестраивает поисковые индексы, что необходимо после изменения настроек индексатора. Если при крупном импорте растет потребление памяти, установите detect_languages: false в секции indexer и выполните переиндексацию. hister cleanup удаляет осиротевшие файлы превью и favicon, оставшиеся после удаления страниц.
Удаление выполняется через запрос, поэтому сначала запустите его в тестовом режиме:
hister delete 'domain:example.com' --dry --verboseУдаленная страница вернется, если сборщик продолжит её отправлять, поэтому добавьте правило пропуска перед удалением.
Запуск неизмененной копии Hister для собственных нужд не накладывает обязательств, так как AGPLv3 подтверждает неограниченное право на запуск неизмененной программы. Передача копий другим лицам, измененных или нет, сопряжена с условиями, такими как сохранение уведомлений об авторских правах и лицензии, а также предоставление получателям копии лицензии. Если вы модифицируете Hister и позволяете другим людям использовать вашу версию по сети, лицензия также требует предоставить им доступ к вашему модифицированному исходному коду.
Режимы сбоев и сообщения, которые вы увидите
Сервер не запускается. Занятый порт 4433 или синтаксическая ошибка в YAML — две причины; проверка конфигурации и доступ к каталогу данных также останавливают запуск. Привязка к 0.0.0.0 без server.base_url вызывает base_url must be specified when listening on, а невозможность записи секретного ключа приводит к failed to create secret key file. sudo ss -lntp | grep 4433 показывает, какой процесс занимает порт, а journalctl -u hister -n 50 --no-pager выводит ошибку запуска.
Интерфейс загружается, но выглядит некорректно. Если текст перемешан, а изображения отсутствуют, проверьте префикс пути в server.base_url. Hister удаляет завершающий слэш из этого параметра.
Расширение не подключается. URL сервера в расширении должен совпадать с base_url, сервер должен быть запущен и обновлен, а промежуточный межсетевой экран может блокировать соединение без вывода сообщений на странице. Firefox не выводит логи расширений в обычную консоль: откройте about:debugging#/runtime/this-firefox и изучите расширение Hister.
Контейнер завершает работу при запуске. Ошибка прав доступа к ./data требует проверки владельца, прав на запись и меток SELinux. Этот compose-файл явно запускается от имени UID 1000 и GID 1000, переопределяя стандартные для образа UID и GID 65532. Предоставьте этой учетной записи права на запись в ./data; на хосте с SELinux добавьте :Z к bind mount.
Ошибка 403 Forbidden при обращении к административному маршруту. POST /api/reindex и POST /api/cleanup доступны только администраторам при включенной обработке пользователей, поэтому обычному аккаунту в доступе будет отказано.
Потребление памяти растет во время импорта. Обычно это вызвано определением языка в большой истории. Установите detect_languages: false и после этого выполните hister reindex.
FAQ
Чем Hister отличается от SearXNG?
SearXNG — это метапоисковый прокси: он перенаправляет ваш запрос к публичным поисковым системам и возвращает их результаты, удаляя трекеры, поэтому индекс принадлежит этим системам. Hister хранит собственный полнотекстовый индекс страниц, которые вы посетили, и файлов, которые вы сохранили, поэтому он отвечает на вопрос «где я это читал», в то время как SearXNG отвечает на вопрос «что об этом говорит интернет». Они решают разные задачи, и многие пользователи запускают оба сервиса на одном сервере.
Безопасно ли хранить всю историю браузера на VPS?
Только при условии предварительной настройки доступа. Hister привязывается к 127.0.0.1:4433 и по умолчанию не требует аутентификации. Установите app.access_token или user_handling: true, настройте перед ним reverse proxy с TLS и закройте порт 4433 на межсетевом экране. Полнотекстовый индекс вашей истории — это обычный текст, поэтому любой, кто получит доступ к порту, сможет прочитать всё без необходимости взлома.
Нужно ли мне расширение для браузера или достаточно импортировать историю?
Импорт — это разовая операция по заполнению данных. Он считывает собственную базу данных истории браузера, поэтому выполняется на компьютере, где находится профиль браузера, а не на сервере. Расширение поддерживает индекс в актуальном состоянии после импорта и захватывает страницы, требующие авторизации, так как извлекает контент в браузере после отрисовки страницы. Стандартная схема использования: один импорт, затем работа через расширение.
Может ли агент для программирования искать по моему индексу Hister?
Да. Hister является MCP-сервером (model context protocol) по адресу POST /mcp относительно вашего базового URL, предоставляя методы search, get_preview и get_history. Укажите клиенту адрес https://your-host/mcp с заголовком Authorization: Bearer, содержащим ваш токен доступа. После этого агент сможет искать по документации, которую вы действительно читали, и именно в той версии, которую вы изучали, а не по результатам, которые сегодня выдает публичный поисковик.