Homarr أو Glance: لوحة تحكم self-hosted لخادم VPS

لماذا تحتاج إلى لوحة تحكم مستضافة ذاتيًا على خادم VPS

حالات استخدام عملية

• ‏الصفحة الرئيسية للمتصفح تشير إلى خادمك الخاص: جميع خدماتك بنقرة واحدة.
• ‏عرض الحالة اللحظية لحاويات Docker دون فتح Portainer أو Dozzle.
• ‏تجميع خلاصات RSS وأخبار تقنية (‏Hacker News، ‏Reddit، ‏GitHub releases) على الشاشة ذاتها مع خدماتك.
• ‏وصول مركزي لفريق أو وكالة تتشارك خادم VPS مشتركًا.
• ‏صفحة بداية لمختبرك المنزلي أو بنية التطوير لديك.
• ‏مراقبة خفيفة دون نشر مجموعة كاملة من Grafana/‏Prometheus.

‏Homarr: لوحة تحكم متكاملة بواجهة رسومية

نشر Homarr باستخدام Docker Compose

1. 01

   إنشاء المجلد وملف Compose

   ‏على خادم VPS، أنشئ مجلدًا مخصصًا وملف docker-compose.yml‏:

   mkdir -p /opt/homarr && cd /opt/homarr

   ‏محتوى ملف docker-compose.yml‏:

   services:
     homarr:
       image: ghcr.io/homarr-labs/homarr:latest
       container_name: homarr
       restart: unless-stopped
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
         - ./appdata:/appdata
       environment:
         - SECRET_ENCRYPTION_KEY=your-random-32-char-key
       ports:
         - "7575:7575"

   ‏SECRET_ENCRYPTION_KEY‏ مطلوب: يشفّر Homarr أسرار تكاملاته (رموز API وكلمات المرور) بهذا المفتاح. أنشئ مفتاحًا باستخدام openssl rand -hex 32‏.

2. 02

   توليد مفتاح التشفير

   ‏يتطلب Homarr مفتاحًا سداسي عشريًا مؤلفًا من 64 حرفًا:

   openssl rand -hex 32

   ‏انسخ القيمة إلى SECRET_ENCRYPTION_KEY‏ في ملف Compose. بدون هذا المتغير، ترفض الحاوية الإقلاع.

3. 03

   تشغيل الحاوية

   docker compose up -d

   ‏يصبح Homarr متاحًا على http://your-domain.com:7575‏. عند الدخول الأول، أنشئ حساب المشرف. يتم الإعداد الأولي (البلاطات والسمة والتكاملات) بالكامل من واجهة الويب.

4. 04

   إعداد تكامل Docker

   ‏مقبس Docker‏ (/var/run/docker.sock‏) مثبَّت للقراءة فقط. في واجهة Homarr، انتقل إلى ‏الإعدادات ← التكاملات وأضف تكامل Docker يشير إلى unix:///var/run/docker.sock‏. سيعرض Homarr تلقائيًا حالة (running/stopped) حاوياتك على البلاطات المرتبطة.

5. 05

   إعداد Traefik كبروكسي عكسي

   ‏لعرض Homarr عبر HTTPS، أضف هذه التسميات إلى الخدمة في ملف Compose:

   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.homarr.rule=Host(`dashboard.your-domain.com`)"
     - "traefik.http.routers.homarr.entrypoints=websecure"
     - "traefik.http.routers.homarr.tls.certresolver=letsencrypt"
     - "traefik.http.services.homarr.loadbalancer.server.port=7575"

   ‏احذف كتلة ports‏ إذا كنت تعرضه عبر Traefik فقط.

6. 06

   بديل nginx

   ‏إذا كنت تستخدم nginx، أنشئ ملف vhost‏ /etc/nginx/sites-available/homarr.conf‏:

   server {
       listen 443 ssl;
       server_name dashboard.your-domain.com;
   
       ssl_certificate     /etc/letsencrypt/live/dashboard.your-domain.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/dashboard.your-domain.com/privkey.pem;
   
       location / {
           proxy_pass http://127.0.0.1:7575;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   }

   ‏شهادة Let's Encrypt عبر certbot --nginx -d dashboard.your-domain.com‏.

‏Glance: ملف Go ثنائي وإعداد YAML وبدون قاعدة بيانات

نشر Glance باستخدام Docker

1. 07

   إنشاء المجلد وملف الإعداد

   mkdir -p /opt/glance && cd /opt/glance

   ‏أنشئ ملف glance.yml‏ بسيطًا مع أداة Hacker News وأداة Docker:

   server:
     host: 0.0.0.0
     port: 8080
   
   pages:
     - name: الرئيسية
       columns:
         - size: full
           widgets:
             - type: hacker-news
               title: Hacker News
   
         - size: small
           widgets:
             - type: docker-containers
               title: الحاويات
               collapsed-by-default: false

   ‏يعرض Glance المنفذ ‏8080 افتراضيًا.

2. 08

   التشغيل باستخدام Docker Compose

   ‏أنشئ ملف docker-compose.yml‏:

   services:
     glance:
       image: glanceapp/glance:latest
       container_name: glance
       restart: unless-stopped
       volumes:
         - ./glance.yml:/app/glance.yml:ro
         - /var/run/docker.sock:/var/run/docker.sock:ro
       ports:
         - "8080:8080"

   ‏ابدأ بـ:

   docker compose up -d

   ‏يصبح Glance متاحًا على http://your-domain.com:8080‏.

3. 09

   إضافة أداة الطقس

   ‏أداة weather‏ هي الأبسط في الإعداد — تتطلب موقعًا فقط:

   - type: weather
     title: الطقس
     location: Casablanca, Morocco
     units: metric
     hour-format: 24h

   ‏أضف هذه الكتلة في قسم widgets‏ في العمود الذي تختاره.

4. 10

   إعداد البروكسي العكسي لـ Glance

   ‏مع Traefik، أضف في docker-compose.yml‏:

   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.glance.rule=Host(`glance.your-domain.com`)"
     - "traefik.http.routers.glance.entrypoints=websecure"
     - "traefik.http.routers.glance.tls.certresolver=letsencrypt"
     - "traefik.http.services.glance.loadbalancer.server.port=8080"

   ‏مع nginx، نفس البنية كما في Homarr، مع استبدال المنفذ بـ 8080‏.

5. 11

   إعادة التحميل التلقائية للإعداد

   ‏يراقب Glance ملف إعداده ويعيد التحميل تلقائيًا عند تعديله. لا حاجة لإعادة تشغيل الحاوية بعد كل إضافة أداة — سيعرض docker logs glance -f‏ السطر Config reloaded‏ بعد ثوانٍ.

‏Homarr مقابل Glance: جدول مقارنة

مرّر الجدول أفقيًا

العرض عبر HTTPS مع بروكسي عكسي

استكشاف الأخطاء: الأخطاء الشائعة

أي أداة تختار؟