🎁 تثبيت Wishlist — سجل الهدايا وقوائم الرغبات المستضاف ذاتياً على Docker

نشر تطبيق Wishlist على Ubuntu باستخدام Docker — سجل الهدايا وقوائم الرغبات ومشاركتها مع العائلة والأصدقاء مع سحب تفاصيل المنتجات تلقائياً وحجز الهدايا على المنفذ 3065.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Wishlist على المنفذ 3065 مع التخزين الدائم وسحب بيانات المنتجات وحجز الهدايا جاهزاً.
عرض على GitHub

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

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

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

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

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

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

chmod +x wishlist-ubuntu.sh

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

./wishlist-ubuntu.sh

4 فتح Wishlist وإنشاء قائمتك الأولى

http://your-server-ip:3065

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

المنفذالغرض
3065Wishlist web app (mapped from container port 3280)

نظرة عامة

يعد Wishlist تطبيق ويب مفتوح المصدر وخفيف ومستضاف ذاتياً لإدارة وتنسيق قوائم الرغبات وسجلات الهدايا (Gift Registry) للأفراد والعائلات والأصدقاء. يعمل التطبيق عبر المنفذ 3065 (المحول من منفذ 3280 الداخلي) ليتيح إنشاء قوائم هدايا مخصصة للمناسبات مثل الأعياد والزواج وحفلات استقبال المواليد وأعياد الميلاد. ويقوم التطبيق بسحب صور المنتجات وعناوينها وأسعارها تلقائياً بمجرد لصق رابط المنتج من أمازون أو أي متجر إلكتروني، مع إمكانية حجز الهدايا من قبل الأقارب لمنع تكرار الشراء مع الحفاظ على عنصر المفاجأة.

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

تمتلئ منصات قوائم الهدايا التجارية بالإعلانات وروابط التتبع والتسويق بالعمولة، وتجبر الجميع على إنشاء حسابات بمتجر واحد محدد. يمنحك Wishlist سجلاً عائلياً خاصاً 100% وخالياً تماماً من الإعلانات: جمع المنتجات من أي متجر على الإنترنت في قائمة موحدة، وتمكين الضيوف من حجز الهدايا بسهولة بدون الحاجة لإنشاء حسابات معقدة، مع الحفاظ على خصوصية العائلة.

متى تحتاجه

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

من يحتاجه

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

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

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

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

  • سحب تلقائي لبيانات المنتجات على المنفذ 3065: جلب العنوان والصورة والسعر والعملة فور لصق الرابط
  • نظام حجز الهدايا ومنع التكرار: إمكانية قيام الزائر بتحديد الهدية كمحجوزة لمنع الآخرين من شرائها
  • وضع المفاجأة (Surprise Mode): إخفاء حالة حجز الهدايا عن صاحب القائمة للحفاظ على عنصر المفاجأة
  • دعم تعدد القوائم والمستخدمين: إنشاء قوائم متعددة للمناسبات والهوايات وأفراد الأسرة
  • واجهة عصرية متجاوبة مع الهواتف: تصفح سريع وسلس على الهواتف الذكية والأجهزة اللوحية والكمبيوتر
  • إضافة عناصر مخصصة يدوياً: إمكانية كتابة هدايا غير موجودة بالمتاجر ورفع صور مخصصة لها
  • محرك SQLite خفيف وفائق السرعة: حفظ كافة البيانات بملف واحد في مجلد التخزين الدائم `./data`
  • معمارية Docker Compose تنشر المنفذ 3065:3280 بتثبيت فوري ومباشر

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3065
  • سجل حساب المشرف الشخصي الأول بالبريد الإلكتروني وكلمة المرور
  • أنشئ قائمتك الأولى (مثل: 'قائمة هدايا التخرج' أو 'أمنيات عيد الميلاد')
  • اضغط على '+ Add Item' والصق رابط أي منتج من متجرك المفضل وراجع البيانات المسحوبة
  • شارك رابط القائمة مع أفراد عائلتك واختبر حجز عنصر من نافذة متصفح خاصة
  • ضع Wishlist خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات `./data`

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

  • تنبيه أمني حاسم: عيّن كلمة مرور قوية لحسابك أثناء شاشة التسجيل الأولى
  • استخدم تشفير HTTPS دائماً لحماية كوكيز الجلسات والبيانات المنقولة بالشبكة
  • عطّل ميزة تسجيل المستخدمين الجدد من الإعدادات إذا كنت تريد قصر السيرفر على عائلتك فقط
  • احمِ مجلد البيانات `./data` الذي يحتوي على قاعدة بيانات SQLite بصلاحيات نظام صارمة (`chmod 700`)
  • لا تكشف المنفذ 3065 للإنترنت العام مباشرة دون وكيل عكسي مشفر بـ SSL
  • حدّث صورة الحاوية دورياً للحصول على أحدث سكريبتات استخراج بيانات المنتجات

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

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

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

  • انسخ مجلد `./data` احتياطياً، والذي يحتوي على ملف قاعدة بيانات SQLite بكافة الحسابات والقوائم والعناصر
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بنسخ مجلد `./data` بحاوية تجريبية والتأكد من ظهور كافة القوائم بنجاح

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

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

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

  • رفض الاتصال بالواجهة — تأكد من عمل الحاوية بالأمر `docker compose ps` وافحص السجلات: `docker logs wishlist -f`
  • فشل سحب صورة أو سعر المنتج — تحظر بعض المواقع زواحف الويب بحماية Cloudflare؛ أدخل البيانات يدوياً
  • زر الحجز لا يتحدث — قم بتحديث الصفحة أو مسح كاش المتصفح لجلب الحالة الأحدث
  • خطأ قفل قاعدة البيانات (Database Locked) — تأكد من وضع ملف البيانات على قرص محلي وليس مشاركة NFS شبكية
  • تعذر تسجيل الدخول — افحص صلاحيات المجلد بالسيرفر: `chown -R 1000:1000 ./data`

البدائل

تطبيق Giftful التجاري للهواتف والويب. منصة Elfster لتبادل الهدايا. قوائم أمنيات Amazon Wishlist التجارية. تطبيق Mealie للوصفات وقوائم المشتريات. منصة Grocy لإدارة مخزون ومشتريات المنزل.

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

تجنب استخدام Wishlist إذا كنت تبحث عن نظام لإدارة مخزون الأطعمة وتواريخ انتهاء الصلاحية بالباركود (حيث صُممت Grocy للمخزون المنزلي). وإذا كنت تحتاج خصيصاً لتنظيم وصفات الطبخ الأسبوعية، فإن Mealie مخصصة للوصفات والمشتريات.

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

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

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

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

ما هو تطبيق Wishlist وكيف يعمل؟

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

كيف تعمل ميزة سحب تفاصيل المنتجات تلقائياً؟

بمجرد لصق رابط المنتج (من أمازون، أو إيباي، أو أي متجر)، يقوم Wishlist بقراءة البيانات الوصفية (Open Graph) للصفحة واستخراج اسم المنتج، وصورته، وسعره، ووصفه تلقائياً دون كتابتها يدوياً.

هل يحتاج الضيوف لإنشاء حساب لتصفح وحجز الهدايا؟

لا! يمكنك مشاركة رابط عام أو محمي بكلمة مرور لقائمتك. ويستطيع الضيوف فتح الرابط وتحديد الهدايا كمحجوزة بسهولة تامة وبدون الحاجة لإنشاء حساب.

هل يستطيع صاحب القائمة معرفة من اشترى كل هدية؟

يتضمن Wishlist ميزة 'وضع المفاجأة' (Surprise Mode) التي تخفي حالة حجز الهدايا عن صاحب القائمة لتبقى الهدايا مفاجأة حقيقية، بينما يستطيع باقي أفراد العائلة رؤية ما تم حجزه.

كم يستهلك تطبيق Wishlist من الذاكرة العشوائية (RAM)؟

تم بناء Wishlist بتقنيات ويب خفيفة مع قاعدة بيانات SQLite، ويتميز بخفة متناهية حيث يستهلك عادة ما بين 30 إلى 70 ميجابايت فقط من الرام داخل Docker.