# Telegram · النشر

Canonical page: https://phishdestroy.io/tgwitness/ar/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/ar/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)

**اللغة الإنجليزية** · [Русский](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) · [الفيتنامية](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. بالنسبة للطرق الأخرى، قم بتنزيل ملف ZIP المصدر واستخراجه أو انسخ المستودع، ثم قم بتشغيل الأمر التالي من دليل المشروع:

| التثبيت | ابدأ | هل يعمل في الخلفية؟ |
| --- | --- | --- |
| حزمة قابلة للتشغيل على نظام ويندوز | `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 — انظر [«النشر عالي الأمان](https://phishdestroy.io/tgwitness/ar/docs/reference/high-assurance/)».

تقوم عملية التشغيل الأصلية بإنشاء `.venv` خاص وتثبيت التبعيات المثبتة. يقوم Docker بإنشائها داخل الصورة، دون الحاجة إلى Python المضيف. يتطلب الإعداد للمرة الأولى اتصالاً بالإنترنت. عند عدم العثور على Python 3.11+، يسأل `Start.cmd` قبل تثبيت Python 3.12 للمستخدم الحالي لنظام Windows (winget، أو برنامج التثبيت الخاص بـ python.org بعد التحقق من توقيع مؤسسة برمجيات Python)؛ ولا يطلب أبدًا صلاحيات المسؤول. تظل خدمات Docker وخدمات نظام التشغيل متطلبات أساسية.

تستخدم التثبيتات الأصلية والقابلة للنقل `data/live` داخل مجلدها. بينما يستخدم Docker وحدة التخزين المسماة `tgwitness-data` في `/data`. وتُعتبر هذه تثبيتات منفصلة إلى أن تقوم عمداً بترحيل دليل البيانات بالكامل. لا تتوقع أن تكتشف حاوية Docker جديدة الحسابات الأصلية تلقائياً.

## متطلبات التثبيت

يتطلب التثبيت الأصلي Python 3.11 أو أحدث مع `venv` و`ensurepip`، ووصولًا إلى الإنترنت لتثبيت التبعية الأولى، ودليل مشروع قابل للكتابة لـ `.venv`. لا تحتاج اللوحة المدمجة إلى Node.js أو بناء واجهة مستخدم. قم بتشغيل المشغل من حساب نظام التشغيل العادي الخاص بك؛ لا يتطلب TgWitness امتيازات المسؤول/الجذر.

- **نظام 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 الإصدار 2.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؛ وهو ليس تقييمًا للسلامة أو التغطية. يقوم برنامج Startup بالتحقق بشكل منفصل من السجلات الموجودة. كما يتجنب `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/ar/docs/reference/security/#external-master-key). يجب أن يحتوي TGWITNESS_TOKEN، في حالة توفيره، على 24 حرفًا على الأقل؛ استخدم قيمة عشوائية مشفرة. وبدونه، يقوم التطبيق بإنشاء رمز عشوائي مكون من 256 بت في ملف panel-token.txt. لا تؤدي عملية تجاوز متغيرات البيئة إلى إعادة كتابة هذا الملف. أعد التشغيل لتبديل بيانات الاعتماد.

يمكن لعملية واحدة فقط أن تمتلك دليل البيانات. يمنع قفل الملفات عبر أنظمة التشغيل الكتابة المتزامنة غير المقصودة. استخدم عامل Uvicorn واحدًا. يمكن للوحة إدارة أي عدد من مساحات العمل، مع وجود أدلة إضافية لمساحات العمل ضمن profiles/<id>/. بالنسبة لمثيلات الخدمة المنفصلة، استخدم أدلة ومنافذ منفصلة. يجب أن تكون ملفات WAL الخاصة بـ SQLite موجودة في وحدة تخزين محلية دائمة، وليس في نظام ملفات شبكي. لا تشارك وحدة تخزين واحدة بين النسخ المتماثلة.

## حزمة قابلة للتشغيل على نظام ويندوز

يحتوي كل إصدار على 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` إليه.

قم بتثبيتها بنفسك على نظام Windows 64 بت باستخدام 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 مسجلة في الالتزام (commit)، وبالتالي يتم رفض أي ملف تم استبداله على PyPI أو على مرآة. يتم بناء الحزم التي تتضمن المصدر فقط (jieba، pyaes) باستخدام أدوات الإعداد (setuptools) المثبتة في ملف deploy/build.lock (خيار `--no-build-isolation`) بواسطة المشغل، وأداة البناء المحمولة لنظام Windows، وملف Dockerfile، لذلك لا يقوم pip بحل بيئة بناء منفصلة غير مثبتة. لا تزال الصورة الأساسية لـ Python وحزم نظام التشغيل تتطلب تأهيلًا مستقلًا للإصدار.

لا تستخدم الأمر docker compose down -v إلا إذا كنت تنوي إتلاف السجل والمفاتيح. تشير تقارير حالة الحاوية إلى توفر خادم الويب، وليس إلى نجاح عملية التقاط رسائل Telegram. افحص حالة المجمع في اللوحة، ونبضه، والأخطاء، وأحداث التغطية.

### ملف تعريفي للشاهد المستقل

تقوم خدمة `witness` الاختيارية بتشغيل [شاهد مستقل](https://phishdestroy.io/tgwitness/ar/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` لاستخدامهما لاحقًا في أوامر الحالة والسجلات والتحديث والإيقاف.

يقوم Caddy بالحصول على شهادة وتجديدها، وإعادة توجيه HTTP إلى HTTPS، وإعادة توجيه الطلبات إلى المجمع على شبكة Compose الخاصة. حالة الشهادة لها وحدة تخزين دائمة خاصة بها. يظل منفذ المضيف المباشر للمجمع مخصصًا للارتداد الداخلي فقط. لا تتيح تهيئة Caddy المُقدمة تسجيل الوصول.

افتح `https://watch.your-domain.org` وأدخل رمز اللوحة. تأكد من الجاهزية تغطي الحاويات؛ ويعتمد إصدار الشهادات وإمكانية الوصول الخارجي على نظام أسماء النطاقات (DNS) وجدار الحماية. إذا لم يكن HTTPS جاهزًا، فافحص نظام أسماء النطاقات وقواعد جدار الحماية، بالإضافة إلى:

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

صورة Caddy المرفقة تتبع علامة `2-alpine` الخاصة بها. يؤدي سحب الصورة إلى تحديثها؛ قم بتثبيت ملخص تم اختباره في بيئتك إذا كنت بحاجة إلى إصدارات ثابتة من البنية التحتية.

## التحديثات والنسخ الاحتياطية

الحفاظ على اسم مشروع Compose وحجم البيانات عبر التحديثات. قم أولاً بإيقاف أداة التجميع (collector) وعمل نسخة احتياطية كاملة. بالنسبة للنشر الافتراضي القائم على المصدر:

```
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 الخاص بتثبيتك لأوامر الإيقاف/النسخ السابقة أيضًا. احتفظ بـ `.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 والتاريخ) في خزينة مساحة العمل ويستعيده عند التشغيل التالي. ثم يطلب العميل التحديثات التي فاتته أثناء توقف العملية، وتقوم إعادة الفحص الدورية باستعادة الرسائل الفائتة وتسجيل الرسائل المحفوظة التي لم يعد Telegram يعرضها. يتم إعادة تحميل الحوارات عند بدء التشغيل. يتم عند كل عملية بدء تشغيل تسجيل رأس السجل السابق، وحدود وضع عدم الاتصال، وموضع التحديث الذي استؤنف منه. يقوم جهاز المراقبة بفحص الاتصال كل 10 ثانية ويضيف نبضة كل دقيقة (**المزيد من الأدوات → المعلمات → تسجيل النشاط كل**). يتم تسجيل حالات انقطاع الاتصال والفترات الصامتة على أنها فجوات في التغطية مع ذكر أسبابها. يتم تخزين لقطات السجل كملاحظات منفصلة للسجل الحالي بجانب السجلات الحية.

يتم تخزين قائمة انتظار الوسائط في قاعدة بيانات SQLite الخاصة بكل مساحة عمل. يتم تثبيت الرسالة ومهمتها بشكل متكامل. يتم استعادة المهام قيد التشغيل التي تمت مقاطعتها لإعادة المحاولة عند البدء. يحتوي كل تنزيل على مهلة أساسية مدتها 120 ثانية بالإضافة إلى الوقت اللازم لنقل حجمه بسرعة 256 كيلو بايت في الثانية، وحد 1–2,000 MiB لكل نوع مرفق؛ يمكن ضبط المهلة والسرعة والمحاولات من خلال **المزيد من الأدوات → المعلمات**. يقوم المجمع بتخطي الملفات التي حجمها غير معروف. تؤدي الإيقاف المؤقت إلى الاحتفاظ بالأعمال الموجودة في قائمة الانتظار. تستخدم إعادة المحاولة وصف الملف الأصلي الذي تمت ملاحظته، ولا تستخدم أبدًا أحدث نسخة من رسالة تم تعديلها لاحقًا. تخضع حالات الفشل المؤقتة لعدد محدود من المحاولات؛ بينما تبقى حالات الإيقاف المؤقت لـ FloodWait للوسائط سارية بعد إعادة التشغيل. يُعد استرداد الوسائط منفصلاً عن استرداد تحديثات Telegram ولا يمكنه إعادة إنشاء الملفات المفقودة.

## النسخ الاحتياطي والاستعادة والسعة

يقوم برنامج `tgwitness backup FOLDER` بنسخ دليل البيانات بينما تظل اللوحة قيد التشغيل: نقاط التحقق أولاً، ثم ملفات SQLite عبر واجهة برمجة تطبيقات النسخ الاحتياطي عبر الإنترنت، ثم المفاتيح والوسائط و ملفات التعريف، بحيث لا تكون أي نقطة تحقق منسوخة أحدث من السجل المنسوخ. يسرد ملف `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، والوسائط، والرمز المميز، ونقاط الفحص، وجميع الملفات الشخصية والدلائل الفرعية. قم باستعادة النسخة الكاملة أثناء توقف الخدمة الوجهة. يؤدي فقدان مفاتيح الخزينة أو عدم تطابق مفتاح التوقيع إلى فشل بدء التشغيل؛ لا تقم بإعادة إنشاء المفاتيح لفرض الوصول.

احتفظ بالنسخ الاحتياطية السرية مشفرة وخاضعة للتحكم في الوصول. ملفات 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/ar/docs/reference/access/) بينما يتم تغطية نقاط الفحص المستقلة في [دليل الشهود](https://phishdestroy.io/tgwitness/ar/docs/reference/witness/).

إجراءات تفصيلية: [الاتصال/الأمان](https://phishdestroy.io/tgwitness/ar/docs/reference/connection/) و [أوضاع التشغيل](https://phishdestroy.io/tgwitness/ar/docs/reference/operations/).
