💰 تثبيت InvoiceShelf — فوترة ذاتية الاستضافة بسيطة
انشر InvoiceShelf على Ubuntu بـ Docker — تطبيق فوترة ذاتي الاستضافة نظيف للمستقلين والشركات الصغيرة، مع قاعدة بيانات SQLite جاهزة مسبقاً فلا حاجة لإعداد أي قاعدة بيانات، على المنفذ 8193.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/accounting/invoiceshelf/invoiceshelf-ubuntu.sh
chmod +x invoiceshelf-ubuntu.sh
./invoiceshelf-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/accounting/invoiceshelf/invoiceshelf-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x invoiceshelf-ubuntu.sh
3 تشغيل المثبّت
./invoiceshelf-ubuntu.sh
4 فتح واجهة الويب وإكمال الإعداد
http://your-server-ip:8193
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8193 | InvoiceShelf web interface (mapped from container port 80) |
نظرة عامة
InvoiceShelf هو تطبيق فوترة وإصدار فواتير مجاني ومفتوح المصدر مصمم للمستقلين والشركات الصغيرة. إنه نسخة يحافظ عليها المجتمع من مشروع Crater الذي توقف تطويره، أُعيد إحياؤه عام 2024 لتحديث الاعتماديات وإصلاح المشكلات العالقة واستمرار التطوير الفعّال. يعمل بالكامل على سيرفرك الخاص برخصة AGPL-3.0، بدون حدود مستخدمين أو اشتراكات مدفوعة أو تتبع بيانات — تمتلك كل فاتورة وكل سجل عميل بنفسك.
لماذا تستخدمه
يمنح InvoiceShelf المستقلين والشركات الصغيرة سير عمل فوترة احترافي دون تسليم بيانات العملاء والبيانات المالية لمنصة SaaS تابعة لجهة خارجية. يستخدم هذا النشر SQLite بدلاً من MySQL أو PostgreSQL، ما يعني عدم وجود حاوية قاعدة بيانات منفصلة يجب إعدادها، ولا بيانات اعتماد يجب إدارتها، وملف واحد فقط يُنسخ احتياطياً — إعداد أبسط بشكل ملموس من معظم تطبيقات الأعمال ذاتية الاستضافة. تحصل على فواتير وعروض أسعار PDF بعلامتك التجارية، وتتبع للمدفوعات، وتسجيل للمصروفات، وبوابة عملاء، كل ذلك بتكلفة سيرفر افتراضي صغير بدلاً من اشتراك شهري لكل مستخدم.
متى تحتاجه
- تُصدر فواتير للعملاء بانتظام كمستقل أو صاحب شركة صغيرة وتريد سير عمل فوترة احترافي بعلامتك التجارية
- تريد ملكية كاملة لبياناتك المالية وبيانات عملائك بدلاً من تخزينها على منصة SaaS تابعة لجهة خارجية
- سئمت من التسعير القائم على الاشتراك لكل مستخدم أو لكل فاتورة في أدوات الفوترة المستضافة
- تحتاج لتتبع المدفوعات، والمدفوعات الجزئية، والأرصدة المستحقة عبر عملاء متعددين
- تريد نشراً بسيطاً دون إدارة سيرفر MySQL أو PostgreSQL منفصل
- تحتاج لمنح عملائك بوابة ذاتية الخدمة لعرض فواتيرهم ودفعها عبر الإنترنت
من يحتاجه
- المستقلون والمتعاقدون المستقلون الذين يفوترون العملاء على أساس متكرر أو حسب المشروع
- أصحاب الشركات الصغيرة الذين يحتاجون فوترة وتتبع مصروفات أساسي دون نظام محاسبة كامل
- المستشارون والوكالات التي تدير عملاء متعددين وتحتاج مستندات بعلامة تجارية خاصة بكل عميل
- المحاسبون وأمناء الدفاتر الذين يريدون أداة خفيفة لإصدار فواتير نيابة عن عملاء صغار
- عشاق الاستضافة الذاتية الذين يريدون استبدال SaaS مدفوعة للفوترة بشيء يتحكمون فيه بالكامل
- الفرق الصغيرة التي تحتاج حسابات موظفين متعددة بأدوار مختلفة تُصدر فواتير تحت شركة واحدة
حالات الاستخدام الشائعة
- إنشاء وإرسال فواتير وعروض أسعار PDF احترافية للعملاء
- تتبع المدفوعات المستلمة والأرصدة المستحقة لكل عميل وكل فاتورة
- تسجيل مصروفات الأعمال وإنشاء تقارير الأرباح والضرائب
- إعداد فواتير متكررة لعملاء الاشتراك الشهري أو الفوترة بنمط الاشتراك
- منح العملاء بوابة ذاتية الخدمة لعرض سجل الفواتير وإجراء المدفوعات
- إدارة شركات أو كيانات أعمال متعددة من تثبيت واحد
الميزات الرئيسية
- إنشاء فواتير وعروض أسعار مع تصدير PDF قابل للتخصيص بعلامتك التجارية
- تسجيل المدفوعات وتتبعها، بما فيها المدفوعات الجزئية وطرق دفع متعددة
- تتبع المصروفات والضرائب مع تقارير أعمال مدمجة
- فواتير متكررة مجدولة للفوترة الشهرية أو بنمط الاشتراك
- بوابة عملاء يمكنهم من خلالها عرض الفواتير والعروض وسجل المدفوعات
- دعم شركات متعددة مع إعدادات خاصة لكل شركة وقوائم عملاء منفصلة
- أدوار وصلاحيات لأعضاء الفريق الذين يُصدرون فواتير نيابة عن الشركة
- دعم عملات ولغات متعددة للعملاء الدوليين
كيفية الاستخدام بعد التثبيت
- افتح واجهة الويب على http://your-server-ip:8193 وأكمل معالج الإعداد الأولي
- أنشئ حساب المسؤول وأدخل اسم شركتك وعنوانها وشعارها
- اضبط العملة الافتراضية ومعدلات الضريبة وتنسيق ترقيم الفواتير تحت Settings
- أعدّ مزود SMTP تحت Settings → Mail حتى يستطيع InvoiceShelf إرسال الفواتير والعروض بالبريد للعملاء
- أضف أول عملائك وأنشئ فاتورة أو عرض سعر للتأكد من أن إنشاء PDF يعمل بشكل صحيح
- ادعُ أعضاء فريق إضافيين إذا احتاج موظفون آخرون غيرك لإصدار الفواتير
- فعّل بوابة العملاء إذا أردت أن يعرض عملاؤك الفواتير ويدفعونها عبر الإنترنت
- أعدّ وكيلاً عكسياً مع HTTPS قبل مشاركة روابط الفواتير أو رابط البوابة مع العملاء
أفضل ممارسات الأمان
- أكمل معالج الإعداد فوراً بعد التثبيت — نسخة غير مُطالَب بها على IP قابل للوصول دعوة مفتوحة للمهاجمين
- ضع InvoiceShelf خلف وكيل عكسي مع HTTPS حتى لا تُرسَل بيانات تسجيل الدخول والبيانات المالية بنص عادي أبداً
- استخدم كلمة مرور قوية وفريدة لحساب المسؤول لأنه يملك وصولاً كاملاً لجميع الفواتير وبيانات العملاء
- قيّد الوصول للمنفذ 8193 عند جدار الحماية واكشفه فقط عبر الوكيل العكسي
- حافظ على أمان بيانات اعتماد SMTP في إعدادات التطبيق — بدّلها إذا شككت في اختراق السيرفر
- حدّث صورة InvoiceShelf Docker بانتظام لتلقي تصحيحات الأمان
- قيّد حسابات أعضاء الفريق على الموظفين الذين يحتاجون فعلاً وصول الفوترة
- انسخ ملف قاعدة بيانات SQLite احتياطياً قبل كل تحديث تحسباً لضرورة التراجع عن ترحيل
المنافذ وإعدادات جدار الحماية
يستمع InvoiceShelf على المنفذ 8193 على المضيف، والذي يُعيَّن إلى المنفذ 80 داخل الحاوية. يخدم هذا المنفذ كلاً من واجهة الويب وواجهة API التي تستخدمها الواجهة الأمامية، لذا فهو المنفذ الوحيد الذي تحتاج لكشفه. لا تكشف المنفذ 8193 مباشرة للإنترنت أبداً — ضعه خلف وكيل عكسي مثل Nginx Proxy Manager على المنفذ 443 مع شهادة SSL صالحة حتى تُشفَّر بيانات الاعتماد وبيانات الفواتير أثناء النقل. احظر المنفذ 8193 في جدار حماية المضيف لحركة المرور الخارجية واسمح فقط بالوصول المحلي أو الوصول من الوكيل العكسي.
النسخ الاحتياطي والصيانة
- انسخ ملف قاعدة بيانات SQLite احتياطياً داخل وحدة التخزين الدائمة للحاوية — يحتوي كل فاتورة وعميل وسجل دفع
- انسخ دليل تخزين التطبيق احتياطياً، الذي يحتوي شعارات الشركات والمرفقات المرفوعة وفواتير PDF المُنشأة
- انسخ ملف .env و docker-compose.yml احتياطياً حتى يمكن إعادة إنشاء الحاوية بإعدادات متطابقة
- جدوِّل نسخاً احتياطية تلقائية بأداة مثل Duplicati أو مهمة cron بسيطة تنسخ الوحدة إلى تخزين بعيد
- خزّن النسخ الاحتياطية خارج السيرفر — لا ينبغي أبداً أن يعني فشل قرص أو سيرفر واحد فقدان سجل فوترتك
- اختبر استعادة نسخة احتياطية دورياً بتشغيل نسخة والتحقق من سلامة الفواتير والعملاء وسجل المدفوعات
- احتفظ بالسجلات المالية للمدة التي تتطلبها لوائح الضرائب والمحاسبة المحلية لديك، عادةً عدة سنوات
الأخطاء الشائعة
- ترك معالج الإعداد غير مكتمل على نسخة قابلة للوصول عبر الإنترنت، مما يسمح لأي شخص بالمطالبة بحساب المسؤول
- كشف المنفذ 8193 مباشرة للإنترنت بدون وكيل عكسي وHTTPS
- نسيان إعداد SMTP، ما يُعطّل بصمت إمكانية إرسال الفواتير والعروض للعملاء بالبريد
- عدم نسخ ملف قاعدة بيانات SQLite احتياطياً، بافتراض خاطئ أنه لا يوجد ما يُنسخ لعدم وجود سيرفر قاعدة بيانات منفصل
- تشغيل الحاوية بدون سياسة إعادة تشغيل، فتصبح الفوترة غير متاحة بعد إعادة تشغيل السيرفر حتى تُشغَّل يدوياً مجدداً
- تخطي إعدادات العملة والضريبة قبل إنشاء أول الفواتير، ما ينتج عنه إجماليات خاطئة في مستندات العملاء
- مشاركة حساب المسؤول بين الموظفين بدلاً من إنشاء حسابات أعضاء فريق فردية بأدوار مناسبة
استكشاف الأخطاء وإصلاحها
- لا يمكن الوصول لواجهة الويب — تحقق من أن الحاوية تعمل بـ docker ps وأن المنفذ 8193 غير محظور بجدار الحماية
- معالج الإعداد لا يظهر — امسح ذاكرة تخزين المتصفح المؤقتة أو جرّب نافذة تصفح خفي، وتأكد من الوصول لـ IP والمنفذ الصحيحين
- البريد لا يُرسَل — تحقق من مضيف SMTP والمنفذ وطريقة التشفير وبيانات الاعتماد تحت Settings → Mail، وراجع سجلات الحاوية لأخطاء التسليم
- فشل إنشاء فواتير PDF — راجع سجلات الحاوية بحثاً عن امتدادات PHP مفقودة أو أخطاء صلاحيات في دليل التخزين
- فشل تسجيل الدخول بعد إعادة التشغيل — تأكد من أن وحدة التخزين الدائمة مُوصَّلة بشكل صحيح حتى لا تُعاد قاعدة بيانات SQLite لتثبيت جديد
- اختفاء شعار الشركة أو الملفات المرفوعة بعد تحديث — تحقق من أن دليل التخزين مُعيَّن لوحدة دائمة وليس نظام ملفات الحاوية المؤقت
- أداء بطيء مع قائمة عملاء كبيرة — تتعامل SQLite جيداً مع أحجام المستقلين والشركات الصغيرة المعتادة، لكن التثبيتات متعددة الشركات الكبيرة جداً قد تستفيد من صيانة دورية لقاعدة البيانات
البدائل
Invoice Ninja هو البديل الأقرب من حيث المقارنة — أغنى بالميزات بكثير مع تتبع الوقت وتكاملات بوابات دفع أعمق وبوابة عملاء أكثر تطوراً، لكنه تطبيق أثقل في التشغيل والإعداد. Akaunting نظام محاسبة كامل بالقيد المزدوج والفوترة فيه مجرد وحدة من بين وحدات كثيرة — خيار أفضل إذا كنت تحتاج دفاتر أستاذ عامة وتسوية بنكية، وليس مجرد فوترة. Crater، المشروع الذي تفرّع منه InvoiceShelf، تجاوزه إلى حد كبير التطوير النشط لـ InvoiceShelf. للشركات التي تريد تقارير بمستوى محاسبي وليس مجرد فوترة، يغطي Firefly III (التمويل الشخصي) أو Akaunting (محاسبة الأعمال) تلك الحاجة بشكل أفضل. للبساطة الخالصة بدون أي إعداد لقاعدة بيانات، يبقى نشر InvoiceShelf القائم على SQLite أخف خيار في المجموعة.
متى لا تستخدمه
InvoiceShelf ليس نظام محاسبة كاملاً — لا يوفر مسك دفاتر بالقيد المزدوج أو تسوية بنكية أو دفاتر أستاذ عامة، لذا يجب على الشركات ذات الاحتياجات المحاسبية المعقدة النظر في Akaunting أو حزمة محاسبة مخصصة بدلاً منه. كما أنه ليس مصمماً لفرق كبيرة تُصدر آلاف الفواتير شهرياً؛ SQLite موثوقة لأحجام المستقلين والشركات الصغيرة لكن أداة مدعومة بـ MySQL أو PostgreSQL تتوسع بشكل أفضل عند أعداد معاملات عالية. إذا كنت تحتاج تكاملات بوابات دفع عميقة أو تتبع وقت العملاء أو إدارة مشاريع مدمجة مع الفوترة، يقدم Invoice Ninja وظائف مدمجة أكثر مقابل تثبيت أثقل. وإذا كنت تفضل عدم تشغيل أي سيرفر إطلاقاً، تستبدل أداة فوترة SaaS مستضافة التحكم وملكية البيانات بصيانة معدومة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو InvoiceShelf؟
هو تطبيق فوترة ذاتي الاستضافة للمستقلين والشركات الصغيرة، ونسخة يحافظ عليها المجتمع من مشروع Crater. إنه مجاني ومفتوح المصدر برخصة AGPL-3.0، ويمنحك ملكية كاملة لفواتيرك وعملائك وبياناتك المالية.
هل يحتاج MySQL أو PostgreSQL؟
لا — يستخدم هذا النشر SQLite جاهزة مسبقاً، فلا حاجة لحاوية قاعدة بيانات منفصلة يجب إعدادها أو بيانات اعتماد يجب إدارتها. هذا يجعله أسهل بشكل ملحوظ في التشغيل والنسخ الاحتياطي مقارنة بمعظم تطبيقات الأعمال: قاعدة البيانات بأكملها ملف واحد داخل وحدة التخزين الدائمة.
ما المنفذ الذي يستخدمه وما بيانات تسجيل الدخول؟
يعمل InvoiceShelf على المنفذ 8193 على المضيف (مُعيَّن من منفذ الحاوية 80). لا يوجد تسجيل دخول افتراضي — تُكمل معالج إعداد عند الزيارة الأولى ينشئ حساب المسؤول ويجمع بيانات شركتك. افعل ذلك فوراً حتى لا يستطيع أحد آخر المطالبة بحساب المسؤول على نسخة قابلة للوصول.
هل يمكنني إرسال الفواتير بالبريد الإلكتروني؟
نعم، بمجرد إعداد مزود SMTP في إعدادات التطبيق. لا يُرسل InvoiceShelf البريد بنفسه — تُوجّهه إلى خدمة SMTP، ويرسل من خلالها الفواتير والعروض لعملائك. إذا لم تُرسَل الرسائل، فالسبب المعتاد هو إعداد SMTP غير مضبوط أو خاطئ.
كيف يقارن بـ Invoice Ninja؟
Invoice Ninja أغنى بالميزات بشكل ملحوظ — تتبع الوقت، الفواتير المتكررة، بوابات العملاء، وتكاملات بوابات دفع أعمق — لكنه تطبيق أثقل في التشغيل والتعلم. يتنازل InvoiceShelf عن بعض هذا العمق مقابل إعداد أبسط وأسرع مناسب جداً للمستقلين والشركات الصغيرة.