hiFTPCleaner для Beget
Публикация комплекта: 27.10.2026

Пошаговая инструкция со схемами и командами:
https://ipwificam.ru/instructions/cloud-cleanup/

Для чего нужен комплект
Скрипт удаляет старые записи камер с хостинга Beget. Он работает с файлами
внутри того же аккаунта хостинга; доступ по FTP и пароль ему не требуются.
Для отдельного облачного S3-хранилища этот комплект не подходит.
Нужен PHP CLI версии 8.1 или выше. Программа запускается на хостинге по Cron;
компьютер не нужно держать включённым. Это не программа для Windows.

Что находится в архиве
1. hiFTPCleaner.php — скрипт; его содержимое менять не нужно.
2. cleaner.json — настройки; откройте их в текстовом редакторе.
3. START_HERE.txt — эта памятка; загружать её на хостинг не требуется.

Куда загрузить файлы
В примере папка архива называется ftpcams и находится в домашней папке аккаунта.
Знак ~ означает домашнюю папку аккаунта хостинга, а не папку сайта public_html.
Создайте ~/maintenance и загрузите туда hiFTPCleaner.php.
Загрузите cleaner.json в ~/ftpcams, рядом с папками камер.
Не переносите существующие записи ради примера: если папка архива называется
иначе, используйте её название и путь. Скрипт и настройки должны находиться
вне публичных папок сайта.

Проверьте структуру записей
Внутри ~/ftpcams должны находиться папки камер. В папках камер — папки дат
в формате ГГГГММДД или ГГГГ-ММ-ДД, внутри которых лежат папки images и record
с файлами. Поддерживаются только файлы непосредственно в этих папках;
вложенные каталоги и символические ссылки не поддерживаются.
В папке архива не должно быть посторонних папок, кроме .cache.
Не используйте скрипт для другой структуры файлов без проверки.

Настройки cleaner.json
enabled: true — проект включён для проверки и очистки.
keep_days: 14 — сохранять 14 календарных дней, включая последнюю дату в архиве.
media_dir: "." — папки камер находятся рядом с cleaner.json.
Если папки камер находятся внутри подпапки cameras, укажите "cameras" вместо ".".
Меняйте только значения, сохраняйте кавычки и запятые. Имя файла должно быть
cleaner.json, а не cleaner.json.txt.

Как считаются дни
Скрипт берёт общую последнюю дату среди камер и сохраняет заданное окно дней.
Например, если последняя дата — 20 сентября, а keep_days равно 3, останутся
18, 19 и 20 сентября. Пропущенные дни тоже входят в окно.
Это не отсчёт от сегодняшнего дня. Если все камеры остановились, окно
не сдвигается. Проверьте правильность даты в настройках камер: будущая дата
может сдвинуть окно и привести к удалению нужных записей.
Скрипт не измеряет свободное место. Срок хранения нужно выбрать с учётом
размера архива и объёма хостинга; защита от переполнения не гарантируется.

Сначала проверка без удаления
Выберите полный путь к PHP CLI версии 8.1 или выше в своём аккаунте.
Версия PHP для Cron может отличаться от версии PHP сайта.
В инструкции на сайте показано, где взять реальные пути и как создать задание.
Вместо /FULL/PATH/TO/PHP ниже подставьте путь к PHP вашего аккаунта:

/FULL/PATH/TO/PHP ~/maintenance/hiFTPCleaner.php --project ~/ftpcams

Без --apply записи не удаляются. Изучите отчёт: window показывает границы
сохраняемых дат, would_delete — файлы, которые будут удалены, error — ошибку.
Не включайте удаление, если даты, папки или список файлов не совпадают с ожиданием.
Сначала проверьте удаление на отдельной папке с копиями файлов.

Включение расписания Cron
После проверки добавьте --apply в команду для настоящего удаления.
В поле команды Cron скопируйте строку из инструкции на сайте вместе с кавычками
и $HOME: Beget подставит домашнюю папку вашего аккаунта. Расписание выбирается
отдельно от команды. Если ваша папка архива называется иначе, измените её путь.
Удаление безвозвратное: важные записи предварительно сохраните отдельно.
Не добавляйте --apply к проверочной команде до проверки отчёта и копий файлов.
После первого запуска убедитесь, что новые записи сохранены, а старые удалены.

Журнал и отключение
Чтобы журнал тоже не рос бесконечно, следуйте способу сохранения последнего
отчёта из инструкции на сайте; не используйте бесконечное дописывание без ротации.
Для остановки удалите или отключите задание Cron либо замените true на false
в поле enabled файла cleaner.json. Без --apply можно продолжать проверки.
Служебный файл .hiFTPCleaner.lock не удаляйте во время работы скрипта.

Настройка по шагам:
https://ipwificam.ru/instructions/cloud-cleanup/
