# Telegram · ذخیره‌سازی و بازیابی

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

نسخه‌برداری، انتقال فایل‌های قدیمی‌تر به فضای ابری شما، نسخه‌های کپی‌شده تحت Object Lock و بازیابی روی دستگاه جدید.

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

[Documentation index](https://phishdestroy.io/tgwitness/fa/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/fa/docs/reference/deployment/)

![راه‌اندازی و بازیابی](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

پنل سه وظیفه را جدا می‌کند:

| وظیفه | کارکرد آن |
| --- | --- |
| یک نسخه پشتیبان تهیه کنید | ژورنال امضا شده، نقاط کنترل، فایل‌های نگهداری‌شده و خروجی‌های صف‌شده را به مقصد S3 پیکربندی‌شده کپی کنید. |
| فضای محلی رایگان | پیوست‌های قدیمی‌تر انتخاب‌شده را به S3 یا یک درایو ابری rclone کپی کنید، آن‌ها را به‌طور کامل دوباره بخوانید، بایت‌های رمزگذاری‌شده را تأیید کنید، سپس نسخه محلی تأییدشده را حذف کنید. |
| یک نسخهٔ مدرکی را نگه دارید | قفل شیء S3 را پیکربندی کنید و وضعیت نگهداری بازگردانده‌شده را بررسی کنید. سرویس باید حالت و تاریخ درخواستی را تأیید کند. |

آزادسازی فضا هرگز دفترچه یادداشت امضا شده را حذف یا بازنویسی نمی‌کند. هر پیوست، شناسه اصلی SHA-256 و یک رسید بازیابی را حفظ می‌کند. فشرده‌سازی اختیاری gzip قبل از رمزگذاری احراز هویت‌شده انجام می‌شود. نام فایل‌های ابری حاوی نام‌های تلگرام، شناسه چت یا نام‌های اصلی پیوست‌ها نیست. یک پیوست می‌تواند تا ۳۲ گیگابایت باشد.

پاسخ بارگذاری به تنهایی مجوز حذف یک فایل را نمی‌دهد. TgWitness شیء رمزگذاری‌شده کامل را دانلود کرده و اندازه و SHA-256 آن را تأیید می‌کند، رسید را ذخیره می‌کند، سپس بلافاصله قبل از حذف، بایت‌های محلی را دوباره بررسی می‌کند. یک خطای بارگذاری، بازخوانی متفاوت یا لغو انتقال، فایل محلی را سر جای خود باقی می‌گذارد. اگر یک نسخه پشتیبان مدرک فعال هنوز آن فایل را کپی نکرده باشد، حذف آن نیز منتظر می‌ماند.

**در این صفحه**

- [وقتی دیسک در حال پر شدن است](https://phishdestroy.io/tgwitness/fa/docs/reference/storage/#when-the-disk-is-filling-up)
- [اتصال به مقصد](https://phishdestroy.io/tgwitness/fa/docs/reference/storage/#connect-a-destination)
- [فایل بازیابی را حفظ کنید](https://phishdestroy.io/tgwitness/fa/docs/reference/storage/#keep-the-recovery-file)
- [بازیابی پس از از دست دادن نصب](https://phishdestroy.io/tgwitness/fa/docs/reference/storage/#recover-after-losing-the-installation)
- [ربات اپراتور و اعلان‌های تکمیل](https://phishdestroy.io/tgwitness/fa/docs/reference/storage/#operator-bot-and-completion-notices)

## وقتی فضای دیسک رو به اتمام است

دانلود پیوست‌ها در زیر از قبل متوقف می‌شوند **ابزارهای بیشتر → پارامترها → عکس‌ها و فایل‌ها → متوقف کردن دانلودها در زیر این فضای خالی دیسک** (1 GiB به طور پیش‌فرض)، و صف آن‌ها را حفظ می‌کند. مشاهده‌های متنی ادامه می‌یابند. این موضوع به تنظیمات اعلان‌ها بستگی ندارد. غیرفعال کردن اعلان‌ها، ذخیره‌سازی دانلود یا محافظ‌های ذخیره‌سازی را غیرفعال نمی‌کند.

برای اقدام زودتر، **اجرای خودکار** را فعال کنید، **حذف فایل محلی برای آزاد کردن فضا** را انتخاب کنید و **انتقال اضافی هنگام کمبود فضای دیسک** را فعال کنید. این قاعدهٔ اختیاری به‌طور پیش‌فرض زیر 5120 MiB فضای آزاد شروع می‌شود و دسته‌دسته ادامه می‌یابد تا 10240 MiB آزاد شود. هر دو آستانه قابل تنظیم‌اند. مقصد، حداقل سن فایل، حد دسته، بررسی با بازخوانی کامل و پیش‌نیازهای پشتیبان‌گیری شواهد همان اجرای دستی‌اند. مقصدی را خودبه‌خود فعال نمی‌کند. بررسی هر 30 ثانیه انجام می‌شود؛ خطا یا نبود پیشرفت، تلاش بعدی را پنج دقیقه عقب می‌اندازد. وضعیت و زمان تلاش مجدد پس از راه‌اندازی دوباره باقی می‌مانند. وقتی قاعده غیرفعال است، اجراهای زمان‌بندی‌شده فاصلهٔ عادی را حفظ می‌کنند.

پنل فضای آزاد، ذخیرهٔ بسته‌بندی، آماده‌بودن قاعده و فایل‌های ردشده به علت کمبود فضای موقت را نشان می‌دهد. بسته‌بندی و بازیابی پیش از شروع، حداکثر نیاز به فضای موقت و هنگام نوشتن، فضای موجود را بررسی می‌کنند. ذخیرهٔ تنظیم‌شده برای دریافت استفاده می‌شود، با حداقل 64 MiB برای عملیات ذخیره‌سازی. این بررسی‌ها سهمیهٔ سیستم فایل نیستند؛ فرایند دیگری می‌تواند بین بررسی‌ها فضا مصرف کند.

Gzip اشیای راه‌دور را بدون اتلاف داده فشرده می‌کند؛ دفتر ثبت فعال را کوچک نمی‌کند و بایگانی محلی نمی‌سازد. JPEG، ویدیو و ZIP ممکن است بسیار کم کوچک شوند یا کمی بزرگ‌تر شوند. با فعال بودن فشرده‌سازی، بسته‌بندی ممکن است موقتاً حدود دو برابر اندازهٔ پیوست به‌علاوهٔ فضای ذخیره نیاز داشته باشد. آستانهٔ شروع را برای بزرگ‌ترین فایل‌ها به‌اندازهٔ کافی زود تعیین کنید. فایل بیش‌ازحد بزرگ حفظ و گزارش می‌شود؛ فایل‌های کوچک‌تر و نسخه‌های راه‌دورِ ازپیش‌بررسی‌شده همچنان می‌توانند فضا آزاد کنند. با نسخهٔ بررسی‌شده می‌توان فایل محلی را بدون ساخت فایل بسته‌بندی دیگری حذف کرد. بازیابی نیز فضای موقت می‌خواهد و ممکن است تا فراهم‌شدن آن رد شود.

اگر فایل مناسبی برای انتقال نباشد یا مقصدی تنظیم نشده باشد، TgWitness نمی‌تواند خودکار فضا آزاد کند. مدیریت ذخیره‌سازی هرگز دفتر ثبت امضاشده را کوتاه یا بازنویسی نمی‌کند. برای مشاهدات متنی جدید همچنان فضا لازم است.

فضاهای کاری روی یک سرور، پیوست‌های یکسانی را به اشتراک می‌گذارند. یک فایل ذخیره شده با SHA-256 نام‌گذاری می‌شود؛ زمانی که فضای کاری دیگری از همان سرور قبلاً همان فایل را در `cas/` از دایرکتوری داده، پس از هش شدن مجدد هر دو فایل، نسخه جدید با یک لینک سخت به آن جایگزین می‌شود، بنابراین سه فضای کاری که یک کانال را ذخیره می‌کنند از فضای دیسک یک نسخه استفاده می‌کنند. هر فضای کاری همچنان فایل مخصوص به خود را در زیر `media/` و آن را مانند قبل می‌خواند، صادر می‌کند و تخلیه می‌کند. فایلی که نمی‌توان به آن لینک داد، برای مثال در یک سیستم فایل بدون لینک‌های سخت، به صورت یک کپی جداگانه باقی می‌ماند. در هر بار راه‌اندازی TgWitness از `cas/` فقط فایل‌هایی که هیچ فضای کاری دیگر به آنها لینک ندارد، حذف می‌شوند؛ یک فایل فضای کاری هرگز در این مرحله حذف نمی‌شود.

## یک مقصد را متصل کنید

در **ابزارهای بیشتر → افزونه ها → ذخیره‌سازی و فضای دیسک → مدیریت ذخیره‌سازی**، وظیفه و مقصد را انتخاب کرده، آن را ذخیره کنید، سپس **آزمایش بارگذاری و دانلود** را انتخاب کنید. این آزمایش یک پروب تصادفی کوچک را بارگذاری کرده و آن را دوباره می‌خواند. این آزمایش از محتوای تلگرام استفاده نمی‌کند.

برای S3، از endpoint، region و bucket واقعی ارائه‌دهنده استفاده کنید. Wasabi، Backblaze، Cloudflare R2 و سایر خدمات سازگار از همان تنظیمات S3 استفاده می‌کنند. سازگاری API به تنهایی به معنای پشتیبانی از Object Lock نیست. حالت Governance ممکن است به یک مدیر مجاز اجازه دهد تا از نگهداری (retention) عبور کند؛ حالت Compliance محدودیت‌های متفاوتی دارد. قبل از اتکا به نگهداری، وضعیت بازگردانده‌شده Object Lock را بخوانید.

برای یک مقصد rclone، یک ریموت با استفاده از تنظیمات ارائه‌دهنده rclone ایجاد کنید و ریموت مذکور را جای‌گذاری کنید `[name]` بخش را در پنل قرار دهید. ابزار کمکی نصب‌شده از MEGA، Google Drive، OneDrive، Dropbox، Box، pCloud و سایر ارائه‌دهندگانی که در انتخابگر نمایش داده شده‌اند، پشتیبانی می‌کند. اعتبارنامه‌ها در گاوصندوق رمزگذاری‌شده این فضای کاری ذخیره می‌شوند. به‌روزرسانی‌های OAuth نیز دوباره در گاوصندوق ذخیره می‌شوند. اعتبارنامه‌ها به رویدادهای گزارش (journal) اضافه نمی‌شوند و در دانلودهای بازیابی گنجانده نمی‌شوند.

این ابزار کمکی در داخل فضای کاری نصب می‌شود، با یک نسخه سنجاق‌شده و یک پوشهٔ «SHA-256». این فایل به مسیر (PATH) سیستم اضافه نمی‌شود. فایل‌های پیکربندی و فایل‌های کاری، فایل‌های موقتی در همان فضای کاری هستند. اتصالات از راه دور مبتنی بر فرمان و فایل‌های محلی رد می‌شوند. rclone در حال حاضر برای درخواست‌های خارجی به یک مسیر **«مستقیم» (Direct)** که صراحتاً انتخاب شده باشد نیاز دارد. برای یک مسیر SOCKS5 یا HTTP در فضای کاری، از ذخیره‌سازی بومی S3 استفاده کنید؛ rclone یک مسیر غیرفعال را بی‌صدا دور نمی‌زند.

## فایل بازیابی را نگه دارید

گزینه **«ذخیره فایل بازیابی** پس از کپی کردن فایل‌ها» را انتخاب کرده و آن را در مکانی جدا از محل نصب نگهداری کنید. این فایل حاوی کلید رمزگشایی و رسیدهای اشیاء امضا شده است، بنابراین آن را به عنوان پشتیبان کلید خصوصی در نظر بگیرید. پیکربندی راه دور اصلی و اعتبارنامه‌های مقصد را نیز به طور جداگانه نگهداری کنید. فایلی که برای بازیابی قبل از کپی بعدی گرفته می‌شود، حاوی رسید آن فایل بعدی نخواهد بود.

اثر انگشت کلید امضا را به طور مستقل ثبت کنید: بررسی امضا در برابر آن اثر انگشت، مشخص می‌کند که فایل بازیابی متعلق به چه کسی است.

برای تعمیر رسیدهای ذخیره‌سازی گم‌شده در یک فضای کاری موجود، **گزینه «بازیابی فایل‌ها» را از یک فایل بازیابی ذخیره‌شده** باز کرده و آن فایل را انتخاب کنید. این پنل امضا را بررسی می‌کند و به کلید امضای همان فضای کاری نیاز دارد. این گزینه از جایگزینی یک کلید ذخیره‌سازی متفاوت خودداری می‌کند. سپس **«بازیابی همه فایل‌ها» را** انتخاب کنید. بازیابی، قانون ذخیره‌سازی خودکار را متوقف می‌کند تا نوبت برنامه‌ریزی‌شده بعدی نتواند فوراً فایل‌های بازیابی‌شده را دوباره حذف کند. پس از اتمام کار با نسخه‌های محلی، قانون را مجدداً فعال کنید.

فرآیند بازیابی، متن رمز را تأیید می‌کند، رمزگشایی را احراز هویت می‌نماید، در صورت لزوم فشرده‌سازی را برعکس می‌کند و پیش از قرار دادن فایل در پوشه `media/`، هش SHA-256 متن ساده اصلی را بررسی می‌کند. یک شیء از راه دور خراب هرگز یک فایل محلی را جایگزین نمی‌کند. وارد کردن یک فایل بازیابی، یک فایل محلی را تنها زمانی موجود می‌شمارد که اندازه و SHA-256 آن با رسید مطابقت داشته باشد، بنابراین **گزینه بازیابی تمام فایل‌ها (Restore all files)** نیز یک فایل محلی را که بایت‌های آن متفاوت است، بازیابی می‌کند. آن بایت‌ها بازنویسی نمی‌شوند: به محض اینکه کپی تأییدشده آماده شود، آن‌ها بدون تغییر به `storage-conflicts/EXPECTED_SHA256.LOCAL_SHA256` منتقل می‌شوند، ژورنال `storage.local_conflict` را ثبت می‌کند و نتیجه بازیابی، هر تعارض را فهرست می‌کند. پنل ذخیره‌سازی نشان می‌دهد که پوشه `storage-conflicts/` حاوی چند فایل است و ۲۰ فایل اول را به همراه اندازه آن‌ها فهرست می‌کند؛ دستور `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` یک رکورد بدون امضا از عملیات بازیابی است. این فرمان یک ژورنال امضا شده از دست رفته یا کلید امضای آن را بازسازی نمی‌کند. برای این موارد یک نسخه پشتیبان کامل از فضای کاری را نگه دارید. یک فایل بازیابی ذخیره‌سازی، یک نسخه پشتیبان کامل از فضای کاری نیست.

## ربات اپراتور و اعلان‌های تکمیل

ربات تلگرام متعلق به اپراتور است. آن را از طریق BotFather ایجاد کنید و توکن، چت مقصد و شناسه کاربران تلگرام مجاز صریح را در پنل تنظیم کنید. هم فرستنده و هم چت باید مطابقت داشته باشند. پیام‌ها و دستورات فوروارد شده از ربات‌های دیگر نادیده گرفته می‌شوند.

`/status` و `/stats` در حالت پیش‌فرض فقط وضعیت در دسترس هستند. حالت کنترل اختیاری اضافه می‌کند `/pause`, `/resume` و `/copy`. `/copy` درخواست وظیفه ذخیره‌سازی پیکربندی‌شده را می‌کند؛ این بدان معنا نیست که بارگذاری از راه دور قبلاً به پایان رسیده است. دستورات نمی‌توانند URLها، فایل‌ها یا برنامه‌های شل دلخواه را فراهم کنند.

از تنظیمات اعلان جداگانه برای هشدارها و اعلان‌های اتمام کار استفاده کنید. اعلان‌های اتمام کار، یک خروجی‌گیری حساب با فاصله‌ها را از یک خروجی‌گیری کامل متمایز می‌کنند و شمارش‌های تاریخچه و ذخیره‌سازی را نشان می‌دهند. گزیده‌های پیام، مگر اینکه به طور جداگانه در تنظیمات اعلان فعال شده باشند، گنجانده نمی‌شوند. انتخابگر سرویس از کاتالوگ واقعی نصب‌شده Apprise و نه از یک مجموعه ثابت از نمونه‌های ارائه‌دهنده، تولید می‌شود.
