📈 تثبيت Ghostfolio — متتبع ثروة ومحفظة استثمارية ذاتي الاستضافة

انشر Ghostfolio على Ubuntu — لوحة إدارة ثروة مفتوحة المصدر تتتبع الأسهم وصناديق ETF والعملات الرقمية والنقد عبر الحسابات، مع PostgreSQL وRedis.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Ghostfolio مع PostgreSQL وRedis على المنفذ 3334.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/finance/ghostfolio/ghostfolio-ubuntu.sh
chmod +x ghostfolio-ubuntu.sh
sudo bash ghostfolio-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/finance/ghostfolio/ghostfolio-ubuntu.sh

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

chmod +x ghostfolio-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم، يشغّل حاويتي PostgreSQL 15 وRedis 7، يولّد الأسرار المطلوبة، ثم يشغّل Ghostfolio على المنفذ 3334.

sudo bash ghostfolio-ubuntu.sh

4 إنشاء حسابك

افتح المتصفح، انتقل إلى Ghostfolio، وانقر على Get Started لإنشاء أول حساب — يصبح هو حساب المسؤول. احفظ رمز الأمان المُولَّد في مكان آمن:

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

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

المنفذالغرض
3334Web app (host → container 3333)
internalPostgreSQL 15 + Redis 7 (not published)

نظرة عامة

Ghostfolio تطبيق مفتوح المصدر لتتبع الثروة والمحفظة الاستثمارية يجمع استثماراتك — الأسهم وصناديق ETF والعملات الرقمية والسلع والنقد — من عدة وسطاء وبورصات وحسابات في لوحة تحكم موحدة واحدة. مبني بـ Angular وNestJS وPrisma فوق PostgreSQL، يسحب بيانات سوق حية من مزودين مثل Yahoo Finance وCoinGecko لحساب الأداء والتوزيع وصافي الثروة دون الاتصال مباشرة بحسابك البنكي أو الوسيط أبداً.

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

يمنحك Ghostfolio بديلاً خاصاً وذاتي الاستضافة لمتتبعات المحافظ التجارية ولوحات المستشارين الآليين. بما أنه لا يرتبط أبداً بحسابات الوساطة الخاصة بك، تبقى بياناتك المالية بالكامل على سيرفرك الخاص — تدخل المعاملات يدوياً أو عبر استيراد CSV، ويتولى Ghostfolio التسعير وتحويل العملات وحساب الأداء تلقائياً. الاستضافة الذاتية تفتح أيضاً كل ميزة تقدمها خطة Ghostfolio Premium المستضافة، دون أي تكلفة شهرية.

متى تحتاجه

  • تريد لوحة واحدة تُظهر صافي ثروتك عبر عدة وسطاء وبورصات وحسابات نقدية
  • تحتفظ بأصول بعملات مختلفة وتحتاج تحويلاً تلقائياً للحصول على رقم صافي ثروة دقيق
  • تريد التخطيط نحو الاستقلال المالي بحاسبات FIRE وتتبع أداء طويل المدى
  • لا تريد ربط بيانات اعتماد حسابك البنكي أو الوساطة بخدمة سحابية تابعة لطرف ثالث
  • تحتاج تفصيلاً للتوزيع حسب فئة الأصل والقطاع والمنطقة والعملة لرصد التركز الزائد
  • تريد تتبع محفظة يخزن بياناته فقط على بنية تحتية تتحكم بها أنت

من يحتاجه

  • المستثمرون الأفراد الذين يحتفظون بأصول عبر عدة وسطاء ويريدون رؤية موحدة واحدة
  • أتباع حركة FIRE (الاستقلال المالي والتقاعد المبكر) الذين يتتبعون معدل الادخار والوقت المتبقي للهدف
  • حاملو الأصول التقليدية والعملات الرقمية الذين يريدون الأسهم وصناديق ETF والعملات في محفظة واحدة
  • المستخدمون المهتمون بالخصوصية الذين يرفضون ربط بيانات اعتماد الوساطة بتطبيق سحابي خارجي
  • المغتربون والمستثمرون متعددو العملات الذين يحتاجون صافي ثروة دقيقاً محوّلاً بالعملة
  • عشاق الاستضافة الذاتية الذين يشغّلون مختبراً منزلياً ويريدون إضافة تتبع مالي إليه
  • أي شخص كان يستخدم جدول بيانات لتتبع استثماراته ويريد تسعيراً آلياً
  • الأسر الصغيرة التي تدمج حسابات استثمار العائلة في لوحة واحدة مشتركة

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

  • تتبع محفظة متنوعة من الأسهم وصناديق ETF والعملات الرقمية عبر عدة وسطاء في مكان واحد
  • حساب صافي الثروة الحقيقي عبر عملات متعددة بتحويل تلقائي لأسعار الصرف
  • مراقبة توزيع الأصول والتعرض للقطاعات والمناطق لرصد التركز الزائد مبكراً
  • تخطيط جدول زمني لـ FIRE باستخدام الأداء التاريخي ومعدل الادخار المتوقع
  • استيراد سنوات من الصفقات التاريخية عبر CSV لبناء سجل أداء كامل
  • استبدال جدول بيانات استثماري يُدار يدوياً بتسعير ورسوم بيانية آلية

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

  • رؤية محفظة موحدة عبر عدد غير محدود من الحسابات والوسطاء والعملات
  • تسعير أصول تلقائي عبر Yahoo Finance وCoinGecko للأسهم وصناديق ETF والعملات الرقمية
  • رسوم بيانية للتوزيع والتفصيل حسب فئة الأصل والقطاع والمنطقة والعملة
  • حاسبة FIRE تتنبأ بوقت الوصول للاستقلال المالي بناءً على معدل الادخار والعوائد
  • مقاييس عائد عبر أطر زمنية متعددة — اليوم، أسبوعياً، شهرياً، سنوياً، سنة واحدة، خمس سنوات، والأقصى
  • استيراد وتصدير CSV لإدخال المعاملات بالجملة وقابلية نقل البيانات
  • تسجيل دخول برمز رمزي دون الحاجة لبريد إلكتروني أو كلمة مرور، يعزز التصميم القائم على الخصوصية
  • تحليل X-ray يكشف مخاطر التركز الزائد عبر ممتلكاتك

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

  • افتح التطبيق وانقر Get Started لتوليد رمز الأمان الشخصي الخاص بك — احفظه فوراً في مدير كلمات مرور
  • أنشئ أول حساب لك تحت Accounts وحدد له اسماً وعملة ومنصة/وسيط
  • أضف ممتلكاتك بتسجيل معاملات الشراء/البيع يدوياً أو استيراد ملف CSV مُصدَّر من وسيطك
  • انتظر حتى يجلب Ghostfolio بيانات السوق لكل رمز وتأكد من أن الأسعار تُملأ بشكل صحيح
  • راجع صفحتي Allocation وAnalysis للتحقق من التعرض حسب فئة الأصل والقطاع والعملة
  • اضبط عملتك الأساسية تحت Settings حتى يظهر صافي الثروة والأداء بشكل متسق
  • استكشف حاسبة FIRE تحت قسم X-ray لتوقع جدولك الزمني للاستقلال المالي
  • أعدّ وكيلاً عكسياً مع HTTPS إذا كنت تخطط للوصول إلى Ghostfolio من خارج شبكتك المحلية

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

  • ضع Ghostfolio خلف وكيل عكسي مع HTTPS قبل كشفه خارج شبكتك المحلية — البيانات المالية يجب ألا تنتقل عبر HTTP عادي أبداً
  • خزّن رمز الأمان الشخصي الخاص بك في مدير كلمات مرور — إنه الطريقة الوحيدة لتسجيل الدخول ولا يمكن استرجاعه إذا فُقد
  • أبقِ PostgreSQL وRedis على شبكة Docker الداخلية فقط — لا تنشر منافذهما خارجياً أبداً
  • قيّد الوصول إلى السيرفر نفسه، فأي شخص يملك رمز الأمان يحصل على وصول كامل للقراءة والكتابة لبياناتك المالية
  • انسخ قاعدة بيانات PostgreSQL احتياطياً بانتظام لأنها المخزن الدائم الوحيد لمعاملاتك وحساباتك
  • حدّث صورة Ghostfolio Docker باستمرار لتحصل على إصلاحات الأخطاء وتحديثات الأمان
  • استخدم VPN مثل WireGuard بدلاً من كشف Ghostfolio علنياً إذا كنت تحتاج الوصول فقط من أجهزتك الخاصة
  • بدّل أو أعد توليد الأسرار المستخدمة لحاويتي PostgreSQL وRedis إذا اشتبهت أنها تعرضت للكشف يوماً

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

يُنشر تطبيق Ghostfolio على منفذ المضيف 3334 المرتبط بالمنفذ الداخلي 3333 للحاوية. تعمل PostgreSQL وRedis فقط على شبكة Docker الداخلية ولا تُنشران للمضيف أبداً، لذا لا يمكن الوصول إليهما من خارج شبكة Docker افتراضياً. لا تكشف المنفذ 3334 مباشرة للإنترنت أبداً — ضعه خلف وكيل عكسي مع HTTPS، ويُفضّل تقييد الوصول أكثر بـ VPN، لأن Ghostfolio لا يملك مصادقة ثنائية العامل مدمجة.

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

  • انسخ قاعدة بيانات PostgreSQL احتياطياً بانتظام — إنها المصدر الوحيد للحقيقة للحسابات والمعاملات والإعدادات
  • يخزن Redis بيانات ذاكرة تخزين مؤقت فقط ولا يحتاج نسخاً احتياطياً — يمكن إعادة بنائه بأمان بإعادة تشغيل الحاوية
  • صدّر سجل معاملاتك دورياً عبر CSV كنسخة احتياطية محمولة ومقروءة مستقلة عن تنسيق قاعدة البيانات
  • انسخ ملف docker-compose.yml وملفات متغيرات البيئة احتياطياً حتى يمكن إعادة إنشاء الحزمة بشكل مطابق على مضيف جديد
  • خزّن رمز الأمان الشخصي منفصلاً عن نسخ السيرفر الاحتياطية — فقدانه يقفل وصولك حتى لو كانت البيانات سليمة
  • اختبر استعادة نسخة PostgreSQL الاحتياطية على نسخة منفصلة دورياً للتأكد أن النسخة قابلة للاستخدام فعلاً

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

  • فقدان رمز الأمان الشخصي — بما أنه لا يوجد مسار لإعادة تعيين كلمة مرور، فقدانه يعني فقدان الوصول للحساب
  • كشف المنفذ 3334 مباشرة للإنترنت دون وكيل عكسي وHTTPS
  • نشر منفذي PostgreSQL أو Redis خارجياً بدلاً من إبقائهما على شبكة Docker الداخلية
  • توقع أن يتزامن Ghostfolio تلقائياً مع وساطتك — لا يتصل أبداً مباشرة ويتطلب إدخالاً يدوياً أو عبر CSV
  • نسيان نسخ حجم PostgreSQL احتياطياً، مما يؤدي لفقدان كامل للبيانات إذا أُزيلت الحاوية
  • عدم ضبط العملة الأساسية الصحيحة مبكراً، مما يعقّد مقارنات الأداء التاريخي لاحقاً
  • تشغيل الحزمة بدون أحجام دائمة لبيانات PostgreSQL، مما يمحو المعاملات عند كل إعادة تشغيل
  • تجاهل تحديثات الصورة وتفويت إصلاحات أخطاء مزودي بيانات السوق أو منطق الحساب

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

  • الأسعار لا تتحدث — تحقق من أن السيرفر يملك وصولاً صادراً للإنترنت للوصول إلى واجهتي Yahoo Finance وCoinGecko
  • لا يمكن تسجيل الدخول مجدداً — تأكد أنك تستخدم رمز الأمان بالضبط الذي وُلّد عند إنشاء الحساب؛ لا يوجد استرجاع لكلمة مرور
  • الحاوية تفشل في البدء — تحقق من سلامة حاويتي PostgreSQL وRedis أولاً، لأن Ghostfolio يعتمد على جاهزية الاثنتين
  • استيراد CSV يفشل — تحقق من أن ملف CSV يطابق تنسيق الأعمدة المتوقع من Ghostfolio وأن الرموز مُتعرَّف عليها من مزودي التسعير
  • تحويل العملة يبدو خاطئاً — تحقق من ضبط عملتك الأساسية بشكل صحيح تحت Settings ومن تحديث أسعار الصرف
  • أداء اللوحة بطيء — تأكد أن Redis يعمل ويمكن الوصول إليه، لأنه يخزّن بيانات السوق والحسابات مؤقتاً
  • أخطاء 502 أو اتصال خلف وكيل عكسي — تأكد أن الوكيل يوجّه إلى منفذ المضيف 3334 وأن حاوية Ghostfolio تعمل
  • بيانات تاريخية مفقودة بعد استيراد CSV — تحقق من تواريخ المعاملات وتأكد أن مزود التسعير يملك بيانات تاريخية لذلك الرمز تعود لفترة كافية

البدائل

Firefly III مدير مالي شخصي كامل يركز على الميزانية والفواتير والتدفق النقدي بدلاً من أداء الاستثمار. Actual Budget يركز على الميزنة الصفرية بدلاً من تتبع المحفظة. Wallos يتتبع الاشتراكات وليس الاستثمارات. البدائل السحابية التجارية مثل Personal Capital أو Sharesight ترتبط مباشرة بحسابات الوساطة لكنها تتطلب مشاركة بيانات الاعتماد مع طرف ثالث وغالباً ما تفرض رسوم اشتراك للميزات المتقدمة. للمستثمرين الذين يريدون تحديداً أداء المحفظة وتحليل التوزيع وتخطيط FIRE دون ربط بيانات اعتماد الوساطة، Ghostfolio مبني خصيصاً لهذه الفئة.

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

Ghostfolio ليس أداة ميزانية أو تتبع فواتير — استخدم Firefly III أو Actual Budget إذا كنت تحتاج إدارة التدفق النقدي والمصروفات اليومية. لا يتزامن تلقائياً مع وسيطك، فإذا أردت استيراد معاملات تلقائي مباشر دون إدخال يدوي أو رفع CSV، قد تناسبك خدمة تجارية مرتبطة مثل Sharesight رغم انخفاض الخصوصية. كما أنه لا يملك تقارير ضريبية مدمجة لمعظم الدول، لذا ستحتاج أداة منفصلة أو محاسباً لتقديم الإقرارات الضريبية.

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

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

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

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

ما الذي يتتبعه Ghostfolio؟

يتتبع Ghostfolio محفظتك الاستثمارية وصافي ثروتك بالكامل — الأسهم وصناديق ETF والعملات الرقمية والسلع والنقد — عبر حسابات وعملات متعددة، ويعرض الأداء والتوزيع ودخل الأرباح.

كيف أسجل الدخول إلى Ghostfolio؟

يستخدم Ghostfolio رمز أمان شخصياً بدلاً من اسم مستخدم وكلمة مرور. عند النقر على Get Started، يُولَّد هذا الرمز ويجب حفظه. تسجّل الدخول لاحقاً بإدخال الرمز، لذا خزّنه في مدير كلمات مرور.

على أي منفذ يعمل Ghostfolio؟

يربط سكريبت التثبيت منفذ المضيف 3334 بالمنفذ الداخلي 3333 للحاوية، لذا تصل إلى التطبيق عبر http://your-server-ip:3334. تبقى خدمتا PostgreSQL وRedis على الشبكة الداخلية.

هل يتصل Ghostfolio بوساطتي تلقائياً؟

لا. Ghostfolio يضع الخصوصية أولاً ولا يرتبط بحسابات الوساطة الخاصة بك. تسجّل معاملات الشراء والبيع يدوياً أو تستوردها عبر CSV، ويجلب Ghostfolio بيانات السوق لتقييمها.

لماذا يحتاج Ghostfolio إلى Redis؟

يُستخدم Redis كذاكرة تخزين مؤقت لتسريع اللوحة وعمليات البحث عن بيانات السوق. لا يخزّن أي بيانات دائمة، لذا لا يحتاج نسخاً احتياطياً — البيانات الدائمة تعيش في PostgreSQL.