⚙️ تثبيت Glance — لوحة تحكم ذاتية الاستضافة ومُجمِّع خلاصات

انشر Glance على Ubuntu — لوحة تحكم سريعة تُضبط عبر YAML وتجمع خلاصات RSS وحالة الخدمات والطقس والأسواق وأكثر في صفحة رئيسية واحدة نظيفة.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Glance على المنفذ 8160 مع ملف إعداد glance.yml جاهز للتعديل.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/management/glance/glance-ubuntu.sh

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

chmod +x glance-ubuntu.sh

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

يثبّت السكريبت Docker إذا لزم الأمر، يسحب صورة glanceapp/glance، ويشغّلها على المنفذ 8160 مع مجلد دائم ./config يحتوي على glance.yml.

sudo bash glance-ubuntu.sh

4 الدخول إلى لوحة التحكم

افتح المتصفح وانتقل إلى Glance، ثم عدّل config/glance.yml لبناء لوحة التحكم الخاصة بك:

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

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

المنفذالغرض
8160Dashboard Web UI (host → container 8080)

نظرة عامة

Glance هي لوحة تحكم سريعة ذاتية الاستضافة مكتوبة بلغة Go تجمع خلاصات RSS والطقس وفحوصات حالة الخدمات وأسعار الأسهم والعملات المشفرة ومنشورات Hacker News وReddit ورفعات YouTube وحالة حاويات Docker وأكثر في صفحة رئيسية واحدة قابلة للتخصيص بالكامل. كل شيء يُعرَّف في ملف YAML واحد اسمه glance.yml — لا توجد قاعدة بيانات ولا لوحة إدارة ولا نظام حسابات. تُحمَّل الصفحات في نحو ثانية واحدة لأن Glance يجلب البيانات فقط عند طلب الصفحة، مع تخزين مؤقت قابل للضبط، بدلاً من الاستعلام المستمر في الخلفية.

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

يستبدل Glance عشرات الألسنة المفتوحة في المتصفح — قارئ RSS، تطبيق طقس، مؤشر أسهم، صفحة حالة، Reddit، Hacker News — بصفحة واحدة تتحكم بها بالكامل عبر ملف نصي. ولأنه ملف Go تنفيذي واحد بحجم يقارب 20 ميجابايت فقط مع اعتماديات محدودة وبدون قاعدة بيانات تحتاج لتجهيزها، فهو يبدأ خلال ثوانٍ ويستهلك موارد سيرفر ضئيلة جداً. لمن يريد صفحة بداية شخصية أو جماعية سريعة فعلاً وقابلة للتخصيص الكامل بصيغة YAML بسيطة، بدلاً من التنقل عبر واجهة إدارة أثقل، يُعد Glance من أخف الخيارات المتاحة.

متى تحتاجه

  • تريد صفحة رئيسية واحدة تجمع خلاصات RSS والطقس وحالة الخدمات وأسعار الأسواق بدلاً من التنقل بين تطبيقات وألسنة منفصلة
  • سئمت لوحات التحكم البطيئة المثقلة بجافاسكريبت وتريد شيئاً يُحمَّل في نحو ثانية واحدة
  • تفضّل تعريف تخطيط لوحتك بالكامل في ملف YAML بسيط بدلاً من التنقل عبر واجهة إدارة على الويب
  • تُشغّل خدمات أخرى ذاتية الاستضافة وتريد صفحة هبوط واحدة تربطها وتراقب حالتها بنظرة سريعة
  • تريد لوحة تحكم خفيفة تعمل بشكل مريح على VPS محدود الموارد أو جهاز Raspberry Pi
  • تحتاج صفحة بداية قابلة للتخصيص لمختبرك المنزلي أو فريقك دون الحاجة لصيانة قاعدة بيانات

من يحتاجه

  • عشاق المختبرات المنزلية الذين يريدون صفحة هبوط واحدة تربط خدماتهم ذاتية الاستضافة وتراقب حالتها
  • المطورون ومسؤولو الأنظمة الذين يفضّلون الإعداد كنص (YAML) على التنقل عبر لوحات الإدارة
  • الفرق الصغيرة التي تريد صفحة بداية داخلية مشتركة تعرض أخبار RSS وفحوصات الحالة والتقويم
  • المستخدمون المهتمون بالخصوصية الذين يريدون تجميع RSS والطقس وبيانات الأسواق دون تتبع من طرف ثالث
  • من يريد استبدال إضافة لوحة تحكم في متصفحه ببديل ذاتي الاستضافة وقابل للتخصيص بالكامل
  • مستخدمو الأجهزة محدودة الموارد مثل Raspberry Pi أو VPS صغير الذين يحتاجون لوحة تحكم خفيفة فعلاً
  • أي شخص يريد نظرة سريعة موحدة على عدة خلاصات RSS ومنتديات فرعية ومصادر أخبار

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

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

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

  • مجموعة واسعة من الأدوات: خلاصات RSS، منتديات فرعية، Hacker News، الطقس، قنوات YouTube، Twitch، أسعار الأسواق، التقويم، قوائم المهام، الإشارات المرجعية، ومراقبة المواقع
  • أداة حاويات Docker تعرض حالة الحاويات العاملة مباشرة على لوحة التحكم
  • إعداد قائم بالكامل على YAML في ملف glance.yml واحد — بدون قاعدة بيانات وبدون لوحة إدارة على الويب
  • صفحات وأعمدة متعددة تتيح تنظيم الأدوات في تبويبات منفصلة حسب الموضوع أو الغرض
  • أدوات مخصصة عبر iframe أو HTML خام أو نقطة نهاية API مخصصة لأي شيء لا تغطيه الأدوات الجاهزة
  • سمات CSS مدمجة ومخصصة، مع تخطيط متجاوب مُحسَّن للهواتف
  • تحميل صفحات سريع جداً — عادة نحو ثانية واحدة — لأن البيانات تُجلب عند الطلب مع تخزين مؤقت قابل للضبط بدلاً من الاستعلام المستمر في الخلفية
  • بصمة صغيرة جداً: ملف Go تنفيذي واحد أقل من 20 ميجابايت باستهلاك ذاكرة منخفض، متاح لـ Linux وWindows وmacOS وDocker

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

  • افتح لوحة التحكم على عنوان IP الخاص بسيرفرك والمنفذ 8160 لترى التخطيط الافتراضي التجريبي
  • عدّل config/glance.yml على المضيف لإضافة أو حذف أو إعادة ترتيب الأدوات والصفحات والأعمدة
  • أعد تشغيل الحاوية بعد كل تعديل لإعادة تحميل الإعداد — يدعم Glance أيضاً إعادة التحميل الفوري إذا فعّلته
  • أضف أداة مراقبة تشير إلى خدماتك الأخرى ذاتية الاستضافة لتتبع حالتها على اللوحة
  • اضبط أدوات RSS والمنتديات الفرعية وHacker News بالخلاصات والمنتديات التي تتابعها فعلياً
  • أضف أداة Docker إذا أردت رؤية حالة الحاويات مباشرة على لوحة التحكم
  • نظّم الأدوات في صفحات متعددة إذا كبرت لوحتك، باستخدام تبويبات لمواضيع مختلفة
  • أعدّ وكيلاً عكسياً مع HTTPS وطبقة مصادقة قبل كشف Glance خارج شبكتك المحلية

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

  • لا يملك Glance تسجيل دخول أو حسابات مستخدمين مدمجة — أي شخص يستطيع الوصول للوحة يرى كل ما عليها
  • لا تكشف المنفذ 8160 مباشرة للإنترنت دون إضافة طبقة مصادقة أمامه
  • ضع Glance خلف وكيل عكسي مع HTTPS وطبقة تسجيل دخول مثل Authelia أو مصادقة Nginx الأساسية لأي وصول عن بُعد
  • أبقِ Glance مقتصراً على شبكتك المحلية أو VPN إذا لم تكن بحاجة لعرضه خارج شبكة منزلك أو مكتبك
  • راجع أي أدوات custom-API أو iframe تضيفها — يمكنها تنفيذ طلبات أو تضمين محتوى بعيد على لوحتك
  • حدّث صورة glanceapp/glance في Docker باستمرار للحصول على إصلاحات الأخطاء مع تطور المشروع
  • انتبه إلى أن الأدوات التي تجلب بيانات خارجية (RSS، الطقس، الأسواق) تُجري طلبات صادرة من سيرفرك
  • إذا كانت لوحتك تعرض روابط أو إحصاءات داخلية حساسة، تعامل معها كأداة داخلية ولا تكشفها للعامة دون مصادقة أبداً

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

يستمع Glance على المنفذ 8160 في المضيف ضمن هذا النشر، والمرتبط بالمنفذ الداخلي 8080 في الحاوية، ويخدم لوحة التحكم بالكامل وأي أدوات مُعدَّة عبر هذا المنفذ الواحد. لا يوجد منفذ API منفصل ولا منفذ قاعدة بيانات يجب إدارته. وبما أن Glance لا يملك مصادقة مدمجة، لا يجب أبداً كشف المنفذ 8160 مباشرة للإنترنت — ضعه خلف وكيل عكسي يضيف HTTPS وطبقة تسجيل دخول، أو قيّد الوصول إلى شبكتك المحلية وVPN عبر قواعد جدار الحماية.

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

  • انسخ مجلد ./config احتياطياً — يحتوي على glance.yml، وهو التعريف الكامل للوحة تحكمك
  • بما أن Glance لا يملك قاعدة بيانات، فإن نسخ glance.yml وحده كافٍ لاستعادة لوحتك بالكامل
  • احتفظ بنسخة من glance.yml في مستودع Git لتتبع التغييرات والتراجع عن التعديلات الخاطئة
  • انسخ احتياطياً ملف docker-compose.yml أو أمر التشغيل حتى يمكن إعادة إنشاء الحاوية بنفس إعدادات المنفذ والمجلد
  • خزّن النسخ الاحتياطية بعيداً عن نفس قرص السيرفر حتى لا يؤدي عطل في الجهاز لفقدان الاثنين معاً
  • اختبر استعادة glance.yml على حاوية جديدة بين الحين والآخر للتأكد من أن نسختك الاحتياطية صالحة فعلاً

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

  • كشف المنفذ 8160 مباشرة للإنترنت دون إدراك أن Glance لا يملك تسجيل دخول أو مصادقة خاصة به
  • كسر glance.yml بمسافات بادئة خاطئة في YAML، مما يجعل لوحة التحكم تفشل في التحميل
  • نسيان إعادة تشغيل الحاوية بعد تعديل glance.yml، فلا تُطبَّق التغييرات أبداً
  • إضافة عدد كبير جداً من الأدوات في صفحة واحدة، مما يجعل اللوحة مزدحمة بدلاً من نظرة سريعة فعلية
  • عدم أخذ نسخة احتياطية من glance.yml قبل إجراء تعديلات كبيرة، مما يفقدك تخطيطاً كان يعمل
  • افتراض أن Glance يخزّن سجلاً أو حالة — فهو أداة عرض بلا حالة تُظهر إعداد YAML وما تجلبه مباشرة فقط
  • إعداد أداة Docker دون ربط Docker socket، فلا تظهر حالة الحاويات أبداً
  • تشغيل Glance بدون مجلد ./config دائم، مما يفقد كل التخصيص عند إعادة إنشاء الحاوية

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

  • لوحة التحكم لا تُحمَّل بعد تعديل — تحقق من أخطاء المسافات البادئة في glance.yml، فحتى مسافة واحدة في غير مكانها تكسر التحليل
  • الأدوات لا تعرض بيانات — تأكد أن الحاوية لديها وصول صادر للإنترنت، فمعظم الأدوات تجلب بيانات من مصادر خارجية
  • تعديلات glance.yml لا تظهر — أعد تشغيل الحاوية لإعادة تحميل الإعداد، أو فعّل إعادة التحميل الفوري إذا كانت نسختك تدعمه
  • أداة Docker لا تعرض شيئاً — تحقق من أن Docker socket مربوط داخل الحاوية بالصلاحيات الصحيحة
  • اللوحة غير قابلة للوصول — تأكد من أن المنفذ 8160 مربوط بشكل صحيح وغير محظور من جدار حماية المضيف
  • أدوات الطقس أو الأسواق تُرجع أخطاء — تحقق من أن أسماء المواقع أو رموز الأسهم في glance.yml مُنسَّقة بشكل صحيح
  • الصفحة تُحمَّل ببطء — قلّل عدد الأدوات التي تجلب بيانات خارجية في صفحة واحدة أو زد مدة التخزين المؤقت للأدوات
  • سمة CSS المخصصة لا تُطبَّق — تأكد من أن مسار الملف في glance.yml يطابق مكان وجود ملف CSS المخصص فعلياً داخل الحاوية

البدائل

Homepage هو البديل الأغنى بالميزات، مع تكاملات وأدوات عميقة للخدمات، لكن إعداده أكثر تعقيداً وتشغيله أثقل. يركز Heimdall على كونه مُطلِق تطبيقات بسيط بأيقونات بدلاً من أدوات بيانات حية. تقع Homarr وDashy في المنتصف، وتوفران إعداداً بواجهة سحب وإفلات بدلاً من YAML، وهو أكثر سهولة للمستخدمين غير التقنيين لكنه أقل دقة للمستخدمين المتقدمين. بالنسبة للوحة تحكم تُعطي الأولوية للسرعة الخام واستهلاك موارد ضئيل وإعداد كامل كشيفرة، يُعد Glance أخف خيار متاح — والمقايضة هي تجربة إعداد أقل صقلاً لأن كل شيء يتم في ملف نصي بدلاً من واجهة مستخدم.

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

لا يملك Glance مصادقة مدمجة، فإذا كنت تحتاج لوحة تحكم بحسابات مستخدمين وأدوار وشاشات تسجيل دخول جاهزة، انظر إلى Homarr أو Homepage بدلاً منه. وإذا كنت تفضّل إعداد كل شيء بالنقر عبر واجهة ويب بدلاً من تحرير YAML، ستكون Dashy أو Homarr أكثر سهولة بالنسبة لك. Glance أيضاً طبقة عرض وليس نظام مراقبة أو تنبيه — فهو لا يخزّن بيانات تاريخية ولا يرسل إشعارات، لذا اقرنه بأداة مثل Uptime Kuma أو Netdata إذا كنت تحتاج تنبيهاً حقيقياً وليس مجرد أداة حالة بنظرة سريعة.

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

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

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

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

كيف يتم إعداد Glance؟

بالكامل عبر ملف YAML واحد، glance.yml، في مجلد ./config. تُعرِّف الصفحات والأعمدة والأدوات بصيغة YAML ويقوم Glance بعرضها. لا توجد قاعدة بيانات ولا واجهة إدارة.

هل يملك Glance حسابات مستخدمين أو تسجيل دخول؟

لا. لا يملك Glance مصادقة مدمجة. أي شخص يستطيع الوصول للوحة يراها. أبقه على شبكتك المحلية أو خلف وكيل عكسي مع HTTPS وطبقة تسجيل دخول مثل Authelia قبل كشفه.

ما المنفذ الذي يعمل عليه Glance؟

يربط هذا النشر المنفذ 8160 في المضيف بالمنفذ الداخلي 8080 في الحاوية، لذا تصل إلى اللوحة عبر http://your-server-ip:8160.

لماذا لا تعرض أدواتي بيانات؟

معظم الأدوات تجلب بيانات من الإنترنت. إذا كانت فارغة، فمن المرجح أن الحاوية لا تستطيع إجراء طلبات صادرة. تحقق من وصولها للشبكة، وتأكد من إعداد الأداة بشكل صحيح في glance.yml.

كيف أطبّق تعديلات glance.yml؟

عدّل الملف في مجلد ./config وأعد تشغيل الحاوية لإعادة تحميله. يدعم Glance أيضاً إعادة التحميل الفوري إذا فُعِّلت. إذا فشلت اللوحة في التحميل بعد تعديل، تحقق من المسافات البادئة في YAML.