WHM Скриптове

 

Общо описание

По време на инсталацията на cPanel & WHM, системата добавя множество полезни скриптове в директориите:

• /usr/local/cpanel/scripts

• /usr/local/cpanel/bin

Тези скриптове се използват за различни задачи – създаване на имейли, настройки за MySQL, архивиране и други.

 

Как се изпълнява скрипт?

Просто въведете пълния път до скрипта в терминала. Например:

/usr/local/cpanel/scripts/upcp

 

Важно:
Винаги използвайте пълния път до скрипта, дори ако вече се намирате в съответната директория.
Не изпълнявайте скриптове, които не са описани в официалната документация – това може да повреди системата ви!

 

Често използвани скриптове:

🔹 addpop

Създава нов имейл акаунт.

 

🔹 auto-adjust-mysql-limits

Автоматично променя някои важни MySQL настройки в WHM → Tweak Settings:

• open_files_limit

• max_allowed_packet

• innodb_buffer_pool_size
  

Полезно за оптимизация на бази данни.

 

🔹 autossl_check

Извършва ръчна проверка на AutoSSL сертификатите:

• Може да се изпълни за един потребител или за всички.

• Изтрива стари AutoSSL логове след завършване.
  

 

🔹 backup

Стартира архивиране (backup) ръчно от команден ред.
Намира се в директорията /usr/local/cpanel/bin

 

🔹 backups_clean_metadata_for_missing_backups

Премахва метаданни, свързани с архиви, които са били ръчно изтрити от сървъра.

 

🔹 backups_create_metadata

Създава метаданни за всички типове архиви (компресирани, инкрементални и др.)

 

🔹 backups_list_user_files

Търси файлове на конкретен потребител във всички архиви.
Резултатите се връщат във CSV формат (разделени със запетаи).

 

🔹 backup_restore_manager

Управлява опашката за възстановяване на архиви.
Също се намира в /usr/local/cpanel/bin

 

🔹 balance_linked_node_quotas

Принудително прилага дисковите квоти за акаунти, хоствани на разпределени сървъри (linked nodes).

 

🔹 build_maxemails_config

Задава лимити за максималния брой имейли, които даден домейн може да изпраща.

 

🔹 build_mysql_conf

Създава стандартен конфигурационен файл за MySQL.

 

🔹 ccs-check

Позволява на приставката Calendar and Contacts Server (CSS) да работи с вашия SSL сертификат.

 

🔹 check_cpanel_pkgs

Сканира всички инсталирани пакети на сървъра за проблеми или липсващи файлове.

 

🔹 check_plugin_pkgs

Проверява дали инсталираните приставки (plugins) са интегрирани коректно.

 

🔹 check_security_advice_changes

Следи промените в WHM секцията Security Advisor.
Ако има нови предупреждения – изпраща известие на администратора.

Този скрипт се изпълнява автоматично при нощната поддръжка на сървъра.

 

🔹 check_users_my_cnf

Проверява дали има невалидни ~/.my.cnf файлове за потребители и ги преименува, за да не пречат.
Полезно, ако конфигурацията на MySQL не работи правилно за даден акаунт.

 

🔹 checkallsslcerts

Инсталира или обновява cPanel-сертифициран SSL сертификат за hostname-а на сървъра.
Намира се в /usr/local/cpanel/bin.

 

🔹 chkmydns

Прави базова проверка на конфигурацията на MyDNS.
MyDNS е премахнат от WHM след версия 106 – не използвайте този скрипт на нови сървъри.

 

🔹 cleandns

Премахва стари и дублиращи се DNS записи (zones), които не се използват.

 

🔹 cleansessions

Изтрива временни сесии от:

• phpMyAdmin

• phpPgAdmin

• Webmail
  Също така премахва изтекли файлове от:

• Възстановяване на парола

• Покани към sub-акаунти
  

 

🔹 clean_up_temp_wheel_users

Изтрива временни потребители с root (wheel) достъп, които се създават от cPanel Support при нужда.

 

🔹 clean_user_php_sessions

Изтрива изтекли PHP сесии от временната защитена директория.

 

🔹 comparecdb

Сравнява съдържанието на два .cdb файла (Card DataBase формат).
Пример:

/usr/local/cpanel/scripts/comparecdb file1 file2

 

🔹 configure_rh_ipv6_firewall_for_cpanel

Настройва IPv6 защитна стена (firewall) за cPanel.

Полезно, ако не използвате друг инструмент за управление на firewall-а.
Отваря портове:

• 22 (SSH)

• 53 (DNS)

• 80 (HTTP)
  

Не се препоръчва при AlmaLinux 8, CloudLinux 8, Rocky Linux 8 или Ubuntu.

 

🔹 copy_user_mail_as_root

Копира имейли от/до отдалечен сървър, като root потребител.

 

🔹 copy_user_mail_as_user

Копира имейли от/до отдалечен сървър, като самия потребител.

 

🔹 convert_accesshash_to_token

Преобразува стария WHM access hash в нов, по-сигурен API токен.

 

🔹 convert_mdbox_to_maildir

Преобразува пощенски кутии от формат mdbox → maildir.

 

🔹 convert_maildir_to_mdbox

Обратното на горния – maildir → mdbox.

 

🔹 convert_roundcube_mysql2sqlite

Конвертира базата данни на Roundcube от MySQL към SQLite.
Полезно за спестяване на ресурси.

 

🔹 cpaddonsup

Обновява системата за cPAddons (добавки като CMS-и).
Не се поддържа на сървъри с Ubuntu.

 

🔹 cpanel_dovecot_solr_rebuild_index

Регенерира Apache Solr индекси, ако са повредени.
Намира се в /usr/local/cpanel/3rdparty/scripts.

 

🔹 cpbackup

Създава резервни копия (backups) на всички cPanel акаунти.

 

🔹 cpdig

Изпълнява DNS заявка чрез WHM DNS системата.
Пример:

cpdig www.example.com AAAA

 

🔹 cpuser_port_authority

Задава персонализирани портове (5-цифрени) за специфичен потребител.

 

🔹 dbmaptool

Свързва бази данни и потребители към конкретен cPanel акаунт.
Намира се в /usr/local/cpanel/bin.

 

🔹 dbstoregrants

Синхронизира MySQL правата от YAML/JSON файловете в /var/cpanel/databases/.
Също е в /usr/local/cpanel/bin.

 

🔹 delpop

Изтрива съществуващ имейл акаунт.

 

🔹 dnssec-cluster-keys

Синхронизира и/или премахва активни DNSSEC ключове в DNS клъстери.

 

🔹 dovecot_maintenance

Изтрива изтрити съобщения от mdbox потребители, които са се логвали след последното почистване.
Работи по време на нощната поддръжка (auto-maintenance).

 

🔹 dumpcdb

Показва съдържанието на .cdb файл (Card DataBase формат).
Пример:

/usr/local/cpanel/scripts/dumpcdb файл

 

🔹 ea4_fresh_install

Инсталира EasyApache 4 – системата за компилиране и настройка на Apache/PHP.

 

🔹 email_hold_maintenance

Премахва временните файлове за имейли, поставени на изчакване (hold) – например такива, чакащи изтриване или изпращане.

 

🔹 empty_user_trash

Изтрива стари файлове от кошчето (.trash) на потребителите.
Настройката за “възраст” на файловете се задава в:
WHM » Tweak Settings → Age of content to purge from users’ File Manager Trash

Скриптът се намира в /usr/local/cpanel/bin и се изпълнява по време на нощната поддръжка.

 

🔹 enable_spf_dkim_globally

Активира SPF и DKIM за всички потребители на сървъра и създава нужните DNS записи.

 

🔹 eximstats_spam_check

Анализира базата данни eximstats и проверява дали даден домейн е изпратил твърде много имейли през последния час.
При надвишаване на лимита:

• може да се покаже предупреждение,

• да се задържат/откажат съобщенията (по настройка).
  

Настройки се правят в WHM → Tweak Settings → Mail.

 

🔹 exportmydnsdb

Експортира DNS зони от MyDNS за използване с BIND или NSD.
Скриптът е остарял – MyDNS и NSD са премахнати от cPanel 106+.

 

🔹 find_and_fix_rpm_issues

Проверява за проблеми в RPM пакетите и, ако има, поправя базата данни.
Не се използва при Ubuntu сървъри.

 

🔹 find_outdated_services

Проверява кои услуги трябва да бъдат рестартирани, защото използват остарели библиотеки.

 

🔹 fix_addon_permissions

Поправя правата на файлове от cPAddons, които съдържат чувствителна информация (например пароли).
Безопасно е да се използва само при сървъри с модули като mpm-itk, mod_ruid2, или mod_suphp.

 

🔹 fix_dns_zone_ttls

Оправя грешки в TTL стойностите на DNS зоните.

 

🔹 fixmailinglistperms

Поправя правата на директориите и файловете, свързани с Mailman мейлинг листи.

 

🔹 fixndc

Поправя грешката “ndc connection refused”.
Важно: Скриптът трябва да се изпълни два пъти след актуализация:

/scripts/upcp  

/scripts/fixndc  

/scripts/fixndc

 

🔹 fix-web-vhost-configuration

Почиства vhost конфигурациите, като премахва излишни ServerAlias стойности от виртуалните хостове.

 

🔹 hook

Изпълнява “hooks” – стандартни скриптови действия, които се активират при дадено събитие в системата.

 

🔹 importmydnsdb

Импортира DNS зони от MyDNS или BIND в NSD.
MyDNS и NSD са премахнати след cPanel версия 106.

 

🔹 install_cpaddons

Инсталира или управлява cPAddons (добавки като CMS системи).
Скриптът се намира в /usr/local/cpanel/bin
Не работи на Ubuntu.

 

🔹 install_cpanel_analytics

Инсталира приставката за cPanel Analytics.

 

🔹 install_dovecot_fts

Активира пълнотекстово търсене (Full-Text Search) за имейли през IMAP, използвайки Apache Solr.

 

🔹 install_plugin

Инсталира cPanel приставка (plugin).
Само root потребител може да изпълнява този скрипт.

 

🔹 installpostgres

Инсталира PostgreSQL база данни.
Не работи на Ubuntu сървъри.

 

🔹 is_script_stuck

Проверява дали даден скрипт работи твърде дълго чрез неговия PID (процес ID).
Може да:

• Уведоми WHM потребител

• Прекрати процеса
  

Намира се в /usr/local/cpanel/bin.

 

🔹 maintenance

Извършва системна поддръжка, включително:

• Терминира нежелани процеси (по настройки в WHM → Background Process Killer)

• Стартира се автоматично с upcp
  

 

🔹 manage_greylisting

Управлява Greylisting – антиспам технология за входящи имейли.

 

🔹 manage_mysql_profiles

Импортира и експортира MySQL профили.

 

🔹 modify_accounts

Променя темата (стила на интерфейса) за избрани cPanel акаунти.

 

🔹 modify_packages

Обновява темата на хостинг пакети на сървъра.

 

🔹 modsec_vendor

Управлява ModSecurity доставчици (vendor-и) – напр. правила за защита.

 

🔹 onboot_handler

Изпълнява скриптове от следните папки при включване на сървъра:

• /var/cpanel/on_boot

• /usr/local/cpanel/libexec/on_boot
  Намира се в /usr/local/cpanel/bin/.
  

 

🔹 php_fpm_config

Създава/обновява конфигурационни файлове за PHP-FPM, след ръчни промени.

 

🔹 pkgacct

Създава архив на cPanel акаунт – използва се при прехвърляне или бекъп.

 

🔹 post_snapshot

Обновява конфигурации на сървър, създаден от snapshot образ.
Стартира се автоматично при първо включване (освен ако не е използван –no-post-service → тогава трябва ръчно).

 

🔹 process_site_templates

Използва шаблони и данни от потребителя, за да създаде сайт с Site Publisher.

 

🔹 purge_modsec_log

Изтрива остарели записи от базата данни на ModSecurity.

 

🔹 realperlinstaller

Инсталира автоматично Perl модули от CPAN (архив на Perl библиотеки).

 

🔹 rebuildhttpdconf

Пресъздава главния конфигурационен файл на Apache (httpd.conf).

 

🔹 rebuild_available_addons_packages_cache

Създава наново кеша за налични cPAddons пакети.
Файл: /var/cpanel/available_addons_packages.cache
Бившото име на скрипта: rebuild_available_rpm_addons_cache

 

🔹 rebuild_dbmap

Поправя или създава наново картата на базите данни за потребител, ако е повредена.

 

🔹 rebuild_phpconf

Управлява PHP конфигурацията по подразбиране (версия + handler-и) в EasyApache 4.
Намира се в /usr/local/cpanel/bin.

 

🔹 rebuild_whm_chrome

Обновява WHM кеша на интерфейс елементи като:

• Header & Footer

• Навигационното меню
  Полезно при разработка на WHM приставки – скриптът го обработва за root и всички реселъри.
  

Предишните кеш файлове се изтриват при стартиране.

 

🔹 remote_log_transfer

Копира системните и потребителски логове от сървъра към отдалечена бекъп дестинация, зададена в WHM.

 

🔹 remove_dovecot_index_files

Изтрива индексите и кеш файловете на Dovecot от имейл акаунтите – освобождава място и решава проблеми с пощата.

 

🔹 removeacct

Изтрива cPanel акаунт изцяло от сървъра – включва имейли, бази данни и файлове.

 

🔹 rescan_user_dovecot_fts

Извършва пълнотекстово сканиране (FTS) на имейлите за конкретен потребител – за по-бързо търсене чрез Solr.

 

🔹 restartsrv

Рестартира определена услуга (service) на сървъра, като Apache, Exim и др.

 

🔹 restorepkg

Възстановява cPanel акаунт от архивен .tar.gz файл, създаден с pkgacct.

 

🔹 runstatsonce

Обновява статистиките на всички потребители – трафик, дисково използване, и т.н.

 

🔹 runweblogs

Обновява статистиката само за един потребител.
Пример:

/usr/local/cpanel/scripts/runweblogs username

 

🔹 secureit

Подобрява правата за достъп и сигурността на файловете и директориите в системата.

 

🔹 securemysql

Подобрява сигурността на MySQL конфигурацията за даден акаунт.

 

🔹 securetmp

Монтира /tmp дяла като ограничена временна файлова система, за да се предотвратят експлойти.

 

🔹 servers_queue

Управлява задачи от опашката на сървъра (task queue).
Намира се в /usr/local/cpanel/bin.

 

🔹 servicedomains

Създава DNS записи за служебни поддомейни като:

• cpanel.example.com

• webmail.example.com

• whm.example.com
  Полезно при командна инсталация на нов акаунт.
  

 

🔹 set_php_memory_limits

Автоматично настройва memory_limit за всички PHP версии в /opt/cpanel/.
Използва се така:

/usr/local/cpanel/scripts/set_php_memory_limits –run

 

🔹 set-tls-settings

Управлява SSL/TLS настройките (cipher-и и протоколи) за следните услуги:

• Web Disk (cpdavd)

• WHM/cPanel интерфейс (cpsrvd)

• Exim (поща)

• Dovecot (пощенски сървър)
  Намира се в /usr/local/cpanel/bin.
  

 

🔹 setupftpserver

Позволява ви да:

• Изберете FTP сървър (Pure-FTPd или ProFTPD)

• Активирате/деактивирате анонимен FTP
  

 

🔹 setup_greylist_db

Създава базата данни за Greylisting и добавя доверени имейл услуги (като Gmail) в whitelist.

 

🔹 setup_modsec_db

Създава MySQL база и потребител за ModSecurity.
Не трие стари бази или данни.

 

🔹 setupmailserver

Позволява избор на имейл сървър (поддържа се само Dovecot в новите версии на cPanel).

 

🔹 setupnameserver

Позволява превключване между DNS сървъри – като BIND, PowerDNS и др.
MyDNS и NSD са премахнати след cPanel версия 106

 

🔹 slurp_exim_mainlog

Импортира всички неархивирани Exim логове от /var/log/exim_mainlog в базата eximstats.

 

🔹 snapshot_prep

Подготвя сървъра за създаване на snapshot образ (например за клониране или преместване).

 

🔹 spf_installer

Добавя SPF DNS записи за всички домейни на потребител.
Намира се в /usr/local/cpanel/bin.

 

🔹 suspendacct

Спира (suspend-ва) даден cPanel акаунт – временно го деактивира.

 

🔹 swapip

Сменя IP адреса в DNS записите на домейн с новия от сървъра.
Намира се в /usr/local/cpanel/bin.

 

🔹 sync_child_accounts

Синхронизира акаунт между основен сървър (parent) и неговите child nodes.

 

🔹 sync-mysql-users-from-grants

Създава нужните MySQL/MariaDB потребители, ако липсват.
Обикновено се изпълнява автоматично при активиране на MySQL.

 

🔹 transfer_account_as_user

Прехвърля cPanel акаунт от отдалечен сървър като потребител (без root достъп).

 

🔹 transfer_accounts_as_root

Прехвърля един или повече акаунта с root достъп от отдалечен сървър.

 

🔹 try-later

Изпълнява команда на интервали, докато тя даде успех.
Може да прави автоматични повторения и след успех – да задейства нова команда.

 

🔹 uninstall_cpanel_analytics

Премахва плъгина за cPanel Analytics.
Само root потребител може да го изпълнява.

 

🔹 uninstall_plugin

Деинсталира плъгин на cPanel.

 

🔹 unlink_service_account

Премахва връзката между услуга и акаунт, връщайки акаунта в самостоятелно състояние.

 

🔹 unsuspendacct

Активира отново (unsuspend) спрян акаунт.
Също така премахва service proxy настройки (ако има такива).

 

🔹 upcp

Стартира актуализацията на cPanel & WHM.

 

🔹 upcp-running

Проверява дали скриптът upcp в момента работи.

 

🔹 update_existing_mail_quotas_for_account

Променя квотите за всички съществуващи имейл акаунти:

• за определен потребител,

• или за всички потребители.

 

🔹 update-packages

Актуализира всички системни пакети.
Бивше име: rpmup

 

🔹 updateuserdomains

Актуализира файла /etc/userdomains според съдържанието на /var/cpanel/users.

 

🔹 upgrade_subaccount_databases

Проверява и обновява схемите на подакаунтите (например за FTP и имейл).

 

🔹 view_transfer

Показва логовете от прехвърляне или възстановяване на акаунт.
Намира се в /usr/local/cpanel/bin.

 

🔹 vps_optimizer

Оптимизира настройките на Apache SpamAssassin според наличната RAM на сървъра (Max Children).

 

🔹 whmlogin

Генерира еднократен WHM login URL – полезно при автоматизация или интеграции.

 

🔹 wwwacct

Създава нов cPanel акаунт чрез командния ред.