Февруари 24, 2026

Скриптът cpconftool

 

Общ преглед

Използвайте скрипта /usr/local/cpanel/bin/cpconftool, за да архивирате и възстановите конфигурационни настройки. Скриптът групира конфигурациите на различни услуги в модули.

 

Модули

С помощта на този скрипт можете да архивирате и възстановявате следните модули:

  • Apache® — cPanel & WHM използва Apache за хостване на уебсайтове.
    🔸 Забележка: Модулът Apache също така променя настройките на ModSecurity®. Apache използва ModSecurity за откриване и предотвратяване на прониквания в уеб сървъра.
    🔸 Различия: Архивирането, възстановяването и прехвърлянето на Apache се различават от останалите модули. Виж секцията “Разлики при модула Apache” по-долу.

  • AutoSSL — Функцията AutoSSL автоматично издава безплатни, валидирани по домейн SSL сертификати за домейните на потребителите.
    🔸 Забележка: Този модул не променя доставчика на SSL. За да го направите, използвайте интерфейса WHM » SSL/TLS » Manage AutoSSL.

  • Backups — cPanel & WHM използва резервни копия за съхранение или архивиране на данни. Можете да използвате тези данни за възстановяване на предишно състояние.
    🔸 Забележка: Този модул не включва настройки на остарялата (legacy) система за резервни копия.

  • Темите на cPanel — Използвани за генериране на интерфейсите на cPanel и WHM.

  • cPHulk — Услуга, която предпазва сървъра от brute force атаки.
    🔸 Забележка: Скриптът не копира историята на отчетите.
    🔸 Скриптът добавя настройки за whitelist и blacklist, но не ги заменя.

  • Exim — Основният пощенски агент за прехвърляне (MTA) в cPanel & WHM.

  • GreyListing — Защита от спам чрез временно отлагане на съобщения от непознати податели.

  • ModSecurity — Отворен код защитна стена за уеб приложения.

  • MySQL® — Система за управление на бази данни.
    🔸 Забележка: Интерфейсът WHM » Transfer Tool не позволява архивиране или прехвърляне на MySQL конфигурации. Трябва да използвате този скрипт.

  • WHM (whmconf) — Архивиране и възстановяване на основни WHM настройки, които не са специфични за потребителите, като например тези от „Tweak Settings“ и „Basic WebHost Manager Setup“.

 

Изпълнение на скрипта

Изпълнете командата като root потребител:

 

/usr/local/cpanel/bin/cpconftool –option

 

Опции

Скриптът /usr/local/cpanel/bin/cpconftool –option приема следните опции:

Опция Описание Пример
–modules (Задължително) Списък с модули, разделени със запетая –modules=cpanel::smtp::exim,cpanel::system::mysql
–backup Създаване на резервно копие –backup –modules=cpanel::smtp::exim
–restore Възстановяване от резервно копие. Посочете пълния път до файла –restore=/home/backup.tar.gz –modules=cpanel::smtp::exim
–list-modules Показва наличните модули на сървъра –list-modules
–query-module-info Показва информация за модулите –query-module-info –modules=cpanel::smtp::exim
–verbose Показва подробности при архивиране или възстановяване –backup –modules=cpanel::smtp::exim –verbose
–prerestore_backup Автоматично създава резервно копие преди възстановяване –restore=/home/backup.tar.gz –modules=cpanel::smtp::exim –prerestore_backup

 

Архивиране на конфигурационен модул

За да архивирате конфигурационен модул, изпълнете следните стъпки:

  1. Влезте в сървъра чрез SSH като root потребител.

  2. Навигирайте до директорията /usr/local/cpanel.

  3. За да видите наличните конфигурационни модули, изпълнете:

 

/usr/local/cpanel/bin/cpconftool –list-modules

 

Примерен изход:

 

cpanel::easy::apache

cpanel::smtp::exim

cpanel::system::autossloptions

cpanel::system::backups

cpanel::system::greylist

cpanel::system::hulk

cpanel::system::modsecurity

cpanel::system::mysql

cpanel::system::whmconf

cpanel::ui::themes

 

За да архивирате модул, изпълнете:

/usr/local/cpanel/bin/cpconftool –backup –modules=configuration::to::backup

 

Ще получите потвърждение като това:

Backup Successful

/home/whm-config-backup-1562881772.tar.gz

 

🔹 Забележка: Името на архива се генерира автоматично и съдържа уникален идентификатор.

 

Съдържание на конфигурационния архив

Можете да видите какви файлове се архивират за даден модул с опцията –verbose. Например:

/usr/local/cpanel/bin/cpconftool –backup –modules=cpanel::smtp::exim –verbose

 

Изходът ще съдържа списък с файлове, като например:

Backing up /etc/exim.conf …

Backing up /var/cpanel/config/email/trust_x_php_script …

Backup Successful

/home/whm-config-backup-cpanel__smtp__exim-90.001000-1604326024.tar.gz

 

Възстановяване на конфигурация

⚠️ Важно: Възстановяването на конфигурации на Apache може да изисква допълнителни стъпки (виж по-долу).

За да възстановите конфигурация от архив:

 

/usr/local/cpanel/bin/cpconftool –restore=/home/backup.tar.gz –modules=config::to::restore –prerestore_backup

 

По време на възстановяването се извършват следните действия:

  • Възстановяват се всички конфигурационни файлове.

    • 🔹 Забележка: Файловете, които не съществуват на източника, ще бъдат изтрити от местоназначението.

  • Скриптът проверява валидността на настройките.

  • Скриптът изпълнява /usr/local/cpanel/scripts/buildeximconf.

  • Ако проверката не успее, настройките се отменят.

  • Ако е успешна, съответната услуга се рестартира.

 

Прехвърляне на конфигурации

⚠️ Предупреждение: Препоръчително е да използвате WHM интерфейса “Transfer Tool”, а не ръчно прехвърляне със скрипта, за да избегнете неочаквани проблеми.

Стъпки:

  1. Направете архив с конфигурацията на изходния сървър.

  2. Копирайте .tar.gz архива до целевия сървър.

  3. Изпълнете възстановяването на целевия сървър.

 

Разлики при модула Apache

⚠️ Важно: При възстановяване на Apache, скриптът премахва всички стандартни include файлове. Ако Apache не стартира, използвайте:

 

/usr/local/cpanel/scripts/rebuildhttpdconf –help

 

и рестартирайте Apache.

Примерна команда за възстановяване:

 

/usr/local/cpanel/bin/cpconftool –restore=/home/backup.tar.gz –modules=cpanel::easy::apache

 

Извършвани действия:

  • Премества:

    • /var/cpanel/secdatadir

    • /var/cpanel/modsec_cpanel_conf_datastore

  • Засича и настройва:

    • конфигурации на ModSecurity® Vendors

    • активни/неактивни правила

  • Прехвърля конфигурации към новия сървър.

Какво НЕ прави скриптът:

  • НЕ прехвърля modsec2.conf, modsec2.user.conf или modsec2.cpanel.conf

  • НЕ заменя съществуващите modsec2.*.conf файлове — само ги модифицира

  • Архивира потребителския modsec2.user.conf, ако съществува

⚠️ Предупреждение: Не извличайте ръчно съдържанието на архивите.