Установка в ручном режиме

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

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

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

  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 выполните команды установки и настройки сервера. В этой команде вместо domain.ru укажите свой домен, привязанный к лицензии.

wget https://cpa.st/setup/d10n.sh
bash d10n.sh domain.ru

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

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

cat config.txt

И она покажет настройки для доступа к FTP, MySQL и базе данных системы. Они потребуются вам в дальнейшем.

Установка лицензии

Скачайте свой лицензионный файл altercpa.txt из раздела "Лицензии" личного кабинета. Обратите внимание, что вам требуется внучную обновлять лицензионный файл каждый раз при продлении лицензии или изменении её настроек!

С помощью Filezilla подключитесь к FTP. Для этого просто скопируйте ссылку из поля Link блока FTP настроек, полученных на прошлом шаге, вставьте его в поле "Хост" и нажмите "Быстрое соединение". Вы подключитесь к папке /var/www.

Просто переместите скачанный файл altercpa.txt в эту папку. Не помещайте его в папку основного домена!

Установка панели управления

Перейдите в раздел "Скачать" личного кабинета и скачайте тестовую версию AlterCPA Pro для PHP 7.2. Тестовая версия практически всегда лучше, чем стабильная, потому что в ней появляются интересные новшества, а нестабильной она бывает крайне редко.

Распакуйте скачанный архив в любую удобную вам папку. Откройте папку work распакованного архива и скопируйте её содержимое по FTP в папку своего основного домена. В редких случаях, передача по FTP может повредить файлы. В случае подобных ошибок, откройте настройки Filezilla и в разделе "Передачи - FTP: Типы файлов" выберите тип передачи по умолчанию - двоичный. После этого повторно скопируйте все файлы из папки work, перезаписав существующие.

Откройте свой основной домен в браузере. Если всё прошло удачно, вам будет предложено указать настройки соединения с базой данных:

  • Сервер: localhost
  • База данных: cpa
  • Пользователь: cpa
  • Пароль: получен вами из файла config.txt

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

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

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

Далее по тексту вместо domain.ru используйте основной домен вашей сети. То есть, если ваша сеть установлена на altercpa.site, то любые упоминания domain.ru для вас будут означать altercpa.site, а r.domain.ru соответственно преобразится в r.altercpa.site.

Вам потребуется внести небольшие изменения в разделы "Основные", "Сайты", "Расширенные", "Финансы", "Базы данных" и возможно "Справочники". Также откройте для редактирования файл config.php из папки r.domain.ru вашего сервера по FTP.

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

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

Раздел "Сайты"

  1. Укажите все галочки "Разрешить парковку" и в поле "IP парковки" впишите IP-адрес вашего сервера.
  2. Укажите все галочки "Использовать SSL"
  3. В поля "Ключ управления" скопируйте значение константы CONTROL из файла config.php
  4. В значение константы APIKEY в файле config.php скопируйте содержимое поля "Глобальный ключ API"

Раздел "Расширенные"

  1. Поставьте галочку "Использовать ClickServer", это рекомендуется при любой работе с сайтами на своём сервере.
  2. Скопируйте содержимое поля "Ключ" раздела ClickServer в константу CLICKSRV_KEY файла config.php
  3. В файле config.php раскомментируйте строчку (удалите символ # в начале) с константой CLICKSERVER.

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

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

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

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

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

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

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

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

apt install exim4

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

dpkg-reconfigure exim4-config

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

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

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