Установка AlterCPA Pro полностью автоматическая. Вы готовите сервер и домен и выполняете на сервере одну команду, а всё остальное установщик делает сам.
Подготовка к работе
- Сервер на чистом Debian 13 (x86-64) без панели управления, с собственным IPv4-адресом, от 2 vCPU, 4 ГБ памяти и 40 ГБ SSD. Порты 22, 80 и 443 должны быть открыты. Виртуальный хостинг не подойдёт.
- Домен для панели управления и внутренних сервисов. Лучше домен второго уровня: понадобятся поддомены www и r.
- Лицензия на AlterCPA Pro, оплаченная и активная. При покупке укажите IP-адрес сервера и домен: лицензия привязана к ним. Если IP-адрес или домен нужно изменить, нажмите «Изменить адрес» на странице лицензии.
- 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 с адресом сервера. Ждать, пока записи заработают, не нужно: сертификаты выпустятся сами, когда домен начнёт указывать на сервер.
Установка
- Подключитесь к серверу по SSH от имени root. Если провайдер не даёт войти как root, после входа выполните команду:
sudo -i
- Откройте в личном кабинете раздел «Лицензии», а в нём свою лицензию. Скопируйте команду из блока «Инструкция по установке на сервере». Если лицензия куплена на поддомен, сначала прочитайте раздел «Установка на поддомен» ниже. Команда выглядит так:
wget https://cpa.st/lic/q1w2e3r4t5y6u7i8o9p0/pro.sh && bash pro.sh
- Вставьте команду в окно SSH и нажмите Enter. Установщик ничего не спрашивает. Не закрывайте терминал, пока он не закончит.
- Подождите несколько минут. В конце установщик выведет строку «Setup completed successfully!» и адрес панели, а на почту вашего аккаунта придёт письмо «Закончена установка AlterCPA на ваш домен» с данными доступа к серверу. Если выше в выводе есть строка «Note: reboot the server once the installation has finished», после установки перезагрузите сервер командой reboot.
- Если установка прервалась или остановилась с ошибкой, устраните причину и выполните ту же команду ещё раз. Установка продолжится с места остановки. Если wget отвечает «404 Not Found», проверьте, что лицензия оплачена и активна, а команда скопирована целиком.
Первичная настройка системы
Откройте свой основной домен сети в браузере. Вам будет предложено завести главного администратора. Укажите действующую почту и надёжный пароль: администратор имеет полный доступ к любым операциям с системой.
Затем перейдите в раздел «Управление — Настройки». В разделе «Внешний вид» выберите цветовую гамму панели управления. После этого внесите небольшие изменения в разделы «Основные», «Финансы», «Базы данных» и, возможно, «Справочники».
Раздел «Основные»
- Укажите название вашей сети, контактный E-mail и часовой пояс.
- Поставьте галочку «Запретить регистрацию пользователей в системе», пока не настроите офферы. Для приватной сети её можно оставить.
- По умолчанию система отправляет письма сама, с сервера. Если хотите отправлять их через свой SMTP-сервер, в блоке «Отправка почты» отметьте «Использовать SMTP для отправки писем» и укажите его данные. Если нет, не меняйте ничего.
Раздел «Финансы»
- Выберите основную внутреннюю валюту системы, в которой будут подсчитываться отчисления и осуществляться выплаты.
- После выбора валюты нажмите кнопку «Обновить» в списке валют.
Раздел «Базы данных»
- Выберите гео-базу MaxMind GeoLite English как наиболее качественную.
- При необходимости активируйте дополнительные базы данных в зависимости от вашего региона работы.
Раздел «Справочники»
В этом разделе вас могут заинтересовать пункты «Категории офферов» и «Методы вывода средств».
Установка на поддомен
Если лицензия куплена на поддомен, например 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 должно быть полным доменным именем и не совпадать с доменом лицензии. Выберите его до первого запуска: на установленном сервере имя хранилища уже не изменить.
Дальнейшие шаги
- Прочитайте раздел «Работа с платформой» этого руководства.
- Нет, мы серьёзно: прочитайте раздел «Работа с платформой» этого руководства, он действительно потребуется вам в работе.
- Система обновляется сама: раз в час сервер проверяет новые версии платформы и устанавливает их.
- Если хотите добавить к системе дополнительные службы, например фронт-сервер, посмотрите другие руководства раздела «Развёртывание системы». Поставьте фронт-сервер, очень нужная штука.