# Telegram · Впровадження

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

Запускайте TgWitness як службу на Windows, Linux, macOS або в Docker, через HTTPS, із резервним копіюванням та оновленнями.

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

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

Запускайте TgWitness як службу на Windows, Linux, macOS або в Docker, через HTTPS, із резервним копіюванням та оновленнями.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документація](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

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

**Англійська** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [Українська](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [Португальська (Бразилія)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [Türkçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [العربية](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [فارсі](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [урду](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [हिन्दी](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [Індонезійська](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [简体中文](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md)

## Оберіть варіант встановлення

Для отримання портативного пакета розпакуйте файл `TgWitness-<version>-windows-amd64-portable.zip` з GitHub Releases. Для інших методів завантажте та розпакуйте ZIP-архів з вихідним кодом або клонуйте репозиторій, а потім виконайте наступну команду з каталогу проєкту:

| Встановлення | Початок | Працює у фоновому режимі? |
| --- | --- | --- |
| Портативний пакет для Windows | `TgWitness.cmd` | Ні; залиште вікно відкритим. |
| Вбудована у Windows | `Start.cmd` | Ні; для роботи у фоновому режимі використовуйте додаткове завдання входу в систему. |
| Вбудована підтримка Linux/macOS | `sh start.sh` | Ні; для роботи у фоновому режимі використовуйте systemd/launchd. |
| Docker на будь-якому підтримуваному хості | `docker compose up -d --build --wait` | Так, поки працює демон Docker. |
| Допоміжний інструмент для Docker у Windows | `scripts\Docker.cmd` | Так; допоміжна програма очікує на стан працездатності веб-сервера. |
| Допоміжний інструмент для Docker на Linux/macOS | `sh scripts/docker-start.sh` | Так; допоміжна програма очікує на стан працездатності веб-сервера. |

Щодо хмарного сервера, який має бути доступним для перевірки третьою стороною — створеного за допомогою API провайдера, без SSH, доступ до якого здійснюється виключно через Cloudflare Tunnel — див. [розділ «Розгортання з високим рівнем надійності](https://phishdestroy.io/tgwitness/uk/docs/reference/high-assurance/)».

Вбудований запуск створює приватний файл `.venv` та встановлює закріплені залежності. Docker компілює їх усередині образу, не потребуючи Python на хості. Для первинного налаштування потрібен доступ до Інтернету. Якщо Python 3.11+ не знайдено, `Start.cmd` запитує до встановлення Python 3.12 для поточного користувача Windows (winget, інакше — інсталятор з python.org після перевірки підпису Python Software Foundation); він ніколи не вимагає прав адміністратора. Docker та служби ОС залишаються обов’язковими вимогами.

Нативні та портативні інсталяції використовують `data/live` у своїй папці. Docker використовує том із назвою `tgwitness-data`, розташований за адресою `/data`. Це окремі інсталяції, доки ви свідомо не перенесете весь каталог даних. Не очікуйте, що новий контейнер Docker автоматично виявить нативні облікові записи.

## Вимоги до встановлення

Для нативна інсталяція потрібні Python 3.11 або новішої версії з `venv` та `ensurepip`, доступ до Інтернету для інсталяції першої залежності, а також каталог проєкту з правом запису для `.venv`. Для панелі, що входить до комплекту, не потрібні Node.js чи фронтенд-збірка. Запустіть програму-запускач зі свого звичайного облікового запису в ОС; TgWitness не вимагає прав адміністратора/root.

- **Windows:** `Start.cmd` перевіряє `py -3`, потім `python`, потім стандартні папки для кожного користувача та папку «Program Files», і вимагає версії 3.11 або пізнішої. Якщо жодна з них не працює, пропонується автоматична інсталяція для кожного користувача, описана вище. `py -3 start.py` також працює. Портативний пакет взагалі не потребує Python.
- **Linux:** `start.sh` перевіряє `python3.13`, `python3.12`, `python3.11`, `python3` та `python` і виводить команду встановлення для apt, dnf, pacman, zypper, apk або Homebrew, якщо жодна з них не підходить. Для встановлення в Debian/Ubuntu може знадобитися пакет `python3-venv`, що відповідає обраному інтерпретатору. Стару версію Python, встановлену за замовчуванням у дистрибутиві, необхідно замінити або доповнити Python 3.11+.
- **macOS:** встановіть актуальну дистрибуцію Python 3.11+; не вважайте, що інтерпретатор, наданий ОС, відповідає вимогам. Використовуйте файл `python3 start.py` із каталогу проєкту.
- **Docker:** використовуйте Docker Engine/Desktop із Compose v2.20 або новішою версією. Docker Desktop повинен використовувати контейнери Linux у Windows. Контейнер встановлює свої власні залежності Python; на хості не потрібно окремо встановлювати Python.

## Локальний комп’ютер

Використовуйте `Start.cmd` у Windows або `sh start.sh` у Linux/macOS. `scripts\Setup.cmd` або `sh start.sh --setup-only` готує середовище. Програма запуску встановлює залежності під час першого використання; подальші запуски використовують уже готове середовище. Для налаштування та збору даних Telegram потрібен доступ до Інтернету, але перегляд існуючих записів та створення експортних файлів працюють в автономному режимі.

Після налаштування запустіть `python start.py --check`, щоб перевірити локальні залежності, Ed25519, сховище, конфігурацію ключів та адресу прослуховування без запуску колектора. Використовуйте `--json` для структурованого виводу. Передайте потрібні `--data-dir`, `--host` та `--port`. Ця перевірка не встановлює пакети, не створює журнал і не підключається до Telegram; вона не є перевіркою цілісності чи повноти охоплення. Під час запуску окремо перевіряються існуючі журнали. `python start.py --help` також дозволяє уникнути інсталяції.

Після запуску start.py виконайте допоміжні команди з `.venv\Scripts\python.exe` у Windows або `.venv/bin/python` у Linux/macOS, або спочатку активуйте це середовище. Наведені нижче приклади `python -m ...` передбачають, що середовище вже активне.

```
python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787
```

Змінні середовища: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE вибирає режим зовнішнього ключа для нової інсталяції; див. [Зовнішній головний ключ](https://phishdestroy.io/tgwitness/uk/docs/reference/security/#external-master-key). TGWITNESS_TOKEN, якщо вказано, має містити щонайменше 24 символів; використовуйте криптографічно випадкове значення. Без нього програма генерує 256-бітний випадковий токен у файлі panel-token.txt. Перезапис із середовища не змінює цей файл. Перезапустіть систему, щоб оновити облікові дані.

Каталог даних може належати лише одному процесу. Міжплатформова блокування файлів ОС запобігає випадковим одночасним операціям запису. Використовуйте один робочий процес Uvicorn. Панель може керувати будь-якою кількістю робочих просторів, з додатковими каталогами робочих просторів у профілях profiles/<id>/. Для окремих екземплярів служби використовуйте окремі каталоги та порти. Файли WAL SQLite мають зберігатися у локальному постійному сховищі, а не в мережевій файловій системі. Не використовуйте один том для декількох реплік.

## Портативний пакет для Windows

Кожен реліз на GitHub містить `TgWitness-<version>-windows-amd64-portable.zip` та його `.sha256`. Він містить офіційне вбудовуване середовище виконання Python 3.12 з python.org (контрольна сума зафіксована в `tools/build_portable.py`), TgWitness та його зафіксовані залежності, а також три програми запуску:

| Файл | Мета |
| --- | --- |
| `TgWitness.cmd` | Запустіть панель; додаткові параметри передаються, наприклад, `TgWitness.cmd --port 8790` |
| `TgWitness-Demo.cmd` | Запустіть синтетичну демонстрацію за посиланням `data\demo` |
| `TgWitness-Check.cmd` | Виконайте перевірку готовності, не запускаючи програму |

Закріплений російський морфологічний словник та профілі кольорів у форматі PDF включені до пакету для офлайн-використання. Упаковка допускає лише відомі шляхи до файлів у каталогах залежностей `data`; наявність несподіваних файлів у цих каталогах призводить до збою збірки.

Розпакуйте весь архів у папку з правами на запис, наприклад `Documents\TgWitness`; не запускайте програму зсередини ZIP-архіву або з папки «Program Files». Середовище виконання використовує ізольований шлях до модулів, тому інші інсталяції Python та `PYTHONPATH` не впливають на нього. Дані зберігаються у папці `data` цього пакету. Для оновлення зупиніть TgWitness, розпакуйте нову версію в нову папку та скопіюйте туди папку `data`.

Створіть його самостійно на 64-бітній Windows із Python 3.12:

```
python tools/build_portable.py
```

## Контейнер

```
docker compose up -d --build --wait
```

Це створює іменований постійний том для /data. Веб-порт прив’язано до 127.0.0.1:8787. Процес працює під UID 10001 із обмеженими правами, кореневою файловою системою тільки для читання та каталогами /data та /tmp, доступними для запису. `--wait` перевіряє працездатність веб-сервера перед поверненням; авторизація та доставка Telegram відображаються на панелі. Надані допоміжні програми використовують 180-секундний тайм-аут готовності після збірки. Початкове завантаження залежностей може тривати довше.

Обидва базові файли Compose використовують назву проєкту `tgwitness`, тому розпакування нового релізу в інший каталог не призведе до автоматичного вибору нового тома даних. Залишайте активним лише одне розгортання для цього проєкту. Для незалежних інсталяцій використовуйте унікальний `docker compose -p NAME ...` та інший порт хосту, і зберігайте обидва під час оновлень. Для старішого розгортання, що використовує іншу назву проєкту, продовжуйте використовувати його оригінальну назву разом із `-p`; `docker compose ls` перелічує існуючі проєкти.

Скопіюйте `deploy/env.example` до `.env` та змініть `TGWITNESS_PORT`, щоб використовувати інший порт зворотного зв’язку. Наприклад, `TGWITNESS_PORT=8788` відкриває доступ до панелі за адресою `http://127.0.0.1:8788`; контейнер як і раніше прослуховує порт 8787. `.env` ігнорується Git.

Отримати початковий токен:

```
docker compose exec tgwitness cat /data/panel-token.txt
```

Корисні команди:

```
docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait
```

`restart: unless-stopped` перезапускає колектор після збою або перезапуску демона Docker. На сервері під управлінням Linux увімкніть Docker під час завантаження за допомогою менеджера служб вашого дистрибутива, зазвичай `sudo systemctl enable --now docker`. У Windows/macOS увімкніть параметр «запускати під час входу» у Docker Desktop. Вихід із системи, перехід у режим сну або зупинка демона Docker можуть перервати збір даних. Явно зупинений контейнер залишається зупиненим, доки ви його знову не запустите.

У наведеному прикладі конфігурації обсяг тома /tmp обмежено 512 Мб. Механізм експорту замість цього використовує папку ``temporary-exports/`` кожного робочого простору на постійному томі /data. Зарезервуйте там місце для одночасних експортів, зростання журналу/WAL, мультимедіа та резервних копій. Програма запуску використовує файл `deploy/constraints.txt` для фіксації відповідних версій залежностей середовища виконання. Сервери Docker та сервери з високим рівнем безпеки встановлюються на основі файлів deploy/requirements.lock та deploy/build.lock за допомогою команди pip --require-hashes: кожен файл пакета повинен відповідати SHA-256, зафіксованому у коміті, тому файл, замінений на PyPI або дзеркалі, відхиляється. Пакеті, які поставляються лише у вигляді вихідного коду (jieba, pyaes), компілюються з використанням setuptools, зафіксованих у файлі deploy/build.lock (опція `--no-build-isolation`) за допомогою запускача, портативного компілятора для Windows та файлу Dockerfile, тож pip не створює окремого, незафіксованого середовища компіляції. Базовий образ Python та пакети операційної системи все ще потребують незалежної кваліфікації випуску.

Не використовуйте команду `docker compose down -v`, якщо ви не маєте наміру знищити журнал та ключі. Звіт про стан контейнера відображає доступність веб-сервера, а не успішність збору даних Telegram. Перевіряйте стан колектора панелі, сигнал активності, помилки та події покриття.

### Профіль незалежного свідка

Опціональний сервіс `witness` запускає [незалежного свідка](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/) у власному контейнері, з власним ключем та журналом у томі `witness-data` і лише токеном свідка, доступним лише для читання, для колектора. Створіть токен у панелі в розділі **Більше інструментів → Додаткові → Незалежний свідок**, додайте його разом із токеном бота та каналом до файлу `.env`, а потім запустіть профіль:

```
docker compose --profile witness up -d          # deploy/compose/compose.image.yaml: same flag
docker compose logs witness                     # witness key fingerprint
```

Сервіс підключається до колектора в мережі Compose за адресою `http://tgwitness:8787` (`TGWITNESS_WITNESS_COLLECTOR` замінює її, наприклад, `/profiles/<workspace ID>` для іншого робочого простору). Для свідка на окремому сервері, яким керує хтось інший, використовуйте `deploy/compose/compose.witness.yaml` , встановивши для `TGWITNESS_WITNESS_COLLECTOR` HTTPS-адресу колектора; цей файл містить лише свідка.

## Встановити опублікований образ

Скопіюйте `deploy/env.example` у `.env`. Встановіть `TGWITNESS_IMAGE` на опубліковану версію, використовуючи шлях до репозиторію **з малими літерами**, наприклад:

```
TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787
```

Запустіть цей файл окремо, замість `compose.yaml`:

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt
```

На хості не потрібні збірка з вихідного коду, Python чи компілятор. Процес випуску орієнтований на контейнери Linux AMD64 та ARM64, включаючи віртуальну машину Linux у Docker Desktop. Використовуйте тег версії або `ghcr.io/owner/repository@sha256:...` із підсумку робочого процесу. Не налаштовано переміщення тегу `latest` або автоматичне оновлення додатка. Образ та варіанти вихідного коду використовують один і той самий том даних, якщо назви їхніх проєктів збігаються.

## Автоматичне ввімкнення HTTPS на сервері

Використовуйте сервер із Docker, домен, який ви контролюєте, та постійне локальне сховище. Направте записи A/AAAA домену на сервер; публікуйте AAAA лише в тому випадку, якщо до нього досягає IPv6. Дозвольте вхідний трафік по TCP 80 та 443, а також вихідний трафік DNS/HTTPS для видачі сертифікатів. Ці порти не повинні бути зайняті іншими службами.

Скопіюйте `deploy/env.example` у `.env` та вкажіть ім’я хосту без схеми та шляху:

```
TGWITNESS_DOMAIN=watch.your-domain.org
```

Запустіть збірку вихідного коду з накладенням HTTPS:

```
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt
```

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait
```

Для опублікованого зображення замість цього використовуйте `deploy/compose/compose.image.yaml` як перший файл. Збережіть обидва аргументи `-f` для подальших команд status, logs, update та stop.

Caddy отримує та поновлює сертифікат, перенаправляє HTTP на HTTPS та пересилає запити до колектора у приватній мережі Compose. Стан сертифіката зберігається у власному постійному томі. Порт прямого хосту колектора залишається лише для локального з’єднання. Надана конфігурація Caddy не вмикає реєстрацію доступу.

Відкрийте `https://watch.your-domain.org` та введіть токен панелі. Перевірка готовності охоплює контейнери; видача сертифікатів та зовнішня доступність залежать від DNS та брандмауера. Якщо HTTPS не готовий, перевірте DNS, правила брандмауера та:

```
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy
```

Наданий образ Caddy відповідає тегу `2-alpine`. Виконання команди pull оновлює цей образ; якщо вам потрібні фіксовані версії інфраструктури, закріпіть перевірений дайджест у вашому розгортанні.

## Оновлення та резервні копії

Зберігайте назву проєкту Compose та обсяг даних під час оновлень. Спочатку зупиніть колектор і створіть повну резервну копію. Для розгортання за замовчуванням на основі вихідного коду:

```
docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update
```

Кожного разу використовуйте нове місце для резервного копіювання, поза межами репозиторію, та захищайте його як матеріал, що вимагає доступу до облікового запису. Наведений приклад шляху є ілюстративним; використовуйте своє власне місце для резервного копіювання. Скопіюйте весь каталог, включаючи приховані файли, усі робочі простори, ключі, журнали та мультимедійні файли. Окремо створіть резервну копію головного ключа зовнішнього сховища, якщо він налаштований. ZIP-архів з доказами не є резервною копією програми, яку можна відновити. Для HTTPS також збережіть томи Caddy, якщо вам потрібно зберегти стан його сертифіката/облікового запису.

Для розгортання з вихідного коду завантажте файли нової версії та виконайте:

```
docker compose up -d --build --wait
```

Для розгортання образу змініть `TGWITNESS_IMAGE` на бажану версію, а потім виконайте:

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
```

Використовуйте файли Compose вашої інсталяції також для наведених вище команд stop/copy. Збережіть `.env`, власні налаштування та ту саму назву проєкту. `down` зберігає іменовані томи; **`down -v` видаляє їх**. Не копіюйте `.venv` між операційними системами або версіями Python. Для оновлення з вихідного коду зупиніть TgWitness, створіть резервну копію всього каталогу даних , замініть вихідні файли та запустіть `python start.py --setup-only` перед запуском програми.

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

## Віддалений сервер

Забезпечте, щоб сервіс працював у режимі loopback та використовував SSH-тунель, або завершуйте HTTPS на зворотному проксі. Базовий файл Compose доступний лише локально; опціональний оверлей `deploy/compose/compose.https.yaml` надає Caddy для налаштованого домену. Не допускайте появи токена носія в URL-адресах та журналах проксі-сервера. Зворотний проксі-сервер повинен обмежувати розмір запитів та частоту з’єднань. Не відкривайте доступ до простого HTTP в Інтернеті.

Приклади для systemd, завдання входу в систему Windows, агента користувача macOS та Caddy наведено у [папці deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md). Перегляньте та адаптуйте їхні шляхи перед встановленням. Це лише шаблони, а не локально виконувані налаштування платформи. Звичайний запускач не реєструє жодних фонових служб чи завдань.

У Windows безвіконний запуск `pythonw.exe` зберігає діагностичні дані запуску/сервера у файлі `logs/server.log` у каталозі даних (5 МіБ на файл, дві чергові резервні копії). Запуск у консолі зберігає консольні журнали. Реєстрація доступу по HTTP вимкнена в обох режимах. Захищайте журнали разом із каталогом даних та перевіряйте їх перед тим, як надавати доступ.

## Перезапуск та прогалини

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

TgWitness зберігає позицію оновлення Telegram для облікового запису та для кожного каналу (pts, qts, seq та date) у сховищі робочого простору та відновлює її під час наступного запуску. Потім клієнт запитує оновлення, пропущені під час зупинки процесу, а періодична повторна перевірка відновлює пропущені повідомлення та фіксує збережені, які Telegram більше не повертає. Діалоги перезавантажуються під час запуску. При кожному запуску фіксуються попередня головка журналу, межа офлайн-режиму та позиція оновлення, з якої відбулося відновлення. Монітор перевіряє підключення кожні 10 секунд і додає сигнал активності щохвилини (**Більше інструментів → Параметри → Запис активності кожні**). Втрати з’єднання та періоди мовчання фіксуються як прогалини в покритті із зазначенням причини. Знімки історії зберігаються як окремі спостереження поточної історії поруч із записами в режимі реального часу.

Черга мультимедіа зберігається в базі даних SQLite кожного робочого простору. Повідомлення та його завдання фіксуються атомарно. Перервані завдання відновлюються для повторної спроби під час запуску. Кожне завантаження має базовий тайм-аут у 120 секунд плюс час, необхідний для завантаження файлу розміром 256 КіБ/с, а також 1–2,000 MiB на тип вкладення; час очікування, швидкість та кількість спроб налаштуються в розділі **Додаткові інструменти → Параметри**. Колектор пропускає файли, розмір яких невідомий. Призупинення зберігає роботи в черзі. Повторна спроба використовує оригінальний спостережуваний дескриптор файлу, а не останню версію повідомлення, яке було відредаговано згодом. Тимчасові збої мають обмежену кількість спроб; паузи FloodWait для медіа зберігаються після перезапуску. Відновлення медіа є окремим від відновлення оновлень Telegram і не може відтворити зниклі файли.

## Резервне копіювання, відновлення та ємність

`tgwitness backup FOLDER` копіює каталог даних, поки панель продовжує працювати: спочатку контрольні точки, потім файли SQLite через API онлайн-резервного копіювання, а потім ключі, мультимедіа та профілі, тому жодна скопійована контрольна точка не є новішою за скопійований журнал. У файлі `backup-manifest.json` перелічено SHA-256 кожного файлу та заголовки журналів. Для відновлення зупиніть TgWitness і замініть весь каталог даних цією папкою. Під час наступного запуску фіксується, що журнал було відновлено зі старішої копії. Цей запис порівнює журнал із заголовком, що зберігається в `TGWITNESS_STATE_DIR` — папці поза каталогом даних: том `tgwitness-state` у Compose, `/var/lib/tgwitness-state` у модулях systemd, а в інших випадках — у локальній папці стану користувача . Без папки стану з правом запису відновлення не виявляється, про що один раз повідомляється у журналі.

Якщо ця команда відсутня, зупиніть процес перед копіюванням **усього каталогу даних**, включаючи файли vault.key, signing.enc, credentials.enc, файли бази даних SQLite та WAL, мультимедіа, токен, контрольні точки, а також усі підкаталоги profiles/. Відновіть повну копію, коли служба призначення зупинена. Відсутність ключів сховища або невідповідність ключів підпису призведе до збою запуску; не слід перегенерувати ключі для примусового доступу.

Зберігайте секретні резервні копії у зашифрованому вигляді з контролем доступу. ZIP-архіви з доказами є портативними артефактами для перегляду, а не резервними копіями додатків чи сеансів Telegram. Автоматичного видалення після закінчення терміну зберігання не відбувається. Заплануйте місце на диску для всіх повідомлень, необроблених метаданих, мультимедіа, тимчасових експортів та резервних копій.

Запуск верифікації та експорту записів потоку замість завантаження всього журналу. Експорт фіксує знімок стану на момент зчитування, тоді як нові записи WAL можуть продовжуватися; тривалі експорти можуть зберігати сторінки WAL, тому ємність диска все ще має значення. Розмір ZIP-архівів обмежено 4 ГіБ у нестисненому вигляді, щоб відповідати налаштуванню за замовчуванням незалежного верифікатора; **Більше інструментів → Параметри → Найбільший підписаний ZIP** підвищує обмеження, і такі архіви перевіряються за допомогою `verify.py --max-gib N`. Інші формати не мають обмеження на кількість подій. Підтримувані браузери передають фрагменти відповіді у потоковому режимі до файлу, обраного користувачем. Інші браузери буферизують не більше 128 МіБ і направляють більші передачі до автентифікованого CLI:

```
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
```

Використовуйте `--profile ID` з **меню «Експорт» → «Ідентифікатор робочого простору»** для іншого робочого простору, `--format zip|jsonl|csv|html`, `--url https://your-server` для віддаленого сервера або `--max-mib`, щоб змінити обмеження на передачу даних у 5 ГіБ. Простий HTTP дозволено лише для петлевого з’єднання. Токени передаються в заголовках, перенаправлення відхиляються, існуючі файли не перезаписуються, а незавершені завантаження не публікуються як завершені файли. Якщо TGWITNESS_TOKEN замінює згенерований токен, використовуйте окремо захищений файл, що містить це активне значення: файл panel-token.txt не перезаписується при заміщенні. SHA-256 команди є лише контрольною сумою передачі; незалежно перевірте підписаний ZIP-файл.

Панель відображає медіафайли в черзі/з помилками, найстаріші медіафайли в очікуванні, вільне місце на диску, паузи у запитах до Telegram та джерела, доступ до яких не підтверджено. Ці діагностичні дані не є повноцінним монітором доставки «від кінця до кінця». Робочі простори використовують спільний процес; обліковий запис із великим трафіком може все одно впливати на інші. Залишаються окремі робочі процеси, зберігання/ротація, відновлення стійких оновлень та повна кваліфікація розгортання. Доступ до панелі з обмеженим обсягом повноважень задокументовано у розділі [«Доступ та дозволи»](https://phishdestroy.io/tgwitness/uk/docs/reference/access/); незалежні контрольні точки висвітлено у [посібнику для свідків](https://phishdestroy.io/tgwitness/uk/docs/reference/witness/).

Детальні інструкції: [підключення/безпека](https://phishdestroy.io/tgwitness/uk/docs/reference/connection/) та [режими роботи](https://phishdestroy.io/tgwitness/uk/docs/reference/operations/).
