💰 تثبيت Actual Budget — مدير مالية شخصية محلي أولاً

انشر Actual Budget على Ubuntu بـ Docker — تطبيق ميزانية بنظام الأظرف محلي الأولوية وموجّه نحو الخصوصية، مع مزامنة بنكية ودون رسوم اشتراك، على المنفذ 5006.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر سيرفر مزامنة Actual Budget على المنفذ 5006.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Tools/actual-budget/actual-budget-ubuntu.sh
chmod +x actual-budget-ubuntu.sh
sudo bash actual-budget-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Tools/actual-budget/actual-budget-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x actual-budget-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم الأمر، ثم يُشغّل سيرفر مزامنة Actual Budget تلقائياً، ويحفظ كل البيانات في حجم مُركَّب.

sudo bash actual-budget-ubuntu.sh

4 الدخول إلى واجهة الويب

افتح المتصفح وانتقل إلى Actual Budget، ثم أنشئ ملف ميزانيتك الأول واضبط كلمة مرور المزامنة:

http://<your-server-ip>:5006

المنافذ المستخدمة

المنفذالغرض
5006Actual Budget Web UI (HTTP)

نظرة عامة

Actual Budget تطبيق مالية شخصية مجاني ومفتوح المصدر ومحلي الأولوية مبني على نظام الميزانية بالأظرف (خالية المجموع) — كل دولار من الدخل يُخصَّص له غرض قبل إنفاقه. على عكس تطبيقات الميزانية السحابية مثل YNAB، تعيش بيانات ميزانيتك على جهازك الخاص وتُزامَن فقط (اختيارياً بتشفير من طرف إلى طرف) عبر سيرفر Node.js خفيف تستضيفه بنفسك، بحيث لا يحتاج أي طرف ثالث لرؤية معاملاتك أبداً. يدعم الإدخال اليدوي واستيراد الملفات والمزامنة البنكية التلقائية في المناطق المدعومة، إضافة إلى التقارير وجداول المعاملات المتكررة وتنظيف المعاملات القائم على القواعد.

لماذا تستخدمه

يمنحك Actual Budget سير عمل ميزانية بالأظرف حقيقياً على طراز YNAB دون اشتراك شهري إلزامي أو شركة تحتفظ ببياناتك المالية على سيرفراتها. ولأن التطبيق محلي الأولوية، يبقى قابلاً للاستخدام الكامل دون اتصال ولا يتواصل مع سيرفر المزامنة الخاص بك إلا لمزامنة الأجهزة المتعددة — بل يمكنك تفعيل التشفير من طرف إلى طرف حتى لا يرى السيرفر نفسه معاملاتك غير المشفَّرة أبداً. لمن يريد تحكماً صارماً وخالياً من أي وصاية في مكان وجود سجل إنفاقه، تُزيل استضافة Actual Budget ذاتياً كلاً من التكلفة المتكررة ومتطلب الثقة بطرف ثالث.

متى تحتاجه

  • تريد ميزانية بنظام الأظرف خالية المجموع حيث يُخصَّص لكل دولار من الدخل غرض قبل إنفاقه
  • تنتقل بعيداً عن تطبيق ميزانية بالاشتراك مثل YNAB وتريد نفس سير العمل دون رسوم متكررة
  • تريد أن تعيش بياناتك المالية على بنية تحتية تتحكم بها بدلاً من سيرفرات شركة طرف ثالث
  • تحتاج مزامنة الميزانية عبر هاتف ولابتوب وجهاز لوحي يستخدمها نفس الأسرة
  • تريد تشفيراً اختيارياً من طرف إلى طرف بحيث لا يستطيع حتى سيرفرك ذاتي الاستضافة قراءة بيانات معاملاتك
  • أنت مرتاح لاستيراد كشوفات البنك يدوياً أو ربط مزودي مزامنة بنكية مدعومين بدلاً من الاعتماد على مجمّع تجاري تلقائي بالكامل

حالات الاستخدام الشائعة

  • إدارة ميزانية أسرية بفئات أظرف للإيجار والبقالة وأهداف الادخار والإنفاق الحر
  • استيراد المعاملات من ملفات تصدير بنكية بصيغ CSV أو QIF أو OFX أو QFX أو CAMT.053 على جدول منتظم
  • ربط SimpleFIN (أمريكا/كندا) أو Enable Banking (أوروبا) أو Akahu (نيوزيلندا) أو Pluggy (البرازيل) للمزامنة البنكية التلقائية
  • ترحيل سجل ميزانية YNAB4 أو nYNAB موجود مباشرة إلى Actual باستخدام أداة الاستيراد المدمجة
  • إعداد جداول معاملات متكررة للفواتير والاشتراكات بحيث تكون معبأة مسبقاً كل شهر
  • استخدام الـ API لبناء سكريبتات استيراد أو أتمتة مخصصة على بيانات ميزانيتك المحلية

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

  • بنية محلية الأولوية — يعمل التطبيق دون اتصال بالكامل ويُزامن عند إمكانية الوصول للسيرفر
  • ميزانية بالأظرف (خالية المجموع) حيث تترحّل أرصدة الفئات ولكل دولار غرض مُخصَّص
  • تشفير اختياري من طرف إلى طرف بحيث لا يرى سيرفر المزامنة ذاتي الاستضافة بيانات المعاملات غير المشفَّرة أبداً
  • مزامنة بنكية تلقائية عبر SimpleFIN أو Enable Banking أو Akahu أو Pluggy حسب منطقتك
  • استيراد كشوفات بنكية بصيغ CSV وQIF وOFX وQFX وCAMT.053
  • أدوات استيراد مدمجة لـ YNAB4 وnYNAB لترحيل سجل ميزانية كامل
  • تنظيف معاملات قائم على القواعد يصنّف ويعيد تسمية الجهات المستفيدة المتكررة تلقائياً
  • تقارير ومزامنة متعددة الأجهزة مدعومة بحل تعارضات قائم على CRDT، بحيث تندمج التعديلات من أجهزة مختلفة بسلاسة

كيفية الاستخدام بعد التثبيت

  • افتح http://your-server-ip:5006 وأنشئ ملف ميزانيتك الأول أو استعد ملفاً موجوداً
  • اضبط كلمة مرور مزامنة قوية عند الطلب — فهي تحمي الوصول لبيانات ميزانيتك على السيرفر
  • إذا أردت تشفيراً من طرف إلى طرف، فعّله عند إنشاء الميزانية؛ فبدونه يستطيع السيرفر تقنياً قراءة بياناتك
  • أنشئ فئات الأظرف الخاصة بك (إيجار، بقالة، ادخار، إنفاق حر) وحدد أرصدتك الابتدائية
  • اربط مزود مزامنة بنكية متاحاً في منطقتك (SimpleFIN أو Enable Banking أو Akahu أو Pluggy) أو أعدّ استيراداً يدوياً متكرراً
  • ثبّت تطبيق Actual Budget لسطح المكتب أو الهاتف ووجّهه إلى رابط سيرفرك ذاتي الاستضافة لمزامنة أجهزة إضافية
  • أعدّ جداول معاملات متكررة للفواتير المتوقعة بحيث تكون جاهزة للتأكيد كل شهر
  • راجع محرك القواعد دورياً للحفاظ على تصنيف أسماء الجهات المستفيدة والفئات بشكل صحيح تلقائياً مع وصول معاملات جديدة

أفضل ممارسات الأمان

  • لا تكشف المنفذ 5006 مباشرة للإنترنت العام دون وكيل عكسي يوفر HTTPS
  • فعّل التشفير من طرف إلى طرف على ملف ميزانيتك حتى لا يستطيع سيرفر مخترَق كشف بيانات معاملات قابلة للقراءة
  • اضبط كلمة مرور مزامنة قوية وفريدة — فهي الشيء الوحيد الفاصل بين الإنترنت وبياناتك المالية إذا كان المنفذ قابلاً للوصول
  • ضع Actual Budget خلف Nginx Proxy Manager أو VPN مثل WireGuard بدلاً من كشفه مباشرة
  • حافظ على تحديث صورة Docker لالتقاط إصلاحات الأمان فوراً
  • قيّد بيانات اعتماد مزود المزامنة البنكية (رموز SimpleFIN وغيرها) على وصول القراءة فقط حيثما يسمح المزود بذلك
  • احفظ مفتاح أو عبارة التشفير احتياطياً في مكان منفصل عن السيرفر — فقدانها يجعل الميزانية المشفّرة غير قابلة للاسترداد

المنافذ وإعدادات جدار الحماية

يستمع سيرفر مزامنة Actual Budget على المنفذ 5006 افتراضياً، ويخدم كلاً من واجهة الويب وواجهة برمجة المزامنة التي تستخدمها عملاء سطح المكتب والهاتف. يجب ألا يُكشف هذا المنفذ مباشرة للإنترنت عبر HTTP عادي، لأنه يحمل بيانات ميزانيتك وكلمة مرور المزامنة. ضعه خلف وكيل عكسي مثل Nginx Proxy Manager بشهادة TLS صالحة للوصول عن بُعد، أو أبقه قابلاً للوصول فقط عبر VPN مثل WireGuard إذا لم تكن تحتاج المزامنة من خارج شبكة منزلك. على مستوى الجدار الناري، احجب الوصول الوارد إلى المنفذ 5006 من أي جهة عدا الوكيل العكسي أو واجهة VPN.

النسخ الاحتياطي والصيانة

  • انسخ دليل بيانات السيرفر احتياطياً بانتظام — يحتوي على ملف (ملفات) ميزانيتك وسجل المعاملات وبيانات المزامنة الوصفية
  • إذا فعّلت التشفير من طرف إلى طرف، احفظ عبارة التشفير في مكان آمن منفصل — البيانات غير قابلة للاسترداد بدونها
  • استخدم ميزة 'تصدير الميزانية' المدمجة في Actual Budget دورياً للحصول على نسخة محمولة وقابلة للاستعادة يدوياً من ملف ميزانية واحد
  • انسخ docker-compose.yml احتياطياً مع البيانات حتى يمكن إعادة إنشاء إعداد السيرفر الدقيق
  • احفظ النسخ الاحتياطية خارج السيرفر، خاصة قبل ترقيات الإصدار الرئيسية
  • اختبر استعادة كاملة أحياناً: شغّل حاوية جديدة، استعد دليل البيانات، وتأكد أن الميزانية تُحمَّل بشكل صحيح على عميل

الأخطاء الشائعة

  • تخطي التشفير من طرف إلى طرف بافتراض أن السيرفر ذاتي الاستضافة يحمي خصوصية المعاملات تلقائياً
  • كشف المنفذ 5006 للإنترنت دون وكيل عكسي أو TLS، ما يرسل كلمة مرور المزامنة وبيانات الميزانية عبر HTTP عادي
  • فقدان عبارة التشفير، ما يجعل ميزانية مشفّرة من طرف إلى طرف غير قابلة للاسترداد نهائياً — لا توجد إعادة تعيين
  • الاعتماد فقط على ميزة تصدير الميزانية كنسخة احتياطية بدلاً من نسخ دليل بيانات السيرفر الخام أيضاً
  • عدم تحديث صورة Docker بانتظام، ما يفوّت إصلاحات توافق مزودي المزامنة البنكية مع تغيّر واجهات البنوك البرمجية
  • افتراض أن المزامنة البنكية تعمل بنفس الطريقة في كل مكان — توفر المزودين (SimpleFIN وEnable Banking وAkahu وPluggy) يعتمد على المنطقة

استكشاف الأخطاء وإصلاحها

  • لا يمكن ربط جهاز بالسيرفر ← تحقق من رابط السيرفر والمنفذ 5006 وأن كلمة مرور المزامنة تطابق تماماً
  • المزامنة البنكية لا تعمل ← تأكد أن منطقتك لديها مزود مدعوم (SimpleFIN لأمريكا/كندا، Enable Banking لأوروبا، Akahu لنيوزيلندا، Pluggy للبرازيل) وأن الاتصال لم تنتهِ صلاحيته
  • الميزانية لا تُفكّ تشفيرها على جهاز جديد ← تحقق مرتين من عبارة التشفير؛ لا يوجد مسار استرداد إذا كانت خاطئة أو مفقودة
  • استيراد CSV/OFX يتخطى أو يكرر معاملات ← تحقق من تعيين أعمدة التاريخ والمبلغ أثناء الاستيراد وابحث عن قواعد موجودة تسبب تطابقات غير متوقعة
  • الحاوية تفشل في البدء بعد تحديث ← راجع سجلات docker بحثاً عن أخطاء ترحيل وتأكد أن حجم البيانات لم يتلف
  • أجهزة متعددة تُظهر أرصدة متعارضة ← اجبر مزامنة يدوية على كل جهاز؛ عادة ما تحل مزامنة CRDT في Actual هذا تلقائياً بمجرد إعادة اتصال كل الأجهزة
  • واجهة الويب تُحمَّل لكن المزامنة تفشل ← تحقق أن إعداد الرابط الخارجي للسيرفر يطابق العنوان الذي يستخدمه العملاء فعلياً للوصول إليه

البدائل

YNAB (You Need A Budget) هو الأصل التجاري المصقول الذي جعل سير عمل الميزانية بالأظرف هذا شائعاً، لكنه يتطلب اشتراكاً مستمراً ويخزّن بياناتك على سيرفرات YNAB. Firefly III مدير مالية ذاتي الاستضافة أكثر توجهاً نحو المحاسبة بقيد مزدوج، وأنسب لمن يريد تقارير مفصّلة أكثر من طريقة أظرف صارمة. تقدّم Buckets وYNAB4 (نسخة سطح المكتب المتوقفة) ميزانية بالأظرف مشابهة دون اشتراك لكنها تفتقر لمزامنة Actual الحديثة وتطبيقات الهاتف. لأداة ميزانية بالأظرف مجانية ومفتوحة المصدر ومحلية الأولوية بخيارات مزامنة بنكية حقيقية ودون اشتراك، يبقى Actual Budget البديل ذاتي الاستضافة الأقرب لـ YNAB.

متى لا تستخدمه

إذا كنت تريد تجميعاً بنكياً تلقائياً بالكامل عبر أي بنك في العالم تقريباً دون استيراد يدوي أبداً، فقد تغطي خدمة تجارية مثل YNAB أو Monarch Money مؤسسات أكثر مما يدعمه مزودو المزامنة البنكية الإقليميون لـ Actual حالياً. إذا كنت تحتاج محاسبة بقيد مزدوج لعمل صغير بدلاً من ميزانية شخصية بالأظرف، فـ Firefly III مناسب هيكلياً أكثر. تجنّب استضافة Actual Budget ذاتياً إذا لم تكن مستعداً لإدارة النسخ الاحتياطية وعبارة التشفير بنفسك — على عكس خدمة تجارية، لا توجد شركة يمكنها مساعدتك في استرداد ميزانية مشفّرة مفقودة. لمستخدم واحد لا يحتاج مزامنة متعددة الأجهزة إطلاقاً، فإن نسخة Actual لسطح المكتب فقط (دون سيرفر) أبسط من إعداد سيرفر مزامنة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

هل Actual Budget مجاني فعلاً؟

نعم. Actual Budget مفتوح المصدر بالكامل ومجاني للاستضافة الذاتية، دون مستويات اشتراك أو ميزات مقفلة خلف جدار دفع. يقدّم المشروع أيضاً خطة استضافة اختيارية لمن لا يريد الاستضافة الذاتية، لكن كل الميزات متاحة في النسخة المجانية ذاتية الاستضافة.

هل يدعم Actual Budget المزامنة البنكية التلقائية؟

نعم، في المناطق المدعومة. يتصل بـ SimpleFIN لبنوك أمريكا وكندا، وEnable Banking لأوروبا، وAkahu لنيوزيلندا، وPluggy للبرازيل. حيث لا تتوفر المزامنة البنكية، يمكنك استيراد المعاملات يدوياً من ملفات CSV أو QIF أو OFX أو QFX أو CAMT.053.

هل يمكنني الترحيل من YNAB إلى Actual Budget؟

نعم. يتضمن Actual Budget أدوات استيراد مدمجة لكل من YNAB4 (نسخة سطح المكتب المتوقفة) وnYNAB (نسخة الاشتراك الحالية)، تنقل هيكل فئاتك الكامل وسجل معاملاتك.

ممّ يحمي التشفير من طرف إلى طرف؟

عند التفعيل، تُشفَّر بيانات ميزانيتك على جهازك قبل إرسالها لسيرفر المزامنة، بحيث لا يستطيع حتى سيرفر مخترَق أو مُدار بسوء نية قراءة معاملاتك. المقابل هو أنك إذا فقدت عبارة التشفير، لا توجد طريقة لاسترداد الميزانية — لا يستطيع مطورو Actual إعادة تعيينها لك.

هل يمكن لعدة أشخاص مشاركة نفس الميزانية؟

نعم. أي شخص يملك رابط السيرفر وكلمة مرور المزامنة يمكنه ربط عميل والوصول لملف الميزانية المشترك، ما يجعله مناسباً طبيعياً للأزواج أو الأسر التي تدير المالية معاً. لصلاحيات لكل مستخدم أو سجلات تدقيق أبعد من ذلك، ستحتاج أداة أكثر تحكماً بالوصول.