دليل النشر

Wakapi على VPS: إحصاءات وقت البرمجة على خادمك

انشر على VPS Cloud ←

Wakapi على VPS: إحصاءات وقت البرمجة على خادمك

تقيس إضافات WakaTime وقت البرمجة بدقة، لكنها ترسل كل ملف مفتوح وكل مشروع وكل فرع إلى خدمة خارجية. Wakapi خادم مفتوح المصدر متوافق مع هذه الإضافات نفسها: تغيّر سطرًا واحدًا في الإعدادات فتبقى إحصاءاتك على خادمك الافتراضي. يثبّته هذا الدليل باستخدام Docker Compose، ويغلق التسجيل، وينشره عبر HTTPS خلف nginx، ثم يربط به محررك.

6 دقائق للقراءةعدد الخطوات: 4
المحتويات· ما الذي يفعله Wakapi1/11
  1. 01ما الذي يفعله Wakapi
  2. 02ما الذي يقدمه لك Wakapi
  3. 03WakaTime المستضاف أم Wakapi على خادمك
  4. 04المتطلبات
  5. 05تثبيت Wakapi باستخدام Docker Compose
  6. 06لا تترك التسجيل مفتوحًا
  7. 07نشر Wakapi عبر HTTPS باستخدام nginx
  8. 08ربط محررك
  9. 09قراءة إحصاءاتك والواجهة البرمجية
  10. 10النسخ الاحتياطي والتحديث
  11. 11تثبيت Wakapi بنقرة واحدة على ServOrbit

ما الذي يفعله Wakapi

يستقبل Wakapi «النبضات» (heartbeats) التي ترسلها إضافات WakaTime أثناء البرمجة: الملف والمشروع واللغة والمحرر والجهاز والفرع، كل دقيقتين تقريبًا. ويجمعها في إحصاءات تتصفحها في لوحة ويب وعبر واجهة برمجية متوافقة مع واجهة WakaTime.

المشروع منشور برخصة MIT. وهو تطبيق Go واحد يحفظ بياناته في SQLite افتراضيًا (ويدعم أيضًا MySQL وPostgreSQL). ويستهلك على الخادم نحو 100 ميغابايت من الذاكرة في وضع الخمول.

ما الذي يقدمه لك Wakapi

  • الوقت لكل مشروع ولغة ومحرر وجهاز وفرع — خلال اليوم أو الأسبوع أو أي فترة تختارها.
  • إضافاتك الحالية — VS Code وJetBrains وVim وNeovim وSublime Text: لا يتغير إلا عنوان الخادم.
  • واجهة برمجية متوافقة مع WakaTime — أشرطة الحالة والأدوات التي تقرأ واجهة WakaTime تتجه إلى نسختك.
  • حسابات بالدعوة فقط — تسجيل عام مغلق، وروابط دعوة تُستخدم مرة واحدة وتصلح 24 ساعة.
  • استيراد سجلك — من WakaTime أو من نسخة Wakapi أخرى، من الإعدادات.
  • بيانات تبقى عندك — لا يخرج شيء من الخادم إلا إذا فعّلت الترحيل نحو WakaTime.

WakaTime المستضاف أم Wakapi على خادمك

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

WakaTime (خدمة مستضافة)Wakapi على خادمك
أين تذهب النبضاتخوادم WakaTimeخادمك الافتراضي
إضافات المحررإضافات WakaTimeالإضافات نفسها
مدة حفظ السجلحسب الاشتراكما دمت تحتفظ به
حسابات الفريقحسابات WakaTimeحسابات على نسختك، بالدعوة
رخصة الخادمخدمة مملوكةMIT

المتطلبات

يكفي خادم Ubuntu 24.04 بذاكرة 1 غيغابايت ومعالج افتراضي واحد. تحتاج إلى Docker مع إضافة Compose، وإلى nginx وcertbot على المضيف، وإلى اسم (wakapi.example.com في هذا الدليل) يشير إلى عنوان IP الخادم. ترسل إضافات WakaTime بياناتها عبر HTTPS، فجهّز الشهادة منذ البداية.

تثبيت Wakapi باستخدام Docker Compose

  1. تحضير المجلد وملف ‎.env

    WAKAPI_PASSWORD_SALT هو الملح المضاف إلى كلمات المرور قبل تجزئتها: ولّده مرة واحدة ولا تغيّره أبدًا، وإلا تعذّر على كل الحسابات تسجيل الدخول. يبقى التسجيل مفتوحًا ريثما تنشئ حسابك، ثم يُغلق في الخطوة 4.

    mkdir -p /opt/wakapi && cd /opt/wakapi
    cat > .env <<EOF
    DOMAIN=wakapi.example.com
    WAKAPI_PASSWORD_SALT=$(openssl rand -hex 32)
    WAKAPI_ALLOW_SIGNUP=true
    EOF
    chmod 600 .env
  2. كتابة ملف docker-compose.yml

    تعمل الصورة الرسمية بمستخدم غير مميز وتحفظ قاعدة SQLite في الحجم wakapi-data. لا يُنشر المنفذ إلا على الواجهة المحلية: nginx وحده يواجه الإنترنت. يوقف WAKAPI_LEADERBOARD_ENABLED لوحة الترتيب العامة، ويحصر WAKAPI_INSECURE_COOKIES بقيمة false ملفات تعريف الجلسة في HTTPS.

    services:
      wakapi:
        image: ghcr.io/muety/wakapi:2.18.2
        restart: unless-stopped
        environment:
          WAKAPI_PASSWORD_SALT: "${WAKAPI_PASSWORD_SALT}"
          WAKAPI_PUBLIC_URL: "https://${DOMAIN}"
          WAKAPI_ALLOW_SIGNUP: "${WAKAPI_ALLOW_SIGNUP:-false}"
          WAKAPI_INVITE_CODES: "true"
          WAKAPI_LEADERBOARD_ENABLED: "false"
          WAKAPI_INSECURE_COOKIES: "false"
        ports:
          - "127.0.0.1:3000:3000"
        volumes:
          - wakapi-data:/data
    
    volumes:
      wakapi-data: {}
  3. التشغيل وإنشاء حسابك

    شغّل الحزمة وتحقق من نقطة الصحة، التي يجب أن تجيب app=1 وdb=1:

    docker compose up -d
    curl -s http://127.0.0.1:3000/api/health

    بعد إعداد nginx والشهادة (القسم التالي)، افتح https://wakapi.example.com/signup وأنشئ حسابك: أول حساب يُنشأ يصبح مسؤولًا.

  4. إغلاق التسجيل

    بمجرد إنشاء حسابك، أغلق التسجيل وأعد إنشاء الحاوية:

    sed -i 's/^WAKAPI_ALLOW_SIGNUP=true/WAKAPI_ALLOW_SIGNUP=false/' .env
    docker compose up -d

    يجيب نموذج التسجيل الآن بعبارة «registration is disabled». لإضافة زميل، أنشئ رابط دعوة من إعدادات حسابك («Invite Friends»): صالح لمدة 24 ساعة ويُستخدم مرة واحدة.

لا تترك التسجيل مفتوحًا

نسخة منشورة على نطاق مع WAKAPI_ALLOW_SIGNUP=true تسمح لأي شخص بفتح حساب وتخزين بيانات عليها. أبقِ القيمة false، وادعُ زملاءك برابط، واترك المنفذ على 127.0.0.1.

نشر Wakapi عبر HTTPS باستخدام nginx

أنشئ الملف /etc/nginx/sites-available/wakapi بكتلة الخادم هذه، ثم فعّله برابط رمزي في sites-enabled:

server {
    listen 80;
    server_name wakapi.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

تحقق من الإعداد، وأعد تحميل nginx، واطلب الشهادة؛ يضيف certbot بنفسه كتلة HTTPS والتحويل من HTTP.

sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d wakapi.example.com

ربط محررك

ثبّت إضافة WakaTime في محررك من متجرها المعتاد. في Wakapi، افتح الإعدادات وانسخ مفتاح الواجهة البرمجية، ثم اكتب الملف ~/.wakatime.cfg على جهازك:

[settings]
api_url = https://wakapi.example.com/api
api_key = <API_KEY>

يستنتج عميل WakaTime اسم المشروع من المجلد الجذر لمستودع Git واسم الجهاز من اسم المضيف: تظهر مستودعاتك كما هي في اللوحة، وتميّز بسهولة بين الحاسوب المحمول والمكتبي. ويفرض ملف .wakatime-project في جذر المستودع اسم مشروع آخر، وهو مفيد حين تحمل عدة نسخ اسم المجلد نفسه. ولاستبعاد مجلد حساس، يقبل المفتاح exclude في ~/.wakatime.cfg تعابير نمطية على المسارات.

برمج بضع دقائق وأعد تحميل لوحة Wakapi: تظهر أرقامك الأولى. يخدم الملف نفسه كل الإضافات على الجهاز. ولإرسال بياناتك إلى WakaTime وWakapi معًا، يقبل عميل WakaTime قسم [api_urls] الذي يضيف وجهات أخرى.

قراءة إحصاءاتك والواجهة البرمجية

تعرض اللوحة الوقت لكل مشروع ولغة ومحرر ونظام تشغيل وجهاز وفرع، خلال الفترة المختارة. والأرقام نفسها متاحة عبر الواجهة المتوافقة مع WakaTime، بمصادقة Basic باستخدام مفتاح الواجهة مرمّزًا بـ base64:

curl -s https://wakapi.example.com/api/compat/wakatime/v1/users/current/statusbar/today \
  -H "Authorization: Basic $(printf %s '<API_KEY>' | base64)"

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

النسخ الاحتياطي والتحديث

كل البيانات في الحجم wakapi-data. أوقف الحاوية أثناء نسخ قاعدة SQLite لتكون النسخة متسقة:

cd /opt/wakapi
docker compose stop wakapi
docker run --rm -v wakapi_wakapi-data:/data -v "$PWD":/backup alpine:3.22 \
  tar czf /backup/wakapi-$(date +%F).tar.gz -C /data .
docker compose start wakapi

للتحديث، اقرأ أولًا ملاحظات الإصدار على GitHub، وخذ نسخة احتياطية، ثم غيّر وسم الصورة:

cd /opt/wakapi
sed -i 's|wakapi:2.18.2|wakapi:<NEW_VERSION>|' docker-compose.yml
docker compose pull && docker compose up -d

تثبيت Wakapi بنقرة واحدة على ServOrbit

على خادم ServOrbit، يُثبَّت Wakapi من المتجر. ينشر السكربت الصورة الرسمية، ويولّد كلمة مرور المسؤول وملح التجزئة، وينشئ حساب admin، ويغلق التسجيل العام ويوقف لوحة الترتيب العامة، ثم يضبط الوكيل العكسي nginx عبر HTTPS — على نطاق فرعي لأحد نطاقاتك أو على النطاق الفرعي المجاني للخادم. تسجّل الدخول باسم المستخدم admin وكلمة المرور المعروضة في مساحة العميل، ثم تربط محررك كما في الأعلى.

شارك هذا المقالservorbit.com/ma-ar/المدونة/استضافة-wakapi-على-vps