SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-11-21

مقایسه نرم‌افزارهای فاکتوردهی self-hosted روی VPS

Invoice Ninja، InvoiceShelf، InvoicePlane، Kimai و ERPNext را از نظر صورتحساب دوره‌ای، مالیات، پورتال مشتری، درگاه پرداخت و شرایط licence مقایسه کنید.

کدام نرم‌افزار فاکتوردهی self-hosted را انتخاب کنید؟

نرم‌افزارهای فاکتوردهی self-hosted به پنج گزینهٔ واقع‌بینانه روی یک VPS محدود می‌شوند که جایگزین‌های نزدیکی برای یکدیگر نیستند. Invoice Ninja کامل‌ترین محصول است: فاکتورهای دوره‌ای، پورتال مشتری، درگاه‌های پرداخت و فرمت‌های فاکتور الکترونیکی، همگی از همان روز نصب کار می‌کنند. InvoiceShelf گزینهٔ سبک‌تر و کاملاً متن‌باز است. InvoicePlane یک برنامهٔ سادهٔ PHP است که نیاز به هیچ‌گونه ارکستراسیون ندارد. Kimai به جای اقلام فاکتور، ساعات کاری ردیابی‌شده را صورت‌حساب می‌کند. ERPNext یک سیستم حسابداری کامل است که قابلیت صدور فاکتور را نیز دارد.

دو مشکل، راه‌اندازی فاکتوردهی self-hosted را بسیار بیشتر از نبود یک قابلیت، با شکست مواجه می‌کنند. اولی ایمیل است. فاکتوری که در پوشهٔ اسپم قرار بگیرد، فاکتوری پرداخت‌نشده است و هیچ‌چیز به شما اطلاع نمی‌دهد که این اتفاق افتاده است. دومی پشتیبان‌گیری (backup) است. این تنها پایگاه‌دادهٔ self-hosted است که از دست دادن آن، به جای یک دردسر ساده، به یک مشکل مالیاتی تبدیل می‌شود.

پیش از خواندن لیست قابلیت‌ها، مجوز (licence) را مطالعه کنید. سه مورد از این پنج گزینه copyleft هستند، یکی permissive است و یکی source-available است که محدودیت‌های واقعی برای نحوهٔ استفاده از آن وجود دارد.

پنج گزینه و مناسب‌بودن هرکدام برای چه کسانی

Invoice Ninja

یک برنامه مبتنی بر Laravel که اکنون در خط v5 قرار دارد. Self-hosting آن رایگان و بدون محدودیت است و امکاناتی مانند فاکتورهای دوره‌ای، پیش‌فاکتورها، پروژه‌ها، ثبت زمان، هزینه‌ها، پورتال مشتری و درگاه‌های پرداخت، از جمله Stripe و PayPal، را ارائه می‌کند. این پروژه خود را «یک برنامه برای فاکتور، پیش‌فاکتور، پروژه و ثبت زمان، ساخته‌شده با Laravel و دارای کد منبع قابل دسترسی» معرفی می‌کند. کاربران self-hosting برای 2 مورد هزینه می‌پردازند. مورد اول برندینگ است. به گفته خود پروژه: «مجوز white-label را با قیمت $40 در سال ارائه می‌کنیم تا برند Invoice Ninja از بخش‌های قابل مشاهده برای مشتری در برنامه حذف شود.» این قیمت در اکتبر 2026 جاری بوده است. مورد دوم، ارسال و دریافت فاکتورهای الکترونیکی از طریق شبکه Peppol است که از طریق پلتفرم میزبانی‌شده خود Invoice Ninja انجام می‌شود و در بخش «آنچه حسابدار شما درخواست خواهد کرد» در ادامه توضیح داده می‌شود.

اگر کامل‌ترین محصول را می‌خواهید و پذیرفته‌اید که بزرگ‌ترین stack را اجرا کنید، این گزینه را انتخاب کنید.

InvoiceShelf

یک fork از Crater است که تحت مجوز GNU Affero General Public License version 3 (AGPL-3.0) منتشر می‌شود. این برنامه فاکتورها، برآوردها، صورتحساب دوره‌ای، هزینه‌ها، مالیات‌ها، چندارزی، پورتال مشتری و چندشرکتی را پوشش می‌دهد. پرداخت‌ها و white-labeling در repositoryهای رسمی جداگانه قرار دارند که هر دو تحت AGPL-3.0 و هر دو رایگان هستند. پرداخت کارتی از طریق Stripe checkout انجام می‌شود. برای محیط production از release پشتیبانی‌شده 2.x استفاده کنید: branch پیش‌فرض 3.x یک پیش‌نمایش alpha است و module پرداخت موجود روی آن اجرا نمی‌شود.

اگر یک برنامه کوچک و کاملاً open source می‌خواهید و به 30 درگاه نیاز ندارید، این گزینه را انتخاب کنید.

InvoicePlane

یک برنامه PHP مبتنی بر CodeIgniter است که تحت مجوز MIT منتشر می‌شود و با unzip کردن فایل‌ها در web root نصب می‌شود. برای release archive به Docker یا مرحله build مربوط به Node نیاز نیست. PDFها با mPDF تولید می‌شوند؛ بنابراین templateها با HTML و CSS ساخته می‌شوند. مشتریان یک guest link برای مشاهده و پرداخت فاکتور دریافت می‌کنند.

پرداخت‌ها قبلاً نقطه‌ضعف آن بودند. InvoicePlane 1.6.0 با Stripe به‌عنوان تنها gateway فعال منتشر شد و همه providerهای دیگر غیرفعال بودند. PayPal در خط 1.6 دوباره اضافه شد: release نسخه 1.6.4 در 19 January 2026 پشتیبانی از PayPal Advanced Credit Cards و Venmo را اضافه کرد و releaseهای 1.6.5، 1.7.1 و 1.7.2 همگی با فعال‌بودن Stripe و PayPal منتشر می‌شوند، درحالی‌که driverهای دیگر غیرفعال باقی می‌مانند. راهنمای نصب همراه با 1.7.2، یعنی release جاری در 28 August 2026، PHP 8.2 یا جدیدتر را درخواست می‌کند و 8.3 و 8.4 را پشتیبانی می‌کند؛ همچنین MariaDB را لازم دارد، درحالی‌که صفحه requirements در wiki پروژه هنوز بازه قدیمی PHP 8.0 تا 8.1 را نشان می‌دهد. یادداشت‌های مربوط به releaseای را که دانلود می‌کنید بخوانید.

اگر از shared hosting یا یک VPS با 512 MB استفاده می‌کنید، این گزینه را انتخاب کنید.

Kimai

یک time tracker تحت AGPL-3.0 است که از timesheetها فاکتور تولید می‌کند. برای هرکسی که بر اساس ساعت کار صورت‌حساب صادر می‌کند، گزینه مناسبی است. templateهای فاکتور به‌صورت فایل‌های DOCX، ODS یا XLSX بارگذاری می‌شوند. مستندات تأیید می‌کنند که این‌ها تنها formatهای پذیرفته‌شده هستند. سپس این فایل‌ها به PDF یا HTML تبدیل می‌شوند. فاکتور را به‌جای نوشتن CSS در یک word processor طراحی می‌کنید و بیشتر افراد این روش را ساده‌تر می‌دانند.

Kimai درگاه پرداخت ندارد و store آن نیز هیچ plugin پرداختی فهرست نکرده است؛ بنابراین PDF را از طریق email ارسال می‌کنید. یک plugin رایگان vendor با نام Customer Portal، آمار مشتری و پروژه و همچنین timesheetها را از طریق یک URL محرمانه به اشتراک می‌گذارد و در صورت تمایل می‌توان آن را با password محافظت کرد؛ اما این plugin timesheetها را نشان می‌دهد، نه فاکتورها. e-invoicing ساختاریافته یک plugin پولی store با نام E-Invoice Plus است که در اکتبر 2026 با قیمت 99 EUR در سال، بدون VAT، فهرست شده است. این plugin profileهای EN16931، Extended و XRechnung 3.0 را در CII یا UBL، نسخه beta از Peppol UBL، و PDFهای ترکیبی ZUGFeRD و Factur-X را پوشش می‌دهد.

اگر فاکتور خروجی زمان ثبت‌شده باشد، این گزینه را انتخاب کنید.

ERPNext

تحت GPL-3.0 منتشر می‌شود و در دسته متفاوتی از نرم‌افزار قرار دارد. sales invoice یکی از انواع سند در یک accounting system کامل است که chart of accounts، journal entry، stock و payroll دارد. زمانی که صدور فاکتور دیگر تمام وظیفه شما نیست، این گزینه مناسب است. برای یک freelancer با 8 مشتری، این نرم‌افزار بیش از حد بزرگ است. راه‌اندازی آن خود یک پروژه جداگانه است که در اجرای ERPNext روی یک VPS پوشش داده شده است.

فاکتورهای دوره‌ای به یک زمان‌بند (scheduler) وابسته هستند که قابل مشاهده نیست

برنامه‌های Invoice Ninja، InvoiceShelf، InvoicePlane و ERPNext همگی قابلیت تولید فاکتورهای دوره‌ای را دارند. Kimai در هستهٔ خود ویژگی فاکتور دوره‌ای ندارد، زیرا در آنجا فاکتور بر اساس ورودی‌های timesheet برای یک دورهٔ زمانی ساخته می‌شود.

حالت شکست در تمام برنامه‌های مبتنی بر Laravel یکسان و بی‌صدا است. فاکتورهای دوره‌ای توسط زمان‌بند Laravel ایجاد می‌شوند که باید هر دقیقه توسط cron با فراخوانی php artisan schedule:run یا توسط یک پردازش طولانی‌مدت php artisan schedule:work فعال شود. اگر چیزی آن را فعال نکند، لیست فاکتورهای دوره‌ای همچنان تاریخ ارسال بعدی را نشان می‌دهد و آن تاریخ به‌سادگی می‌گذرد. هیچ فاکتوری ایجاد نمی‌شود. هیچ خطایی هم ثبت نمی‌شود، زیرا کدی اجرا نشده است.

بنابراین پس از ایجاد اولین فاکتور دوره‌ای، تاریخ ارسال بعدی آن را چند دقیقه جلوتر تنظیم کنید و منتظر بمانید. اگر چیزی ارسال نشد، زمان‌بند در حال اجرا نیست. در نصب Docker، این معمولاً به این معنی است که سرویس یا پردازش زمان‌بند هرگز شروع نشده یا متوقف شده است. در ایمیج‌های فعلی Invoice Ninja و InvoiceShelf، زمان‌بند به‌جای یک سرویس جداگانه، درون کانتینر برنامه اجرا می‌شود، بنابراین لاگ‌های همان کانتینر را باید بررسی کنید.

docker compose ps
docker compose logs --tail 50

هر سرویس در فایل باید وضعیت running را گزارش کند. سرویسی که در وضعیت exited قرار دارد، همان سرویسی است که باید لاگ‌هایش را بخوانید.

ارز چندگانه و مالیات: مواردی که باید پیش از نهایی‌سازی بررسی کنید

لیست ویژگی‌های نرم‌افزارها از عبارت «ارز چندگانه» (multi-currency) معانی بسیار متفاوتی برداشت می‌کنند. این چهار مورد را روی یک نمونه نمایشی (demo) و با استفاده از اعداد واقعی کسب‌وکار خود آزمایش کنید؛ چرا که اشتباه در این بخش، به‌جای شما توسط حسابدارتان کشف خواهد شد.

  1. آیا فاکتور، نرخ ارز اعمال‌شده در تاریخ صدور را ذخیره می‌کند؟ این الزامی است. اگر برنامه، مجموع مبالغ را بر اساس نرخ لحظه‌ای بازمحاسبه کند، گزارش‌های فصل گذشته با هر بار باز کردن تغییر می‌کنند و دفاتر حسابداری شما دیگر با آنچه قبلاً ثبت کرده‌اید، مطابقت نخواهند داشت.
  2. آیا مالیات بر اساس هر ردیف کالا، بر اساس کل فاکتور، یا هر دو اعمال می‌شود؟ نرخ واحد برای کل فاکتور تا زمانی که یکی از ردیف‌ها مشمول نرخ صفر نباشد، مشکلی ایجاد نمی‌کند.
  3. آیا می‌توانید قیمت‌ها را هم به‌صورت «شامل مالیات» و هم «بدون مالیات» وارد کنید؟ تبدیل قیمت‌ها پس از ثبت، باعث ایجاد اختلاف گرد کردن به اندازه یک سنت در هر ردیف می‌شود و این سنت‌ها در طول یک سال انباشته خواهند شد.
  4. سند برای مشتری در کشور دیگری که مشمول مالیات بر ارزش افزوده (VAT) نیست، چه چیزی را نشان می‌دهد؟ شما به درج یادداشت معافیت مالیاتی روی فاکتور نیاز دارید، نه فقط یک عدد صفر در ستون مالیات.

نرم‌افزارهای Invoice Ninja و ERPNext هر چهار مورد را پوشش می‌دهند. InvoiceShelf مالیات و ارز چندگانه را در لیست ویژگی‌های خود دارد. InvoicePlane و Kimai ساده‌تر هستند، بنابراین آن‌ها را با پیچیده‌ترین فاکتور خود آزمایش کنید، نه با ساده‌ترین آن‌ها.

پرتال مشتری و درگاه‌های پرداخت

پرتال مشتری صفحه‌ای است که مشتری در آن فاکتورهای خود را می‌بیند، فایل PDF را دانلود می‌کند و پرداخت را انجام می‌دهد. این قابلیت مهم‌تر از چیزی است که به نظر می‌رسد، چون پیگیری پرداخت از طریق ایمیل زمان بیشتری از شما می‌گیرد تا صدور خود فاکتور.

Invoice Ninja در این زمینه قوی‌تر است و یک پرتال کامل، درگاه‌های متعدد، روش‌های پرداخت ذخیره‌شده و صدور خودکار صورتحساب برای فاکتورهای دوره‌ای ارائه می‌کند. InvoiceShelf پرتال مشتری دارد و checkout مربوط به Stripe را از طریق ماژول پرداخت خود اضافه می‌کند. InvoicePlane برای هر فاکتور یک guest link ایجاد می‌کند و از Stripe و PayPal پشتیبانی می‌کند؛ پشتیبانی از PayPal نیز از نسخه 1.6.4 برقرار شده است. Kimai هیچ درگاه پرداختی ندارد و افزونه رایگان Customer Portal آن به‌جای فاکتورها، timesheetها و آمار را به اشتراک می‌گذارد؛ بنابراین فایل PDF به‌صورت پیوست ارسال می‌شود.

یک نکته دائماً با موضوع دیگری اشتباه گرفته می‌شود. self-host کردن برنامه صدور فاکتور به معنای نگهداری شماره کارت‌ها نیست. در Stripe checkout، مشتری به Stripe هدایت می‌شود و شماره کارت را همان‌جا وارد می‌کند؛ بنابراین VPS شما هرگز شماره کارت را نمی‌بیند. دامنه PCI (payment card industry) شما دقیقاً به این دلیل محدود باقی می‌ماند که فرم پرداخت را خودتان نساخته‌اید. اگر بعداً به بیش از یک پردازشگر پرداخت نیاز داشتید یا خواستید پرداخت‌ها را بر اساس کشور مسیریابی کنید، این موضوع باید در یک لایه جداگانه، مانند orchestration پرداخت self-hosted با Hyperswitch، پیاده‌سازی شود.

کیفیت PDF و قالبی که در نهایت ویرایش خواهید کرد

شما باید این قالب را ویرایش کنید. تمام تنظیمات پیش‌فرض در اینجا، آدرس شما را در موقعیت نادرستی برای کشورتان قرار می‌دهند.

نرم‌افزار Invoice Ninja برای تبدیل قالب‌های HTML و CSS به PDF از یک مرورگر Chrome بدون رابط کاربری (headless) استفاده می‌کند که درون ایمیج بسته‌بندی شده است (Chromium در معماری arm64)؛ به همین دلیل حجم کانتینر زیاد است. برای آن حافظه کافی در نظر بگیرید: مرورگر headless سنگین‌ترین پردازش در این پشته است، بنابراین یک VPS با 1 GB رم برای آن بسیار محدود است. نرم‌افزار InvoicePlane از mPDF استفاده می‌کند که کاملاً مبتنی بر PHP و سبک است، اما به قیمت نادیده گرفتن برخی ویژگی‌های مدرن CSS. نرم‌افزار Kimai رویکرد متفاوتی دارد و از شما می‌خواهد یک فایل DOCX یا ODS آپلود کنید؛ بنابراین طراحی چیدمان توسط کسی انجام می‌شود که از LibreOffice یا Word استفاده می‌کند و ممکن است هرگز یک استایل‌شیت (stylesheet) ننوشته باشد.

اگر طراحی فاکتور برای شما اهمیت دارد و CSS اهمیتی ندارد، رویکرد Kimai برنده است. اگر می‌خواهید قالب در کنترل نسخه (version control) باشد و بتوان تفاوت‌های آن را بررسی کرد (diffable)، رویکرد HTML برنده است.

آیا مجوز اجازه استفاده تجاری از آن را می‌دهد؟

هر پنج نرم‌افزار به شما اجازه می‌دهند برای مشتریان خود فاکتور صادر کنید. تفاوت‌ها زمانی ظاهر می‌شوند که کاری فراتر از این انجام دهید.

Invoice Ninja تحت Elastic License 2.0 منتشر می‌شود. 2 بند اهمیت دارند.

شما نمی‌توانید نرم‌افزار را به‌صورت یک سرویس میزبانی‌شده یا مدیریت‌شده در اختیار اشخاص ثالث قرار دهید؛ در صورتی که آن سرویس دسترسی کاربران را به مجموعه قابل‌توجهی از قابلیت‌ها یا عملکرد نرم‌افزار فراهم کند.
شما نمی‌توانید قابلیت مربوط به license key را در نرم‌افزار جابه‌جا کنید، تغییر دهید، غیرفعال کنید یا دور بزنید.

بنابراین اجرای آن برای کسب‌وکار خودتان مجاز است، اما اجرای نمونه‌هایی برای مشتریان به‌عنوان یک محصول مجاز نیست. بند دوم دلیل آن است که حذف branding با یک مجوز $40 انجام می‌شود، نه با اعمال patch روی source.

InvoiceShelf، Kimai و Crater تحت AGPL-3.0 هستند. استفاده تجاری تحت هر 3 مجوز رایگان است. فروشگاه Kimai برای قابلیت‌هایی که در نصب رایگان وجود ندارند، مانند E-Invoice Plus، custom fields و expense management، pluginهای پولی را با قیمت 99 EUR برای هرکدام در سال عرضه می‌کند. اشتراک pluginها شامل یک مجوز جایگزین دائمی است: نسخه‌های خریداری‌شده پس از لغو اشتراک همچنان کار می‌کنند، اما دریافت update به اشتراک فعال نیاز دارد. تعهد مجوز در section 13 آمده است: اگر کد را تغییر دهید و نسخه تغییر‌یافته خود را از طریق شبکه در اختیار افراد دیگر قرار دهید، باید source تغییرات خود را نیز به آن‌ها ارائه کنید. یک نمونه تغییرنیافته از قبل تحت پوشش source عمومی upstream قرار دارد؛ بنابراین بیشتر self-hosterها هرگز با این الزام مواجه نمی‌شوند.

InvoicePlane تحت MIT است و در این گروه کمترین تعهد را دارد؛ هرچند README آن اشاره می‌کند که نام و logo همچنان متعلق به پروژه باقی می‌مانند.

ERPNext تحت GPL-3.0 است. تغییراتی که توزیع می‌کنید باید به اشتراک گذاشته شوند، اما اجرای خصوصی آن هیچ تعهدی ایجاد نمی‌کند.

این متن، مجوز را توصیف می‌کند و توصیه حقوقی نیست.

آیا پروژه همچنان نگهداری می‌شود؟ لاگ commit را بررسی کنید

Crater چندین سال برنامه محبوب open source برای صدور فاکتور بود و هنوز راهنماهای زیادی آن را پیشنهاد می‌کنند. در تاریخ 10 October 2026، از آخرین commit در شاخه پیش‌فرض آن 1329 روز گذشته بود؛ این commit در 19 February 2023 انجام شده بود.

نمودارGap since the last commit on the default branch, in days, checked 10 October 2026
داده‌های پشت این نمودار
[
  {
    "label": "ERPNext",
    "commit_gap": 0
  },
  {
    "label": "InvoicePlane",
    "commit_gap": 0
  },
  {
    "label": "Kimai",
    "commit_gap": 4
  },
  {
    "label": "InvoiceShelf",
    "commit_gap": 11
  },
  {
    "label": "Invoice Ninja",
    "commit_gap": 22
  },
  {
    "label": "Crater",
    "commit_gap": 1329
  }
]

از میان 6 پروژه موجود در آن بخش، پنج پروژه در چهار هفته پیش از آن بررسی commit داشتند و سه پروژه در هفته پیش از آن commit داشتند. InvoiceShelf همان forkی است که توسعه Crater را ادامه داده است؛ این پروژه نیز تحت همان مجوز AGPL-3.0 و با همان مدل داده منتشر می‌شود. بنابراین انتقال به آن، migration داده است، نه بازنویسی برنامه. InvoiceShelf را نصب کنید، نه Crater را.

نصب هرکدام روی یک VPS

به‌جز InvoicePlane، اجرای همه این برنامه‌ها با Docker Compose ساده‌تر است. اگر با آن آشنا نیستید، ابتدا اولین stack مربوط به Docker Compose روی یک VPS را راه‌اندازی کنید و سپس به اینجا برگردید.

Invoice Ninja مخزن compose مخصوص خود را منتشر می‌کند. دستورالعمل‌های فعلی از شاخه debian آن استفاده می‌کنند و فایل compose در زیردایرکتوری‌ای با همین نام قرار دارد.

git clone https://github.com/invoiceninja/dockerfiles.git -b debian
cd dockerfiles/debian
docker run --rm -it invoiceninja/invoiceninja-debian php artisan key:generate --show

کل خروجی را در APP_KEY موجود در فایل .env آن دایرکتوری کپی کنید و APP_URL واقعی خود را نیز وارد کنید. IN_USER_EMAIL و IN_PASSWORD را هم برای نخستین حساب خود تنظیم کنید، زیرا اگر آن‌ها را خالی بگذارید، ورود با admin@example.com و گذرواژه changeme! به‌صورت پیش‌فرض انجام می‌شود. سپس آن را اجرا کنید.

docker compose up -d

سرویس nginx همراه برنامه، پورت 80 را روی میزبان منتشر می‌کند؛ بنابراین TLS proxy خود را جلوی آن قرار دهید یا این mapping را تغییر دهید. در wizard راه‌اندازی، mysql را به‌عنوان میزبان پایگاه داده وارد کنید، زیرا این نام سرویس در شبکه compose است. localhost در همان بخش به خود container برنامه اشاره می‌کند.

InvoiceShelf فایل‌های compose آماده را برای هر موتور پایگاه داده، به‌صورت جداگانه منتشر می‌کند.

curl -fLO https://raw.githubusercontent.com/InvoiceShelf/docker/master/docker-compose.mysql.yml
mv docker-compose.mysql.yml docker-compose.yml

پیش از اجرای آن فایل را باز کنید. همه گذرواژه‌های موجود در آن placeholder هستند و خود فایل نیز در commentهایش این موضوع را مشخص می‌کند. APP_URL، SESSION_DOMAIN و SANCTUM_STATEFUL_DOMAINS همگی به‌طور پیش‌فرض روی localhost تنظیم شده‌اند و پیش از نخستین ورود، باید hostname واقعی خود را برای هر سه وارد کنید. سپس آن را بالا بیاورید.

docker compose up -d

این برنامه پورت 8090 را روی میزبان منتشر می‌کند و داخل container روی پورت 8080 سرویس می‌دهد. پیش از آن‌که حتی یک client را به آن متصل کنید، یک reverse proxy با TLS (امنیت لایه انتقال) جلوی آن قرار دهید.

فایل compose مربوط به محیط production در Kimai، از مستندات پروژه
services:

  sqldb:
    image: mysql:8.3
    volumes:
      - mysql:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=kimai
      - MYSQL_USER=kimaiuser
      - MYSQL_PASSWORD=kimaipassword
      - MYSQL_ROOT_PASSWORD=changemeplease
    command: --default-storage-engine innodb
    restart: unless-stopped
    healthcheck:
      test: mysqladmin -uroot -p$$MYSQL_ROOT_PASSWORD ping -h 127.0.0.1 --silent
      interval: 10s
      timeout: 5s
      retries: 12
      start_period: 30s

  kimai:
    image: kimai/kimai2:stable
    depends_on:
      sqldb:
        condition: service_healthy
        restart: true
    volumes:
      - data:/opt/kimai/var/data
      - plugins:/opt/kimai/var/plugins
    ports:
      - 8001:8001
    environment:
      - APP_SECRET=your-fantastic-long-random-and-ultra-secure-secret
      - TRUSTED_HOSTS=kimai.example.com
      - ADMINMAIL=admin@example.com
      - ADMINPASS=changemeplease
      - DATABASE_URL=mysql://kimaiuser:kimaipassword@sqldb/kimai?charset=utf8mb4&serverVersion=8.3.0
    restart: unless-stopped

volumes:
  data:
  mysql:
  plugins:

APP_SECRET را به یک رشته تصادفی طولانی که خودتان تولید کرده‌اید و TRUSTED_HOSTS را به دامنه‌ای که واقعاً استفاده خواهید کرد تنظیم کنید. ADMINMAIL و ADMINPASS نخستین administrator را در اولین boot ایجاد می‌کنند؛ بنابراین پس از آن، گذرواژه را در interface تغییر دهید و آن را از فایل حذف کنید.

InvoicePlane برای development و testing، setupهای Docker دارد. برای نصب از archive، ابتدا یک پایگاه داده خالی ایجاد کنید.

sudo mysql -e "CREATE DATABASE invoiceplane CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

archive را از صفحه releases پروژه دانلود کنید، آن را در web root استخراج کنید، ipconfig.php.example را به ipconfig.php کپی کنید و URL خود را طبق commentهای همان فایل در آن تنظیم کنید. سپس https://your-domain.example/index.php/setup را باز کنید و مراحل installer را انجام دهید.

چرا فاکتور شما در پوشهٔ spam قرار می‌گیرد

این همان خطایی است که برای شما هزینه ایجاد می‌کند، در حالی که برنامه با اطمینان گزارش می‌دهد فاکتور ارسال شده است.

ایمیل فاکتور را از IP خود VPS ارسال نکنید. IP جدید VPS سابقهٔ ارسال ندارد و دریافت‌کنندگان بزرگ، به‌طور پیش‌فرض، اولین پیام از یک نشانی ناشناس در محدودهٔ IPهای میزبانی را مشکوک تلقی می‌کنند. ارسال را از طریق یک relay از نوع SMTP (simple mail transfer protocol) انجام دهید که روی دامنه‌ای احراز هویت‌شده قرار دارد. انجام کامل این کار راهنمای جداگانه‌ای است و ارسال قابل‌اعتماد ایمیل از یک برنامهٔ self-hosted relay، رکوردهای DNS و آزمایش را پوشش می‌دهد.

بیشتر پیکربندی‌های فاکتوردهی در نشانی From دچار مشکل می‌شوند. این نشانی باید روی دامنه‌ای باشد که relay شما را مجاز می‌کند. روش ساده برای تضمین این موضوع، استفاده از دامنه‌ای است که کنترل آن را در اختیار دارید و relay شما با DKIM (domainkeys identified mail) برای آن امضا انجام می‌دهد. قرار دادن نشانی خود مشتری در From مؤدبانه به نظر می‌رسد، اما معمولاً تحویل پیام را مختل می‌کند. دستورالعمل‌های Gmail برای فرستندگان می‌گوید یک پیام فقط زمانی از DMARC عبور می‌کند که SPF یا DKIM موفق باشد و دامنهٔ احرازکننده با دامنهٔ موجود در header مربوط به From هم‌راستا باشد. relay شما دامنهٔ شما را احراز هویت می‌کند، نه دامنهٔ مشتری را. این وضعیت فقط از سمت مشتری قابل اصلاح است: مشتری باید relay شما را در رکورد SPF خودش وارد کند یا از طریق آن، امضای DKIM را برای دامنهٔ خود تنظیم کند. Google از هر کسی که از طریق یک provider ارسال می‌کند همین را می‌خواهد: "If you use an email service provider, verify that they authenticate your domain’s email with SPF and DKIM." تا زمانی که مشتری این کار را انجام نداده باشد، پیام از DMARC عبور نمی‌کند و Gmail می‌گوید پیام‌های احراز هویت‌نشده "might be marked as spam or rejected with a 5.7.26 error." چنین رد شدنی به این شکل دیده می‌شود:

550 5.7.26 Unauthenticated email from example.com is not accepted due to domain's DMARC policy

نشانی خودتان را در From نگه دارید و مشتری را در Reply-To قرار دهید. پیش از ارسال هر پیام واقعی، رکوردهای منتشرشدهٔ خود را بررسی کنید.

dig +short TXT example.com
dig +short TXT _dmarc.example.com
dig +short TXT selector1._domainkey.example.com

مورد اول باید یک رکورد SPF (sender policy framework) برگرداند که relay شما را مشخص می‌کند. مورد دوم باید یک سیاست DMARC (domain-based message authentication, reporting and conformance) برگرداند. مورد سوم به selectorای بستگی دارد که relay در اختیار شما گذاشته است. پاسخ خالی یعنی رکورد DKIM وجود ندارد یا با نام نادرست منتشر شده است؛ بنابراین امضای هر پیامی که ارسال می‌کنید در بررسی اعتبار شکست خواهد خورد.

سپس یک فاکتور واقعی به حسابی که در یک provider بزرگ و متعلق به خودتان است ارسال کنید و headerهای خام را بخوانید. dkim=pass و spf=pass در header مربوط به Authentication-Results تنها مدرک قابل‌اتکا هستند. پرچم "sent" خود برنامه فقط نشان می‌دهد که برنامه پیام را به relay تحویل داده است.

پشتیبان‌گیری: تنها پایگاه‌داده‌ای که نباید از دست بدهید

از دست دادن یک مدیا سرور به معنای دانلود مجدد فایل‌هاست. حتی یک سرویس میزبانی شخصی عکس مانند PhotoPrism یا Immich معمولاً نسخه‌ای ثانویه از فایل‌های اصلی را نگه می‌دارد که همچنان روی گوشی موبایلی که آن‌ها را ثبت کرده، موجود است. اما از دست دادن پایگاه‌دادهٔ صورت‌حساب‌ها به این معناست که نمی‌توانید مشخص کنید چه چیزی را صورت‌حساب کرده‌اید، چه مبلغی دریافت کرده‌اید یا چه بدهی‌هایی باقی مانده است. با آن متناسب با اهمیتش برخورد کنید.

از چهار مورد پشتیبان تهیه کنید: پایگاه‌داده، volume ذخیره‌سازی که لوگوها، PDFهای تولیدشده و رسیدهای هزینه را در خود نگه می‌دارد، فایل environment برنامه، و در نهایت PDFهای نهایی که به صورت فایل‌های معمولی ذخیره شده‌اند؛ زیرا یک فایل PDF حتی پس از ده سال، بدون برنامه‌ای که آن را تولید کرده است، باز می‌شود.

اهمیت فایل environment بیش از آن چیزی است که تصور می‌شود. لاراول مقادیر حساس ذخیره‌شده، از جمله اعتبارنامه‌های درگاه پرداخت را با استفاده از APP_KEY موجود در آن فایل رمزنگاری می‌کند. اگر پایگاه‌داده را در کنار یک کلید تازه تولیدشده بازیابی کنید، آن مقادیر رمزگشایی نخواهند شد. صورت‌حساب‌های شما موجود خواهند بود، اما تنظیمات درگاه پرداخت غیرقابل خواندن می‌شوند.

یک خروجی (dump) از پشته InvoiceShelf به این شکل است. سرویس پایگاه‌دادهٔ آن از mariadb:10 استفاده می‌کند، بنابراین ابزار داخل کانتینر mariadb-dump است.

docker compose exec -T database mariadb-dump \
  --user=root --password=YOUR_ROOT_PASSWORD \
  --single-transaction --databases invoiceshelf > invoiceshelf.sql

--single-transaction یک اسنپ‌شات منسجم از جداول InnoDB بدون قفل کردن آن‌ها می‌گیرد، بنابراین برنامه در حین اجرای عملیات dump همچنان به سرویس‌دهی ادامه می‌دهد. -T از تخصیص ترمینال توسط داکر جلوگیری می‌کند؛ در غیر این صورت خروجی تغییر مسیر داده شده (redirected) خراب می‌شود و فایل dump حاصل، قابل import نخواهد بود.

این فایل را طبق یک زمان‌بندی با استفاده از پشتیبان‌های رمزنگاری‌شده restic به فضای ذخیره‌سازی خارج از سایت از سرور خارج کنید و دوره نگهداری (retention) را به اندازه‌ای طولانی تنظیم کنید که بازهٔ زمانی مورد نظر حسابدارتان را پوشش دهد.

سپس آن را بازیابی کنید. dump را در یک کانتینر موقت بالا بیاورید، وارد شوید و صورت‌حساب ماه گذشته را باز کنید. تا زمانی که این کار را یک بار انجام نداده‌اید، نمی‌دانید که آیا پشتیبان‌گیری واقعاً کار می‌کند یا خیر.

آنچه حسابدار شما درخواست خواهد کرد

از یک آموزش، مشاوره مالیاتی نگیرید. مطالب زیر نشان می‌دهد این نرم‌افزار چه خروجی‌هایی می‌تواند تولید کند تا بتوانید این فهرست را به شخصی بدهید که به شما مشاوره می‌دهد.

داده‌های قابل خروجی‌گرفتن. باید بتوانید فاکتورها و پرداخت‌های خود را از رابط کاربری و در قالب CSV خروجی بگیرید، بدون آن‌که به database client نیاز داشته باشید یا تیکت پشتیبانی باز کنید. SQL dump پشتیبان است، نه خروجی؛ چون حسابدار شما نمی‌تواند آن را باز کند.

شماره‌گذاری تغییرناپذیر. شماره فاکتورها باید به‌صورت متوالی پیش بروند و هرگز دوباره استفاده نشوند و هیچ فاصله‌ای در این توالی وجود نداشته باشد. حذف یک فاکتور باعث ایجاد فاصله‌ای می‌شود که سپس باید توضیح داده شود. به‌جای حذف، آن را لغو یا credit کنید؛ همه برنامه‌های این فهرست از این کار پشتیبانی می‌کنند. الزامی‌بودن شماره‌گذاری بدون فاصله به محل ثبت کسب‌وکار شما بستگی دارد و بهتر است این موضوع را زودتر بپرسید.

نگهداری. database dumpها و PDFهای renderشده را تا مدت‌زمانی که مقررات شما تعیین می‌کنند نگه دارید. PDF همان سندی است که واقعاً ارسال شده و اگر فاکتوری مورد اختلاف قرار بگیرد، همین artefact اهمیت دارد.

تاریخچه تغییرات. امکان نمایش این‌که چه کسی و چه زمانی فاکتوری را ویرایش کرده است، ارزشمند است و بیشترین تفاوت میان این برنامه‌ها نیز در همین بخش دیده می‌شود. Invoice Ninja برای هر record یک activity log نگه می‌دارد.

e-invoicing ساختاریافته در بخش‌هایی از اتحادیه اروپا از یک قابلیت اضافی مطلوب به یک الزام واقعی تبدیل شده است. Invoice Ninja قالب‌های رایج را تولید می‌کند و ZUGFeRD و XRechnung، Facturae، FatturaPA و EN16931 عمومی را پوشش می‌دهد؛ بااین‌حال، مستندات آن FatturaPA را آماده استفاده در محیط production نمی‌دانند، زیرا اتصال به SDI ایتالیا فعال نیست. ارسال از طریق شبکه Peppol از یک instance خودمیزبان، از پلتفرم میزبانی‌شده Invoice Ninja عبور می‌کند. طبق مستندات vendor، entity خود را در Invoice Ninja ثبت می‌کنید، این سرویس برای شما یک legal entity ID ایجاد می‌کند، instance شما e-invoiceها را از طریق سرویس آن proxy می‌کند و e-invoiceهای ورودی از طریق cronی دریافت می‌شوند که هر چهار ساعت یک‌بار سرورهای آن را poll می‌کند. صفحه e-invoicing مربوط به Invoice Ninja، دسترسی Peppol را به‌عنوان بخشی از طرح Enterprise ارائه می‌کند؛ این طرح از $18 در ماه شروع می‌شود و 250 اعتبار Peppol دارد که هر submission یک e-invoice مصرف می‌کند. اعتبارهای اضافی با قیمت $50 برای 500 اعتبار یا $100 برای 1,000 اعتبار عرضه می‌شوند و به مدت یک سال معتبرند. نصب‌های self-hosted اعتبار شامل‌شده ندارند و تا تاریخ 15 November 2026 همان بسته‌ها را خریداری می‌کنند. افزونه پولی E-Invoice Plus برای Kimai، EN16931، XRechnung، ZUGFeRD، Factur-X و Peppol را در وضعیت beta پوشش می‌دهد، اما از Facturae یا FatturaPA پشتیبانی نمی‌کند. InvoicePlane یک hook برای e-invoicing دارد، اما هیچ قالبی را در core خود عرضه نمی‌کند: باید templateها را از repository پروژه با نام InvoicePlane-e-invoices اضافه کنید؛ این repository برای ZUGFeRD، Factur-X و UBL نمونه‌هایی دارد. ERPNext، XRechnung، ZUGFeRD و Factur-X را از برنامه رایگان GPL-3.0 با نام eu_einvoice که ALYF ارائه کرده است دریافت می‌کند؛ این پشتیبانی فقط در CII است و UBL یا Peppol را شامل نمی‌شود. InvoiceShelf اکنون از PDFهای hybrid با EN16931 ZUGFeRD / Factur-X، از طریق module رسمی و رایگان E-Invoicing برای پیش‌نمایش alpha نسخه 3.x، پشتیبانی می‌کند؛ بااین‌حال، پروژه همچنان کاربران production را به 2.x هدایت می‌کند. Invoice Ninja تنها گزینه‌ای است که همه این قابلیت‌ها را به‌صورت built-in دارد و اگر در داخل اتحادیه اروپا فاکتور صادر می‌کنید، این قوی‌ترین دلیل واحد برای انتخاب آن است.

FAQ

Crater را نصب کنم یا InvoiceShelf را؟

InvoiceShelf. شاخهٔ پیش‌فرض Crater تا 10 October 2026، به‌مدت 1329 روز هیچ commitی نداشته است و راهنمای مهاجرت خود InvoiceShelf آن را «پروژهٔ Crater که اکنون رها شده است» می‌نامد. InvoiceShelf همان مجوز AGPL-3.0 و همان مدل داده را دارد؛ بنابراین جابه‌جایی بین آن‌ها migration پایگاه داده است، نه بازنویسی. هر راهنمایی که هنوز Crater را پیشنهاد می‌کند، پیش از متوقف‌شدن فعالیت پروژه نوشته شده است.

آیا می‌توانم بدون پرداخت هزینه از Invoice Ninja برای کسب‌وکار خودم استفاده کنم؟

بله. نسخهٔ self-hosted از Invoice Ninja تحت Elastic License 2.0 بدون هزینه کاملاً کاربردی است و شامل recurring invoiceها، client portal و payment gatewayها می‌شود. دو مورد هزینهٔ اضافی دارند. حذف branding مربوط به Invoice Ninja از صفحه‌هایی که مشتری می‌بیند، به white-label licence نیاز دارد؛ این مجوز، طبق عبارت خود پروژه در October 2026، «$40 per year» است. ارسال یا دریافت e-invoice از طریق شبکهٔ Peppol با استفاده از hosted platform مربوط به Invoice Ninja انجام می‌شود. در 15 November 2026، نصب‌های self-hosted باید creditهای Peppol را خریداری کنند و هیچ creditی به‌صورت پیش‌فرض شامل آن‌ها نیست: $50 برای 500 credit یا $100 برای 1,000 credit، با اعتبار یک‌ساله. هر e-invoice ارسالی یک credit مصرف می‌کند. چیزی که این مجوز ممنوع می‌کند، اجرای نرم‌افزار به‌عنوان hosted service برای افراد دیگر است.

چرا emailهای invoice من به پوشهٔ spam می‌روند؟

تقریباً همیشه علت این است که پیام برای دامنهٔ موجود در نشانی From احراز هویت نشده است. پیام را از طریق SMTP relay ارسال کنید، نه مستقیماً از VPS؛ سپس رکوردهای SPF و DMARC را برای دامنهٔ خود منتشر کنید و رکورد DKIM را با selectorای که relay در اختیار شما می‌گذارد اضافه کنید. نشانی خودتان را در From نگه دارید و مشتری را در Reply-To قرار دهید. قرار دادن نشانی مشتری به‌عنوان فرستنده باعث می‌شود پیام در DMARC رد شود، مگر این‌که مشتری relay شما را در رکورد SPF خود مجاز کرده باشد یا از طریق relay برای دامنهٔ خود DKIM signing را راه‌اندازی کرده باشد؛ در غیر این صورت Gmail ممکن است پیام را spam علامت‌گذاری کند یا با خطایی مانند 550 5.7.26 Unauthenticated email from example.com is not accepted due to domain's DMARC policy آن را رد کند. با پیدا کردن dkim=pass و spf=pass در header مربوط به Authentication-Results یک پیام آزمایشی، اصلاح انجام‌شده را تأیید کنید.

اگر بر اساس ساعت صورت‌حساب صادر می‌کنم، کدام‌یک را انتخاب کنم؟

Kimai. این نرم‌افزار ابتدا یک time tracker است؛ بنابراین invoice از entryهای تأییدشدهٔ timesheet تولید می‌شود و line itemها همان کارهایی هستند که ثبت کرده‌اید. templateها فایل‌های DOCX، ODS یا XLSX هستند که آن‌ها را در word processor طراحی می‌کنید؛ این کار از ویرایش CSS ساده‌تر است. در مقابل، Kimai هیچ online paymentی دریافت نمی‌کند. افزونهٔ رایگان Customer Portal آن، timesheetها و آمار پروژه را از طریق یک لینک محرمانه به اشتراک می‌گذارد، اما invoiceها را ارائه نمی‌کند؛ بنابراین PDF را email می‌کنید و وجه را از طریق انتقال بانکی دریافت می‌کنید. Invoice Ninja نیز زمان را ثبت می‌کند و invoice portal کاملی با card payment دارد؛ پس اگر online card payment برای شما مهم‌تر از جزئیات timesheet است، آن را انتخاب کنید.

دقیقاً از چه چیزهایی باید backup بگیرم؟

از database، volume مربوط به storage که logoها و PDFهای تولیدشده را نگه می‌دارد، فایل environment و PDFهای renderشده که به‌صورت فایل‌های معمولی نگهداری می‌شوند. فایل environment همان موردی است که افراد معمولاً فراموش می‌کنند: برنامه‌های Laravel مانند Invoice Ninja و InvoiceShelf، credentialهای ذخیره‌شده را با APP_KEY رمزگذاری می‌کنند؛ بنابراین اگر database را در کنار key تازه‌تولیدشده restore کنید، تنظیمات payment gateway شما قابل‌خواندن نخواهد بود. کل مجموعه را یک بار در یک instance موقت restore کنید و یک invoice قدیمی را باز کنید، چون فقط از این طریق می‌توان فهمید backup کار می‌کند.

آیا این مقاله مفید بود؟