Хранилище сайтов для AlterCPA Pro и Cloud

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

Подготовка к работе

  1. Платформа AlterCPA Pro или Cloud, установленная и работающая. Отдельная лицензия на хранилище не нужна: установщик использует лицензию платформы.
  2. Сервер на чистом Debian 13 без панели управления, с собственным IPv4-адресом. Порты 22, 80 и 443 должны быть открыты. Сервер нужен отдельный, не тот, где работает платформа.
  3. Домен хранилища, отдельный от домена платформы. Имя r.domain.com не подойдёт: его занимает встроенное хранилище платформы. Как выбрать домен, рассказано в статье «Домен хранилища сайтов».
  4. SSH-клиент: PuTTY для Windows, встроенный «Терминал» для macOS.

Настройка домена

Направьте домен хранилища на сервер. В DNS-зоне домена (именно в записях зоны, а не в списке DNS-серверов) удалите лишние записи A, AAAA и CNAME и добавьте одну запись A. Вместо 12.34.56.78 укажите IP-адрес сервера хранилища.

@ A 12.34.56.78

Если это поддомен, вместо @ укажите его имя. Ждать, пока запись заработает, не нужно: сертификат выпустится сам, когда домен начнёт указывать на сервер.

Затем укажите этот домен в настройках платформы. Откройте «Управление — Настройка — Сайты», впишите домен в поле «Домен» блока «Хранилище сайтов» и сохраните настройки. Из этого поля установщик берёт имя хранилища. Остальные поля пока не меняйте.

Установка

  1. Подключитесь к серверу по SSH от имени root. Если провайдер не даёт войти как root, после входа выполните команду:
    sudo -i
  2. Откройте в панели управления раздел «Управление — Настройка — Диагностика». В блоке «Установка серверов поддержки» скопируйте команду из строки «Хранилище сайтов: Debian 13». Все нужные данные в ней уже указаны. Если вместо команды панель показывает сообщение, исправьте то, что в нём названо, и обновите страницу. Команда выглядит так:
    wget -q -O pros.sh https://cpa.st/setup/pros.sh && bash pros.sh --platform=domain.com --platform-ip=87.65.43.21 --license=0123456789abcdef0123456789abcdef --apikey=q1w2e3r4t5y6u7i8o9p0 --control=p0o9i8u7y6t5r4e3w2q1 --sites=domain2.com
  3. Вставьте команду в окно SSH и нажмите Enter. Установщик ничего не спрашивает. Не закрывайте терминал, пока он не закончит.
  4. Подождите несколько минут. В конце установщик выведет настройки для платформы, данные доступа по SFTP и строку «Done.». Перезагружать сервер не нужно.
  5. Если установка остановилась с ошибкой, устраните причину и выполните ту же команду ещё раз.

Параметры установщика

Команда из панели уже содержит все параметры, и обычно в ней ничего не меняют. Этот раздел пригодится, если команду нужно собрать или поправить вручную. Для AlterCPA Pro и Cloud параметры одни и те же. Каждый параметр пишется один раз в виде --имя=значение, без пробелов вокруг знака равенства. Полная команда, с ClickServer, выглядит так:

wget -q -O pros.sh https://cpa.st/setup/pros.sh && bash pros.sh --platform=domain.com --platform-ip=87.65.43.21 --license=0123456789abcdef0123456789abcdef --apikey=q1w2e3r4t5y6u7i8o9p0 --control=p0o9i8u7y6t5r4e3w2q1 --sites=domain2.com --click-key=z1x2c3v4b5n6m7a8s9d0 --click-port=1862

Панель подставляет в команду значения из настроек платформы, ключ лицензии и публичный IP-адрес сервера. Откуда взято каждое из них, сказано в списке ниже. Формат, указанный ниже, проверяет и панель: если значение ему не соответствует, вместо команды она показывает сообщение.

  • --platform: домен платформы. Обязательный. Панель берёт его из поля «Основной URL» в блоке «URL-адреса и домены сети» на странице «Управление — Настройка — Основные» и оставляет только имя домена, без https:// и пути. Это должно быть доменное имя из латинских букв, цифр и дефисов, не IP-адрес.
  • --platform-ip: публичный IPv4-адрес сервера платформы. Обязательный. Панель определяет его сама. Адрес IPv6 не подойдёт.
  • --license: ключ лицензии платформы. Обязательный. Панель берёт его из лицензии платформы. Посмотреть ключ можно на странице лицензии в личном кабинете. В ключе ровно 32 символа, это цифры и латинские буквы от a до f.
  • --apikey: глобальный ключ API платформы. Обязательный. Берётся из поля «Глобальный ключ API» в блоке «Технические настройки» на странице «Управление — Настройка — Сайты». Ключ не короче 16 символов и состоит только из латинских букв, цифр и знаков «.», «_», «~» и «-».
  • --control: ключ управления хранилищем, по нему платформа обращается к хранилищу. Обязательный. Берётся из поля «Ключ управления» в блоке «Хранилище сайтов» на той же странице «Сайты». Формат тот же, что у ключа API.
  • --sites: домен хранилища, тот, что вы вписали в поле «Домен» блока «Хранилище сайтов» при настройке домена. Должен отличаться от домена платформы. Параметр можно не указывать, но тогда при первой установке установщик возьмёт имя r.домен-платформы, а оно занято встроенным хранилищем платформы. Команда из панели содержит этот параметр всегда.
  • --click-key: ключ ClickServer. Нужен, только если ClickServer на платформе включён. Берётся из поля «Ключ» в блоке «Обработка кликов» на странице «Управление — Настройка — Расширенные». Формат тот же, что у ключа API. Пустое значение (--click-key=) выключает ClickServer на хранилище. Если параметра нет, при первой установке ClickServer выключен, а при повторном запуске остаётся прежний ключ.
  • --click-port: порт ClickServer. Необязательный, по умолчанию 1862. Берётся из поля «Порт» того же блока. Число от 1 до 65535.

Установщик сохраняет значения в файле /root/config. Если на установленном хранилище выполнить bash pros.sh без параметров, оно обновится по сохранённым значениям. Параметр, указанный в команде, заменяет только своё сохранённое значение, остальные остаются прежними. Исключение одно, это --apikey. Другой ключ установленное хранилище не принимает, потому что имена файлов с кликами и лидами, которые ещё не дошли до платформы, строятся по ключу, и с другим ключом хранилище их не найдёт. Если глобальный ключ API на платформе действительно сменился, исправьте значение THEAPIKEY в файле /root/config и выполните bash pros.sh без параметров.

Настройка системы

Вернитесь в «Управление — Настройка — Сайты». В блоке «Хранилище сайтов» укажите значения, которые установщик вывел в конце. Они же сохранены на сервере в файле /root/config.txt.

  • «URL управления»: адрес вида https://domain2.com/control.php.
  • «IP парковки»: IP-адрес сервера хранилища.

Сохраните настройки. Поле «Домен» уже заполнено, поле «Ключ управления» менять не нужно.

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

Если на платформе уже были сайты, замените в них домен по инструкции «Домен хранилища сайтов».

Если на платформе включён ClickServer, откройте «Управление — Настройка — Расширенные» и проверьте блок «Обработка кликов». Поле «Адрес» должно быть пустым или содержать IP-адрес платформы, но не localhost. Порт из поля «Порт» должен быть открыт на платформе для IP-адреса хранилища.

Дальнейшие шаги

  1. Сохраните вывод установщика: в нём пароль для доступа к хранилищу по SFTP, логин wsvr. Те же данные лежат на сервере в файле /root/config.txt.
  2. Хранилище обновляется само: раз в час сервер проверяет новую сборку платформы и устанавливает её.
  3. Если IP-адрес платформы изменился, выполните на сервере хранилища команду из раздела «Диагностика» ещё раз: в ней уже будет новый адрес.