ما الذي يفعله 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
تحضير المجلد وملف .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كتابة ملف 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: {}التشغيل وإنشاء حسابك
شغّل الحزمة وتحقق من نقطة الصحة، التي يجب أن تجيب
app=1وdb=1:docker compose up -d curl -s http://127.0.0.1:3000/api/healthبعد إعداد nginx والشهادة (القسم التالي)، افتح
https://wakapi.example.com/signupوأنشئ حسابك: أول حساب يُنشأ يصبح مسؤولًا.إغلاق التسجيل
بمجرد إنشاء حسابك، أغلق التسجيل وأعد إنشاء الحاوية:
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