DroBinG Backup - справочник пользователя (F1)

БЫСТРЫЙ СТАРТ
1. Выберите диск, на котором будут храниться копии. Это может быть флешка, внешний или внутренний диск.
2. Укажите адрес VDS, SSH-порт и логин. Это реквизиты SSH, а не адрес страницы сайта.
3. Для нового сервера нажмите «Получить ключ…» и сверьте отпечаток с доверенным источником (панелью VDS или ранее проверенным SSH-подключением). Не подтверждайте незнакомый ключ вслепую.
4. Введите пароль, укажите исходные пути на сервере, интервал и лимит копий.
5. Если нужны автоматические копии, включите «Автозапуск и расписание». Нажмите «Сохранить / автозапуск».
6. Нажмите «Проверить SSH», затем «Сделать копию сейчас». Дождитесь сообщения об успешном завершении. «Открыть резервные копии» открывает папку результата.

1. НОСИТЕЛЬ И СТРАННЫЕ НОМЕРА ДИСКОВ
Буква (например, F:) помогает выбрать диск сейчас. Она может измениться после переподключения. В списке показаны метка, общий объём, файловая система и доступное место. Пустая метка отображается как «Без названия». «Обновить» перечитывает подключённые диски.
Внутри программа использует аппаратный серийный номер, серийный номер тома и свой контрольный файл device.ini. Это не номер «Диск 0/1/2» в Windows: такие номера не постоянны.
Некоторые контроллеры возвращают вместо заводского номера FFFF_FFFF... или иной общий идентификатор. Это ответ драйвера, а не признак поломки диска. В списке такая заглушка не показывается; выводится номер тома. Он также не является абсолютно уникальным: после клонирования возможны совпадения. При неоднозначности программа отказывается выбирать носитель автоматически.
Привязка существующих настроек сохранена. После форматирования выберите носитель заново. При выборе другого диска и сохранении программа переносит на него свой EXE и настройки, а локальная задача начинает искать новый диск. Старые резервные копии автоматически туда не переносятся и не стираются.

2. ПОДКЛЮЧЕНИЕ И ПАРОЛЬ
IP / домен - адрес SSH-сервера без https:// и без пути страницы. Порт SSH - тот, который установлен на вашем VDS (не обязательно 22). Логин - пользователь Linux с правом чтения нужных файлов.
Пароль вводится один раз для выбранного подключения в текущей учётной записи Windows. Он хранится в диспетчере учётных данных Windows, привязан к адресу, порту, логину и закреплённому ключу. На флешке в settings.ini пароля нет. Пустое поле оставляет сохранённый пароль для того же подключения. Для другого сервера/ключа/логина или нового ПК пароль нужно ввести снова.
Закреплённый ключ SSH - отпечаток SHA256 ключа сервера. Он защищает от подключения к подменённому серверу. Если ключ изменился, автоматическое подключение останавливается до аутентификации. Сначала выясните причину смены, затем получите и подтвердите проверенный новый ключ.
«Проверить SSH» сохраняет настройки и проверяет ключ с авторизацией. Это не создаёт резервную копию и не доказывает доступность всех исходных файлов.

3. КАК УКАЗАТЬ ФАЙЛЫ СЕРВЕРА
Один абсолютный путь Linux на строку. Можно указать каталог целиком или отдельный файл. Пример:
/opt
/var/www
/srv/site/data
/var/log
/etc
/root
/usr/local/bin
Это пути на VDS, а не папки вашего ПК. Каталог /opt обычно содержит API и сканер, /var/www - страницы сайта, /srv/site/data - базы, /var/log - журналы, /etc - настройки. Реальное расположение зависит от сервера. Копируются только выбранные пути, это не образ всей виртуальной машины. Корень / указывать нельзя. Вложенные источники не дублируются. Символические ссылки сохраняются как ссылки; их внешние цели отдельно не обходятся.
На VDS должен быть python3. На вашем ПК устанавливать Python или SSH-клиент не нужно. Программа не устанавливает постоянный сервис на VDS.

4. ИНТЕРВАЛ И АВТОЗАПУСК
Интервал в часах отсчитывается от окончания последней успешной копии; по умолчанию 24. Дата сохранена на носителе, закрытие окна и перезапуск ПК не сбрасывают её. В окне даты обозначены UTC; это не местное время. «Следующая» - срок, после которого копирование разрешено, а не обещание запуска секунда в секунду.
Планировщик Windows (задача DroBinG-SiteBackup) проверяет срок каждые 15 минут и после входа в Windows. Окно можно закрыть, экран заблокировать. Постоянно работающего интерфейса для расписания не нужно.
Для копирования ПК должен быть включён и не спать, пользователь должен войти в Windows, диск и интернет должны быть доступны. Во время выключения/сна копирования нет. При отсутствии диска/сети проверка повторится позже; пропущенные интервалы не создают пачку одинаковых копий.
На другом компьютере откройте EXE с носителя, введите пароль и сохраните настройки с включённым автозапуском. Само подключение флешки не регистрирует задачу на новом ПК. Обычно администратор не нужен; если политика Windows запрещает создание задачи, откройте настройки от имени администратора.
Чтобы отключить расписание, снимите флажок и сохраните. Простое закрытие окна расписание не отключает.

5. ЛИМИТ КОПИЙ И СВОБОДНОЕ МЕСТО
«Хранить копий»: 0 означает хранить все завершённые копии без автоматического удаления. Например, 7 - оставлять семь последних собственных завершённых копий после успешного создания новой. Это количество, а не срок в днях.
Программа не удаляет старые копии заранее, чтобы освободить место. Для старта нужно минимум 512 МиБ свободного места, но реальному архиву может понадобиться гораздо больше. При нехватке места новая копия не считается успешной. Для архивов больше 4 ГиБ нужен exFAT или NTFS; FAT32 не поддерживает такой файл.

6. КНОПКИ И СТАТУС
«Сохранить / автозапуск» - сохранить настройки, учётные данные и применить расписание на данном ПК. Изменения полей сами по себе не применяются.
«Сделать копию сейчас» - сохранить настройки и запустить копирование независимо от срока.
«Отменить» - остановить текущую операцию; незаконченная копия не станет завершённой. Кнопка не удаляет задачу расписания.
«Открыть резервные копии» - открыть папку выбранного сохранённого носителя.
Во время передачи окно нельзя закрыть обычным крестиком: дождитесь окончания или отмените операцию. Принудительное выключение/извлечение носителя может прервать запись. Не извлекайте диск до завершения.
Нижнее поле содержит состояние операции и ошибки. Даты рядом показывают последнюю успешную копию и следующий срок. Ошибка не сдвигает успешную дату вперёд.

7. ГДЕ РЕЗУЛЬТАТ И КАК ЕГО ПРОЧИТАТЬ
Папка на выбранном диске: Backcup_Site_DroBinG (именно такое написание). Внутри отдельные каталоги с датой UTC и уникальным суффиксом.
site.tar.gz - архив выбранных серверных файлов с сохранением путей.
SHA256SUMS.txt - контрольная сумма архива для проверки целостности.
snapshot.ini - параметры копии; COMPLETE - признак завершённой копии.
schedule.ini в общей папке хранит срок, backup.log - журнал работы. Папка .partial-* содержит незавершённую передачу и не является готовой копией. При повторной попытке собственные незавершённые данные перезаписываются.
В архиве __DroBinG_Backup__/manifest.json описывает источники, снимки SQLite и предупреждения. Распаковывать архив можно программой, поддерживающей tar.gz. Наличие COMPLETE не заменяет пробное восстановление и проверку содержимого под вашу задачу.

8. БАЗЫ ДАННЫХ И ВОССТАНОВЛЕНИЕ
SQLite копируются через механизм online backup и проверяются quick_check. Для них в архив помещается согласованная копия базы. Остальные файлы копируются с работающего сервера: весь сайт и несколько разных баз не замораживаются в один общий момент. Для PostgreSQL/MySQL нужны отдельные штатные дампы, если вы начнёте их использовать.
Автоматического восстановления на VDS нет. Перед ручным восстановлением выберите нужную успешную копию, проверьте её и остановите сервисы, использующие восстанавливаемую базу. Распаковывайте только нужные файлы, учитывая владельцев и права Linux. Не заменяйте весь /etc вслепую. При восстановлении SQLite нужно корректно обработать старые WAL/SHM работающей базы.

9. БЕЗОПАСНОСТЬ И ОШИБКИ
Передача защищена SSH, однако архив на диске НЕ зашифрован. В нём могут быть базы пользователей, ключи и конфигурации сервера. Храните носитель в безопасном месте; при необходимости используйте шифрование диска.
Не подключается - проверьте адрес, порт, интернет, SSH и логин/пароль. Несовпадение ключа - проверьте сервер, а не отключайте защиту. Нет носителя - подключите выбранный диск, нажмите «Обновить»; если диск форматировали, выберите и сохраните его заново. Нет места - освободите место или выберите другой носитель. Копирование упало - смотрите нижнее поле, backup.log и %LOCALAPPDATA%\DroBinG\SiteBackup\errors.log.
Локальный экземпляр для задачи находится в %LOCALAPPDATA%\DroBinG\SiteBackup. Не удаляйте его, если используете расписание.

10. ИКОНКА
Database Backup из Iconoir (https://iconoir.com), Copyright (c) 2021 Luca Burgio. MIT License: разрешено коммерческое использование и изменение при сохранении уведомления о лицензии. Иконка адаптирована по цвету и фону. Полный текст лицензии находится в ICON-LICENSE.txt и включён ниже.

MIT License

Copyright (c) 2021 Luca Burgio

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.