📂 تثبيت PairDrop — بديل AirDrop لمشاركة الملفات بين جميع الأجهزة على Docker
نشر منصة PairDrop على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر لمشاركة الملفات والنصوص الفورية مباشرة عبر المتصفح (P2P) بين أجهزة آيفون وأندرويد وويندوز وماك ولينكس.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/pairdrop/pairdrop-ubuntu.sh
chmod +x pairdrop-ubuntu.sh
sudo bash pairdrop-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/pairdrop/pairdrop-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x pairdrop-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وإعداد الشبكة وتشغيل حاوية PairDrop على المنفذ 3026 لتقديم واجهة الويب وخادم إشارات WebSockets لربط الأجهزة.
sudo bash pairdrop-ubuntu.sh
4 فتح الموقع وإقران الأجهزة
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:3026 من جهازين أو أكثر على نفس الشبكة. ستكتشف الأجهزة بعضها تلقائياً — انقر على أيقونة الجهاز لبدء إرسال الملفات.
http://<your-server-ip>:3026
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3026 | Web UI + signaling WebSocket (host → container 3000) |
نظرة عامة
تعد PairDrop منصة ويب مفتوحة المصدر وخفيفة جداً لمشاركة الملفات والنصوص المباشرة بين الأجهزة، مستوحاة من خدمة AirDrop في أبل ومنصة Snapdrop. تعمل المنصة على المنفذ 3026 كخادم إشارات WebSockets وواجهة تطبيق ويب تقدمي (PWA). وبمجرد فتح الصفحة على الأجهزة المتصلة بالشبكة المحلية، أو إقرانها عبر رمز مؤقت مكون من 6 أرقام أو رمز QR، يتم نقل الملفات مباشرة من جهاز إلى جهاز (Peer-to-Peer) عبر قنوات WebRTC المشفرة من طرف لطرف دون مرور الملفات بسيرفرك إطلاقاً.
لماذا تستخدمه
تنحصر ميزة AirDrop الرسمية في أجهزة أبل فقط، بينما تتطلب أدوات المشاركة التجارية (مثل واتساب أو Google Drive أو WeTransfer) رفع الملفات على خوادم الشركات الخارجية وضغط جودة الصور وإنشاء حسابات. يحل PairDrop هذه المشكلة بتوفير أداة سريعة تعمل داخل المتصفح عبر كافة الأنظمة (من آيفون إلى ويندوز، ومن أندرويد إلى ماك) بدون تثبيت تطبيقات، وبدون حد لحجم الملفات، وبأقصى سرعة لشبكة الواي فاي المحلية.
متى تحتاجه
- تحتاج إلى نقل الصور والفيديوهات والملفات الضخمة فورياً بين أجهزة مختلفة (مثل من iPhone إلى كمبيوتر Windows أو من Android إلى Mac)
- ترغب في مشاركة الملفات بسرعة عبر شبكة الواي فاي المحلية دون استهلاك باقة الإنترنت أو رفع الملفات للسحابة
- تحتاج إلى وسيلة مشاركة سهلة للضيوف والعملاء تتيح إرسال الملفات بمجرد فتح رابط المتصفح دون تثبيت برامج
- تريد نقل الملفات بين أجهزة بعيدة عبر الإنترنت بأمان عبر ميزة رمز الإقران المؤقت أو رمز الاستجابة السريعة (QR)
- تبحث عن أداة خفيفة جداً تعمل في الخلفية وتستهلك قدراً ضئيلاً جداً من الذاكرة والمعالج بالسيرفر
من يحتاجه
- المصورون وصناع الفيديو ومصممو الجرافيك لنقل الصور الخام ومقاطع 4K بين الكاميرات والهواتف والحواسيب
- المكاتب ومساحات العمل المشتركة لتسهيل تبادل الملفات والمستندات بين الموظفين والعملاء عبر أنظمة متعددة
- العائلات والمستخدمون في المنازل لمشاركة الصور ومقاطع الفيديو بين هواتف iOS وAndroid بسرعة
- مطور البرمجيات ومديرو الأنظمة لنقل ملفات APK وROMs وحزم التثبيت للأجهزة التجريبية
- أصحاب السيرفرات المنزلية لتوفير ميزة AirDrop مستقلة ومحلية لكافة أجهزة المنزل
حالات الاستخدام الشائعة
- إرسال مقاطع فيديو 4K وصور عالية الدقة من هاتف آيفون إلى جهاز كمبيوتر ويندوز في ثوانٍ معدودة
- مشاركة النصوص وروابط المواقع وكلمات المرور بين الحافظة (Clipboard) في الهاتف والكمبيوتر بنقرة واحدة
- إقران جهازين على شبكات مختلفة عبر الإنترنت باستخدام رمز مؤقت مكون من 6 أرقام لنقل الملفات مشفرة
- توزيع ملفات العروض التقديمية وملفات PDF للحاضرين في ورش العمل المتصلين بنفس شبكة الواي فاي
- نقل ملفات ISO وأفلام بحجم عشرات الجيجابايت عبر كابلات الشبكة المحلية بأقصى سرعة لكارت الشبكة (Gigabit)
الميزات الرئيسية
- بدون تثبيت: يعمل مباشرة داخل أي متصفح حديث يدعم WebRTC (سفاري، كروم، فايرفوكس، إيدج)
- نقل مباشر من جهاز لجهاز (Peer-to-Peer) عبر قنوات بيانات WebRTC المشفرة ببروتوكول DTLS
- اكتشاف تلقائي للأجهزة على نفس الشبكة المحلية مع توليد أسماء وأيقونات ملونة ومميزة لكل جهاز
- دعم الإقران الدائم والرموز المؤقتة (6 أرقام) ورموز QR لمشاركة الملفات عبر شبكات مختلفة وعبر الإنترنت
- مشاركة النصوص والحافظة: إرسال الرسائل النصية والروابط فورياً مع زر النسخ السريع
- دعم تطبيقات الويب التقدمية (PWA) لتثبيت الأداة كتطبيق مستقل على الشاشة الرئيسية للهواتف
- استهلاك فائق الخفة للذاكرة لا يتجاوز 50 ميجابايت من الذاكرة العشوائية
- نشر منظم عبر Docker مع دعم تخصيص خوادم STUN/TURN لتجاوز جدران الحماية المعقدة
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3026 من حاسوبك الشخصي
- افتح نفس الرابط على هاتفك الذكي أو حاسوب آخر متصل بنفس شبكة الواي فاي المحلية
- ستلاحظ ظهور الجهازين على الشاشة كأيقونات ملونة بأسماء مستعارة لطيفة
- انقر على أيقونة الجهاز الآخر، واختر ملفاً أو اكتب نصاً، ثم وافق على الاستلام من الجهاز الآخر
- لإقران أجهزة على شبكات مختلفة، انقر على 'Pair Devices' في الأعلى وأدخل الرمز المكون من 6 أرقام أو امسح رمز QR
- ضع PairDrop خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة (حيث تتطلب المتصفحات HTTPS لـ WebRTC)
- ثبت PairDrop كتطبيق على هاتفك بالنقر على 'إضافة إلى الشاشة الرئيسية' في قائمة المتصفح
أفضل ممارسات الأمان
- تنبيه تقني هام: استخدم تشفير HTTPS دائماً عبر وكيل عكسي — حيث تحظر المتصفحات الحديثة (خاصة Safari وiOS) ميزات WebRTC في الاتصالات غير المشفرة
- عمليات نقل الملفات مشفرة بالكامل من طرف لطرف (E2EE) باستخدام تشفير DTLS/SRTP بين المتصفحات مباشرة
- لا يتم حفظ أو تخزين أي ملف على قرص السيرفر إطلاقاً؛ حيث يقتصر دور السيرفر على الربط الأولي فقط (Signaling)
- اضبط خوادم STUN/TURN خاصة بك في متغيرات البيئة إذا كنت ترغب في الربط بين أجهزة خلف جدران حماية معقدة عبر الإنترنت
- يمكنك حماية الوصول لخادم الإشارات بكلمة مرور عبر الوكيل العكسي لقصر الاستخدام على أفراد عائلتك
- حدّث حاوية lscr.io/linuxserver/pairdrop دورياً للحصول على التحديثات وتحسينات الاتصال
المنافذ وإعدادات جدار الحماية
يستمع PairDrop على منفذ TCP 3026 (المحول من 3000 الداخلي) لواجهة الويب وقنوات إشارات WebSockets. يجب السماح بهذا المنفذ في جدار الحماية للشبكة المحلية (ufw allow 3026/tcp). وفي الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 مع تفعيل ترويسات ترقية WebSocket ووجهه لمنفذ 3026.
النسخ الاحتياطي والصيانة
- خادم PairDrop عديم الحالة (Stateless): لا يتم تخزين أي قواعد بيانات أو ملفات منقولة على القرص
- احتفظ بنسخة من ملف docker-compose.yml وإعدادات الوكيل العكسي Nginx
- احفظ أي بيانات اعتماد لخوادم STUN/TURN المخصصة في حال قمت بإضافتها
- اختبر الاستعادة بتشغيل الحاوية من جديد والتأكد من اكتشاف الأجهزة لبعضها بسلاسة
الأخطاء الشائعة
- التشغيل عبر بروتوكول HTTP غير المشفر: حيث تحظر متصفحات الهواتف (خاصة متصفح سفاري في آيفون) تقنية WebRTC في الروابط غير المشفرة
- نسيان تفعيل ترويسات ترقية WebSockets (`Upgrade $http_upgrade`) في إعدادات الوكيل العكسي Nginx
- الاعتقاد بأن السيرفر يخزن الملفات: حيث يعمل PairDrop كجسر لنقل البيانات المباشرة اللحظية فقط وليس كسحابة تخزين دائمة
- محاولة النقل عبر شبكات إنترنت معقدة دون إعداد خادم TURN لتجاوز جدران الحماية الصارمة (Symmetric NAT)
- فتح المنفذ 3026 للإنترنت العام مباشرة دون شهادة SSL، مما يسبب ظهور تحذيرات أمنية في المتصفحات
استكشاف الأخطاء وإصلاحها
- الأجهزة لا تكتشف بعضها على نفس الواي فاي — تأكد من وجود الأجهزة في نفس النطاق الشبكي أو استخدم ميزة رمز الإقران 'Pair Devices'
- فشل النقل أو توقفه عند 0% — تأكد من تشغيل الموقع عبر HTTPS وصحة ترقية قنوات WebSockets في الوكيل العكسي
- رسالة 'WebRTC connection failed' في آيفون — وفر شهادة SSL موثوقة ونطاقاً مشفراً ليعمل محرك سفاري بأمان
- واجهة الويب لا تفتح على 3026 — افحص سجلات الحاوية بالأمر: `docker logs pairdrop -f`
- فشل النقل بين شبكتين مختلفتين — اضبط خادم TURN (مثل Coturn) في متغير `RTC_CONFIG` لتجاوز جدران الحماية
البدائل
منصة Snapdrop هي المنصة الأصلية مفتوحة المصدر التي تم بناء PairDrop كنسخة محسنة منها. تطبيق LocalSend تطبيق أصلي رائع لمشاركة الملفات محلياً بدون خوادم ويب. منصة Filebrowser مدير ملفات ويب فردي ممتاز. أدوات Wormhole وCroc لمشاركة الملفات عبر سطر الأوامر والمتصفح. ميزة Apple AirDrop البروتوكول الخاص بأجهزة أبل.
متى لا تستخدمه
تجنب استخدام PairDrop إذا كنت بحاجة إلى سحابة تخزين دائمة ترفع عليها الملفات وتبقى متاحة للتحميل بروابط ثابتة لأسابيع (استخدم Nextcloud أو OpenCloud أو Filebrowser بدلاً منه). وإذا كنت تبحث عن تطبيق يعمل بين الهواتف مباشرة دون الحاجة لتشغيل أي سيرفر Docker في منزلك، فإن تطبيق LocalSend يعمل ذاتياً عبر الشبكة المحلية.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين PairDrop ومنصة Snapdrop الأصلية؟
منصة PairDrop هي تفرع نشط ومحدث من Snapdrop يضيف ميزات جوهرية: الإقران الدائم للأجهزة، والرموز المؤقتة (6 أرقام) للمشاركة عبر شبكات مختلفة والإنترنت، ودعم تثبيت PWA، وتحسين ثبات اتصالات WebRTC.
هل يقوم PairDrop برفع ملفاتي إلى السيرفر؟
لا! يستخدم PairDrop قنوات WebRTC للنقل المباشر من جهاز لجهاز (P2P). وتنتقل الملفات مباشرة عبر شبكتك المحلية من هاتف لآخر دون أن تلمس القرص الصلب للسيرفر نهائياً.
لماذا يعد تشفير HTTPS ضرورياً لعمل PairDrop؟
تفرض المتصفحات الحديثة (خاصة Safari على iOS وChrome) سياسات أمان صارمة تعطل واجهات WebRTC البرمجية وميزات قراءة الحافظة والتشفير على الاتصالات غير المشفرة بـ SSL.
هل يمكن نقل الملفات بين أجهزة على شبكات واي فاي مختلفة؟
نعم، انقر على زر 'Pair Devices' لتوليد رمز مؤقت مكون من 6 أرقام أو مسح رمز QR. وبمجرد الإقران، يمكنك نقل الملفات بأمان حتى لو كانت الأجهزة على شبكات مختلفة أو عبر الإنترنت.
كم يستهلك PairDrop من الذاكرة العشوائية والمعالج؟
خادم PairDrop خفيف جداً، حيث يستهلك ما بين 20 إلى 45 ميجابايت فقط من الذاكرة العشوائية ونسبة معالج شبه منعدمة، نظراً لأن السيرفر يتولى فقط إشارات الربط الأولية.