EN RU
Цены Блог

# Перенос трекера с сохранением данных

# В каких случаях выполняется перенос трекера

  1. Частые критические неисправности в работе текущего сервера, на котором установлен трекер.

  2. Неподходящий функционал и система ценообразования.

  3. Недостаточно места на диске, и текущий провайдер не предоставляет возможность увеличить его объём.

  4. Необходимость сменить дата-центр сервера и сохранить статистику.

  5. Необходим дубль или копия Keitaro для масштабирования связок или тестирования новых ГЕО.

# Как перенести трекер версии 11 и выше на новый сервер

TIP

Убедитесь, что новый сервер не уступает текущему по характеристикам.

  1. Подключитесь к старому серверу по SSH.

  2. Запустите команду создания дампа:

kctl backups create
1
  1. После создания дампа получите его имя командой:
ls -1 /var/lib/kctl-backups/common/
1

Скопируйте имя дампа и подключитесь по SSH к новому серверу для выполнения следующих шагов.

  1. На новом сервере запустите команду установки трекера:
curl keitaro.io/kctl.sh | bash -s -- install
1
  1. Создайте директорию common для дампа:
mkdir -p /var/lib/kctl-backups/common/
1
  1. Запустите команду screen. Процессы внутри screen не прерываются при потере соединения с сервером.
screen
1
  1. Запустите синхронизацию директорий common старого и нового серверов:
rsync -avzP -e "ssh -p 22" root@OLD_IP:/var/lib/kctl-backups/common/DUMP_NAME/ /var/lib/kctl-backups/common/DUMP_NAME/
1

Где:

  • 22 — номер порта старого сервера;
  • OLD_IP — IP-адрес старого сервера;
  • DUMP_NAME — имя дампа со старого сервера, полученное на шаге 3.

Пример:

rsync -avzP -e "ssh -p 22" root@77.71.136.233:/var/lib/kctl-backups/common/2025-08-01-13-35-34/ /var/lib/kctl-backups/common/2025-08-01-13-35-34/
1

При запросе введите пароль от старого сервера.

  1. Восстановите трекер из дампа командой:
kctl backups restore
1

Статистика и настройки, включая локальные лендинги, офферы и пользовательские списки ботов и User-Agent, переносятся автоматически.

  1. Перейдите в личный кабинет на сайте keitaro.io, раздел Лицензии. Нажмите Unlink для ключа лицензии, который хотите привязать к новому трекеру. Войдите в новый трекер.

WARNING

Не создавайте в новом трекере кампании, лендинги, партнерские сети и другие сущности до окончания процесса переноса статистики. По окончании работы скрипта переноса в новом трекере останутся исключительно данные со старого трекера.

# Создание архивной копии трекера локально

Архивная копия трекера создаётся локально на текущем сервере. Включая данные MySQL, данные ClickHouse, системные настройки, локальные лендинги, salt, Postback key, сертификаты, фильтры, кастомные списки ботов и т.д.

  1. Запустите screen:
screen
1

Процессы, выполняемые внутри screen, не прерываются при разрыве соединения с сервером.

  1. Запустите команду создания дампа:
kctl backups create
1

WARNING

Во время создания дампа важно обращать внимание на вывод терминала — если в процессе возникали ошибки, целостность дампа, возможно, не сохранена. Впоследствии восстановить трекер в полном объёме из такого дампа возможности не будет.

Данные сохраняются в директории /var/lib/kctl-backups/common/ и доступны для скачивания. Создание нового дампа не стирает предыдущий. Имя дампа задаётся по дате создания.

# Восстановление трекера из локальной архивной копии

Локальная архивная копия включает данные MySQL, данные ClickHouse, системные настройки, локальные лендинги, salt, Postback key, сертификаты, фильтры, кастомные списки ботов и т.д.

  1. Установите трекер на сервер и загрузите дамп в директорию /var/lib/kctl-backups/common/. Если директория отсутствует, её необходимо создать.

  2. Выполните команду:

kctl backups restore
1

# Действия после переноса трекера

  1. После успешного переноса необходимо привязать ключ лицензии на новый сервер. Отвяжите ключ лицензии в личном кабинете на сайте keitaro.io, следуя инструкции.

  2. Далее, чтобы трафик начал направляться на новый сервер, необходимо обновить DNS-записи всех доменов, изменив A-запись на IP-адрес нового сервера. Изменения вступают в силу в течение 24 часов.

# FAQ

Как перенести трекер 10 версии?

Обратитесь в поддержку для переноса.

Как восстановить трекер из dump.gz или dump.sql?

Для восстановления трекера из дампа БД необходимо использовать команду kctl-transfers с действием restore-from-sql local, например:

SALT=test kctl-transfers restore-from-sql local path/to/dump.gz
1

При создании дампа в phpMyAdmin выберите английский язык интерфейса.

Что обозначает **Could not detect TRACKER_POSTBACK_KEY** при переносе?

Это диагностическое сообщение указывает на отсутствие пользовательского postback key в конфигурации. Это сообщение следует игнорировать.

← Гео-профили →