Telegram · Przechowywanie i odzyskiwanie

TgWitness / Dokumentacja · Wdrażanie i przywracanie

Panel dzieli zadania na trzy kategorie:

Zwolnienie miejsca nigdy nie powoduje usunięcia ani nadpisania podpisanego dziennika. Każdy załącznik zachowuje swój oryginalny tag SHA-256 oraz potwierdzenie odzyskania. Opcjonalna kompresja gzip odbywa się przed szyfrowaniem z uwierzytelnieniem. Nazwy plików w chmurze nie zawierają nazw użytkowników Telegrama, identyfikatorów czatów ani oryginalnych nazw załączników. Jeden załącznik może mieć rozmiar do 32 GiB.

Sama odpowiedź na przesłanie pliku nie stanowi zgody na jego usunięcie. TgWitness pobiera cały zaszyfrowany obiekt i weryfikuje jego rozmiar, a SHA-256 zapisuje potwierdzenie, a następnie ponownie sprawdza lokalne bajty tuż przed usunięciem. Niepowodzenie przesłania, różnica w odczycie lub anulowany transfer powodują, że plik lokalny pozostaje na swoim miejscu. Jeśli włączona kopia zapasowa dowodów nie skopiowała jeszcze tego pliku, usunięcie również czeka na to.

Na tej stronie

• Gdy dysk się zapełnia
• Połącz miejsce docelowe
• Zachowaj plik odzyskiwania
• Przywrócenie po utracie instalacji
• Bot operatorski i powiadomienia o zakończeniu

Gdy kończy się miejsce na dysku#

Pobieranie załączników jest wstrzymywane poniżej wartości Parametry → Załączniki → wolne miejsce na dysku (domyślnie 1 GiB), z zachowaniem kolejki. Obserwacje tekstowe trwają dalej. Nie zależy to od powiadomień: ich wyłączenie nie wyłącza rezerwy pobierania ani zabezpieczeń magazynu.

Aby zareagować wcześniej, włącz Uruchamiaj automatycznie, wybierz Usuń lokalny plik, aby zwolnić miejsce i włącz Dodatkowe przenoszenie przy małej ilości miejsca. Domyślnie opcjonalna reguła rusza poniżej 5120 MiB wolnego miejsca i przetwarza partie do osiągnięcia 10240 MiB. Oba progi można ustawić. Używa tego samego celu, minimalnego wieku plików, limitu partii, pełnej weryfikacji przez ponowny odczyt i wymogów kopii zapasowej dowodów co przebieg ręczny. Nie włącza samodzielnie miejsca docelowego. Sprawdza co 30 sekund; błąd lub brak postępu odracza kolejną próbę o pięć minut. Stan i termin próby przetrwają restart. Gdy reguła jest nieaktywna, zaplanowane przebiegi zachowują zwykły odstęp.

Panel pokazuje wolne miejsce, rezerwę pakowania, gotowość reguły i pliki pominięte z powodu braku miejsca tymczasowego. Pakowanie i odtwarzanie sprawdzają szczytowe zapotrzebowanie przed startem oraz wolne miejsce podczas zapisu. Obowiązuje rezerwa ustawiona dla pobierania, ale co najmniej 64 MiB dla operacji magazynu. To nie limit systemu plików: inny proces może zużyć miejsce między kontrolami.

Gzip bezstratnie kompresuje obiekty zdalne; nie zmniejsza aktywnego dziennika ani nie tworzy lokalnych archiwów. JPEG, filmy i ZIP mogą zmaleć nieznacznie lub nieco urosnąć. Przy kompresji pakowanie może tymczasowo wymagać około dwukrotnego rozmiaru załącznika plus rezerwy. Ustaw próg uruchomienia odpowiednio wcześnie dla największych plików. Zbyt duży plik pozostaje na miejscu i jest zgłaszany; mniejsze pliki i sprawdzone kopie zdalne nadal mogą zwalniać miejsce. Sprawdzona kopia pozwala usunąć plik lokalny bez tworzenia kolejnego pliku pakowania. Odtwarzanie też wymaga miejsca tymczasowego i może zostać odrzucone do czasu jego udostępnienia.

Jeśli nie ma odpowiednich plików do przeniesienia lub skonfigurowanego celu, TgWitness nie zwolni miejsca automatycznie. Zarządzanie magazynem nigdy nie przycina ani nie przepisuje podpisanego dziennika. Nadal potrzebuje on miejsca na nowe obserwacje tekstowe.

Połącz miejsce docelowe#

W menu Dodatki → Pamięć i miejsce na dysku → Zarządzaj pamięcią wybierz zadanie i miejsce docelowe, zapisz je, a następnie wybierz opcję Test przesyłania i pobierania. Test polega na przesłaniu małego losowego pliku testowego i odczytaniu go z powrotem. Nie wykorzystuje on treści z Telegrama.

W przypadku S3 należy użyć rzeczywistego punktu końcowego, regionu i zasobnika dostawcy. Wasabi, Backblaze, Cloudflare R2 i inne kompatybilne usługi korzystają z tych samych ustawień S3. Sama kompatybilność z API nie oznacza obsługi funkcji Object Lock. Tryb zarządzania może pozwalać upoważnionemu administratorowi na pominięcie okresu przechowywania; tryb zgodności ma inne ograniczenia. Przed poleganiem na okresie przechowywania należy sprawdzić zwracany status funkcji Object Lock.

W przypadku miejsca docelowego rclone należy utworzyć jedno zdalne konto, korzystając z konfiguracji dostawcy w rclone, a następnie wkleić sekcję tego zdalnego konta [name] sekcję tego serwera zdalnego do panelu. Zainstalowany moduł pomocniczy obsługuje MEGA, Google Drive, OneDrive, Dropbox, Box, pCloud oraz innych dostawców wyświetlanych w selektorze. Dane uwierzytelniające są zapisywane w zaszyfrowanym sejfie tego obszaru roboczego. Odświeżenia OAuth są zapisywane z powrotem w sejfie. Dane uwierzytelniające nie są dodawane do zdarzeń dziennika ani uwzględniane w plikach do odzyskiwania.

Narzędzie pomocnicze jest instalowane w obszarze roboczym, z przypiętą wersją i SHA-256. Nie jest on dodawany do ścieżki systemowej PATH. Pliki konfiguracyjne i pliki robocze są plikami tymczasowymi w ramach tego obszaru roboczego. Zdalne połączenia oparte na poleceniach i plikach lokalnych są odrzucane. rclone wymaga obecnie jawnie wybranej trasy Direct dla żądań zewnętrznych. Należy używać natywnej pamięci masowej S3 dla trasy SOCKS5 lub HTTP obszaru roboczego; rclone nie omija w sposób cichy niedostępnej trasy.

Zachowaj plik odzyskiwania#

Wybierz opcję „Zapisz plik odzyskiwania po skopiowaniu plików” i przechowuj go w miejscu oddzielnym od instalacji. Zawiera on klucz deszyfrujący oraz podpisane potwierdzenia obiektów, więc traktuj go jak kopię zapasową klucza prywatnego. Oryginalną konfigurację zdalną oraz dane uwierzytelniające miejsca docelowego również przechowuj oddzielnie. Plik odzyskiwania utworzony przed późniejszym skopiowaniem nie zawiera potwierdzenia tego późniejszego pliku.

Odcisk palca klucza podpisującego powinien być już wcześniej zapisany oddzielnie. Podpis sprawdzany wyłącznie względem klucza zawartego w tym samym pliku nie pozwala ustalić, do kogo należy dany plik odtworzeniowy.

Aby naprawić brakujące potwierdzenia przechowywania w istniejącym obszarze roboczym, otwórz opcję „Odzyskaj pliki z zapisanego pliku odzyskiwania” i wybierz plik. Panel sprawdza podpis i wymaga tego samego klucza podpisującego obszar roboczy. Nie zezwala na zastąpienie innego klucza przechowywania. Następnie wybierz opcję „Przywróć wszystkie pliki”. Przywracanie wstrzymuje działanie automatycznej reguły przechowywania, dzięki czemu następny zaplanowany cykl nie usunie od razu przywróconych plików. Ponownie włącz regułę po zakończeniu pracy z lokalnymi kopiami.

Funkcja przywracania weryfikuje tekst zaszyfrowany, uwierzytelnia odszyfrowanie, w razie potrzeby dekompresuje i sprawdza oryginalny tekst jawny SHA-256 przed umieszczeniem pliku w media/. Uszkodzony obiekt zdalny nigdy nie zastępuje pliku lokalnego. Istniejący plik lokalny zawierający inne bajty jest zachowywany do wglądu, a nie nadpisywany.

Przywracanie po utracie instalacji#

Zainstaluj TgWitness na innym komputerze. Użyj prywatnego pliku odzyskiwania, oddzielnie zarejestrowanego odcisku palca oraz oryginalnych danych uwierzytelniających do serwisu docelowego:

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

W przypadku S3 --credentials odwołuje się do prywatnego pliku JSON z access_key oraz secret_key; podpisany plik odzyskiwania dostarcza ustawienia miejsca docelowego. Polecenie korzysta z bezpośredniego połączenia zewnętrznego i pobiera przypięty program pomocniczy , gdy wymaga tego zdalny serwer rclone. Odrzuca istniejący katalog wyjściowy.

Odzyskane oryginalne bajty są zapisywane do recovered-attachments/media/o nazwach zgodnych z ich identyfikatorami SHA-256. recovery-log.jsonl jest niepodpisanym zapisem operacji odzyskiwania. Polecenie to nie odtwarza utraconego podpisanego dziennika ani jego klucza podpisu. W tym celu należy zachować pełną kopię zapasową obszaru roboczego. Plik odzyskiwania pamięci masowej nie jest pełną kopią zapasową obszaru roboczego .

Bot operatora i powiadomienia o zakończeniu#

Bot Telegramu należy do operatora. Utwórz go za pomocą BotFather i ustaw w panelu jego token, czat docelowy oraz wyraźnie określone dozwolone identyfikatory użytkowników Telegramu. Zarówno nadawca, jak i czat muszą się zgadzać. Przekazywane wiadomości i polecenia od innych botów są ignorowane.

/status oraz /stats są dostępne w domyślnym trybie wyświetlania wyłącznie statusów. Opcjonalny tryb kontroli dodaje /pause, /resume oraz /copy. /copy wywołuje skonfigurowane zadanie przechowywania; nie oznacza to, że zdalne przesyłanie zostało już zakończone. Polecenia nie mogą przekazywać dowolnych adresów URL, plików ani programów powłoki.

Należy korzystać z oddzielnych ustawień powiadomień dla alertów i zakończenia zadań. Powiadomienia o zakończeniu rozróżniają eksport konta z brakami od eksportu kompletnego oraz pokazują historię i liczbę zapisów. Fragmenty wiadomości nie są uwzględniane, chyba że zostaną osobno włączone w ustawieniach powiadomień. Selektor usług jest generowany na podstawie faktycznego katalogu zainstalowanych aplikacji Apprise, a nie stałego zestawu przykładowych dostawców.