Как развернуть Iva: Telegram AI ассистент на VPS
Установите Iva версии 0.3.13 на свой VPS без открытия портов и настройки домена. Используйте systemd для запуска и Obsidian для управления базой знаний в Markdown.
Что вы создаете
Iva — это self-hosted ИИ-ассистент для Telegram. Это одно из немногих решений, которое можно развернуть, не открывая входящие порты и не привязывая доменное имя. Сертификаты также не требуются, так как на сервере нет компонентов, ожидающих публичных подключений. Сервис сам инициирует соединение с Telegram, удерживает его открытым и считывает ваши сообщения из ответов. Все остальное вытекает из этого единственного исходящего соединения.
Iva распространяется по лицензии MIT и написана на Node. Память ассистента представляет собой папку с обычными markdown-файлами, которые можно открыть напрямую через Obsidian, поэтому заметки остаются доступными для чтения даже без самого приложения. В этом руководстве используется релиз v0.3.13, выпущенный 6 августа 2026 года. Репозиторий был переименован из smixs/iva в smixs/iva-agent, и в приведенных ниже командах используется новое имя.
Большинство self-hosted приложений требуют настройки DNS-записи и сертификата Let's Encrypt, выпущенного через Certbot. Iva полностью исключает этот уровень, поэтому для развертывания достаточно небольшого VPS за межсетевым экраном, который разрешает только SSH.
Почему Iva не требует открытых портов
iva-telegram-poll.service — это мост, работающий по принципу long polling. Он обращается к API getUpdates Telegram и ожидает ответа, поэтому каждое соединение инициируется с вашего сервера. Telegram никогда не подключается к вам напрямую, а значит, нет необходимости настраивать reverse proxy и следить за обновлением сертификатов.
Сам агент прослушивает только порт 127.0.0.1 8723. Документация проекта прямо указывает: не открывайте порт 8723 вовне, а любой reverse proxy перед ним должен сохранять требование bearer token. Проверьте адрес привязки после установки.
sudo ss -tlnp | grep 8723Адрес должен выглядеть как 127.0.0.1:8723. Использование wildcard-адреса, такого как 0.0.0.0:8723, означает, что HTTP-маршруты агента доступны из Интернета. Исправьте это перед тем, как передавать боту конфиденциальные данные.
Таким образом, межсетевой экран должен оставаться закрытым. Разрешите SSH до его включения, так как ufw enable без правила для SSH может привести к потере доступа к серверу.
sudo ufw allow OpenSSH
sudo ufw enable
sudo ufw statusЧто на самом деле делает однострочный установщик
На главной странице проекта приведена одна команда, которая передает скрипт с GitHub напрямую в bash. Сначала ознакомьтесь с содержимым скрипта, так как он выполняет гораздо больше действий, чем просто установку одной программы.
curl -fsSL https://raw.githubusercontent.com/smixs/iva-agent/main/install.sh -o iva-install.sh
less iva-install.sh- Скрипт устанавливает системные пакеты с помощью обнаруженного менеджера пакетов:
git,gh,python3,ffmpeg,pandocиpoppler-utils. - Он пытается создать файл подкачки размером 2 GB по пути
/swapfileили активировать существующий, если объем оперативной памяти менее 1500 MB, а общий объем подкачки менее 1024 MB. - Он устанавливает nvm, а затем Node 24 — минимальную версию, необходимую для работы Iva.
- Он устанавливает
uv, менеджер пакетов Python, в директорию~/.local/bin. - Он клонирует репозиторий в
~/ivaи запускаетnpm ci. - Он устанавливает
agent-browserкак глобальный npm-пакет, который затем загружает Chromium, и устанавливает CLI для Google Workspace,gws, как глобальный npm-пакет без прав sudo. - Он запускает мастер настройки, выполняет сборку проекта и создает хранилище.
- Он записывает команду
ivaв~/.local/binи устанавливает пользовательские юниты systemd.
Это большой объем программного обеспечения для одной команды. Это также объясняет указание в README устанавливать программу от имени обычного пользователя, а не root: в дальнейшем инструменты оболочки агента будут выполняться с теми же привилегиями, что были у установщика. Скрипт вызывает sudo только для установки пакетов и создания файла подкачки, а также, возможно, один раз для этапа с Chromium через вспомогательный скрипт, который выполняет команды напрямую, если вы уже работаете от имени root.
Создание выделенного пользователя перед установкой
Выделите для Iva отдельную учетную запись. Агент выполняет shell-команды на хосте через child_process Node, без использования контейнеров или песочницы, поэтому учетная запись, от имени которой он запущен, является границей безопасности.
sudo adduser --disabled-password --gecos "" iva
sudo usermod -aG sudo iva
sudo install -d -m 700 -o iva -g iva /home/iva/.ssh
sudo cp ~/.ssh/authorized_keys /home/iva/.ssh/authorized_keys
sudo chown iva:iva /home/iva/.ssh/authorized_keys
sudo chmod 600 /home/iva/.ssh/authorized_keys
sudo loginctl enable-linger ivaenable-linger важен, так как Iva работает как user unit в systemd. Без включенного linger systemd обычно останавливает сервисы пользователя после завершения его последнего сеанса, поэтому помощник завершит работу при закрытии SSH-соединения. Это же правило действует для любых сервисов и таймеров, которые вы создаете в systemd самостоятельно.
Права sudo нужны учетной записи только во время установки пакетов. Отзовите их после завершения установки.
sudo deluser iva sudoВойдите в систему под этим пользователем напрямую по SSH. В оболочке, открытой через sudo -iu iva, не установлены переменные DBUS_SESSION_BUS_ADDRESS и XDG_RUNTIME_DIR, поэтому любая команда systemctl --user завершится ошибкой Failed to connect to bus. Проведение этой границы — это та же задача, что и запуск сервисов от имени пользователей с минимальными привилегиями.
Установка фиксированного релиза вместо передачи скрипта в bash
У установщика есть полезная особенность. Перед клонированием репозитория он проверяет, содержит ли директория, в которой находится скрипт, package.json с файлом "eve". Если это так, он выполняет сборку из этой копии и пропускает этап клонирования. Таким образом, вы можете самостоятельно выбрать версию.
git clone --branch v0.3.13 https://github.com/smixs/iva-agent.git ~/iva
cd ~/iva
git log -1 --oneline
bash install.shТеперь вы знаете, какой именно код выполняется. Вы не можете быть в этом уверены, если скрипт клонирует main в том состоянии, в котором репозиторий находится в текущий момент. Iva выпустила пять релизов в период с 4 по 6 августа 2026 года, поэтому main сегодня утром и main сегодня днём — это разные программы.
Переключение на тег оставляет git в состоянии detached HEAD. Это работает корректно, но учитывайте ограничение: iva update переводит рабочую копию на ветку обновлений, поэтому фиксация версии — это лишь известная точка отсчёта, а не постоянная заморозка. iva version выводит версию пакета и git commit, чтобы вы всегда могли видеть текущее состояние.
Чтобы намеренно перейти на более поздний релиз, выведите список тегов, переключитесь на выбранный вместо v0.3.13 ниже, а затем снова запустите установщик изнутри директории с кодом. Для чистой установки установщик также принимает тег релиза через BRANCH: он выполняет git clone --branch "$BRANCH" "$REPO_URL" "$INSTALL_DIR", а команда --branch в Git поддерживает теги. Среди переменных окружения доступны REPO_URL, BRANCH и INSTALL_DIR; самостоятельное переключение на тег — это ещё один способ зафиксировать версию.
cd ~/iva
git fetch --tags
git tag --list 'v*' | sort -V | tail -5
git checkout v0.3.13
bash install.sh --skip-setup
iva restart--skip-setup предотвращает повторный запуск мастера поверх уже работающей .env. После этого выполните iva version, чтобы подтвердить коммит, на котором вы остановились.
Пять шагов мастера настройки и требуемые ключи
- Поставщик модели и сама модель.
MODEL_PROVIDERпринимаетopencode,ollama,openrouterилиcodex. Мастер проверяет выбранную модель в реальном времени. OpenCode, Ollama и Codex получают списки моделей; OpenRouter принимает введенный вами slug и тестирует его с помощью вызова инструмента. - Голос и поиск. Ключ Deepgram расшифровывает голосовые заметки. Ключ для веб-поиска (Tavily, Exa, Parallel или Brave) является опциональным.
- Токен Telegram-бота от @BotFather, проверяемый через эндпоинт
getMe. - Контроль доступа. Вы отправляете боту сообщение, и мастер считывает ваш числовой ID пользователя из
getUpdates. - Системные настройки. Часовой пояс IANA, каталог хранилища и локальный порт, по умолчанию 8723.
OpenCode Go теперь требует собственный User-Agent клиента и стабильный заголовок x-opencode-session. Iva добавила эти заголовки в версии v0.4.1, поэтому используйте релиз с этим исправлением для Go, а не зафиксированную версию v0.3.13. Текущая политика Go также предполагает типичный трафик для агентов программирования.
Два из этих пунктов являются зависимостями, которые скрыты за формулировкой «одна команда». Iva не поставляется с моделью, поэтому для ответов ей требуется API-ключ модели или существующая подписка ChatGPT; бесплатные модели OpenRouter не требуют подписки на модель. Она также не расшифровывает аудио самостоятельно, поэтому для голосовых заметок нужен отдельный сервис. Модель nova-3 от Deepgram с DEEPGRAM_LANGUAGE=multi определяет язык, а новые учетные записи Deepgram получают стартовые кредиты, которых хватает на месяцы личного использования. Текстовые функции работают только с ключом модели. Только голосовые функции зависят от Deepgram.
Проверьте, что записал мастер.
grep -E '^(MODEL_PROVIDER|TELEGRAM_ALLOWED_USER_IDS|ASSISTANT_VAULT_DIR|IVA_PORT)=' ~/iva/.env
ls -l ~/iva/.envls должен выводить -rw------- с правами 0600, так как этот файл хранит все ключи, которые вы только что вставили. TELEGRAM_ALLOWED_USER_IDS должен содержать ваш числовой ID. Список разрешенных пользователей работает по принципу «запрещено по умолчанию», поэтому пустое значение означает, что Iva никому не отвечает.
Модель считывается один раз при запуске процесса. Редактирование MODEL_PROVIDER или имени модели в .env ничего не изменит, пока вы не выполните iva restart. В openrouter имя модели — это slug поставщика, например anthropic/claude-sonnet-4.5, а не просто название. В codex API-ключ отсутствует: iva login авторизуется через существующую подписку ChatGPT.
Сколько стоит ежемесячное использование Iva
Данные, на которых построен график
[
{
"plan": "Small VPS, monthly budget",
"usd_per_month": 5
},
{
"plan": "OpenCode Go model plan",
"usd_per_month": 10
},
{
"plan": "Ollama Cloud model plan",
"usd_per_month": 20
},
{
"plan": "Deepgram voice, starter credits",
"usd_per_month": 0
},
{
"plan": "Tavily web search, free tier",
"usd_per_month": 0
},
{
"plan": "VPS plus OpenRouter free text",
"usd_per_month": 5
}
]Цены на модели были проверены 5 ноября 2026 года; стоимость VPS — это ежемесячный бюджет, а не фиксированный тариф хостинга. Небольшой бюджет на VPS в размере 5 долларов США плюс план OpenCode Go за 10 долларов составляют около 15 долларов в месяц при соблюдении требований совместимости с Go, указанных выше. На странице Go от OpenCode указана именно эта ежемесячная цена без скидки за первый месяц. Ollama Cloud — это другой вариант подписки стоимостью 20 долларов за план Pro, при этом использование сверх включенных в план кредитов оплачивается отдельно. Голосовые функции стоят 0, пока действуют стартовые кредиты Deepgram.
Модели :free в OpenRouter не требуют покупки кредитов, поэтому использование бесплатной текстовой модели с поддержкой инструментов снижает общую стоимость примера до 5 долларов в месяц только за VPS. У бесплатных моделей есть лимиты использования; отдельные вызовы OpenRouter для обработки изображений в Iva и дополнительные платные функции могут увеличить расходы. Платные модели OpenRouter работают по системе pay as you go, поэтому счет зависит от вашего фактического использования. Это тот параметр, за которым нужно следить: помощник с длинной историей диалога может быстро превысить стоимость подписки. Установите переменную размера контекстного окна в соответствии с реальными возможностями модели, так как завышенное значение откладывает сжатие контекста и создает риск переполнения окна модели.
Два сервиса и два таймера
iva.serviceзапускает сам агент.iva-telegram-poll.serviceзапускает мост для long polling, который взаимодействует с Telegram.iva-memory-doctor.timerсрабатывает в 05:00 и выполняет ночное обслуживание хранилища.iva-update-check.timerсрабатывает в 10:00 и проверяет наличие более новой версии (release).iva-telegram-userbot.serviceсуществует только в том случае, если вы настроили дополнительный прокси Telethon.
iva status
systemctl --user status iva.service iva-telegram-poll.service
systemctl --user list-timers
iva logs polliva status выводит состояние обоих сервисов и обоих таймеров. systemctl --user list-timers показывает время следующего запуска для каждого таймера; так вы можете убедиться, что процедура очистки памяти действительно выполнится сегодня ночью. Оба сервиса должны находиться в состоянии active (running). Если один из них перезапускается в цикле, journalctl --user -u iva.service -n 100 укажет причину.
Разделение важно при отладке. Мост может работать и опрашивать серверы, пока агент неактивен; в этом случае Telegram примет ваше сообщение, но ответа на него не последует. iva logs poll позволяет отслеживать логи моста, iva logs — логи агента, поэтому два лога помогут понять, какая именно часть системы неисправна.
Где находится хранилище Obsidian и как выполнять его резервное копирование
ASSISTANT_VAULT_DIR по умолчанию использует vault внутри каталога установки, поэтому память располагается в ~/iva/vault. Это отдельный git-репозиторий, независимый от кода, что позволяет обновлять Iva, не затрагивая ваши заметки.
vault/CORE.mdсодержит постоянные факты и текущие настройки, ограниченные 1200 символами, и передается в каждом системном промпте.vault/daily/YYYY-MM-DD.md— это транскрипт дня, в который данные только добавляются.vault/cards/хранит типизированные карточки для контактов, проектов, решений, идей и заметок.vault/summaries/daily/,weekly/,monthly/иyearly/содержат сводные данные (rollups).vault/attachments/хранит файлы по датам, аvault/.graph/содержит граф связей.vault/schema.jsonопределяет типы карточек и правила их устаревания.
Сводные данные формируются по расписанию внутри процесса. Ежедневный проход в 04:00 преобразует вчерашний транскрипт в карточки и сводку, после чего перезаписывает CORE.md. Затем еженедельные, ежемесячные и ежегодные проходы последовательно сжимают эти данные. В 05:00 запускается «доктор памяти» (memory doctor), выполняющий детерминированную проверку без участия модели: он обеспечивает соблюдение схемы, перестраивает граф связей, обновляет индекс, а затем выполняет commit и push.
Этот push является вашей резервной копией, и это тот шаг, который часто пропускают. Если у хранилища нет git-ремоута, «доктор» пытается создать приватный репозиторий на GitHub через gh, для чего требуется аутентифицированный GitHub CLI.
gh auth login
systemctl --user start iva-memory-doctor.service
cd ~/iva/vault && git log --oneline -3Коммит с сегодняшней датой подтверждает локальное сохранение; проверьте лог «доктора» на наличие doctor: done, vault committed and pushed, чтобы убедиться, что резервная копия покинула сервер. doctor: no remote and gh unavailable означает, что push был пропущен, поэтому в случае выхода VPS из строя ваша память будет утеряна, если у вас нет другой резервной копии.
Храните копию, которую вы контролируете самостоятельно.
tar czf ~/iva-vault-backup.tgz -C ~/iva vaultСкопируйте этот файл с сервера с помощью scp, а затем удалите его с сервера. Чтобы прочитать память в Obsidian, укажите Obsidian путь к клону репозитория хранилища. Wikilinks и обратные ссылки работают в исходном виде, как и представление графа. Редактирование карточек и CORE.md вручную безопасно. Не трогайте MOC.md и .graph/, так как ночной проход процесса пересоздает их оба.
Относитесь к хранилищу как к журналу своей жизни
Этот каталог — датированная запись того, что вы сказали, с кем встретились и что решили, на арендованной вами машине. Из этого следуют два вывода.
Self-hosting переносит хранение данных, а не их обработку. Каждый запрос уходит провайдеру модели, а каждая голосовая заметка — в Deepgram. Хранилище принадлежит вам. Но запросы не являются приватными от компаний, которые их обслуживают. Запуск уровня памяти на собственном оборудовании, как в случае с сервером памяти Mem0 на вашем VPS, имеет ту же особенность: хранилище локально, но вызов модели всё равно покидает пределы сервера. Если тема слишком конфиденциальна для третьей стороны, не обсуждайте её в чате.
Область доступа этой учётной записи — всё хранилище целиком. Инструменты Iva работают на хосте напрямую через fs и child_process среды Node, без Docker и песочницы, поэтому в случае компрометации запроса злоумышленник получает все права пользователя, от имени которого запущен сервис. Именно поэтому учётная запись не содержит sudo после установки, и именно поэтому списку разрешённых адресов (allowlist) стоит уделить больше внимания, чем кажется: это шлюз, который определяет, чьи сообщения станут командами на вашем сервере. Если вы хотите иметь ассистента под рукой, не открывая порты наружу, используйте ту же схему, что и для доступа к self-hosted агенту Hermes с телефона, где клиент чата выполняет ту работу, которую в ином случае делала бы публичная точка входа.
Что ломается и какие сообщения вы увидите
Build killed, exit 137. Код завершения 137 означает принудительное завершение по сигналу SIGKILL (128 плюс сигнал 9). Это не всегда означает, что процесс был убит OOM-киллером (Out of Memory) ядра. Сигнал SIGKILL, отправленный вручную, дает тот же результат. Проверьте sudo journalctl -k -b на наличие отчета OOM, прежде чем считать это нехваткой памяти. Установщик пытается добавить или включить swap, если объем RAM менее 1500 MB, а общий объем swap менее 1024 MB (включая уже существующий). Если логи подтверждают OOM-kill, проверьте наличие swap перед его увеличением; используйте приведенные ниже команды, только если /swapfile еще не существует, а затем запустите установщик снова.
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
free -hFailed to connect to bus. Каждая команда systemctl --user выводит это сообщение, если у оболочки нет пользовательской шины сеанса, которую предоставляет sudo -iu iva. Откройте обычную SSH-сессию от имени этого пользователя или выполните export XDG_RUNTIME_DIR=/run/user/$(id -u iva) перед запуском команды.
Бот игнорирует вас. TELEGRAM_ALLOWED_USER_IDS пуст, а список разрешенных пользователей (allowlist) по умолчанию закрыт. Если список пуст, в ответ на прямое сообщение бот ответит, что он еще не настроен. Запустите iva config и отправьте боту сообщение, чтобы мастер обнаружил ваш числовой ID, затем выполните iva restart.
Бот замолкает сразу после iva config. До версии v0.1.4 мастер мог переместить IVA_PORT, не обновив ASSISTANT_HOST, из-за чего мост подключался к порту, на котором никто не отвечал. В закрепленном релизе локальные адреса синхронизируются; если у вас старая или отредактированная вручную конфигурация, сравните эти две строки, а затем перезапустите сервис.
grep -E '^(IVA_PORT|ASSISTANT_HOST)=' ~/iva/.env
iva restartГолосовое сообщение остается без ответа. Bot API Telegram отклоняет загрузку файлов размером более 20 MB, поэтому мост не получает длинные аудиозаписи и не может отправить их в Deepgram. Разделите файл на части перед отправкой.
ffmpeg -i long.ogg -f segment -segment_time 600 -c copy part-%02d.oggОчередь зависает и не отвечает. Застрявшее состояние рабочего процесса сохраняется после перезагрузки и ставится в очередь повторно, поэтому обычный перезапуск не помогает. iva reset помещает это состояние в карантин и перезапускает оба сервиса. /new в чате начинает новый диалог.
Chromium не запускается на Ubuntu 24.04. Ubuntu 24.04 ограничивает привилегии внутри пространств имен непривилегированных пользователей через AppArmor, поэтому для запуска песочницы Chromium требуется соответствующий профиль AppArmor. Установщик обходит это ограничение, записывая "--no-sandbox" в ~/.agent-browser/config.json. Учитывайте наличие этого файла. Он снижает уровень изоляции браузера, что является еще одной причиной, почему учетная запись не должна владеть ничем, кроме Iva.
FAQ
Нужен ли мне домен или открытый порт для самостоятельного размещения Iva?
Нет. Iva взаимодействует с Telegram через long polling: iva-telegram-poll.service вызывает getUpdates и ожидает ответа, поэтому все соединения являются исходящими с вашего сервера. Извне к серверу ничего подключаться не должно, поэтому вам не нужны ни DNS-запись, ни сертификат. HTTP-порт агента 8723 привязывается к 127.0.0.1, и документация проекта предписывает не открывать его наружу. Правильная конфигурация — это межсетевой экран, разрешающий только SSH.
Сколько стоит ежемесячное использование Iva?
Согласно ценам на модели, актуальным на 5 ноября 2026 года, бюджет на небольшой VPS в размере 5 долларов плюс OpenCode Go за 10 долларов составляют около 15 долларов США в месяц; для Go требуется исправление клиентских заголовков Iva, добавленное в v0.4.1. Тариф Pro в Ollama Cloud стоит 20 долларов, а использование сверх включенных кредитов оплачивается отдельно. Стартовые кредиты Deepgram покрывают расходы на голосовые функции на начальном этапе, а у Tavily есть бесплатный лимит. OpenRouter предлагает как платные, так и бесплатные модели: для текстовой модели :free с поддержкой инструментов покупка кредитов не требуется, что доводит итоговую сумму примера до 5 долларов за VPS, с учетом лимитов использования и любых платных функций распознавания изображений или дополнительных опций.
Где Iva хранит мои данные и как их резервировать?
По умолчанию в ~/iva/vault, путь к которому задается через ASSISTANT_VAULT_DIR. Это отдельный приватный git-репозиторий с файлами в формате markdown: CORE.md, daily/YYYY-MM-DD.md, cards/ и summaries/. В 05:00 «доктор памяти» (memory doctor) выполняет коммит и отправку (push), что полезно только при наличии удаленного репозитория, поэтому выполните gh auth login или добавьте свой удаленный репозиторий во время настройки. Также храните офлайн-копию с помощью tar czf ~/iva-vault-backup.tgz -C ~/iva vault и перемещайте этот файл за пределы сервера.
Являются ли мои данные приватными при самостоятельном размещении Iva?
Хранилище принадлежит вам. Обработка — нет. Хранилище остается на вашем диске до тех пор, пока вы не выполните push, а файл .env имеет права доступа 0600 и принадлежит пользователю сервиса. Вызовы моделей и транскрипция голоса осуществляются через облачные API, поэтому эти сообщения проходят через вашего провайдера моделей и Deepgram. Iva распространяется по лицензии MIT, поэтому вы можете точно изучить, что именно она отправляет, и изменить это. Список разрешенных пользователей Telegram работает по принципу «запрещено по умолчанию»: пустой файл TELEGRAM_ALLOWED_USER_IDS блокирует доступ для всех, включая вас.
Какие провайдеры моделей поддерживает Iva?
В закрепленном релизе v0.3.13 MODEL_PROVIDER поддерживает opencode (OpenCode Go), ollama (Ollama Cloud), openrouter и codex. Для OpenCode Go теперь требуются клиентские заголовки, добавленные в Iva v0.4.1, поэтому используйте релиз с этим исправлением для Go. OpenRouter принимает идентификатор вендора, такой как anthropic/claude-sonnet-4.5, и предлагает самый широкий выбор моделей. codex выполняет вход в существующую подписку ChatGPT через iva login и не требует API-ключа. В последующих релизах добавлены дополнительные маршруты, включая подписку Claude и пользовательский эндпоинт, совместимый с OpenAI. Укажите провайдера, установите соответствующее окно контекста согласно реальному размеру модели, а затем выполните iva restart, так как модель считывается один раз при запуске процесса.