Установка: AlterCPA Pro

Эта инструкция поможет вам развернуть AlterCPA Pro наиболее простым и удобным образом, не вдаваясь в подробности и тонкости. Мы рекомендуем производить равёртывание системы именно по этой инструкции, потому что она подходит практически для любой конфигурации сети.

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

Для развёртывания вам потребуется самостоятельно подготовить следующие компоненты:

  1. Виртуальный или выделенный сервер на чистом Debian 11 без панели управления. Именно Debian 11. Именно чистый и без панели управления. Это требование является критичным для работы системы, мы не гарантируем работу на другой серверной конфигурации. Виртуальный хостинг не подойдёт.
  2. Домен для панели управления и внутренних сервисов. Мы рекомендуем использовать домен второго уровня, поскольку для работы нам потребуется несколько поддоменов. Установка панели управления на поддомен не потребуется - вы сможете заменить форму входа на свой лендинг и на основном домене.
  3. Лицензия на AlterCPA любого срока действия. При покупке лицензии вам необходимо указать ваши IP-адрес сервера и основной домен.
  4. Умение пользоваться SSH-клиентом и FTP-клиентом, а также сами клиенты. В качестве SSH-клиента для Windows подойдёт Putty, для MacOS можно использовать Terminus. В качестве FTP-клиента рекомендуется Filezilla, пользователям MacOS не нужно ставить её из AppStore, скачайте бесплатно с официального сайта.

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

Вам необходимо направить домен на купленный сервер. Для этого вам потребуется IP-адрес купленного сервера. Вероятнее всего, он пришел к вам на почту в момент покупки или отображается в личном кабинете управления сервером.

В настройках DNS-серверов домена выберите вариант "Использовать DNS-серверы регистратора" (или похожий на него). Если ваш регистратор не предоставляет бесплатные DNS-серверы, рекомендуем воспользоваться DNS-серверами от CloudFlare (без прокси, только DNS).

В настройках зоны DNS (именно DNS-зоны или DNS-записей, а не списка самих DNS-серверов) вам необходимо указать следующие записи. Можете использовать любой из приведённых ниже вариантов, они взаимозаменяемы и зависят исключительно от возможностей вашего регистратора. Вместо 12.34.56.78 используйте IP-адрес вашего сервера. В списке указаны соответственно название записи, тип записи и значение.

Вариант 1. Оптимально для большинства случаев.

@ A 12.34.56.78
www CNAME @
pms CNAME @
r CNAME @

Вариант 2. Работает у всех и всегда.

@ A 12.34.56.78
www A 12.34.56.78
pms A 12.34.56.78
r A 12.34.56.78

Настройка сервера

Перед настройкой сервера, обязательно подождите некоторое время для завершения настройки домена. Как правило, смена DNS-серверов требует около суток, настройка записей требует около часа.

Подключитесь к своему серверу по SSH от имени пользователя root. Как правило, root-пароль приходит на почту после окончания установки сервера на стороне провайдера. В некоторых случаях, при первом входе требуется сменить пароль на новый. Используйте надёжный пароль не короче 16 символов. По возможности, изучите вопрос подключения по SSH с помощью сертификата и используйте свой сертификат при заказе сервера. Некоторые серверы не позволяют подключиться от имени root, используя различные ухищрения, поэтому после соединения необходимо выполнить команду:

sudo -i

После подключения к серверу от имени root выполните команды установки и настройки сервера. Необходимая команда отображается у вас в разделе "Лицензия" и выглядит приблизительно так:

wget https://cpa.st/lic/q1w2e3r4t5y6u7i8o9p0/setup.sh && bash setup.sh

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

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

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

Сразу же после установки необходимо настроить базовые параметры системы. Для этого перейдите в раздел "Управление - Настройки", в котором осуществляются все манипуляции с основными настройками. В разделе "Основные настройки" укажите название вашей сети и контактный E-mail. В разделе "Внешний вид" выберите цветовую гамму панели управления. На этом с самыми важными и критичными настройками покончено, перейдём к техническим настройкам.

Вам потребуется внести небольшие изменения в разделы "Основные", "Финансы", "Базы данных" и возможно "Справочники".

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

  1. Рекомендуется поставить галочку "Запретить регистрацию пользователей" до окончания процедуры настройки офферов. Также эта галочка будет полезна для приватной сети.
  2. Укажите данные вашего почтового домена (мы рекомендуем Яндекс.Коннект). Если его использование не планируется, не вносите изменений в настройки почты и воспользуйтест "костылём", описанным ниже.

Раздел "Финансы"

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

Раздел "Базы данных"

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

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

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

Костыль для поддержки почты

Мы рекомендуем использовать полноценный почтовый сервер для работы с почтой, например Яндекс.Коннект. Но при необходимости, вы можете отправлять сообщения пользователям напрямую с сервера. Для этого необходимо установить и настроить Exim. Зайдите на сервер по SSH и выполните:

apt install exim4

По окончании установки, Exim4 необходимо настроить. Для этого выполните:

dpkg-reconfigure exim4-config

В открывшемся диалоговом окне выберите модель работы Internet site, на втором и четвёртом экранах укажите свой основной домен, остальные настройки оставьте без изменений.

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

  1. Прочитайте раздел "Работа с системой" этой инструкции.
  2. Нет, мы серьёзно: прочитайте раздел "Работа с системой" этой инструкции, он действительно потребуется вам в работе.
  3. При необходимости, ознакомьтесь с другими руководствами раздела "Развёртывание", если хотите внести какие-то особые изменения в работу своего сервера. Как правило, этого не потребуется и всё будет работать само.