إذا كنت تستخدم نظام تشغيل يمنع تثبيت الحزم العادية للمستخدم عبر `pip`،
يمكنك إعادة `pip` إلى سلوكه الطبيعي عن طريق تعديل ملف `~/.config/pip/pip.conf`،
وإضافة التوجيه التالي في قسم `[global]`:```text
[global]
break-system-packages = true

عند بدء تشغيل Reticulum لأول مرة، سيقوم بإنشاء ملف تكوين افتراضي، مما يوفر اتصالاً أساسياً بأقران Reticulum الآخرين الذين قد يكونون قابلين للوصول محلياً. يحتوي ملف التكوين الافتراضي على بضعة أمثلة ومراجع لإنشاء تكوين أكثر تعقيداً.

إذا كان لديك إصدار قديم من `pip` على نظامك، فقد تحتاج إلى ترقيته أولاً باستخدام `pip install pip --upgrade`. إذا لم يكن `pip` مثبتاً لديك بالفعل، فيمكنك تثبيته باستخدام مدير الحزم في نظامك باستخدام `sudo apt install python3-pip` أو ما شابه ذلك.

للحصول على أمثلة أكثر تفصيلاً حول كيفية توسيع نطاق الاتصال عبر العديد من الوسائط مثل الراديو الحزمي أو LoRa، أو المنافذ التسلسلية، أو عبر روابط IP السريعة والإنترنت باستخدام واجهات UDP وTCP، ألق نظرة على قسم [الواجهات المدعومة](https://markqvist.github.io/Reticulum/manual/interfaces.html) من [دليل Reticulum](https://markqvist.github.io/Reticulum/manual/).

## الأدوات المضمنة
يتضمن Reticulum مجموعة من الأدوات المفيدة لإدارة شبكاتك، وعرض الحالة والمعلومات، والمهام الأخرى. يمكنك قراءة المزيد عن هذه البرامج في قسم [برامج الأدوات المضمنة](https://markqvist.github.io/Reticulum/manual/using.html#included-utility-programs) من [دليل Reticulum](https://markqvist.github.io/Reticulum/manual/).

- البرنامج الخفي للنظام `rnsd` لتشغيل Reticulum كخدمة متاحة دائماً
- أداة حالة الواجهة المسماة `rnstatus`، التي تعرض معلومات حول الواجهات
- أداة البحث عن المسار وإدارته `rnpath` التي تتيح لك عرض جداول المسار وتعديلها
- أداة تشخيص مسماة `rnprobe` للتحقق من الاتصال بالوجهات
- برنامج نقل ملفات بسيط مسماً `rncp` يسهل نقل الملفات بين الأنظمة
- أداة إدارة الهوية والتشفير `rnid` تتيح لك إدارة الهويات وتشفير/فك تشفير الملفات
- يتيح لك برنامج `rnsh` إنشاء جلسة شل تفاعلية كاملة مع الأنظمة البعيدة
- برنامج تنفيذ الأوامر عن بعد `rnx` يتيح لك تشغيل أوامر وبرامج بسيطة واسترداد المخرجات من الأنظمة البعيدة
- يوفر برنامج `rngit` عقدة Git كاملة متعددة المستودعات لخدمة المستودعات عبر Reticulum
- يسمح لك المساعد المضمن `git-remote-rns` بالتفاعل مع مستودعات Git عبر Reticulum

جميع الأدوات، بما في ذلك `rnx` و`rncp`، تعمل بشكل موثوق وجيد حتى عبر روابط النطاق الترددي المنخفض جداً مثل LoRa أو الراديو الحزمي. للحصول على شل بعيد كامل الميزات عبر Reticulum، ألق نظرة أيضاً على برنامج [rnsh](https://github.com/acehoss/rnsh).

## أنواع الواجهات والأجهزة المدعومة

ينفذ Reticulum مجموعة من أنواع الواجهات المعممة التي تغطي معظم أجهزة الاتصالات التي يمكن لـ Reticulum العمل عليها. إذا كان جهازك غير مدعوم، فمن [البسيط تنفيذ وحدة واجهة مخصصة](https://markqvist.github.io/Reticulum/manual/interfaces.html#custom-interfaces).

يتم قبول طلبات السحب للواجهات المخصصة بامتنان، شريطة أن تكون مفيدة بشكل عام ومختبرة جيداً في الاستخدام الواقعي.

حالياً، يتم دعم الواجهات المضمنة التالية:

- أي جهاز إيثرنت
- LoRa باستخدام [RNode](https://unsigned.io/rnode/)
- أجهزة TNC للراديو الحزمي (مع أو بدون AX.25)
- أجهزة المودم المتوافقة مع KISS (برمجية ومادية)
- أي جهاز مزود بمنفذ تسلسلي
- TCP عبر شبكات IP
- UDP عبر شبكات IP
- البرامج الخارجية عبر stdio أو الأنابيب
- الأجهزة المخصصة عبر stdio أو الأنابيب

## الأداء
يستهدف Reticulum نطاق أداء قابل للاستخدام *واسع جداً*، لكنه يعطي الأولوية للأداء على الوسائط منخفضة النطاق الترددي. الهدف هو توفير نطاق أداء ديناميكي من 250 بت في الثانية إلى 1 جيجابت في الثانية على الأجهزة العادية.

حالياً، نطاق الأداء القابل للاستخدام هو تقريباً من 150 بت في الثانية إلى 500 ميجابت في الثانية، مع عدم إشباع الوسائط المادية الأسرع من ذلك. الأداء الذي يتجاوز المستوى الحالي مخصص للترقيات المستقبلية، لكنه ليس ذا أولوية عالية في هذه المرحلة الزمنية.

## الحالة الحالية
جميع ميزات البروتوكول الأساسية منفذة وتعمل، لكن الإضافات ربما ستحدث مع استكشاف وفهم الاستخدام الواقعي. يمكن اعتبار API وشكل الأسلاك مستقرين.

## التبعيات
يتطلب تثبيت الحزمة الافتراضية `rns` تبعيتين خارجيتين فقط، مدرجتين أدناه. تحتوي جميع الأنظمة والتوزيعات تقريباً على حزم متاحة بسهولة لهذه التبعيات، وعند تثبيت حزمة `rns` باستخدام `pip`، سيتم تنزيلها وتثبيتها أيضاً.

- [PyCA/cryptography](https://github.com/pyca/cryptography)
- [pyserial](https://github.com/pyserial/pyserial)

على الأنظمة غير المألوفة، وفي بعض الحالات النادرة، قد لا يكون من الممكن تثبيت أو حتى تجميع واحدة أو أكثر من الوحدات المذكورة أعلاه. في مثل هذه الحالات، يمكنك استخدام حزمة `rnspure` بدلاً من ذلك، والتي لا تتطلب أي تبعيات خارجية للتثبيت. يرجى ملاحظة أن محتويات حزمتي `rns` و`rnspure` *متطابقة*. الاختلاف الوحيد هو أن حزمة `rnspure` لا تدرج أي تبعيات مطلوبة للتثبيت.

بغض النظر عن كيفية تثبيت Reticulum وتشغيله، فإنه سيحمل التبعيات الخارجية فقط إذا كانت *مطلوبة* و*متوفرة*. على سبيل المثال، إذا كنت ترغب في استخدام Reticulum على نظام لا يمكنه دعم [pyserial](https://github.com/pyserial/pyserial)، فمن الممكن تماماً القيام بذلك باستخدام حزمة `rnspure`، لكن Reticulum لن يكون قادراً على استخدام الواجهات التسلسلية. سيستمر تحميل جميع الوحدات الأخرى المتاحة عند الحاجة.

**يرجى الملاحظة!** إذا كنت تستخدم حزمة `rnspure` لتشغيل Reticulum على أنظمة لا تدعم [PyCA/cryptography](https://github.com/pyca/cryptography)، فمن المهم أن تقرأ وتفهم قسم [البدائل الأولية للتشفير](#cryptographic-primitives) من هذا المستند.

## بدء الاتصال

Reticulum ليس خدمة تشترك فيها، ولا هو شبكة عالمية واحدة "تنضم" إليها. يوفر Reticulum وظائف لاكتشاف الواجهات العامة المتاحة عبر الشبكة نفسها، وقدم المجتمع الأوسع أدلة متنوعة لنقاط الدخول المتاحة للجمهور لبدء الاتصال.

لمعرفة كيفية إنشاء اتصال أولي عبر Reticulum، اقرأ قسم [بدء الاتصال](https://reticulum.network/manual/gettingstartedfast.html#bootstrapping-connectivity) من الدليل.

إذا كانت لديك فكرة عامة عن كيفية عمل ذلك، فيمكنك استخدام مواقع يديرها المجتمع مثل [directory.rns.recipes](https://directory.rns.recipes/) و [rmap.world](https://rmap.world) للعثور على تعريفات واجهة للاتصال الأولي بالعمود الفقري الموزع عالمياً لـ Reticulum.

## شبكة الاختبار العامة
***هام!** تاريخياً، تم توفير شبكة اختبار موجهة للمطورين من قبل مشروع Reticulum نفسه. نظراً لنمو عدد عقد Reticulum العالمية ونقاط الدخول إلى كمية كبيرة، تم إيقاف تشغيل شبكة الاختبار العامة هذه، بما في ذلك نقطة دخول أمستردام التجريبية. إذا كان لا يزال لديك مثيلات تعتمد على نقطة الدخول هذه للاتصال، فانتقل إلى استخدام العمود الفقري الموزع بدلاً من ذلك. يتضمن Reticulum الآن نظاماً كاملاً لاكتشاف الواجهة على الشبكة وبدء الاتصال. اقرأ قسم [بدء الاتصال](https://reticulum.network/manual/gettingstartedfast.html#bootstrapping-connectivity) من الدليل للحصول على إرشادات.*

## ادعم Reticulum
لجعل هذا ممكناً، أحتاج إلى مساعدتك. يرجى دعم التطوير المستمر لأنظمة الاتصالات المفتوحة والحرة والخاصة عن طريق التبرع عبر إحدى القنوات التالية:

- Monero:  ```
  84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w

Liberapay: https://liberapay.com/Reticulum/

- Ko-Fi: https://ko-fi.com/markqvist

## الأوليات التشفيرية
يستخدم Reticulum مجموعة بسيطة من الأوليات التشفيرية الفعالة والقوية والمختبرة جيدًا، مع تطبيقات متاحة على نطاق واسع يمكن استخدامها على كل من وحدات المعالجة المركزية العامة والمتحكمات الدقيقة.

أحد الاعتبارات الأساسية لاختيار هذه المجموعة المعينة من الأوليات هو أنه يمكن تنفيذها *بأمان* مع عدد قليل نسبيًا من المزالق، على جميع منصات الحوسبة الحالية عمليًا.

الأوليات المدرجة هنا **معتمدة**. أي شيء يدعي أنه Reticulum، لكنه لا يستخدم هذه الأوليات الدقيقة **ليس** Reticulum، ومن المحتمل أن يكون نسخة مضعفة أو مخترقة عمدًا. الأوليات المستخدمة هي:

- مفاتيح هوية Reticulum هي مجموعات مفاتيح Curve25519 بطول 512 بت
- مفتاح Ed25519 بطول 256 بت للتوقيعات
- مفتاح X22519 بطول 256 بت لتبادل المفاتيح ECDH
- HKDF لاشتقاق المفاتيح
- الرموز المشفرة مبنية على [مواصفات Fernet](https://github.com/fernet/spec/)
- مفاتيح مؤقتة مشتقة من تبادل مفاتيح ECDH على Curve25519
- HMAC باستخدام SHA256 لمصادقة الرسائل
- يجب إنشاء IVs من خلال `os.urandom()` أو أفضل
- AES-256 في وضع CBC مع حشو PKCS7
- لا توجد حقول وصفية لنسخة Fernet وطابع زمني
- SHA-256
- SHA-512

في تكوين التثبيت الافتراضي، يتم توفير الأوليات `X25519` و `Ed25519` و `AES-256-CBC` بواسطة [OpenSSL](https://www.openssl.org/)
(عبر حزمة [PyCA/cryptography](https://github.com/pyca/cryptography)).
يتم توفير دوال التجزئة `SHA-256` و `SHA-512` بواسطة مكتبة Python القياسية [hashlib](https://docs.python.org/3/library/hashlib.html). يتم دائمًا توفير الأوليات `HKDF` و `HMAC` و `Token` و دالة الحشو `PKCS7` بواسطة التطبيقات الداخلية التالية:

- [HKDF.py](https://github.com/markqvist/reticulum/blob/HEAD/RNS/Cryptography/HKDF.py)
- [HMAC.py](https://github.com/markqvist/reticulum/blob/HEAD/RNS/Cryptography/HMAC.py)
- [Token.py](https://github.com/markqvist/reticulum/blob/HEAD/RNS/Cryptography/Token.py)
- [PKCS7.py](https://github.com/markqvist/reticulum/blob/HEAD/RNS/Cryptography/PKCS7.py)

يتضمن Reticulum أيضًا تطبيقًا كاملاً لجميع الأوليات الضرورية في Python النقية. إذا لم يكن OpenSSL و PyCA متاحين على النظام عند بدء تشغيل Reticulum، فسيستخدم Reticulum بدلاً من ذلك الأوليات الداخلية النقية في Python. إحدى النتائج الثانوية لذلك هي الأداء، حيث أن الواجهة الخلفية لـ OpenSSL أسرع *بكثير*. أما النتيجة الأكثر أهمية فهي فقدان الأمان المحتمل باستخدام أوليات لم تخضع لنفس القدر من التدقيق والاختبار والمراجعة مثل تلك من OpenSSL.

يرجى ملاحظة أنه افتراضيًا، سيتطلب تثبيت Reticulum **تثبيت** OpenSSL و PyCA تلقائيًا إذا لم يكونا متاحين بالفعل. من الممكن فقط استخدام الأوليات النقية في Python إذا تم تجاوز هذا المطلب على وجه التحديد من قبل المستخدم، على سبيل المثال عن طريق تثبيت حزمة `rnspure` بدلاً من حزمة `rns` العادية، أو عن طريق التشغيل مباشرة من الكود المصدري المحلي.

إذا كنت ترغب في استخدام الأوليات الداخلية النقية في Python، فمن **المستحسن بشدة** أن يكون لديك فهم جيد للمخاطر التي يشكلها ذلك، وأن تتخذ قرارًا مستنيرًا حول ما إذا كانت تلك المخاطر مقبولة بالنسبة لك.

Reticulum هو برنامج جديد نسبيًا، ويجب التعامل معه على هذا النحو. على الرغم من أنه تم بناؤه مع مراعاة أفضل ممارسات التشفير في المقدمة، إلا أنه _لم_ يخضع لتدقيق أمني خارجي، وقد يكون هناك بالتأكيد أخطاء تتعلق بالخصوصية أو الأمان. إذا كنت ترغب في المساعدة، أو المساعدة في رعاية تدقيق، فيرجى التواصل.

## الشكر والتقدير
لا يمكن أن يوجد Reticulum إلا بفضل الجبل الشاسع من العمل مفتوح المصدر الذي بني عليه، ومساهمات جميع المشاركين، وكل من دعم المشروع على مر السنين. لكل من ساعد، شكرًا جزيلاً لكم.

عدد من الوحدات والمشاريع الأخرى هي إما جزء من Reticulum أو تستخدمه. شكر صادق لمؤلفي ومساهمي المشاريع التالية:

- [PyCA/cryptography](https://github.com/pyca/cryptography)، *ترخيص BSD*
- [Pure-25519](https://github.com/warner/python-pure25519) من [Brian Warner](https://github.com/warner)، *ترخيص MIT*
- [Pysha2](https://github.com/thomdixon/pysha2) من [Thom Dixon](https://github.com/thomdixon)، *ترخيص MIT*
- [Python AES-128](https://github.com/orgurar/python-aes) من [Or Gur Arie](https://github.com/orgurar)، *ترخيص MIT*
- [Python AES-256](https://github.com/boppreh/aes) من [BoppreH](https://github.com/boppreh)، *ترخيص MIT*
- [Curve25519.py](https://gist.github.com/nickovs/cc3c22d15f239a2640c185035c06f8a3#file-curve25519-py) من [Nicko van Someren](https://gist.github.com/nickovs)، *الملكية العامة*
- [I2Plib](https://github.com/l-n-s/i2plib) من [Viktor Villainov](https://github.com/l-n-s)
- [PySerial](https://github.com/pyserial/pyserial) من Chris Liechti، *ترخيص BSD*
- [Configobj](https://github.com/DiffSK/configobj) من Michael Foord و Nicola Larosa و Rob Dennis و Eli Courtwright، *ترخيص BSD*
- [ifaddr](https://github.com/pydron/ifaddr) من Stefan C. Mueller، *ترخيص MIT*
- [Umsgpack.py](https://github.com/vsergeev/u-msgpack-python) من [Ivan A. Sergeev](https://github.com/vsergeev)
- [rnsh](https://github.com/acehoss/rnsh) من [Aaron Heise](https://github.com/acehoss)
- [Python](https://www.python.org)