# Telegram · Зберігання та відновлення

Canonical page: https://phishdestroy.io/tgwitness/uk/docs/reference/storage/

Резервне копіювання, переміщення старих файлів у хмарне сховище, копії під захистом Object Lock та відновлення на новому комп’ютері.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/uk/llms.txt)

Резервне копіювання, переміщення старих файлів у хмарне сховище, копії під захистом Object Lock та відновлення на новому комп’ютері.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Розгортання та відновлення](https://phishdestroy.io/tgwitness/uk/docs/reference/deployment/)

![Розгортання та відновлення](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

Панель розділяє три завдання:

| Завдання | Що це робить |
| --- | --- |
| Створюйте резервні копії | Скопіюйте підписаний журнал, контрольні точки, збережені файли та експорти в черзі до налаштованого місця призначення S3. |
| Безкоштовний локальний простір | Скопіюйте вибрані старі вкладення до S3 або віддаленого хмарного сховища rclone, повністю завантажте їх назад, перевірте зашифровані байти, а потім видаліть перевірену локальну копію. |
| Зберігайте копію доказів | Налаштуйте S3 Object Lock і перевірте повернутий статус зберігання. Сервіс повинен підтвердити запитуваний режим та дату. |

Звільнення місця ніколи не призводить до видалення чи перезапису підписаного журналу. Кожне вкладення зберігає свій оригінальний тег SHA-256 та квитанцію відновлення. Опціональне стиснення gzip відбувається перед шифруванням з автентифікацією. Імена файлів у хмарі не містять імен Telegram, ідентифікаторів чатів або оригінальних імен вкладень. Розмір одного вкладення може становити до 32 ГіБ.

Сама по собі відповідь на завантаження не є дозволом на видалення файлу. TgWitness завантажує повний зашифрований об’єкт, перевіряє його розмір та SHA-256, зберігає квитанцію, а потім ще раз перевіряє локальні байти безпосередньо перед видаленням. У разі невдалого завантаження, відмінного результату зчитування або скасованого перенесення локальний файл залишається на місці. Якщо увімкнена резервна копія доказів ще не скопіювала цей файл, видалення також чекає на це.

**На цій сторінці**

- [Коли диск заповнюється](https://phishdestroy.io/tgwitness/uk/docs/reference/storage/#when-the-disk-is-filling-up)
- [Підключити пункт призначення](https://phishdestroy.io/tgwitness/uk/docs/reference/storage/#connect-a-destination)
- [Зберегти файл відновлення](https://phishdestroy.io/tgwitness/uk/docs/reference/storage/#keep-the-recovery-file)
- [Відновлення після втрати інсталяції](https://phishdestroy.io/tgwitness/uk/docs/reference/storage/#recover-after-losing-the-installation)
- [Бот-оператор та повідомлення про завершення](https://phishdestroy.io/tgwitness/uk/docs/reference/storage/#operator-bot-and-completion-notices)

## Коли закінчується місце на диску

Завантаження вкладень уже призупиняється нижче **пункту Більше інструментів → Параметри → Фотографії та файли → Призупиніть завантаження нижче цього вільного місця на диску** (за замовчуванням — 1 ГіБ), зберігаючи їхню чергу. Текстові спостереження продовжуються. Це не залежить від налаштувань сповіщень. Вимкнення сповіщень не вимикає резерв завантаження або заходи безпеки щодо зберігання.

Для раннього реагування ввімкніть **Запускати автоматично**, виберіть **Видаляти локальний файл для звільнення місця** та ввімкніть **Додаткове перенесення за нестачі місця**. Типово правило запускається нижче 5120 MiB вільного місця й обробляє файли пакетами, доки не стане доступно 10240 MiB. Обидва пороги налаштовуються. Місце призначення, мінімальний вік файлів, розмір пакета, повна перевірка зворотним читанням і вимоги до резервної копії доказів такі самі, як для ручного запуску. Місце призначення не вмикається автоматично. Перевірки відбуваються кожні 30 секунд; помилка або відсутність прогресу відкладає повтор на п’ять хвилин. Стан правила й час повтору зберігаються після перезапуску. Коли правило неактивне, планові проходи мають звичайний інтервал.

Панель показує вільне місце, резерв для пакування, готовність правила нестачі місця та файли, пропущені через брак тимчасового простору. Перед пакуванням і відновленням перевіряється пікова потреба в тимчасовому місці, а під час запису — доступний обсяг. Резерв відповідає налаштуванню завантажень, але для сховища становить щонайменше 64 MiB. Це не квота файлової системи: інший процес може зайняти місце між перевірками.

Gzip стискає віддалені об’єкти без втрат; активний журнал не зменшується, локальні архіви не створюються. JPEG, відео та ZIP можуть майже не стискатися або трохи збільшуватися. За ввімкненого стиснення пакування може тимчасово потребувати приблизно подвійного розміру вкладення плюс резерв. Обирайте поріг запуску з урахуванням найбільших файлів. Завеликий файл зберігається й зазначається у звіті; менші файли та раніше перевірені віддалені копії все ще можуть звільнити місце. Перевірена копія дозволяє видалити локальний файл без нового файла пакування. Відновлення також потребує тимчасового місця й може бути відхилене до його появи.

Якщо придатних файлів немає або місце призначення не налаштоване, TgWitness не може автоматично звільнити місце. Керування сховищем ніколи не скорочує й не переписує підписаний журнал. Для нових текстових спостережень йому все одно потрібне місце.

Робочі простори на одному сервері використовують однакові вкладені файли. Збережений файл отримує ім’я на основі його SHA-256; якщо в іншому робочому просторі цього сервера вже є такий самий файл у `cas/` каталозі даних, нова копія замінюється жорстким посиланням на нього після того, як обидва файли знову хешуються, тому три робочі простори, що зберігають один і той самий канал, використовують дисковий простір лише однієї копії. Кожен робочий простір, як і раніше, має власний файл у `media/` і читає, експортує та вивантажує його, як і раніше. Файл, який неможливо пов’язати, наприклад, у файловій системі без жорстких посилань, залишається окремою копією. Під час кожного запуску TgWitness видаляє з `cas/` лише ті файли, на які більше не посилається жодна робоча область; файл робочої області ніколи не видаляється на цьому етапі.

## Підключити пункт призначення

У розділі **Інші інструменти → Додаткові → Зберігання та дисковий простір → Керування сховищем** виберіть завдання та місце призначення, збережіть його, а потім виберіть **Тестове завантаження та завантаження**. Під час тесту завантажується невеликий випадковий зразка та зчитується назад. При цьому не використовується вміст Telegram.

Для S3 використовуйте фактичну кінцеву точку, регіон та бакет провайдера. Wasabi, Backblaze, Cloudflare R2 та інші сумісні сервіси використовують ті самі налаштування S3. Сама лише сумісність API не означає підтримку Object Lock. Режим «Управління» може дозволити авторизованому адміністратору обійти термін зберігання; режим «Відповідність вимогам» має інші обмеження. Перед тим, як покладатися на термін зберігання, перегляньте повернутий статус Object Lock.

Для місця призначення rclone створіть один віддалений сервер за допомогою налаштування провайдера rclone та вставте розділ цього віддаленого сервера `[name]` у панель. Встановлений допоміжний модуль підтримує MEGA, Google Drive, OneDrive, Dropbox, Box, pCloud та інших провайдерів, показаних у вибірнику. Повноваження зберігаються у зашифрованому сховищі цього робочого простору. Оновлення OAuth зберігаються назад у сховище. Повноваження не додаються до подій журналу та не включаються у завантаження для відновлення.

Допоміжний модуль встановлюється в робочому просторі, із закріпленою версією та SHA-256. Він не додається до системного PATH. Конфігураційні та робочі файли є тимчасовими файлами в межах цього робочого простору. Віддалені підключення на основі команд та локальних файлів не підтримуються. Наразі rclone вимагає явно обраного маршруту **Direct** для зовнішніх запитів. Використовуйте вбудоване сховище S3 для маршруту SOCKS5 або HTTP робочого простору; rclone не обходить недоступний маршрут без попередження.

## Збережіть файл відновлення

Виберіть опцію **«Зберегти файл відновлення** після копіювання файлів» і зберігайте його окремо від інсталяції. Він містить ключ дешифрування та підписані квитанції об’єктів, тож ставтеся до нього як до резервної копії приватного ключа. Оригінальну віддалену конфігурацію та облікові дані призначення також зберігайте окремо. Файл відновлення, створений до пізнішого копіювання, не містить квитанції цього пізнішого файлу.

Незалежно записати відбиток ключа підпису: перевірка підпису щодо цього відбитка дозволяє визначити, чий це файл відновлення.

Щоб відновити відсутні квитанції зберігання в існуючому робочому просторі, відкрийте **«Відновити файли зі збереженого файлу відновлення**» та виберіть файл. Панель перевіряє підпис і вимагає того самого ключа підпису робочого простору. Вона відмовляється замінювати інший ключ зберігання. Потім виберіть **«Відновити всі файли**». Відновлення призупиняє дію автоматичного правила зберігання, щоб наступний запланований цикл не зміг одразу знову видалити відновлені файли. Поверніть правило в дію, коли закінчите роботу з локальними копіями.

Функція відновлення перевіряє шифрований текст, підтверджує автентичність розшифрування, розпаковує файл, якщо це необхідно, та перевіряє SHA-256 вихідного відкритого тексту перед розміщенням файлу в папці `media/`. Пошкоджений віддалений об’єкт ніколи не замінює локальний файл. Під час імпорту файлу відновлення локальний файл вважається наявним лише тоді, коли його розмір та SHA-256 збігаються з квитанцією, тому **функція Відновити всі файли** також відновлює локальний файл, байти якого відрізняються. Ці байти не перезаписуються: щойно перевірена копія готова, їх без змін переміщують до `storage-conflicts/EXPECTED_SHA256.LOCAL_SHA256`, у журналі реєструється `storage.local_conflict`, а у результатах відновлення перелічуються всі конфлікти. На панелі «Зберігання» показано, скільки файлів міститься в папці `storage-conflicts/`, та перелічено перші 20 із вказанням їхнього розміру; команда `recover` виводить кожен конфлікт із обома хешами та його шляхом. Доки такий файл не буде відновлено, під час повного експорту доказів вам буде запропоновано спочатку відновити всі файли.

## Відновлення після втрати інсталяції

Встановіть TgWitness на іншому комп’ютері. Використовуйте приватний файл відновлення, окремо записаний відбиток та оригінальні облікові дані призначення:

```
python -m tgwitness.storage recover \
  --recovery storage-recovery.json \
  --fingerprint TRUSTED_WORKSPACE_SHA256 \
  --credentials original-rclone.conf \
  --output recovered-attachments
```

Для S3 параметр `--credentials` вказує на приватний JSON-файл із `access_key` та `secret_key`; підписаний файл відновлення надає налаштування призначення. Команда використовує пряме зовнішнє з’єднання та завантажує закріплений допоміжний модуль, коли це потрібно віддаленому серверу rclone. Вона відхиляє існуючий вихідний каталог, якщо у цьому каталозі зберігається перерване відновлення з того самого підписаного файлу відновлення; повторне виконання команди зберігає перевірені файли та продовжує роботу з рештою.

Відновлені вихідні байти записуються в `recovered-attachments/media/`, названі за їхнім SHA-256. `recovery-log.jsonl` — це запис операцій відновлення без підпису. Команда не відтворює втрачений підписаний журнал або його ключ підпису. Для цього зберігайте повну резервну копію робочого простору. Файл відновлення сховища не є повною резервною копією робочого простору .

## Бот-оператор та повідомлення про завершення

Бот Telegram належить оператору. Створіть його за допомогою BotFather і встановіть у панелі його токен, чат-призначення та явно вказані дозволені ідентифікатори користувачів Telegram. І відправник, і чат повинні збігатися. Переслані повідомлення та команди від інших ботів ігноруються.

`/status` і `/stats` доступні у стандартному режимі «тільки статус». Додатковий режим керування додає `/pause`, `/resume` та `/copy`. `/copy` запитує налаштовану задачу зберігання; це не означає, що віддалене завантаження вже завершилося. Команди не можуть передавати довільні URL-адреси, файли або програми оболонки.

Використовуйте окремі налаштування сповіщень для попереджень та завершення завдань. Повідомлення про завершення розрізняють експорт облікового запису з пропусками та повний експорт, а також показують історію та кількість збережених даних. Витяги з повідомлень не включаються, якщо це не ввімкнено окремо в налаштуваннях сповіщень. Вибір сервісу формується на основі фактичного встановленого каталогу Apprise, а не фіксованого набору прикладів постачальників.
