كيف يعمل HOMEPAGE_ALLOWED_HOSTS؟

منذ الإصدار 0.9.0، تتحقق Homepage من رأس Host لمنع Host Header Injection. اضبطه على نطاقك (مثل home.example.com) أو على "*" للنشر الحلقي الذي يُقرأ عبر نفق SSH — وهو الإعداد الافتراضي في ServOrbit.

هل يمكن لـ Homepage عرض حالة حاويات Docker؟

نعم. اربط /var/run/docker.sock:/var/run/docker.sock:ro وأضف الوسوم homepage.group وhomepage.name وhomepage.href على كل حاوية تريد عرضها. تكتشفها Homepage تلقائياً وتضيفها إلى لوحة التحكم دون تعديل ملفات الإعداد.

أين يُخزَّن الإعداد؟

يعيش الإعداد كاملاً في ملفات YAML (services.yaml وwidgets.yaml وbookmarks.yaml وsettings.yaml) في الحجم المُسمّى المربوط على /app/config. حرّرها مباشرة على الخادم. تطبّق التغييرات عند إعادة تحميل الصفحة — دون إعادة تشغيل الحاوية.

كم من الذاكرة تحتاج Homepage؟

أقل من 128 ميغابايت للحاوية نفسها. لا قاعدة بيانات مطلوبة. هذا يترك مساحة وافرة حتى على أصغر خطط VPS للخدمات التي تراقبها.

مراقبة البنى التحتية.

Homepage

لوحة تحكم ذاتية الاستضافة — تجمع خدماتك وأدواتك وإشاراتك المرجعية في صفحة واحدة، دون قاعدة بيانات، بأقل من 128 ميغابايت من الذاكرة.

512 ميغابايت ذاكرة عشوائية 1 vCPU المنفذ 3000 قيد التحقق

قيد التحقق

التثبيت التلقائي لهذا الحل جاهز ويخضع حاليًا لاختباراتنا على خادم حقيقي. سيُفتح الطلب فور اكتمال التحقق.

المنظومة التقنية

DockerNext.js

الحد الأدنى من RAM512 ميغابايت

الحد الأدنى من CPU1 vCPU

المنفذ الافتراضي3000

أنظمة التشغيل المتوافقةتوزيعات Linux حسب اختيارك

Homepage (~22 ألف نجمة على GitHub، رخصة Apache 2.0، Next.js) لوحة تحكم ذاتية الاستضافة تجمع كل خدماتك وإشاراتك المرجعية وأدواتك المصغّرة في صفحة واحدة مرتّبة بإتقان. يعيش الإعداد بالكامل في ملفات YAML — الخدمات والإشارات المرجعية والأدوات والإعدادات — مما يمنحك بنية متوافقة مع GitOps تعيد بناءها طبق الأصل في ثوانٍ.

على خادم VPS من ServOrbit، تعمل Homepage في حاوية Docker واحدة بأقل من 128 ميغابايت من الذاكرة دون أي قاعدة بيانات. اربط مقبس Docker للقراءة فقط وتكتشف Homepage حاوياتك الجارية تلقائياً من وسومها، فتحدّث لوحة التحكم دون أي تعديل يدوي. أكثر من 100 تكامل للأدوات المصغّرة — إحصاءات CPU والذاكرة، Proxmox وPlex وGrafana وPi-hole وSonarr وأكثر — تعرض مقاييس حيّة مباشرة على الصفحة.

كل البيانات تبقى على جهازك. لا حسابات خارجية، ولا تحليلات، ولا اتصالات خارجية للخدمة الجوهرية. يُحمَّل الواجهة الأمامية الساكنة Next.js بسرعة على أي اتصال؛ خلف وسيط عكسي مع HTTPS تصبح صفحتك الخاصة المتاحة دائماً لكل ما يعمل في بنيتك التحتية.

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

إعداد مبني على YAML: الخدمات والإشارات المرجعية والأدوات والتخطيط كلها في ملفات نصية تُدار بالإصدارات.

الاكتشاف التلقائي: اربط مقبس Docker وتلتقط Homepage الحاويات من وسومها — دون إدخال روابط يدوياً.

أكثر من 100 تكامل للأدوات: إحصاءات Proxmox وGrafana وSonarr وPi-hole وPlex وqBittorrent وأكثر.

لا قاعدة بيانات: حاوية Next.js واحدة بأقل من 128 ميغابايت — لا Postgres ولا Redis ولا هجرات.

لا قياس عن بُعد: لا شيء يتصل بالخارج — تبقى لوحة التحكم خاصة تماماً.

تحكم كامل بالمظهر: وضع فاتح/داكن، خلفيات مخصصة، حزم أيقونات وموفرو شريط البحث عبر settings.yaml.

Docker Compose: أمر واحد للتشغيل، حجم مُسمّى واحد للإعداد — إعادة تشغيل دون فقدان التخطيط أو بيانات الاعتماد.

أيقونات حالة الصحة: عرض حالة الخدمة (تعمل/معطّلة) بجانب كل إشارة مرجعية بقواعد فحص صحة بسيطة.

متى تستخدم هذا الحل؟

1

مركزة منظومة ذاتية الاستضافة

حين يكون لديك عشرات الحاويات — Nextcloud وJellyfin وGitea وVaultwarden — تغني صفحة Homepage عن كتابة عناوين IP. خطّطها في services.yaml بروابطها وأنواع أدواتها؛ الاكتشاف التلقائي يتكفّل بأي حاوية تحمل وسوماً. كل الخدمات في علامة تبويب واحدة.

2

لوحة قيادة HomeLab مع مقاييس حيّة

تسحب مكتبة أدوات Homepage بيانات حيّة من الخدمات المحلية دون وسيط سحابي. شاهد حمل CPU على Proxmox، وقائمة انتظار Sonarr، ومعدل حجب Pi-hole، واستخدام القرص جنباً إلى جنب في صفحة واحدة. اضبطها مرة؛ تتحدث عند كل تحميل.

3

صفحة إشارات مرجعية مشتركة لفريق على VPS

ضع أدوات الفريق المشتركة — الوثائق الداخلية والمراقبة وCI ومراجعة الكود — على نسخة Homepage خاصة. يفتح الأعضاء رابطاً واحداً بدلاً من البحث عن 'رابط Grafana ذاك' في Slack. صنّف حسب الفريق، وثبّت الخدمات الحيوية، واحفظ bookmarks.yaml في المستودع.

نشر Homepage على خادم VPS الخاص بك

دليل محسّن لخوادم VPS Cloud من ServOrbit.

01

اطلب خادم VPS من ServOrbit

تعمل Homepage على أي خادم VPS تقريباً. خطة 512 ميغابايت كافية لـ Homepage وحدها؛ خطّط للخدمات التي تعمل بجانبها. Ubuntu 24.04 مع Docker هو الصورة الأساسية الموصى بها.

02

انشر من السوق

افتح لوحة ServOrbit ← السوق ← المراقبة ← Homepage ← نشر. يسحب المُنصِّب ghcr.io/gethomepage/homepage:latest، ينشئ حجماً مُسمّى لملفات الإعداد ويشغّل الحاوية على المنفذ 3000 مع ضبط HOMEPAGE_ALLOWED_HOSTS. انتظر نحو 30 ثانية.

03

الوصول عبر نفق SSH

قبل إضافة نطاق، ادخل إلى لوحة التحكم عبر: ssh -L 3000:127.0.0.1:3000 root@<ip> ثم افتح http://localhost:3000. ستظهر الصفحة الافتراضية — هذا يؤكد أن الحاوية تعمل.

04

أضف خدماتك

حرّر /opt/stacks/homepage/config/services.yaml على الخادم. صنّف خدماتك وأدخل الرابط وأيقونة الخدمة وعند الحاجة نوع الأداة المصغّرة لكل خدمة. أعد تحميل المتصفح — لا حاجة لإعادة تشغيل الحاوية.

05

ضعها خلف HTTPS

وجّه نطاقاً فرعياً (مثل home.yourdomain.com) إلى الخادم واضبط وسيطاً عكسياً. مع Caddy: home.yourdomain.com { reverse_proxy localhost:3000 }. حدّث HOMEPAGE_ALLOWED_HOSTS ليطابق النطاق وأعد تشغيل الحاوية. أصبح داشبوردك متاحاً من أي مكان عبر HTTPS.

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

لا. لا تمتلك Homepage مصادقة مدمجة. إنها مصمّمة للوصول الحلقي (loopback) أو عبر VPN. لعنوان URL عام، ضعها خلف وسيط عكسي يضيف HTTP Basic Auth أو استخدم Cloudflare Access أمامها.

حلول تكميلية

المراقبة وقابلية الرصد

لا يمكن طلب Homepage بعد.