Установка AlterCPA Pro полностью автоматическая. Вы готовите сервер и домен и выполняете на сервере одну команду, а всё остальное установщик делает сам.

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

  1. Сервер на чистом Debian 13 (x86-64) без панели управления, с собственным IPv4-адресом, от 2 vCPU, 4 ГБ памяти и 40 ГБ SSD. Порты 22, 80 и 443 должны быть открыты. Виртуальный хостинг не подойдёт.
  2. Домен для панели управления и внутренних сервисов. Лучше домен второго уровня: понадобятся поддомены www и r.
  3. Лицензия на AlterCPA Pro, оплаченная и активная. При покупке укажите IP-адрес сервера и домен: лицензия привязана к ним. Если IP-адрес или домен нужно изменить, нажмите «Изменить адрес» на странице лицензии.
  4. SSH-клиент: PuTTY для Windows, встроенный «Терминал» для macOS.

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

Направьте домен на сервер. В DNS-зоне домена (именно в записях зоны, а не в списке DNS-серверов) добавьте три записи. Вместо 12.34.56.78 укажите IP-адрес вашего сервера. Запись @ — это сам домен, www — его псевдоним, r — адрес хранилища сайтов.

@ A 12.34.56.78
www CNAME @
r CNAME @

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

Установка

  1. Подключитесь к серверу по SSH от имени root. Если провайдер не даёт войти как root, после входа выполните команду:
    sudo -i
  2. Откройте в личном кабинете раздел «Лицензии», а в нём свою лицензию. Скопируйте команду из блока «Инструкция по установке на сервере». Если лицензия куплена на поддомен, сначала прочитайте раздел «Установка на поддомен» ниже. Команда выглядит так:
    wget https://cpa.st/lic/q1w2e3r4t5y6u7i8o9p0/pro.sh && bash pro.sh
  3. Вставьте команду в окно SSH и нажмите Enter. Установщик ничего не спрашивает. Не закрывайте терминал, пока он не закончит.
  4. Подождите несколько минут. В конце установщик выведет строку «Setup completed successfully!» и адрес панели, а на почту вашего аккаунта придёт письмо «Закончена установка AlterCPA на ваш домен» с данными доступа к серверу. Если выше в выводе есть строка «Note: reboot the server once the installation has finished», после установки перезагрузите сервер командой reboot.
  5. Если установка прервалась или остановилась с ошибкой, устраните причину и выполните ту же команду ещё раз. Установка продолжится с места остановки. Если wget отвечает «404 Not Found», проверьте, что лицензия оплачена и активна, а команда скопирована целиком.

Первичная настройка системы

Откройте свой основной домен сети в браузере. Вам будет предложено завести главного администратора. Укажите действующую почту и надёжный пароль: администратор имеет полный доступ к любым операциям с системой.

Затем перейдите в раздел «Управление — Настройки». В разделе «Внешний вид» выберите цветовую гамму панели управления. После этого внесите небольшие изменения в разделы «Основные», «Финансы», «Базы данных» и, возможно, «Справочники».

Раздел «Основные»

  1. Укажите название вашей сети, контактный E-mail и часовой пояс.
  2. Поставьте галочку «Запретить регистрацию пользователей в системе», пока не настроите офферы. Для приватной сети её можно оставить.
  3. По умолчанию система отправляет письма сама, с сервера. Если хотите отправлять их через свой SMTP-сервер, в блоке «Отправка почты» отметьте «Использовать SMTP для отправки писем» и укажите его данные. Если нет, не меняйте ничего.

Раздел «Финансы»

  1. Выберите основную внутреннюю валюту системы, в которой будут подсчитываться отчисления и осуществляться выплаты.
  2. После выбора валюты нажмите кнопку «Обновить» в списке валют.

Раздел «Базы данных»

  1. Выберите гео-базу MaxMind GeoLite English как наиболее качественную.
  2. При необходимости активируйте дополнительные базы данных в зависимости от вашего региона работы.

Раздел «Справочники»

В этом разделе вас могут заинтересовать пункты «Категории офферов» и «Методы вывода средств».

Установка на поддомен

Если лицензия куплена на поддомен, например my.domain.com, хранилище сайтов по умолчанию окажется на r.my.domain.com. Чтобы разместить его рядом с панелью, на r.domain.com, допишите в конец команды установки параметр --sites с нужным именем. В личном кабинете команда показана без него.

wget https://cpa.st/lic/q1w2e3r4t5y6u7i8o9p0/pro.sh && bash pro.sh --sites=r.domain.com

Поддомен www в этом случае не нужен, поэтому в DNS-зоне domain.com достаточно двух записей:

my A 12.34.56.78
r A 12.34.56.78

Имя после --sites должно быть полным доменным именем и не совпадать с доменом лицензии. Выберите его до первого запуска: на установленном сервере имя хранилища уже не изменить.

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

  1. Прочитайте раздел «Работа с платформой» этого руководства.
  2. Нет, мы серьёзно: прочитайте раздел «Работа с платформой» этого руководства, он действительно потребуется вам в работе.
  3. Система обновляется сама: раз в час сервер проверяет новые версии платформы и устанавливает их.
  4. Если хотите добавить к системе дополнительные службы, например фронт-сервер, посмотрите другие руководства раздела «Развёртывание системы». Поставьте фронт-сервер, очень нужная штука.