📸 تثبيت Zipline — سيرفر رفع ومشاركة الصور ولقطات الشاشة وShareX على Docker

نشر سيرفر Zipline على Ubuntu باستخدام Docker — خادم رفع الصور والملفات ومشاركتها فائق السرعة وبديل Imgur مع دعم ShareX وتقصير الروابط والتضمين المخصص في Discord على المنفذ 3053.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Zipline على المنفذ 3053 مع قاعدة بيانات PostgreSQL وتخزين المرفقات والربط مع ShareX جاهزاً.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/zipline/zipline-ubuntu.sh
chmod +x zipline-ubuntu.sh
sudo bash zipline-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/zipline/zipline-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x zipline-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلد قاعدة البيانات (`./db`) ومجلدات رفع الملفات (`./uploads` و`./public`) وضبط مفاتيح التشفير وتشغيل Zipline على المنفذ 3053 (المحول من 3000 الداخلي).

sudo bash zipline-ubuntu.sh

4 تسجيل الدخول وربط برامج ShareX وFlameshot

افتح متصفحك على الرابط http://ip-سيرفرك:3053. سجل حساب المشرف، وتوجه لإعدادات المستخدم لتحميل ملف الإعداد `.sxcu` لبرنامج ShareX، وابدأ في رفع لقطات الشاشة بضغطة زر واحدة.

http://<your-server-ip>:3053

المنافذ المستخدمة

المنفذالغرض
3053Web UI + upload API (host → container 3000)
internalPostgreSQL 16 (zipline-db, not published)
./uploadsHosted files and screenshots (also ./db, ./public)

نظرة عامة

تعد Zipline منصة وسيرفر ويب مفتوح المصدر وخفيف وفائق السرعة لرفع واستضافة ومشاركة لقطات الشاشة، والصور، والفيديوهات، والملفات، والنصوص البرمجية تم بناؤه بـ Next.js وTypeScript وقاعدة بيانات PostgreSQL. تعمل المنصة عبر المنفذ 3053 (المحول من منفذ 3000 الداخلي) لتكون وجهة الرفع الأساسية لبرامج التقاط الشاشة الشهيرة مثل ShareX (لويندوز) وFlameshot (للينكس والماك). وتوفر روابط قصيرة مخصصة، وتضميناً بصرياً أنيقاً بالبطاقات الغنية في Discord وOpenGraph، وحماية الملفات بكلمات مرور وروابط تنتهي تلقائياً.

لماذا تستخدمه

تقوم مواقع رفع الصور التجارية (مثل Imgur وGyazo) بضغط الصور وتخفيض جودتها، وتغمر الزوار بالإعلانات المزعجة وسكريبتات التتبع، وتحذف الملفات القديمة تلقائياً بدون سابق إنذار. يمنحك Zipline منصة رفع خاصة 100%: رفع لقطات الشاشة بضغطة زر واحدة ونسخ الرابط المباشر فورياً للحافظة، ونشر الروابط بنطاقك المخصص، مع الاحتفاظ بملفاتك للأبد على سيرفرك الخاص بجودتها الأصلية الكاملة.

متى تحتاجه

  • تبحث عن بديل مفتوح المصدر ومستضاف ذاتياً لمنصات Imgur وGyazo وCloudApp لرفع الصور
  • تستخدم برنامج ShareX أو Flameshot وتريد سيرفر رفع فوري ينسخ الرابط للحافظة في أقل من ثانية
  • تريد تخصيص شكل بطاقات المعاينة (Discord Embeds) بلون وعنوان مخصص عند مشاركة الصور والفيديوهات بالدردشات
  • تريد روابط قصيرة أنيقة ومباشرة بنطاقك الخاص بدون إعلانات أو صفحات وسيطة مزعجة
  • تحتاج لمشاركة ملفات أو نصوص برمجية حساسة محمية بكلمة مرور أو تنتهي وتحذف نفسها بعد وقت محدد

من يحتاجه

  • المطورون والمصممون لتبادل لقطات الشاشة والتصاميم ومقاطع توضيح الأخطاء البرمجية بسرعة
  • صناع المحتوى واللاعبون لرفع لقطات الألعاب ومقاطع الفيديو ومشاركتها بروابط مباشرة
  • فرق الدعم الفني وتقنية المعلومات لإرسال لقطات شاشات الأخطاء وسجلات الطرفية للعملاء
  • المهتمون بالخصوصية الذين يرفضون رفع لقطات شاشاتهم الشخصية لمواقع الاستضافة العامة
  • أصحاب السيرفرات المنزلية لبناء مركز مشاركة وسائط وتقصير روابط خاص ومستقل

حالات الاستخدام الشائعة

  • التقاط لقطة شاشة للكمبيوتر عبر ShareX ورفعها فورياً ونسخ الرابط للحافظة في أقل من نصف ثانية
  • مشاركة مقطع فيديو بحجم 50 ميجابايت يظهر كبطاقة تشغيل مباشرة أنيقة داخل محادثات Discord
  • رفع تقرير بصيغة PDF برابط محمي بكلمة مرور ومضبوط ليحذف نفسه نهائياً بعد 24 ساعة
  • استخدام ميزة تقصير الروابط المدمجة لتوجيه الروابط الطويلة لعناوين قصيرة وأنيقة
  • تنظيم واستعراض الصور والوسائط المرفوعة في لوحة تحكم بصرية حديثة مع محرك بحث سريع

الميزات الرئيسية

  • واجهة برمجية لرفع الملفات فائقة السرعة على المنفذ 3053: رفع فوري للملفات عبر بروتوكول HTTP وملفات SXCU
  • تضمين مخصص لـ Discord وOpenGraph: تخصيص عنوان المعاينة، ووصف الملف، واللون البصري، واسم الكاتب
  • تقصير روابط متقدم ومرن: توليد روابط برموز عشوائية، أو كلمات مفهومة، أو تواريخ، أو أسماء مخصصة
  • حماية بكلمات المرور وتواريخ الانتهاء: حماية الملفات وتعيين مؤقتات الحذف التلقائي (بالساعات أو الأيام)
  • منصة نصوص برمجية (Pastebin) مدمجة: مشاركة الأكواد والملاحظات النصية مع تمييز لغات البرمجة
  • إدارة الحصص والمستخدمين: تحديد حدود حجم الملفات وصلاحيات رفع متعددة للمستخدمين
  • ضغط الصور وتوليد المصغرات: إنشاء صور مصغرة بصيغة WebP لتسريع تصفح المعرض في لوحة التحكم
  • معمارية Docker Compose تجمع Zipline بـ Next.js مع قاعدة بيانات PostgreSQL 16

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3053
  • سجل حساب المشرف الشخصي الأول لتهيئة السيرفر
  • توجه إلى إعدادات المستخدم User Settings ← Manage Tokens، وولّد رمز API واضغط 'Download SXCU' لـ ShareX
  • اضغط مرتين على ملف `.sxcu` المحمل بنظام Windows لربط ShareX بسيرفرك مباشرة كوجهة رفع افتراضية
  • خصص بطاقات التضمين في Discord من قائمة User Settings ← Embed
  • ضع Zipline خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • أعد سكريبت نسخ احتياطي دوري لمجلد الملفات المرفوعة `./uploads` وقاعدة البيانات `./db`

أفضل ممارسات الأمان

  • تنبيه أمني حاسم: عيّن قيمة سرية معقدة لـ `CORE_SECRET` في ملف `.env` قبل تشغيل الحاوية
  • عطّل ميزة التسجيل العام (`CORE_REGISTRATION_DISABLED=true`) إذا كان السيرفر خاصاً بك
  • استخدم تشفير HTTPS دائماً لحماية رموز المصادقة وملفات لقطات الشاشة المنقولة بالشبكة
  • أبقِ منفذ قاعدة البيانات الداخلي PostgreSQL 5432 معزولاً عن الإنترنت العام
  • احمِ مجلدات البيانات والمرفقات بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

المنافذ وإعدادات جدار الحماية

يقدم Zipline واجهة الويب والواجهة البرمجية عبر منفذ TCP 3053 (المحول من منفذ 3000 الداخلي). اسمح بالمنفذ 3053 للشبكة المحلية (`ufw allow 3053/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 3053، مع إبقاء المنفذ 3053 مغلقاً خارجياً وقاعدة البيانات معزولة.

النسخ الاحتياطي والصيانة

  • انسخ مجلد `./uploads` احتياطياً، والذي يحتوي على كافة الصور والفيديوهات والنصوص والملفات المرفوعة
  • انسخ مجلد `./db` الذي يحتوي على كامل قاعدة بيانات PostgreSQL بكافة المستخدمين والرموز والبيانات الوصفية
  • استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec zipline-db pg_dump -U zipline zipline > zipline_backup.sql`
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env` المحتوي على `CORE_SECRET`
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync

الأخطاء الشائعة

  • عدم ربط مجلدي التخزين الدائم `./uploads` و`./db`، مما يسبب مسح كافة الملفات المرفوعة عند تحديث الحاوية
  • ترك التسجيل العام متاحاً على سيرفر متصل بالإنترنت مما يسمح للغرباء باستهلاك مساحة قرص السيرفر
  • تشغيل Zipline عبر HTTP غير المشفر مما يجعل متصفحات الويب تحظر عرض الصور في المواقع الآمنة (Mixed Content)
  • نسيان ضبط الحد الأقصى لحجم الملفات في الوكيل العكسي (`client_max_body_size 100M;` في Nginx) مما يسبب خطأ 413 عند رفع ملفات كبيرة
  • نسيان حفظ مفتاح `CORE_SECRET` الذي يشفر جلسات ورموز المستخدمين

استكشاف الأخطاء وإصلاحها

  • فشل الرفع عبر ShareX مع خطأ 413 Payload Too Large — ارفع قيمة `client_max_body_size 500M;` في إعدادات الوكيل العكسي Nginx
  • برنامج ShareX يعيد خطأ 401 Unauthorized — أعد توليد رمز الرفع (Token) من إعدادات المستخدم وحمل ملف `.sxcu` مجدداً
  • ظهور خطأ 502 Bad Gateway في الواجهة — انتظر 30 ثانية لاكتمال إقلاع PostgreSQL وراجع السجلات: `docker logs zipline -f`
  • الصور المرفوعة لا تظهر ومصغراتها مكسورة — افحص صلاحيات مجلد الرفع بالسيرفر: `chown -R 1000:1000 ./uploads`
  • خطأ الاتصال بقاعدة البيانات — تأكد من صحة وعمل حاوية `zipline-db` وتطابق البيانات بملف `.env`

البدائل

موقع Imgur التجاري للصور. تطبيق Gyazo التجاري لقطات الشاشة. منصة Chibisafe مفتوحة المصدر لرفع الملفات. ميزة التخزين السحابي الشاملة في Nextcloud.

متى لا تستخدمه

تجنب استخدام Zipline إذا كنت تبحث عن منصة تخزين ومزامنة سحابية متكاملة للمستندات والتقويم والمجلدات المشتركة (حيث صُممت Nextcloud أو OwnCloud للتخزين السحابي الشامل). وإذا كنت تحتاج حصراً لمشاركة نصوص وكلمات مرور مشفرة ذاتية التدمير لمرة واحدة فقط وبدون حفظ بالقرص، فإن Yopass أخف.

هل تحتاج مساعدة احترافية؟

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

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو سيرفر Zipline وكيف يتكامل مع برنامج ShareX؟

سيرفر Zipline هو نظام مفتوح المصدر لرفع واستضافة الوسائط. يوفر ملف إعداد `.sxcu` جاهز لبرنامج ShareX بنظام ويندوز أو أوامر لـ Flameshot بلينكس، لتقوم بالتقاط لقطات الشاشة بالهوت كي ويتم رفعها لسيرفرك ونسخ الرابط المباشر للحافظة فورياً.

هل يمكنني استخدام نطاق مخصص وروابط قصيرة لملفاتي؟

نعم! يمكنك توجيه نطاق فرعي قصير (مثل `i.yourdomain.com`) إلى سيرفر Zipline، لتظهر كافة روابط لقطات الشاشة والمقاطع باسم نطاقك الخاص بهوية مميزة واحترافية.

هل يدعم Zipline المعاينة الغنية المخصصة في Discord؟

نعم! يتيح Zipline تخصيص بيانات التضمين (Embeds)، حيث يمكنك تحديد لون البطاقة، وعنوانها، واسم الكاتب، والوصف، لتظهر لقطات الشاشة والفيديوهات ببطاقات معاينة تفاعلية في محادثات ديسكورد.

هل يمكن ضبط مؤقت لحذف الملفات تلقائياً بعد فترة زمنية؟

نعم! يتيح لك Zipline تحديد مدة صلاحية للملفات المرفوعة (مثل ساعة، أو يوم، أو أسبوع)، ليقوم النظام بمسح الملف نهائياً من القرص وقاعدة البيانات فور انتهاء المدة.

كم يستهلك سيرفر Zipline من الذاكرة العشوائية (RAM)؟

تستهلك منظومة Zipline (تطبيق Next.js مع قاعدة PostgreSQL) عادة ما بين 150 إلى 350 ميجابايت فقط من الرام داخل Docker، مما يجعلها خفيفة وسريعة جداً على أي سيرفر VPS.