iWant

مشاركة ملفات لامركزية من نظير إلى نظير عبر سطر الأوامر

حالة البناء

ما هي؟

أداة سطر أوامر للبحث عن الملفات وتنزيلها في شبكة محلية، بدون أي خادم مركزي.

الميزات

• لامركزية: لا يوجد خادم مركزي يستضيف الملفات. وبالتالي، لا توجد نقطة فشل مركزية.
• سهولة اكتشاف الملفات: سهلة مثل البحث عن شيء في جوجل.
• تنزيل الملفات من عدة نظراء: إذا فشل الباذر/غادر المجموعة، سيستمر المستفيد في التنزيل من باذر آخر في الشبكة.
• تنزيل المجلدات: يدعم تنزيل المجلدات.
• استئناف التنزيل: استئناف التنزيل من حيث توقفت.
• بيانات متسقة: أي تغييرات (تعديل، حذف، إضافة) تُجرى على الملفات داخل المجلد المشترك ستنعكس فورًا في الشبكة.
• عبر المنصات: يعمل على لينكس/ويندوز/ماك. يحتاج إلى مزيد من الاختبار على ماك.

لماذا بنيت هذا؟

• أحب فكرة كتابة اسم ملف في الطرفية وتنزيله إذا كان لدى الأشخاص من حولي.
• لا حاجة لتسجيل طرف ثالث.
• لا إعدادات معقدة.
• أردته أن يكون عبر المنصات.
• وقت تعطل صفري (Zero Downtime).
• لا متصفح... فقط طرفية.
• للمتعة ¯_(ツ)_/¯

التثبيت

pip install iwant

أو، إذا قمت بالتنزيل من المصدر

python setup.py install --user

التبعيات النظامية

تأكد من تثبيت التبعيات النظامية التالية:

• libffi-dev
• libssl-dev

الاستخدام

iWant.

    أداة سطر أوامر للبحث عن الملفات وتنزيلها في شبكة محلية، بدون أي خادم مركزي.

الاستخدام:
    iwanto start
    iwanto search <name>
    iwanto download <hash>
    iwanto share <path>
    iwanto download to <destination>
    iwanto view config
    iwanto --version

الخيارات:
    -h --help                           إظهار هذه الشاشة.
    --version                           إظهار الإصدار.
    start                               يبدأ تشغيل خادم iwant في نظامك.
    search <name>                       اكتشاف الملفات في الشبكة. مثال: iwanto search batman
    download <hash>                     تنزيل الملف من الشبكة.
    share <path>                        تغيير المجلد المشترك.
    view config                         عرض المجلد المشترك ومجلد التنزيل.
    download to <destination>           تغيير مجلد التنزيل.

ملاحظة: لا يمكن أن يكون المجلد المشترك ومجلد التنزيل متطابقين

كيفية التشغيل

قم بتشغيل iwanto start (يقوم هذا بتشغيل خدمة iwant).

تشغيل العميل

لتشغيل خدمات مثل البحث والتنزيل وعرض التكوين وتغييره، افتح طرفية أخرى وتأكد من تشغيل خادم iwant.

تشغيل الخادم

في ويندوز، يتطلب تشغيل الخادم صلاحيات المسؤول.

iwanto start

البحث عن الملفات

اكتب اسم الملف 😉 (ملاحظة: ليست هناك حاجة لأسماء دقيقة)

iwanto search <filename>

مثال:

iwanto search "slicon valey"

تنزيل الملفات

لتنزيل الملف، فقط أدخل هاش الملف الذي حصلت عليه بعد البحث.

iwanto download <hash of the file>

مثال:

iwanto download b8f67e90097c7501cc0a9f1bb59e6443

تغيير المجلد المشترك

تغيير المجلد المشترك في أي وقت (حتى أثناء تشغيل خدمة iwant).

iwanto share <path>

مثال:

iwanto share /home/User/Movies/

في ويندوز، استخدم علامات الاقتباس:

iwanto share "C:\Users\xyz\books\"

تغيير مجلد التنزيلات

تغيير مجلد التنزيل في أي وقت.

iwanto download to <path>

مثال:

iwanto download to /home/User/Downloads

في ويندوز، استخدم علامات الاقتباس:

iwanto download to "C:\User\Downloads"

عرض المجلد المشترك/التنزيل

iwanto view config

كيف يعمل؟

بمجرد بدء البرنامج، يقوم بتشغيل برنامج الانتخابات الخفي، و__برنامج مراقبة المجلد الخفي__، و__برنامج الخادم الخفي__.

1. برنامج الانتخابات الخفي يتولى الأنشطة التالية:

   • إدارة التوافق (Consensus).
   • إخطار برنامج الخادم الخفي فور حدوث تغيير في القائد.
   • التنسيق مع النظائر الأخرى في الشبكة فيما يتعلق بالانتخابات المتنازع عليها، وعدم توفر القائد، وفشل الشبكة، وحالة الانقسام الدماغي (Split Brain)، إلخ.
   • يستخدم البث المتعدد (Multicast) لاكتشاف النظائر. وصف التوافق مذكور هنا.

2. عندما يبدأ برنامج مراقبة المجلد الخفي، يقوم بالخطوات التالية:

   • فهرسة جميع الملفات في المجلد المشترك.
   • تحديث الإدخالات في قاعدة البيانات.
   • إبلاغ الخادم عن الملفات والمجلدات المفهرسة.
   • أي تغييرات تطرأ على المجلد المشترك ستؤدي إلى قيام برنامج مراقبة المجلد الخفي بفهرسة الملفات المعدلة، وتحديث قاعدة البيانات، ثم إبلاغ الخادم بالتغييرات.

3. عميل iwant يتحدث مع برنامج الخادم الخفي عندما يرغب المستخدم في:

   • البحث عن الملفات.
   • تنزيل الملفات.
   • تغيير المجلد المشترك.
   • تغيير مجلد التنزيل.

4. برنامج الخادم الخفي يتلقى الأوامر من عميل iwant والتحديثات من برنامج مراقبة الملفات وبرنامج الانتخابات الخفي.

   • التحديثات الواردة من برنامج مراقبة المجلد الخفي تُمرر إلى القائد. على سبيل المثال: معلومات الملفات/المجلدات المفهرسة.
   • التحديثات الواردة من برنامج الانتخابات الخفي مثل حدث تغيير القائد تؤدي إلى قيام الخادم بتمرير معلومات الملفات/المجلدات المفهرسة إلى القائد الجديد.
   • الاستعلامات الواردة من عميل iwant مثل بحث عن ملف تُمرر إلى القائد، الذي يقوم بدوره بإجراء بحث ضبابي (fuzzy search) على البيانات الوصفية التي تلقاها من النظائر الأخرى ويعيد قائمة تحتوي على (اسم الملف، الحجم، المجموع الاختباري (checksum)).
   • الاستعلامات الواردة من عميل iwant مثل تنزيل ملف تُمرر إلى القائد، الذي يقوم بإعادة توجيه الجذر (roothash) للملف/المجلد مع قائمة النظائر الذين لديهم الملف. ثم يقوم ببدء عملية التنزيل مع النظائر المذكورة في قائمة النظائر.

المهام القادمة

• دمج آليات أمان محكمة.
• إضافة دعم بايثون 3.
• إضافة معاينة فيديو.
• إضافة وظيفة البث (Streaming).
• إضافة عبور NAT أساسي.
• إنشاء وحدات اختبار.
• تحسين واجهة المستخدم لشريط تقدم تنزيل الملف/المجلد.

لماذا قد لا يعمل؟

• جدار الحماية.
• عدم دعم جهاز التوجيه الخاص بك للبث المتعدد (Multicast).

الأخطاء

جميع السجلات موجودة في ~/.iwant/.iwant.log أو AppData\Roaming\.iwant\.iwant.log

أعجبك المشروع؟

أي أفكار أو أخطاء أو تعديلات مطلوبة، لا تتردد في إرسال طلب سحب (PR) لي :)