Февруари 24, 2026

Скрипт: backups_list_user_files

 

Списък с файлове от архивите на потребител

 

📋 Общ преглед

Скриптът /usr/local/cpanel/scripts/backups_list_user_files се използва за намиране и показване на файловете от архивите (backup-и) на даден cPanel потребител.

📌 Резултатът се връща в CSV (Comma-Separated Values) формат, което е удобно за автоматизирана обработка или анализ.

 

Как да стартираш скрипта

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

 

/usr/local/cpanel/scripts/backups_list_user_files [аргументи]

 

🧾 Поддържани аргументи

Аргумент Описание Стойност Пример
–user= Посочва потребителя, чиито архиви ще се преглеждат Потребителско име

 

–user=exampleuser

 

| –regexp= | Извежда само резултати, които съвпадат с даден текст или шаблон (регулярен израз).
Позволен е само един критерий. | Текст или regex шаблон |

 

–regexp=’example’

 

Примерна команда

 

/usr/local/cpanel/scripts/backups_list_user_files –user=username –regexp=’example’ | tail -n 8

 

Това ще покаже последните 8 резултата, които съдържат думата example в пътя на файла.

 

Формат на върнатата информация (CSV)

Системата връща резултати като CSV редове със следната структура:

 

[дата и час], [размер], [тип архив], [файл относително към /home], [пълен път в архива], [тип]

 

Примерни стойности:

Поле Описание Пример
Дата и час Кога е създаден файлът (в UTC) “Mon Aug 7 21:02:00 2017”
Размер Размер на файла в байтове 183
Тип архив compressed, uncompressed, или incremental incremental
Файл (относителен път) Пътя до файла спрямо /home/username /nvdata.cache
Пълен архивен път Пълният път до архива или директорията /backup/weekly/2018-04-02/accounts/username/homedir/nvdata.cache
Тип обект FILE, DIR или SYMLINK FILE

 

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

 

“Tue Feb 23 21:15:00 2016″,183,incremental,”/nvdata.cache”,”/backup/weekly/2018-03-26/accounts/username/homedir/nvdata.cache”,FILE

“Mon Aug  7 21:02:00 2017″,59,incremental,”/nvdata/optionselect_filemanager”,”/backup/weekly/2018-04-02/accounts/username/homedir/nvdata/optionselect_filemanager”,FILE

 

Полезно за:

  • Проверка дали конкретен файл/директория присъства в архивите 
  • Инвентаризация на backup съдържание 
  • Подготовка за възстановяване на конкретни файлове 
  • Автоматизирани скриптове за анализ на архиви