Блог и Новости is*hosting - Хостинг-провайдер Нового Поколения

Установка Keitaro на VPS: подробное руководство по запуску

Written by Команда is*hosting | 14.07.2026 9:21:18

Ваш облачный трекер знает, какие офферы конвертят, а какие — нет. И те, кто им управляет, тоже это знают. В этом главная проблема SaaS-трекеров: данные ваших кампаний лежат на чужих серверах, и за эту «привилегию» вы еще и платите за каждый клик.

Keitaro — это селф-хост альтернатива SaaS-трекерам. Вы платите фиксированную цену за годовую лицензию, ставите трекер на свой VPS, и все данные остаются только у вас.

В этом руководстве мы подробно разберем реальную установку на тарифе Medium от is*hosting с ОС CentOS 9 x64.

Что такое Keitaro?

Keitaro создан специально для performance-маркетинга: арбитража трафика, медиабаинга и любых задач, где нужно распределять платный трафик по разным источникам и гео.

Как только пользователь переходит по ссылке кампании, Keitaro фиксирует клик и собирает все данные (гео, устройство, мобильный оператор, реферер, UTM-метки). Затем трекер применяет заданные вами правила (потоки) и перенаправляет пользователя на нужный лендинг или оффер. Информация о конверсиях возвращается через S2S-постбэк. Трекер связывает их с исходными кликами, поэтому вы видите точные показатели ROI в разрезе источников, sub-ID, офферов и устройств.

Главное отличие Keitaro от обычных систем аналитики — это система маршрутизации. Потоки (Flows) позволяют направлять трафик на разные офферы, опираясь на любые комбинации условий: гео, провайдера, ОС устройства, время суток или кастомные параметры рекламной сети. Например, по одной и той же ссылке пользователь с Android из Германии увидит один оффер, а пользователь с ПК из Канады — совершенно другой. А встроенные инструменты фильтрации ботов и клоакинга срабатывают на самом входе, еще до того, как клик дойдет до вашего оффера.

Два строгих ограничения перед запуском сервера:

  • Keitaro работает только на CentOS 9 Stream или CentOS 10 Stream. Ubuntu и Debian не поддерживаются. Установщик проверяет операционную систему сразу при запуске и прерывает работу, если она не подходит.

  • Трекер не работает за NAT, поэтому вашему VPS обязательно нужен прямой публичный IP-адрес.

Оба этих требования жестко зашиты в установщик, и обойти их не получится.

Keitaro против облачных трекеров или когда стоит переходить на селф-хост

SaaS-трекеры берут плату за каждый клик или событие. На небольших объемах трафика это нормально: вы просто платите за то, что кто-то другой занимается настройкой и поддержкой инфраструктуры. Но когда счет переваливает за несколько сотен тысяч кликов в месяц – это уже большая финансовая нагрузка. За лицензию Keitaro вы платите фиксированную сумму независимо от того, сколько трафика вы через нее прогоняете. Так что после установки вашим единственным регулярным расходом останется только оплата самого сервера.

Второй важный момент — безопасность данных. Владельцы облачного трекера видят ровно то же, что и вы, включая то, какие офферы конвертят, а какие сливают в минус. По сути, ваше главное конкурентное преимущество лежит на чужом железе. Собственный сервер полностью исключает этот риск.

Третий фактор для тех, кто работает на разные гео — это физическое расположение сервера. У хостинг-провайдера is*hosting есть VPS в более чем 40 локациях по всему миру. Если ваша целевая аудитория в Бразилии, вы арендуете сервер в Сан-Паулу. Работаете на Германию? Выбираете ноду во Франкфурте. Задержка при редиректе (пинг) — это измеримая величина, которая напрямую влияет на скорость загрузки лендинга и эффективность всей вашей рекламной воронки.

Что понадобится перед началом установки

  • VPS на базе CentOS 9 Stream или CentOS 10 Stream (другие операционные системы не поддерживаются)
  • Виртуализация KVM (OpenVZ не подойдет)
  • Root-доступ по SSH
  • Абсолютно чистый сервер без установленных панелей управления (вроде ISPmanager, cPanel и т.д.)
  • Минимум 20 ГБ свободного места на SSD (сам установщик займет около 8 ГБ)
  • Доменное имя (необходимо для работы HTTPS в ссылках кампаний и для постбэков)
  • Активная лицензия Keitaro, купленная на сайте keitaro.io

Как выбрать сервер под ожидаемый объем трафика:

Кликов в день

Оперативная память (RAM)

Процессор (CPU)

Тариф is*hosting

До 100 000

4 ГБ

2 ядра

Medium VPS

От 100 000 до 500 000

8 ГБ

4 ядра

Premium VPS

От 500 000 до 1 000 000

16 ГБ

4 ядра

Elite VPS или выше

Совет: если вы планируете активно использовать Admin API (например, для автоматической загрузки расходов или сторонних интеграций), выбирайте тариф на одну ступень мощнее, чем того требует ваш объем кликов.

Тариф Medium от is*hosting (3 ядра / 4 ГБ RAM / 40 ГБ NVMe, от $21.24/мес при оплате за год) — это идеальная стартовая площадка для Keitaro. Более дешевый тариф Start имеет всего 2 ГБ оперативной памяти, что ниже минимальных системных требований трекера. Установка там пройдет успешно, но как только пойдет реальный трафик, сервер начнет «задыхаться» от нехватки памяти.

Важно, что в любой тариф is*hosting уже включен выделенный IPv4-адрес. Это полностью решает проблему с отсутствием NAT, о которой мы говорили выше. Кроме того, во все тарифы входят бесплатные еженедельные бэкапы сервера.

При заказе сервера в выпадающем списке операционных систем обязательно выберите пункт CentOS 9 x64 — именно так он называется в корзине.

VPS

KVM VPS с выделенным IPv4, NVMe-диском и CentOS 9 — всё, что нужно Keitaro, в 40+ локациях, чтобы развернуть трекер рядом с вашим трафиком.

Выбрать VPS

Как установить Keitaro на VPS

Шаг 1: Подключитесь к серверу

На Mac или Linux откройте терминал и введите:

ssh root@YOUR_VPS_IP

На Windows используйте PowerShell или PuTTY. Примите предупреждение безопасности, введите свой root-пароль, и когда увидите строку [root@server ~]# — значит вы успешно вошли в консоль сервера.

Шаг 2: Запустите установщик

Keitaro устанавливается всего одним скриптом. Он делает всё за вас: поднимает контейнеры podman, настраивает nginx, MariaDB, ClickHouse, Redis, получает SSL-сертификаты через certbot и прописывает правила фаервола.

Вставьте эту команду:

curl https://files.keitaro.io/scripts/releases/stable/kctl.sh | bash -s -- install

Сначала скрипт скачает kctl (это собственная утилита Keitaro для командной строки) и проверит, подходит ли сервер. Если всё в порядке, он выдаст сообщение All assertions have passed. Затем начнется параллельная загрузка образов контейнеров для каждого компонента системы. На абсолютно чистом VPS тарифа Medium в Малайзии этот процесс занимает около 15 минут.

Важный нюанс: установщик использует podman, а не Docker. Вам не нужно ничего устанавливать заранее — скрипт всё сделает сам. Вы заметите строчку Installing podman-docker в самом начале процесса.

Кроме того, скрипт автоматически настроит встроенный фаервол, открыв порты 22, 80 и 443. Прописывать команды для портов вручную не нужно. Все базы данных (MariaDB на порту 3306, Redis на 6379/6380, ClickHouse на 8123) привязываются строго к локальному адресу 127.0.0.1 и недоступны извне — это важно для безопасности.

Когда установка завершится, в терминале появится сообщение:

Keitaro 11.2.4 has been installed!
Please open the link in your browser of choice:
http://YOUR_VPS_IP/admin

Шаг 3: Проверьте, что все работает

Убедитесь, что все службы прошли проверку состояния (health checks). Введите:

kctl check

При успешной чистой установке выведет следующее:

Checking service clickhouse . OK
Checking service mariadb . OK
Checking service redis . OK
Checking service guest-redis . OK
Checking service system-redis . OK
Checking service kctld-server . OK
Checking service nats . OK
Checking service tracker-sandbox . OK
Checking service tracker-traffic . OK
Checking service tracker-admin . OK
Checking service nginx . OK
Everything is ok

Если хотите посмотреть подробную информацию о запущенных службах:

kctl version

Эта команда покажет весь стек установленных компонентов и их версии: сам Keitaro, утилиту kctl, ClickHouse, MariaDB, Redis, Nginx и все внутренние модули трекера.

Шаг 4: Откройте панель управления и выполните базовую настройку

Перейдите в браузере по адресу http://ВАШ_IP_VPS/admin. Сервер автоматически перенаправит вас на защищенную HTTPS-версию. При первом запуске Keitaro предложит пройти быструю настройку в два этапа.

Базовые настройки. Введите лицензионный ключ с сайта keitaro.io, выберите системную валюту, язык по умолчанию и часовой пояс. К выбору валюты отнеситесь внимательно: ее можно будет изменить позже, но Keitaro не станет пересчитывать старые данные по кликам под новую валюту.

Создание администратора. Придумайте пароль и сохраните данные. После этого вы попадете на главный дашборд трекера.

Шаг 5: Привяжите домен

Keitaro использует припаркованные домены для ссылок на кампании, доступа к админке и постбэков.

В панели вашего регистратора доменов добавьте А-запись, указывающую на IP-адрес вашего VPS. Удалите все остальные A, AAAA или CNAME-записи для этого домена. Трекеру нужен абсолютно чистый, выделенный только под него домен. Использовать один и тот же домен для Keitaro и какого-то другого сервиса не получится.

Обновление DNS обычно занимает пару минут, но иногда может затянуться до часа. Как только IP обновится, откройте вкладку Домены в Keitaro, нажмите Добавить, впишите ваш домен и нажмите Создать. Трекер сам запросит и установит бесплатный SSL-сертификат от Let's Encrypt. Никакой ручной возни с сертификатами не потребуется.

Когда у домена появится статус OK, включите в его настройках три опции:

  • Admin Dashboard: ограничит доступ к панели управления только через этот домен.
  • HTTPS-only: принудительно перенаправит весь HTTP-трафик на безопасный HTTPS.
  • Crawlers: выберите Disallowed, чтобы запретить поисковым ботам индексировать ссылки ваших кампаний.

Шаг 6: Настройте безопасность админки

В разделе Обслуживание → Настройки ограничьте доступ к панели управления по IP-адресу, чтобы в /admin можно было зайти только с вашего IP.

Если вам нужно временно пустить в трекер техподдержку, не давайте им root-пароль от сервера. Используйте специальную встроенную команду:

kctl support-team-access allow
# Доступ автоматически закроется через 5 дней. Чтобы закрыть его досрочно, введите:
kctl support-team-access deny

Чтобы проверить, кто заходил в панель, используйте команду:

tail -n 100 /var/log/nginx/keitaro-admin.access.log

Шаг 7: Проверьте состояние системы

Перед запуском боевого трафика загляните в раздел Обслуживание → Статус. Здесь важны четыре показателя:

  • CPU Stolen (Украденное время процессора): любое значение выше нуля означает, что гипервизор забирает вычислительные ресурсы. Прежде чем продолжать работу, напишите в поддержку is*hosting.
  • Free disk space (Свободное место на диске): установка съела около 8 ГБ на диске объемом 40 ГБ. База данных будет расти с каждым новым кликом, поэтому следите за этим показателем, если льете большие объемы трафика.
  • Data processing queue size (Размер очереди обработки данных): если тут постоянно висит значение больше нуля, значит сервер не успевает обрабатывать клики. Пора переходить на тариф повыше.
  • Cron timestamp (Время работы Cron): обновляется каждую минуту. Если время «зависло», трекер полностью перестанет обрабатывать трафик.

Совет: чтобы мониторить доступность трекера извне, можно связать Keitaro с сервисом Uptime Kuma. Так вы будете получать уведомления, если админка перестанет отвечать или редиректы кампаний начнут отваливаться по таймауту.

Как пользоваться Keitaro: Кампании, Потоки и Отчеты

Четыре базовых элемента Keitaro

Кампании (Campaigns) — это точки входа. У каждой кампании есть уникальная ссылка, которую вы вставляете в рекламную сеть. Сама по себе кампания без привязанного к ней потока ничего не делает; всю работу по распределению трафика берут на себя потоки.

Потоки (Flows) — здесь живет логика маршрутизации: фильтры (какой трафик принимаем), лендинги (что показываем сначала) и офферы (куда отправляем в итоге). Внутри одной кампании можно создать несколько потоков для разных сегментов. Например: первый поток забирает мобильный Android-трафик из Германии, второй — десктопный трафик со всего остального мира, а третий ловит все «остатки», которые не подошли под первые два условия.

Лендинги (Landing pages) — это страницы вашей воронки, на которые пользователь попадает до оффера (в арбитраже их часто называют прелендингами или проклами). Keitaro поддерживает загрузку локальных файлов (zip-архивы), внешние ссылки, редиректы и предзагрузку страниц (preload). Встроенный редактор позволяет править код загруженных страниц прямо в трекере, не перезаливая архив целиком.

Офферы (Offers) — это ваши партнерские ссылки или страницы прямых продаж. Информация о конверсиях возвращается в трекер через S2S-постбэк и привязывается к тому самому клику, с которого всё началось.

Настройка базовой кампании

  1. Перейдите в раздел Источники (Sources), нажмите «Создать» и выберите шаблон вашей рекламной сети. Для Facebook, Google Ads, TikTok и сотен других источников уже есть готовые шаблоны, которые автоматически пропишут правильные макросы и UTM-метки.
  2. Откройте Партнерские сети (Affiliate Networks), нажмите «Создать» и выберите шаблон вашей партнерки. Система сама подставит правильный формат ссылки (URL) для постбэка.
  3. Зайдите в Кампании (Campaigns), нажмите «Создать», выберите ваш домен и источник трафика, после чего нажмите «Создать поток» (Create Flow).
  4. В схеме потока выберите заранее добавленный лендинг и оффер.
  5. Скопируйте ссылку кампании (Campaign URL) и вставьте её как целевую ссылку в вашем рекламном кабинете.

Отчеты

На тарифах Advanced и выше аналитика Keitaro работает на базе ClickHouse. Согласно тестам самих разработчиков, ClickHouse генерирует отчеты до 14 раз быстрее, чем MySQL.

В разделе создания отчетов вы можете собирать кастомные выборки по любой комбинации метрик: гео, устройство, источник трафика, sub-ID, оффер или статус конверсии. А в Логе кликов (Click Log) можно посмотреть сырые данные по каждому отдельному клику со всем набором его параметров.

Как обновить Keitaro

Когда выходит новая версия, Keitaro показывает уведомление прямо в панели управления. Чтобы обновиться через интерфейс, перейдите в Обслуживание → Обновление Keitaro, выберите стабильную версию (stable), нажмите «Да» и запустите установку. Она идет в фоновом режиме и занимает около 15 минут.

Обновление через терминал запускается командой:

kctl update

Об успешном завершении сообщит строка:

Keitaro X.X.X has been installed!

Обязательно делайте бэкап перед каждым обновлением. Зайдите в Обслуживание → Архив, создайте резервную копию трекера и скачайте её на свой компьютер. Если хранить единственный бэкап на том же сервере, то при неудачном обновлении восстанавливать данные будет просто неоткуда.

Хотя is*hosting и делает бесплатные еженедельные бэкапы VPS на всех тарифах, восстановление из полного снимка сервера (снэпшота) — это крайняя мера. Восстановить базу из собственного архива Keitaro намного быстрее, да и места он занимает меньше.

Хранилище бэкапов

Бесплатные еженедельные бэкапы VPS на всех тарифах — чтобы неудачное обновление Keitaro или сбой ночью не стоили вам данных по кликам.

Подробнее

Подведем итоги: что мы получили

Установка Keitaro на VPS с ОС CentOS 9 x64 и прямым публичным IP занимает около 15 минут. Выполнив шаги из этого гайда, вы получаете готовый трекер с безлимитным числом кампаний, полной детализацией по каждому клику прямо на вашем сервере, интеграцией S2S-постбэков с сотнями партнерок и быстрыми отчетами на базе ClickHouse — и всё это прекрасно работает на сервере с 3 ядрами и 4 ГБ оперативки.

Правила фаервола, выпуск SSL-сертификатов и настройка сети для контейнеров установщик взял на себя. Вам больше не нужно ничего донастраивать вручную — система готова принимать трафик.

Тариф Medium от is*hosting (3 ядра / 4 ГБ RAM / 40 ГБ NVMe, от $21.24/мес при оплате за год) отлично справляется с нагрузкой до 100 000 кликов в день. Если вы масштабируетесь, тариф Premium потянет до 500 000 кликов ежедневно. Главное — при оформлении заказа не забудьте выбрать ОС CentOS 9 x64. Кстати, если для автоматизации рутины или загрузки расходов вы используете n8n в связке с Keitaro, у is*hosting есть специальные VPS для n8n, которые идеально работают на той же инфраструктуре.