🛠️ تثبيت Beaver Habits — متتبع عادات بسيط ذاتي الاستضافة
انشر Beaver Habits على Ubuntu بـ Docker — متتبع عادات نظيف وبسيط بشبكة مساهمات على طراز GitHub، يخزّن البيانات على القرص، على المنفذ 8220.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/beaverhabits/beaverhabits-ubuntu.sh
chmod +x beaverhabits-ubuntu.sh
sudo bash beaverhabits-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/beaverhabits/beaverhabits-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x beaverhabits-ubuntu.sh
3 تشغيل المثبت
يثبّت السكريبت Docker إن لزم ويُشغّل daya0576/beaverhabits على المنفذ 8220 مع ضبط HABITS_STORAGE على USER_DISK وحفظ البيانات في ./data.
sudo bash beaverhabits-ubuntu.sh
4 سجّل حسابك
افتح Beaver Habits وسجّل حسابك عند أول زيارة، ثم أضف العادات التي تريد تتبعها:
http://<your-server-ip>:8220
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8220 | Web UI (host → container 8080) — register on first visit |
| HABITS_STORAGE | USER_DISK — data kept as files in ./data |
| ./data | All habit history |
نظرة عامة
Beaver Habits متتبع عادات مجاني ومفتوح المصدر وذاتي الاستضافة يقوم على فكرة واحدة: شبكة مساهمات على طراز GitHub تُظهر انتظامك بلمحة واحدة. لا يوجد وضع أهداف، ولا تلعيب، ولا إشعارات — فقط شبكة نظيفة تمتلئ خلاياها كل يوم تُنجز فيه عادة، والفكرة كلها هي عدم كسر السلسلة. يعمل كحاوية Docker واحدة خفيفة مبنية بـ NiceGUI (بايثون وFastAPI وQuasar في الخلفية)، ويخزّن كل عادة وسلسلة كملفات عادية على القرص، دون الحاجة لأي قاعدة بيانات.
لماذا تستخدمه
معظم تطبيقات تتبع العادات تُكدّس تجميد السلاسل ونقاط الخبرة والشارات وإشعارات الدفع حتى يصبح التطبيق نفسه مصدر تشتيت. يتخلى Beaver Habits عمداً عن كل ذلك ويحتفظ بالآلية الوحيدة التي تنجح فعلاً — سجل بصري لأيام متتالية، بأسلوب رسم مساهمات GitHub، يجعل كسر السلسلة أمراً مرئياً وغير مرغوب فيه. ولأنه ذاتي الاستضافة، فبيانات عاداتك — التي قد تكون شخصية جداً — لا تغادر سيرفرك أبداً، ولأنه يخزّن كل شيء كملفات عادية بدلاً من قاعدة بيانات خارجية، فالنشر بأكمله حاوية واحدة دون خدمات إضافية للصيانة.
متى تحتاجه
- تريد بناء عادات يومية أو أسبوعية منتظمة وتجد التطبيقات المُلعّبة بالنقاط والشارات مشتتة أكثر منها محفزة
- تفضل سجلاً بصرياً سريعاً لسلاسلك يشبه رسم مساهمات GitHub
- تريد إبقاء بيانات تتبع عاداتك خاصة على سيرفرك بدلاً من سحابة تطبيق تجاري لطرف ثالث
- تريد تسجيل الدخول من هاتفك كتطبيق على الشاشة الرئيسية دون تثبيت أي شيء من متجر تطبيقات
- تستضيف بالفعل أدوات شخصية أخرى وتريد إضافة خفيفة دون الاعتماد على قاعدة بيانات خارجية
من يحتاجه
- الأفراد الذين يبنون روتيناً يومياً — رياضة، قراءة، تأمل، تدوين — ويريدون متتبعاً بسيطاً خالياً من التشتيت
- المستخدمون المهتمون بالخصوصية الذين لا يريدون تخزين بيانات عاداتهم وسلوكهم في سحابة تطبيق تجاري
- عشاق الاستضافة الذاتية الذين يريدون أداة خفيفة تضيف حاوية واحدة فقط دون قاعدة بيانات خارجية
- من جرّبوا تطبيقات عادات مُلعّبة ووجدوا النقاط وتجميد السلاسل والإشعارات تأتي بنتيجة عكسية
- المطورون الذين يريدون استخدام API المدمجة لتسجيل إنجاز العادات من سكريبتات أو أتمتة أو أدوات ذاتية الاستضافة أخرى
- مستخدمو iOS الذين يريدون تطبيقاً قابلاً للتثبيت على الشاشة الرئيسية دون المرور بمتجر التطبيقات
- المدربون أو شركاء المساءلة الذين يريدون طريقة مشتركة وبسيطة لتصور انتظام شخص ما عبر الزمن
حالات الاستخدام الشائعة
- تتبع عادة يومية للرياضة أو القراءة أو التأمل ومشاهدة السلسلة تنمو كشبكة مساهمات
- تسجيل عدة عادات دفعة واحدة — مثلاً روتين صباحي بعدة مهام يومية صغيرة
- إضافة ملاحظات يومية لإدخال عادة لتسجيل السياق، مثل شعورك بعد التمرين أو ما قرأته
- تثبيت Beaver Habits كتطبيق على الشاشة الرئيسية في iOS لتسجيلات يومية سريعة
- استخدام API المدمجة لتعليم عادة كمُنجزة تلقائياً من سكريبت أو أتمتة أخرى
- مراجعة انتظامك عبر أسابيع أو أشهر بلمحة واحدة دون التنقيب في قوائم أو رسوم بيانية
الميزات الرئيسية
- شبكة مساهمات على طراز GitHub كواجهة أساسية — السجل البصري الوحيد لتاريخ سلاسلك
- بسيط عمداً — بلا أهداف أو تلعيب أو نقاط أو شارات أو إشعارات دفع تحتاج لإدارتها
- بيانات مخزنة كملفات عادية على القرص عند ضبط HABITS_STORAGE على USER_DISK، متفادياً أي قاعدة بيانات خارجية
- REST API مدمجة لإنشاء العادات وتحديثها وسردها وتعليمها كمُنجزة برمجياً
- ملاحظات ووصف يومي مرفق بإدخالات العادة الفردية لسياق إضافي
- قابل للتثبيت كتطبيق ويب مستقل على iOS عبر إضافة إلى الشاشة الرئيسية في Safari عند تفعيل ENABLE_IOS_STANDALONE
- يوم بداية الأسبوع قابل للضبط (FIRST_DAY_OF_WEEK) ليطابق تقويم منطقتك
- مبني بـ NiceGUI على FastAPI، ما يبقي التطبيق بأكمله حاوية واحدة خفيفة
كيفية الاستخدام بعد التثبيت
- افتح http://your-server-ip:8220 وسجّل حسابك — لا يوجد حساب مسؤول افتراضي، أول تسجيل هو من ينشئه
- أنشئ عاداتك الأولى من الشاشة الرئيسية، وأعطِ كل واحدة اسماً قصيراً وواضحاً
- سجّل الدخول يومياً بتعليم كل عادة كمُنجزة — تمتلئ شبكة المساهمات مع بناء السلسلة
- أضف ملاحظة لإدخال يوم معين إذا أردت تسجيل سياق مع عادة مُنجزة
- ثبّت التطبيق على الشاشة الرئيسية في iOS عبر Safari ← مشاركة ← إضافة إلى الشاشة الرئيسية لتجربة تسجيل يومي أقرب لتطبيق أصلي
- إذا كنت تؤتمت التسجيلات، أنشئ وصول API اللازم وراجع دليل API في ويكي المشروع على GitHub
- اضبط FIRST_DAY_OF_WEEK في متغيرات البيئة إذا لم يطابق بداية الأسبوع الافتراضية تفضيلك التقويمي
- ضع الخدمة خلف وكيل عكسي مع HTTPS إذا كنت تخطط للتسجيل من خارج شبكة منزلك
أفضل ممارسات الأمان
- سجّل حسابك فور النشر الأول — النسخة غير المسجلة مفتوحة لأي شخص يصل إليها أولاً
- ضع Beaver Habits خلف وكيل عكسي مع HTTPS، خاصة إذا استخدمت تطبيق الشاشة الرئيسية على iOS من خارج شبكة منزلك
- لا تكشف المنفذ 8220 مباشرة للإنترنت دون TLS — وإلا ستنتقل بيانات تسجيل الدخول بنص عادي HTTP
- استخدم VPN مثل WireGuard للوصول عن بُعد إذا كنت تفضل عدم إدارة وكيل عكسي عام لتطبيق شخصي واحد
- حدّث صورة daya0576/beaverhabits بانتظام للحصول على إصلاحات الأخطاء والأمان
- قيّد من يمكنه التسجيل إذا شارك عدة أشخاص نفس السيرفر، لأن التسجيل الذاتي مفتوح افتراضياً
المنافذ وإعدادات جدار الحماية
يكشف Beaver Habits منفذ ويب واحداً فقط، المنفذ المضيف 8220، المعيّن للمنفذ الداخلي 8080 في الحاوية. لا يوجد منفذ منفصل لـ API أو للمقاييس — نفس المنفذ يخدم واجهة الويب وREST API. ولأن التطبيق يتعامل مع التسجيل الذاتي وبيانات العادات الشخصية دون تحديد معدل مدمج، لا يجب كشف المنفذ 8220 مباشرة للإنترنت دون HTTPS. إذا احتجت وصولاً عن بُعد لتطبيق الشاشة الرئيسية على iOS أو للتسجيل العام بعيداً عن المنزل، ضعه خلف وكيل عكسي مثل Nginx Proxy Manager بشهادة TLS صالحة، أو اتصل عبر VPN بدلاً من فتح المنفذ في الجدار الناري.
النسخ الاحتياطي والصيانة
- انسخ دليل ./data (المعيّن إلى /app/.user/ في الحاوية) الذي يحتفظ بكل عادة وسلسلة وملاحظة كملفات عادية بما أن HABITS_STORAGE مضبوط على USER_DISK
- انسخ docker-compose.yml حتى يمكن إعادة إنشاء الحاوية بنفس الصورة وتعيين المنفذ ومتغيرات البيئة
- بما أنه لا توجد قاعدة بيانات خارجية، النسخ الاحتياطي الكامل هو فقط هذان الأمران — لا حاجة لتفريغ قاعدة بيانات منفصل
- خزّن النسخ الاحتياطية بعيداً عن نفس القرص الذي تعمل عليه الحاوية حتى لا يُفقد كل من البيانات ونسختها الاحتياطية معاً عند تعطل القرص
- اختبر الاستعادة دورياً باستعادة ./data على نسخة احتياطية والتحقق من ظهور عاداتك وتاريخ سلاسلك بشكل صحيح
الأخطاء الشائعة
- فقدان حجم ./data أثناء إعادة النشر — بما أن HABITS_STORAGE هو USER_DISK، فهذا المجلد هو النسخة الوحيدة من كل سلسلة؛ أعد إنشاء الحاوية دون مسحه
- نسيان تسجيل حساب فور الإطلاق الأول، ما يترك النسخة مفتوحة لأي شخص يصل إلى المنفذ 8220 أولاً
- كشف المنفذ 8220 للإنترنت دون وكيل عكسي وTLS، ما يرسل بيانات تسجيل الدخول وبيانات العادات بنص عادي HTTP
- تحميل سكريبت التثبيت من مسار بواصلة — اسم مجلد المستودع الصحيح هو beaverhabits بدون واصلة، خلافاً لمشاريع مشابهة الاسم
- توقع إشعارات تذكير — Beaver Habits صامت عمداً، فالاعتماد عليه لتذكيرك بالتسجيل لن يجدي
- عدم ضبط ENABLE_IOS_STANDALONE قبل محاولة تثبيته كتطبيق شاشة رئيسية على iPhone، ما يمنع عمل التجربة المستقلة بشكل صحيح
استكشاف الأخطاء وإصلاحها
- تعذر الوصول لواجهة الويب — تأكد أن الحاوية تعمل بـ docker ps وأن المنفذ 8220 غير محظور بالجدار الناري أو مستخدم من خدمة أخرى
- اختفى تاريخ العادات بعد إعادة النشر — تحقق أن حجم ./data تم الحفاظ عليه وتعيينه إلى /app/.user/ في الحاوية الجديدة، وليس إعادة إنشائه فارغاً
- تطبيق الشاشة الرئيسية على iOS يفتح في Safari بدلاً من الوضع المستقل — تأكد أن ENABLE_IOS_STANDALONE مضبوط على true وأعد إضافة التطبيق للشاشة الرئيسية بعد التغيير
- تعذر تسجيل حساب جديد — تحقق من سجلات الحاوية بـ docker logs beaverhabits بحثاً عن أخطاء بدء التشغيل، وتأكد أن حجم البيانات له صلاحيات كتابة صحيحة
- الأسبوع يبدأ في يوم خاطئ — عدّل متغير البيئة FIRST_DAY_OF_WEEK وأعد تشغيل الحاوية
البدائل
يحوّل Habitica تتبع العادات إلى لعبة تقمص أدوار بنقاط وشخصيات ومكافآت — جذاب لمن يريد التلعيب، لكنه عكس فلسفة البساطة في Beaver Habits تماماً، وهو حزمة أثقل للاستضافة الذاتية. Loop Habit Tracker تطبيق أندرويد جيد بمفهوم شبكة مساهمات مشابه، لكنه محلي على الجهاز فقط دون سيرفر ذاتي الاستضافة أو مزامنة بين الأجهزة. تطبيقات تجارية مثل TickTick تقدم تجارب جوال مصقولة لكنها تتطلب اشتراكاً وتخزّن بياناتك في سحابتها. لمن يريد تحديداً آلية شبكة السلسلة، ذاتية الاستضافة ومجردة من التلعيب، يبقى Beaver Habits الخيار الأكثر تركيزاً.
متى لا تستخدمه
Beaver Habits بسيط عمداً، فهو ليس خياراً مناسباً إذا أردت تذكيرات أو تلعيباً أو تحليلات مفصلة لعاداتك — هذه الميزات غائبة بالتصميم لا بالإغفال. كما أنه لا يملك نظام صلاحيات متعدد المستخدمين يتجاوز الحسابات الأساسية، فهو غير مبني لفريق أو منصة تدريب تدير عادات أشخاص كثيرين بمستويات وصول مختلفة. إذا كانت الإشعارات هي ما يجعلك فعلياً تلتزم بعادة، فتطبيق جوال يرسل تذكيرات سيخدمك أفضل من أداة تختار الصمت عمداً.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الذي يميز Beaver Habits عن تطبيقات العادات الأخرى؟
ضبط نفسه. يركز على آلية واحدة مثبتة الفعالية — شبكة مساهمات على طراز GitHub تُصوّر سلسلتك — دون نقاط أو شارات أو تلعيب أو إشعارات تنافس على انتباهك.
أين تُخزَّن بيانات عاداتي؟
على القرص، كملفات عادية. HABITS_STORAGE مضبوط على USER_DISK، لذا تعيش كل عادة وسلسلة في مجلد ./data بدلاً من قاعدة بيانات خارجية. هذا يُبقي النشر بسيطاً، لكنه يعني أيضاً أن ./data هو الشيء الوحيد الذي يجب نسخه احتياطياً — فقدانه يصفّر تاريخك بالكامل.
ما المنفذ الذي يستخدمه Beaver Habits؟
المنفذ المضيف 8220، المعيّن للمنفذ الداخلي 8080 في الحاوية. تصفّح المنفذ 8220 على سيرفرك؛ 8080 يُستخدم داخل الحاوية فقط وغير مكشوف مباشرة.
هل يمكنني استخدام Beaver Habits على هاتفي؟
نعم. بتفعيل ENABLE_IOS_STANDALONE يمكنك تثبيته كتطبيق مستقل على iOS عبر إضافة إلى الشاشة الرئيسية في Safari. لتعمل هذه التجربة بشكل موثوق بعيداً عن المنزل، ضع وكيلاً عكسياً بـ TLS أمامه.
هل يرسل Beaver Habits تذكيرات أو إشعارات؟
لا، بالتصميم. الدافع من المفترض أن يأتي من رؤية شبكة المساهمات وعدم الرغبة بكسر السلسلة، لا من إشعارات دفع تُذكّرك بالتسجيل.