📁 تثبيت copyparty — سيرفر ملفات بملف تنفيذي واحد يفعل كل شيء
انشر copyparty على Ubuntu بـ Docker — سيرفر ملفات بقدرات مذهلة من ملف تنفيذي واحد، مع رفع سريع وWebDAV وبث وسائط وصور مصغّرة، على المنفذ 3923.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/copyparty/copyparty-ubuntu.sh
chmod +x copyparty-ubuntu.sh
sudo bash copyparty-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/files/copyparty/copyparty-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x copyparty-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم ويشغّل copyparty على المنفذ 3923، مقدّماً حجم ./data مع حساب مسؤول تُطبع كلمة مروره المولَّدة بنهاية الإعداد.
sudo bash copyparty-ubuntu.sh
4 فتح واجهة الويب وتسجيل الدخول
افتح copyparty في متصفحك وسجّل الدخول كمسؤول بكلمة المرور المولّدة للبدء برفع الملفات ومشاركتها:
http://<your-server-ip>:3923
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3923 | Web UI + WebDAV + FTP — login admin / generated password |
| ./data | The folder copyparty serves (mounted at /w) |
| features | Resumable uploads, media streaming, thumbnails, per-folder permissions |
نظرة عامة
copyparty سيرفر ملفات بقدرات مذهلة معبأ في ملف تنفيذي واحد مستقل (أو سكريبت Python واحد) — دون تثبيت، ودون قاعدة بيانات، ودون أي اعتماديات لتشغيله. من تحميل واحد صغير تحصل على واجهة ويب سريعة للرفع والتنزيل، ونقل قابل للاستئناف ومُسرَّع يتعامل مع الملفات الضخمة عبر اتصالات غير مستقرة، ووصول WebDAV وFTP لتوصيله كقرص شبكة، ومشغل وسائط مدمج مع صور مصغّرة لتصفح الصور والفيديوهات، وبحث كامل في الملفات وبياناتها الوصفية، ونظام صلاحيات دقيق لكل مستخدم ولكل مجلد. يعمل بسلاسة على أي شيء من Raspberry Pi إلى سيرفر كامل ولا يحتاج تقريباً أي إعداد للبدء بمشاركة مجلد.
لماذا تستخدمه
معظم سيرفرات الملفات تفرض مفاضلة: الأدوات البسيطة مثل سيرفر HTTP بسيط بـ Python لا توفر أي موثوقية للرفع الكبير، بينما المنصات الكاملة مثل Nextcloud تحتاج قاعدة بيانات وبيئة تشغيل PHP وصيانة حقيقية. يقع copyparty في المنتصف — ملف تنفيذي واحد يبدأ خلال ثوانٍ ومع ذلك يوفر رفعاً قابلاً للاستئناف لملفات متعددة الجيجابايت، ووصول WebDAV/FTP، وبث وسائط، وصلاحيات لكل مستخدم. لأي شخص يحتاج طريقة موثوقة لنقل ملفات كبيرة من وإلى سيرفر، أو نقطة استلام مؤقتة لعميل أو فريق، دون تجهيز حزمة تطبيقات كاملة، يوصلك copyparty لهذا الهدف بتحميل واحد وأمر واحد.
متى تحتاجه
- تحتاج رفع أو استقبال ملفات كبيرة جداً (تصوير فيديو، نسخ احتياطية، صور أقراص) عبر اتصال غير مستقر حيث يجب أن يُستأنف النقل بدلاً من إعادة البدء
- تريد طريقة سريعة وبلا تثبيت لمشاركة مجلد عبر الشبكة دون إعداد منصة تعتمد على قاعدة بيانات
- تحتاج وصول WebDAV أو FTP لمجلد ليُوصَل كقرص شبكة على Windows أو macOS أو Linux
- تريد متصفح وسائط خفيفاً مع صور مصغّرة ومشغل مدمج للصور أو الموسيقى أو الفيديو دون نشر سيرفر وسائط كامل
- تحتاج صلاحيات لكل مستخدم ولكل مجلد لمنح متعاونين مختلفين مستويات وصول مختلفة على نفس السيرفر
- تشغّل عتاداً محدود القدرة (Raspberry Pi، لابتوب قديم، VPS صغير) وتحتاج سيرفر ملفات لا يحتاج قاعدة بيانات أو بيئة تشغيل ثقيلة
- تحتاج نقطة استلام مؤقتة محمية بكلمة مرور ليرفع العملاء ملفات كبيرة دون إنشاء حسابات على منصة أكبر
من يحتاجه
- المصورون الفوتوغرافيون ومصورو الفيديو الذين يحتاجون رفع عملاء لملفات raw ضخمة بموثوقية، مع استئناف عند انقطاع الرفع
- مسؤولو الأنظمة الذين يريدون طريقة بلا اعتماديات لنقل ISO والنسخ الاحتياطية وصور الأقراص بين الأجهزة على الشبكة المحلية
- مشغّلو المختبرات المنزلية الذين يريدون WebDAV وFTP وواجهة ويب لمجلد مشترك واحد دون نشر Nextcloud أو Seafile
- الفرق الصغيرة التي تحتاج مجلد استلام مؤقت محكوم بالصلاحيات لمشروع دون تجهيز بنية تحتية حقيقية
- مستخدمو العتاد المحدود أو المدمج (Raspberry Pi، NAS، لابتوبات قديمة) الذين يحتاجون سيرفر ملفات بأقل استهلاك للموارد
- المطورون الذين يريدون كشف مجلد نتائج بناء أو مجموعة بيانات سريعاً عبر HTTP وWebDAV أثناء الاختبار
- أي شخص يريد بديلاً ذاتي الاستضافة عن روابط WeTransfer أو Google Drive لإرسال ملفات كبيرة جداً لشخص آخر
حالات الاستخدام الشائعة
- استقبال رفعات فيديو أو نسخ احتياطية متعددة الجيجابايت من العملاء عبر اتصالات غير مستقرة مع استئناف تلقائي
- توصيل مجلد مشترك كقرص شبكة عبر WebDAV على لابتوب، أو كقرص FTP على برمجيات قديمة
- تصفح مجموعة صور أو موسيقى عبر معرض الصور المصغّرة المدمج ومشغل الصوت والفيديو
- البحث في أرشيف ملفات كبير حسب اسم الملف أو الحجم أو التاريخ أو وسوم البيانات الوصفية المضمّنة
- إعداد مجلد رفع فقط محمي بكلمة مرور ليرفع العملاء ملفات كبيرة دون منحهم وصولاً كاملاً للسيرفر
- تقديم صور البرامج الثابتة أو ملفات ISO أو حزم البرامج لأجهزة أخرى على الشبكة المحلية
- إزالة التكرار من التخزين تلقائياً عبر الهاش عند رفع نفس الملف من مواقع متعددة
الميزات الرئيسية
- يأتي كملف تنفيذي واحد مستقل أو سكريبت Python — دون تثبيت، ودون قاعدة بيانات، وباعتماديات أدنى
- رفع وتنزيل قابل للاستئناف ومُسرَّع يكمل من حيث توقف بعد انقطاع الاتصال، حتى لملفات متعددة الجيجابايت
- وصول WebDAV وFTP(S) وSFTP وTFTP جنباً إلى جنب مع واجهة الويب، فنفس المجلد يمكن توصيله كقرص شبكة
- مشغل وسائط مدمج مع دعم قوائم التشغيل والموازن الصوتي، مع توليد تلقائي للصور المصغّرة للصور والفيديو
- بحث في الملفات حسب الاسم والحجم والتاريخ والمسار ووسوم البيانات الوصفية الصوتية عبر الشجرة كاملة
- إزالة التكرار حسب المحتوى باستخدام هاش الملفات لتجنب تخزين نفس الملف مرتين
- نظام صلاحيات دقيق للقراءة/الكتابة/الحذف لكل مستخدم ولكل مجلد مع دعم روابط مشاركة مؤقتة
- تنزيل أرشيفات zip وtar لمجلدات أو تحديدات متعددة الملفات تُولَّد فورياً عند الطلب
كيفية الاستخدام بعد التثبيت
- سجّل الدخول لواجهة الويب على http://your-server-ip:3923 بحساب المسؤول وكلمة المرور المولّدة تلقائياً من الإعداد
- غيّر كلمة مرور المسؤول المولّدة فوراً، وأنشئ حسابات مستخدمين إضافية بصلاحيات محددة إذا لزم الأمر
- تأكد أن مجلد ./data مربوط بالحجم الذي تريد مشاركته فعلياً، وأضف أي أحجام إضافية في الإعداد
- اختبر رفع ملف كبير للتأكد من أن سلوك النقل القابل للاستئناف يعمل كما هو متوقع على شبكتك
- اتصل عبر WebDAV من مدير الملفات في نظام تشغيلك (Windows Explorer أو macOS Finder أو مدير ملفات Linux) للتأكد من عمل الوصول كقرص بعيد
- اضبط صلاحيات لكل مجلد إذا احتاج عدة مستخدمين أو عملاء مستويات وصول مختلفة لأحجام مختلفة
- فعّل مشغل الوسائط وفهرسة الصور المصغّرة إذا كنت تخطط لاستخدام copyparty لتصفح الصور أو الموسيقى أو الفيديو
- أعدّ وكيلاً عكسياً مع HTTPS أمام المنفذ 3923 إذا كان السيرفر سيكون متاحاً من خارج شبكتك المحلية
أفضل ممارسات الأمان
- غيّر كلمة مرور المسؤول المولّدة تلقائياً فور تسجيل الدخول الأول وتجنّب إعادة استخدامها في مكان آخر
- لا تكشف المنفذ 3923 مباشرة للإنترنت دون HTTPS — ضع copyparty خلف وكيل عكسي مثل Nginx Proxy Manager
- أنشئ حسابات مستخدمين منفصلة ومحددة الصلاحيات لكل متعاون بدلاً من مشاركة حساب المسؤول
- قيّد صلاحيات الكتابة والحذف على الحد الأدنى المطلوب لكل مجلد — امنح وصول قراءة فقط للتنزيل البحت
- استخدم روابط مشاركة محدودة الوقت أو محمية بكلمة مرور بدلاً من منح وصول حساب كامل لرفعات خارجية لمرة واحدة
- حافظ على تحديث ملف copyparty التنفيذي أو صورة Docker لالتقاط الإصلاحات الأمنية مع تطور المشروع السريع
- راجع قائمة الحسابات والصلاحيات دورياً وأزل وصول المتعاونين الذين لم يعودوا بحاجته
المنافذ وإعدادات جدار الحماية
يستمع copyparty على منفذ TCP واحد، هو 3923 افتراضياً، والذي يقدّم واجهة الويب وWebDAV والوصول بأسلوب FTP معاً. يجب ألا يُكشف هذا المنفذ مباشرة للإنترنت العام دون HTTPS، لأن الإعداد الافتراضي ينقل بيانات الاعتماد عبر HTTP عادي. ضع copyparty خلف وكيل عكسي مثل Nginx Proxy Manager على المنفذ 443 مع شهادة SSL صالحة، وقيّد الوصول المباشر للمنفذ 3923 في جدار الحماية بحيث يكون متاحاً فقط من الوكيل العكسي أو شبكتك المحلية. إذا فعّلت بروتوكولات إضافية مثل SFTP أو TFTP، يجب فتح وتأمين منافذها الخاصة بشكل منفصل.
النسخ الاحتياطي والصيانة
- انسخ مجلد ./data (أو أي دليل ربطته كحجم مقدَّم) احتياطياً لأنه يحتوي كل الملفات المرفوعة
- انسخ ملف إعداد copyparty احتياطياً إذا استخدمت واحداً، لأنه يحدد الحسابات والأحجام والصلاحيات
- خزّن كلمة مرور المسؤول وأي بيانات اعتماد مستخدمين في مدير كلمات مرور — لا يمكن استرجاعها من السيرفر إذا فُقدت
- احتفظ بالنسخ الاحتياطية على تخزين منفصل عن قرص السيرفر حتى لا يؤدي عطل عتاد لفقدان البيانات ونسختها الاحتياطية معاً
- اختبر استعادة نسخة من مجلد البيانات دورياً للتأكد من بقاء الملفات سليمة وقابلة للقراءة
- وثّق أي أحجام مرتبطة بأي أدلة حتى يمكن إعادة إنشاء نفس البنية بسرعة بعد أي ترحيل
الأخطاء الشائعة
- كشف المنفذ 3923 مباشرة للإنترنت دون وكيل عكسي أو HTTPS، مما يرسل بيانات الاعتماد بنص عادي
- عدم تغيير كلمة مرور المسؤول المولّدة تلقائياً بعد تسجيل الدخول الأول أبداً
- مشاركة حساب المسؤول الوحيد بين عدة أشخاص بدلاً من إنشاء حسابات منفصلة ومحددة الصلاحيات
- ربط الدليل الخاطئ كحجم مقدَّم وكشف جزء أكبر من نظام الملفات عن غير قصد
- نسيان أن الوضع المجهول الافتراضي في copyparty يمنح الجميع صلاحية قراءة/كتابة إذا لم تُضبط حسابات
- عدم ضبط صلاحيات لكل مجلد، مما يمنح كل مستخدم صلاحية كتابة وحذف كاملة على كل حجم مشترك
- تجاهل التحديثات المتاحة — يصدر copyparty إصدارات متكررة بإصلاحات أخطاء وتحسينات أمنية
استكشاف الأخطاء وإصلاحها
- تعذّر تسجيل الدخول — تأكد من استخدام كلمة المرور المولّدة تلقائياً المطبوعة بنهاية مخرجات سكريبت التثبيت بالضبط، وليس كلمة مخمَّنة
- فشل أو توقف الرفع على الملفات الكبيرة — تحقق من مساحة القرص المتاحة على السيرفر وتأكد أن متصفح العميل يدعم تقسيم الرفع القابل للاستئناف
- فشل توصيل WebDAV من Windows أو macOS — تأكد أن الرابط يتضمن المنفذ الصحيح وأن العميل يدعم WebDAV عبر HTTP عادي إذا لم تستخدم وكيلاً عكسياً
- الصور المصغّرة للوسائط لا تُولَّد — تحقق أن السيرفر يملك CPU/RAM كافية للتوليد الفوري للصور المصغّرة وراجع السجلات بحثاً عن أخطاء ترميز
- الملفات مفقودة بعد إعادة تشغيل الحاوية — تأكد أن مجلد ./data هو bind mount أو حجم مسمّى فعلي وليس تخزيناً مؤقتاً للحاوية
- أداء بطيء مع المجلدات الكبيرة — فعّل أو أعد بناء فهرس الملفات وتجنّب تقديم مجلدات بعدد ملفات مرتفع جداً من حجم واحد
- لا يمكن الاتصال عن بُعد — تحقق أن الوكيل العكسي يحوّل إلى المنفذ 3923 بشكل صحيح وأن جدار الحماية يسمح بمرور حركة الوكيل
البدائل
Filebrowser مدير ملفات ويب أبسط وأكثر أناقة يركّز على تصفح نظيف لقرص السيرفر المحلي، لكنه يفتقر للرفع القابل للاستئناف للملفات الكبيرة وWebDAV/FTP وبث الوسائط جاهزة. Nextcloud وSeafile منصتا تخزين سحابي ذاتي الاستضافة كاملتان مع عملاء مزامنة وميزات تعاون، لكنهما تحتاجان قاعدة بيانات وموارد أكبر وصيانة مستمرة حقيقية. Syncthing يركّز على المزامنة المستمرة للملفات بين الأجهزة بدلاً من التصفح والمشاركة المستضافة على سيرفر. للنقل البحت للملفات الكبيرة دون أي من ميزات copyparty الإضافية، أداة بأسلوب WeTransfer أبسط لكنها ليست ذاتية الاستضافة. تميّز copyparty هو أداؤه لمجموعة واسعة بشكل غير معتاد من مهام سيرفر الملفات — الرفع وWebDAV وFTP والوسائط والبحث — من ملف تنفيذي واحد صغير دون قاعدة بيانات.
متى لا تستخدمه
copyparty ليس منصة تعاون كاملة — لا يملك تحرير مستندات مشتركاً أو تقويماً أو مزامنة جهات اتصال مثل Nextcloud، وواجهة الويب فيه تفضّل الوظيفة على الأناقة. إذا كنت تحتاج واجهة تصفح بسيطة ونظيفة للمستخدمين العاديين، قد تكون واجهة Filebrowser الأبسط أنسب. إذا احتاج فريقك مزامنة مستمرة ثنائية الاتجاه بين عدة أجهزة بدلاً من نقطة رفع/تنزيل مركزية، فـ Syncthing خيار أفضل. للمؤسسات التي تحتاج ميزات على مستوى المؤسسات مثل SSO وسجلات التدقيق وضوابط الامتثال على نطاق واسع، منصة مثل Nextcloud أو Seafile مع دعم مدفوع خيار أكثر أماناً من ملف تنفيذي خفيف واحد.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو copyparty؟
إنه سيرفر ملفات بقدرات مذهلة معبأ في ملف تنفيذي صغير واحد أو سكريبت Python. من تحميل واحد صغير تحصل على واجهة ويب سريعة للرفع والتنزيل، ونقل قابل للاستئناف ومُسرَّع للملفات الضخمة، ووصول WebDAV وFTP، وبث وسائط مع مشغل مدمج وصور مصغّرة، وبحث في الملفات، ونظام صلاحيات لكل مستخدم ولكل مجلد — كل هذا دون تثبيت قاعدة بيانات أو بيئة تشغيل ثقيلة.
ما المنفذ الذي يستخدمه وما بيانات الدخول؟
يعمل copyparty على المنفذ 3923. ينشئ المثبّت حساب مسؤول بكلمة مرور تُولَّد عشوائياً وتُطبع بنهاية مخرجات الإعداد — انسخها فوراً لأنها لا تُعرض مرة أخرى.
هل يستطيع التعامل مع رفعات كبيرة جداً؟
نعم — هذه إحدى أبرز نقاط قوته. يدعم copyparty رفعاً قابلاً للاستئناف ومُسرَّعاً يتعامل فعلياً مع ملفات متعددة الجيجابايت واتصالات غير مستقرة، ويكمل من حيث توقف بدلاً من إعادة البدء من الصفر.
هل يدعم WebDAV وبث الوسائط؟
كلاهما. إلى جانب واجهة الويب، يوفّر copyparty وصول WebDAV (وFTP)، بحيث يمكن لتطبيقات وأنظمة تشغيل أخرى توصيله كقرص شبكة. كما يبث الصوت والفيديو بمشغل مدمج ويولّد صوراً مصغّرة ومعارض للصور، فيعمل أيضاً كمتصفح وسائط خفيف.
ما الفرق بينه وبين Filebrowser؟
Filebrowser مدير ملفات ويب أبسط وأكثر أناقة لقرص السيرفر المحلي، يركّز على تصفح نظيف. يقدّم copyparty أكثر بكثير من ملف تنفيذي واحد — رفع مُسرَّع وقابل للاستئناف، وWebDAV وFTP، وبث وسائط، وصلاحيات دقيقة — على حساب واجهة أكثر ازدحاماً.