🎵 تثبيت Your Spotify — إحصائيات وسجل استماع Spotify المستضاف ذاتياً على Docker
نشر منصة Your Spotify على Ubuntu باستخدام Docker — لوحة تتبع وإحصائيات استماع Spotify المستضافة ذاتياً وبديل Last.fm لعرض سجل أغانيك وفنانيك المفضلين على المنافذ 3058 و8218.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/your-spotify/your-spotify-ubuntu.sh
chmod +x your-spotify-ubuntu.sh
sudo bash your-spotify-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/your-spotify/your-spotify-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x your-spotify-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد قاعدة البيانات (`./db`) وطلب مفاتيح Client ID وSecret لحساب مطوري Spotify وتشغيل الواجهة على المنفذ 3058 والخادم على المنفذ 8218.
sudo bash your-spotify-ubuntu.sh
4 تسجيل الدخول وربط حساب Spotify
افتح متصفحك على الرابط http://ip-سيرفرك:3058. اضغط على 'Log in with Spotify' وامنح الصلاحيات لحسابك الشخصي عبر OAuth ليبدأ Your Spotify في تسجيل وأرشفة أغانيك فورياً.
http://<your-server-ip>:3058
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3058 | Web client (host → container 3000) — the interface you open |
| 8218 | API server (host → container 8080) — redirect URI must match |
| internal | MongoDB 6 (your-spotify-mongo, not published) |
نظرة عامة
تعد Your Spotify منصة ويب مفتوحة المصدر ومستضافة ذاتياً لتسجيل وتحليل وتتبع تاريخ استماع الموسيقى على منصة Spotify تم بناؤها بـ React وNode.js وقاعدة بيانات MongoDB. تعمل المنصة عبر واجهة الويب على المنفذ 3058 وخادم الواجهة البرمجية على المنفذ 8218، لتتصل بالواجهة البرمجية الرسمية لـ Spotify وتقوم بتسجيل كل مقطع وفنان وألبوم وتصنيف تستمع إليه عبر كافة أجهزتك (الهاتف، الكمبيوتر، التلفزيون). وتقدم إحصائيات استماع على مدار العام، ورسوماً بيانية تفاعلية، وقوائم أكثر الفنانين استماعاً، مع إمكانية استيراد أرشيف بياناتك التاريخية السابقة.
لماذا تستخدمه
تقدم منصة سبوتيفاي ملخصاً سنوياً قصيراً ومحدوداً (Spotify Wrapped) مرة واحدة فقط في نهاية العام لأغراض التسويق. بينما تفرض الخدمات التجارية (مثل Last.fm وStats.fm) اشتراكات شهرية مدفوعة لاستعراض سجلات الاستماع القديمة وتبيع بيانات اهتماماتك الموسيقية. تمنحك Your Spotify لوحة تحكم موسيقية خاصة 100%: تسجيل دائم لكافة أغانيك دون انقطاع، ورسوم بيانية تفاعلية في أي وقت بالسنة، واستيراد كامل لأرشيفك الموسيقي القديم، مع ملكية كاملة لبياناتك بسيرفرك الخاص.
متى تحتاجه
- تريد لوحة إحصائيات موسيقية شاملة شبيهة بـ 'Spotify Wrapped' تعمل على مدار العام في أي وقت
- تريد تسجيل وحفظ سجل أغانيك واستماعك على سبوتيفاي بشكل دائم في قاعدة بيانات خاصة بك
- تبحث عن بديل مفتوح المصدر وخاص لمنصات Last.fm وStats.fm بدون أي اشتراكات مدفوعة
- تريد استيراد ملفات أرشيف سبوتيفاي السابقة (ملفات JSON) لتوثيق سنوات الاستماع القديمة
- تريد تحليلات موسيقية عميقة (أكثر الفنانين استماعاً بكل شهر، توزيع الأنواع الموسيقية، أوقات الاستماع)
من يحتاجه
- عشاق الموسيقى ومستخدمو Spotify الراغبون في توثيق أغانهم وفنانيهم المفضلين وتطور ذوقهم الموسيقي
- المستخدمون المحترفون الباحثون عن تحليلات بيانية وإحصائية دقيقة تتجاوز الملخص السنوي التقليدي
- المهتمون بالخصوصية الذين يرفضون مشاركة عادات استماعهم الموسيقي مع المنصات التجارية كـ Last.fm
- صناع المحتوى والمهتمون بالموسيقى لدراسة أنماط الاستماع اليومية والأسبوعية
- أصحاب السيرفرات المنزلية لبناء لوحات بيانات شخصية تدمج خدمات الترفيه والميديا
حالات الاستخدام الشائعة
- معرفة أكثر الألبومات والفنانين الذين استمعت إليهم خلال رحلتك الصيفية في الشهر الماضي
- استيراد أرشيف سبوتيفاي لخمس سنوات ماضية لدمج سجلات استماعك القديمة في لوحة واحدة
- التعرف على الأنواع الموسيقية الأكثر استماعاً وكيف تغيرت اهتماماتك بين فصول السنة
- استعراض خريطة حرارية (Heatmap) توضح الساعات والأيام التي تستمع فيها للموسيقى بكثافة
- مشاركة السيرفر مع أفراد العائلة حيث يربط كل فرد حسابه في سبوتيفاي بإحصائيات مستقلة
الميزات الرئيسية
- لوحة إحصائيات تفاعلية على المنفذ 3058: رسوم بيانية لأكثر الأغاني والفنانين والألبومات والتصنيفات
- تسجيل تلقائي مستمر على المنفذ 8218: رصد دقيق للمقاطع المشغلة بالهاتف أو الكمبيوتر أو مكبرات الصوت الحية
- استيراد تاريخ الاستماع القديم: دعم رفع ملفات الأرشيف الرسمية من سبوتيفاي لتوثيق السنوات السابقة
- خرائط حرارية لساعات وأيام الاستماع: توضيح أوقات ذروة الاستماع للموسيقى على مدار الأسبوع
- دعم تعدد المستخدمين: إمكانية ربط حسابات سبوتيفاي متعددة لأفراد العائلة بحسابات وإحصائيات منفصلة
- محرك بحث وتاريخ تشغيل الأغاني: البحث عن أي أغنية لمعرفة تواريخ استماعك لها وإجمالي الدقائق
- واجهة React عصرية وسريعة: متجاوبة مع الهواتف ومربوطة بقاعدة بيانات MongoDB لحفظ السجلات
- معمارية Docker Compose تجمع واجهة العميل وخادم الـ API مع قاعدة MongoDB
كيفية الاستخدام بعد التثبيت
- أنشئ تطبيق مطورين في موقع `developer.spotify.com` وأضف رابط إعادة التوجيه (`http://ip-سيرفرك:8218/oauth/spotify/callback`)
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3058
- اضغط على 'Log in with Spotify' وسجل دخولك بحسابك في سبوتيفاي لمنح الصلاحيات
- اطلب أرشيف بياناتك القديمة من إعدادات خصوصية سبوتيفاي وارفعه من تبويب Import
- ضع Your Spotify خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة بيانات MongoDB (`./db`)
أفضل ممارسات الأمان
- تنبيه أمني حاسم: احتفظ بمفتاح Spotify Client Secret سراً ولا تشاركه بمستودعات عامة
- استخدم تشفير HTTPS دائماً؛ حيث يتطلب بروتوكول المصادقة في سبوتيفاي روابط آمنة ومعتمدة
- أبقِ منفذ قاعدة البيانات الداخلي MongoDB 27017 معزولاً عن الإنترنت العام
- احمِ مجلد البيانات `./db` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
- تأكد من إضافة بريدك الإلكتروني في قائمة المستخدمين المعتمدين في Spotify Developer Console
- حدّث صور الحاويات دورياً لضمان توافق الاتصال مع أحدث إصدارات الواجهة البرمجية لسبوتيفاي
المنافذ وإعدادات جدار الحماية
يستخدم Your Spotify منفذ TCP 3058 لواجهة الويب ومنفذ TCP 8218 لخادم الـ API ومصادقة OAuth. اسمح بكلا المنفذين للشبكة المحلية (`ufw allow 3058/tcp && ufw allow 8218/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع إبقاء قاعدة البيانات معزولة.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./db` احتياطياً، والذي يحتوي على كامل قاعدة بيانات MongoDB بكافة سجلات الاستماع والفنانين والأغاني
- استخرج نسخة احتياطية لقاعدة البيانات عبر mongodump: `docker exec your-spotify-mongo mongodump --out /dump`
- احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env` المحتوي على مفاتيح سبوتيفاي
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
الأخطاء الشائعة
- كتابة رابط إعادة التوجيه بشكل غير متطابق في لوحة مطوري سبوتيفاي (يجب أن يطابق مسار المنفذ 8218 بدقة)
- عدم ربط مجلد التخزين الدائم لقاعدة البيانات، مما يسبب مسح سجلات الاستماع التاريخية عند تحديث الحاوية
- كتابة متغيرات `API_ENDPOINT` أو `CLIENT_ENDPOINT` بشكل خاطئ مما يعطل اتصال الواجهة بالخادم
- تشغيل السيرفر بدون اتصال بالإنترنت الخارجي مما يمنع جلب بيانات الأغاني من سبوتيفاي
- نسيان إضافة حساب المستخدم في لوحة مطوري سبوتيفاي تحت قائمة User Management
استكشاف الأخطاء وإصلاحها
- خطأ تسجيل الدخول 'INVALID_CLIENT: Invalid redirect URI' — تأكد من تطابق رابط الـ Callback في Spotify Console مع المنفذ 8218 بدقة
- الأغاني لا تُسجل والإحصائيات فارغة — تأكد من تشغيل الموسيقى بالفعل بسبوتيفاي وراجع السجلات: `docker logs your-spotify-server -f`
- الواجهة تظهر خطأ اتصال بالشبكة — تأكد من صحة رابط `API_ENDPOINT` في متغيرات بيئة الواجهة
- فشل استيراد ملفات الـ JSON التاريخية — فك الضغط عن أرشيف سبوتيفاي وارفع ملفات `StreamingHistory*.json` بشكل فردي
- خطأ الاتصال بقاعدة البيانات — تأكد من صحة وعمل حاوية `your-spotify-mongo`
البدائل
منصة Last.fm التجارية للموسيقى والإحصائيات. تطبيق Stats.fm (Spotistats) التجاري للهواتف. سيرفر Maloja مفتوح المصدر لسجلات الموسيقى. مشروع ListenBrainz المفتوح من MetaBrainz.
متى لا تستخدمه
تجنب استخدام Your Spotify إذا كنت لا تستخدم منصة سبوتيفاي للاستماع للموسيقى (حيث يدعم Maloja أو ListenBrainz مشغلات الصوت العامة والملفات المحلية). وإذا كنت تبحث عن سيرفر لبث وتشغيل ملفات الموسيقى المخزنة على قرصك (FLAC وMP3)، فإن Navidrome أو Jellyfin مخصص للبث المحلي.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي منصة Your Spotify وكيف تقوم بتسجيل الموسيقى؟
منصة Your Spotify هي تطبيق ويب مفتوح المصدر ومستضاف ذاتياً يتصل بحسابك في سبوتيفاي عبر الواجهة البرمجية الرسمية. يقوم الخادم بفحص ما تستمع إليه دورياً ويسجل كل أغنية مشغلة في قاعدة بياناتك الخاصة.
هل يتطلب استخدام Your Spotify اشتراكاً مدفوعاً في Spotify Premium؟
لا! يعمل Your Spotify مع حسابات Spotify المجانية والمدفوعة (Premium) على حد سواء. طالما أنك تمتلك حساب سبوتيفاي وقمت بإنشاء تطبيق مجاني في بوابة المطورين، فسيتم تتبع استماعك بنجاح.
لماذا يستخدم Your Spotify منفذين منفصلين (3058 و8218)؟
يقدم المنفذ 3058 واجهة الويب الأمامية (React) التي تتصفحها في المتصفح، بينما يقدم المنفذ 8218 خادم الواجهة البرمجية الخلفي (Node.js API) الذي يتصل بسبوتيفاي ويدير عمليات مصادقة OAuth.
هل يمكنني استيراد تاريخ استماعي الموسيقي القديم من سبوتيفاي؟
نعم! يمكنك طلب أرشيف بياناتك التاريخية الكاملة من صفحة خصوصية حسابك في سبوتيفاي (التي تحتوي على ملفات `StreamingHistory*.json`) ورفعها مباشرة لـ Your Spotify لتوثيق سنوات الاستماع السابقة.
كم يستهلك Your Spotify من الذاكرة العشوائية (RAM)؟
تستهلك منظومة Your Spotify الكاملة (الواجهة + الخادم + قاعدة MongoDB) عادة ما بين 200 إلى 450 ميجابايت فقط من الرام داخل Docker.