WHMCS¶

В этой статье

• WHMCS. Основные возможности
• Особенности сборки
• Начало работы после развертывания WHMCS
• Первоначальные настройки WHMCS
• Подключение к серверу по SSH
• Настройка лицензионного ключа и базы данных
• Создание учетной записи администратора
• Завершение установки
• Вход в систему
• Первоначальная настройка системы
• Настройка аддонов и модулей
• Настройка модуля HOSTKEY VPS/Dedicated
• Настройка валют
• Заказ сервера с WHMCS с помощью API

WHMCS. Основные возможности¶

• WHMCS автоматизирует повседневные задачи и операции, включая биллинг, выставление счетов, управление клиентами и обработку запросов поддержки;
• Платформа легко интегрируется со всеми ведущими панелями управления, платежными системами, регистраторами доменов и облачными сервисами;
• WHMCS поддерживает основные платежные шлюзы, такие как PayPal, Google Checkout и Authorize.Net, включая возможность работы с различными валютами и создания промо-акций;
• Система включает полнофункциональную корзину покупок, позволяя посетителям приобретать веб-хостинг услуги в одном месте;
• WHMCS предоставляет инструменты для управления доменами, включая регистрацию, продление и трансфер доменных имен;
• Встроенная система поддержки клиентов с возможностью создания и отслеживания тикетов, базой знаний и системой уведомлений;
• Платформа предлагает расширенную аналитику и отчетность в реальном времени для принятия бизнес-решений;
• WHMCS является гибкой, масштабируемой и расширяемой платформой с сотнями доступных приложений и интеграций для всех ведущих поставщиков услуг;
• Система включает мощный API для разработчиков и возможности глубокой кастомизации под потребности бизнеса;
• WHMCS предоставляет мобильные приложения для управления бизнесом в дороге и удаленного администрирования.

Особенности сборки¶

• Минимальные системные требования для установки WHMCS:

  • Процессор: 2 ядра, 64-бит;
  • ОЗУ: 4 Гб;
  • Дисковое пространство: 20 Гб HDD.

• Рекомендуемые системные требования:

  • Процессор: 4+ ядра, 64-бит;
  • ОЗУ: 8+ Гб;
  • Дисковое пространство: 50+ Гб SSD.

• Структура установки:

  • Основные файлы WHMCS: /var/www/html/whmcs/;
  • Конфигурационная панель: /opt/panel/;
  • Логи и кэш: /var/log/, /var/cache/;
  • SSL-сертификаты: /var/www/certbot/.

Веб-интерфейс будет доступен по ссылке: https://whmcs{Server_ID_from_Invapi}.hostkey.in

Панель администратора: https://whmcs{Server_ID_from_Invapi}.hostkey.in/admin

Начало работы после развертывания WHMCS¶

После оплаты заказа на указанную при регистрации электронную почту придет уведомление о готовности сервера к работе. В нем будет указан IP-адрес VPS, а также логин и пароль для подключения. Управление оборудованием клиенты нашей компании осуществляют в панели управления серверами и API — Invapi.

Данные для авторизации, которые можно найти во вкладке Информация >> Тэги панели управления сервером или в присланном e-mail:

• Ссылка для доступа к веб-интерфейсу WHMCS: в теге webpanel;
• Логин и Пароль для управления сервером: приходят в письме на вашу электронную почту при сдаче сервера.

Первоначальные настройки WHMCS¶

Подключение к серверу по SSH¶

Перед началом установки WHMCS необходимо подключиться к серверу по SSH для выполнения команд в терминале.

ssh root@<IP_сервера>

1. Система спросит подтверждение подключения - введите yes;
2. Введите пароль для указанного пользователя;
3. После успешного подключения вы увидите командную строку сервера.

Настройка лицензионного ключа и базы данных¶

На первом экране установки необходимо ввести следующие данные:

Лицензионный ключ¶

• Введите ваш лицензионный ключ в поле License Key.

Настройки базы данных¶

Заполните следующие поля для подключения к MySQL базе данных:

• Database Host: localhost;
• Database Port: 3306 (стандартный порт MySQL);
• Database Username: whmcs_user (имя пользователя БД);
• Database Password: введите пароль для доступа к БД (совпадает с паролем для подключения к серверу по SSH);
• Database Name: whmcs_db (название базы данных).

После заполнения всех полей нажмите Continue:

Создание учетной записи администратора¶

На втором экране необходимо настроить учетную запись администратора:

Заполните обязательные поля:

• First Name: имя администратора;
• Last Name: фамилия администратора;
• Email: Email адрес администратора;
• Username: логин администратора;
• Password: пароль;
• Confirm Password: подтверждение пароля.

После заполнения всех полей нажмите Complete Setup:

Завершение установки¶

После успешной установки появится экран с подтверждением и дальнейшими шагами:

Обязательные действия по безопасности:¶

1. Удаление папки установки

   Подключитесь к серверу по SSH и выполните команду:

   rm -rf /var/www/html/whmcs/install/
   

   

2. Для входа в административную панель вернитесь в веб-интерфейс и нажмите Go to the Admin Area Now:

   

Вход в систему¶

После завершения установки используйте созданные учетные данные для входа:

1. Введите Username (логин администратора);
2. Введите Password (пароль администратора);
3. При желании отметьте Remember Me для запоминания сессии;
4. Нажмите Login:

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

После успешного входа в админ-панель WHMCS откроется главная панель управления (Dashboard):

5.1 Обзор панели управления¶

На главной странице вы увидите:

• Статистику заказов, тикетов и отмен;
• Системную информацию (версия 8.13.1);
• Графики активности системы;
• Предложения по интеграции с PayPal.

5.2 Доступ к системным настройкам¶

Для настройки системы:

1. Нажмите на иконку в правом верхнем углу;
2. Выберите System Settings из выпадающего меню:

Настройка аддонов и модулей¶

6.1 Переход к управлению аддонами¶

1. В разделе System Settings найдите и нажмите на название раздела Apps & Integrations;
2. Выберите Addon Modules для управления дополнительными модулями:

6.2 Активация необходимых модулей¶

В списке доступных аддонов вы найдете:

• Bulk Pricing Updater - для массового обновления цен;
• Google Analytics - для интеграции с аналитикой;
• HOSTKEY VPS/Dedicated - для управления серверами;
• Licensing Manager - для управления лицензиями;
• MailChimp - для email-маркетинга;
• PayPal Transaction Lookup - для поиска транзакций PayPal;
• Project Management - для управления проектами;
• Staff Notifboard - для уведомлений персонала.

Для активации модуля нажмите кнопку Activate напротив нужного аддона.

Настройка модуля HOSTKEY VPS/Dedicated¶

После активации модуля HOSTKEY VPS/Dedicated в разделе Addon Modules, необходимо настроить API-ключи для интеграции с сервисами HOSTKEY.

7.1 Получение API-ключа¶

1. В в панели управления серверами и API — Invapi в карточке сервера найдите раздел API keys & control panel (отмечен как "new!")
2. Нажмите кнопку Add new для создания нового API-ключа:

7.2 Создание API-ключа¶

В открывшемся окне "Add new API key and control panel":

1. В поле Name введите название для ключа (например, my_api_key);
2. В поле IP ACL можно указать IP-адреса для ограничения доступа (оставьте пустым для неограниченного доступа);
3. Убедитесь, что флажок Active отмечен;
4. Нажмите кнопку Create:

7.3 Сохранение API-ключа¶

После создания ключа система покажет окно подтверждения:

1. Важно! Скопируйте и сохраните показанный API-ключ в безопасном месте (выделен красным фоном);
2. Этот ключ больше не будет показан в панели управления - сохраняется только его хеш;
3. Также сохраните ссылку на панель управления сервером;
4. Нажмите OK для завершения.

7.4 Настройка модуля в WHMCS¶

1. В WHMCS перейдите в раздел Addons → HOSTKEY VPS/Dedicated;
2. В поле API Key вставьте полученный API-ключ;
3. В поле API URL укажите: https://invapi.hostkey.com/:

7.5 Настройка импорта продуктов¶

В разделе Select products to resell:

1. Отметьте нужные типы продуктов для импорта:

   • Import VPS products - для импорта VPS-серверов;
   • Import Bare metal products - для импорта выделенных серверов;
   • Import GPU products - для импорта GPU-серверов.

2. Настройте ценовую наценку для каждого типа продуктов:

   • Введите процент наценки в соответствующих полях;
   • Выберите тип наценки из выпадающего списка.

3. В поле Round price to выберите правила округления цен;

4. В поле Email template выберите шаблон email-уведомлений.

7.6 Импорт продуктов¶

После завершения настройки нажмите кнопку Import products/Adjust prices для импорта продуктов из каталога HOSTKEY в вашу систему WHMCS.

Система автоматически создаст продукты со всеми необходимыми характеристиками и настроенными ценами согласно указанной наценке.

Настройка валют¶

8.1 Доступ к настройкам валют¶

1. В боковом меню выберите Payments;
2. Нажмите на Currencies.

8.2 Добавление дополнительной валюты¶

По умолчанию система настроена на USD. Для добавления новой валюты (например, EUR):

1. В разделе Add Additional Currency заполните поля:

   • Currency Code: EUR
   • Prefix: €
   • Suffix: EUR
   • Format: выберите формат отображения (например, 1234.56)
   • Base Conv. Rate: укажите курс конвертации к базовой валюте (например, 1.00)

   

2. Нажмите кнопку Add Currency для сохранения настроек.

8.3 Настройка курсов валют¶

Система позволяет настроить автоматическое обновление курсов валют или устанавливать их вручную через поле Base Conv. Rate.

Заказ сервера с WHMCS с помощью API¶

Для установки данного ПО с использованием API следуйте этой инструкции.