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

آموزش نصب ERPNext روی VPS با Docker

راهنمای کامل نصب ERPNext با استفاده از Docker Compose و مدیریت 11 کانتینر. نکات کلیدی شامل تنظیم TLS، پیکربندی ایمیل، نسخه ثابت image و تست بازیابی دیتابیس برای پایداری سیستم.

آنچه برای اجرای آن ثبت‌نام می‌کنید

میزبانی شخصی ERPNext روی یک VPS یک وظیفه عملیاتی است، نه یک نصب با یک دستور ساده. پشته رسمی Docker Compose شامل یازده کانتینر است و دفتر کل عمومی و سوابق مشتریان شما را نگهداری می‌کند. این موضوع استاندارد همه موارد زیر را بالا می‌برد: پشتیبان‌گیری تا زمانی که آن را بازیابی نکرده‌اید، پشتیبان محسوب نمی‌شود و یک image tag بدون نسخه ثابت (unpinned)، یک مهاجرت دیتابیس است که در انتظار وقوع است.

چند نام در سراسر این راهنما تکرار می‌شوند. ERPNext برنامه تجاری است. Frappe چارچوب پایتونی است که در زیر آن قرار دارد. Bench ابزار خط فرمانی است که سایت‌ها را مدیریت می‌کند و از قبل داخل کانتینرها نصب شده است. یک سایت یک مستأجر است: یک دیتابیس MariaDB به همراه یک دایرکتوری از فایل‌های آپلود شده. تقریباً هر دستوری در اینجا bench داخل کانتینر backend و علیه یک سایت مشخص اجرا می‌شود.

این راهنما از مخزن frappe_docker استفاده می‌کند که همان پیاده‌سازی مورد تأیید پروژه است. تمام دستورات زیر در آگوست 2026 با آن مخزن بررسی شده‌اند. اگر Docker Compose برای شما جدید است، اجرای Docker Compose روی یک VPS مبانی مورد نیاز این راهنما را پوشش می‌دهد.

یک VPS چقدر برای ERPNext نیاز است؟

نمودارCommon published ERPNext sizing tiers (guidance, not a measurement)
داده‌های پشت این نمودار
[
  {
    "label": "Evaluation",
    "vcpu": 2,
    "ram_gb": 4,
    "disk_gb": 40
  },
  {
    "label": "Small production",
    "vcpu": 4,
    "ram_gb": 8,
    "disk_gb": 100
  },
  {
    "label": "Room to grow",
    "vcpu": 4,
    "ram_gb": 16,
    "disk_gb": 160
  }
]

راهنمای منتشرشده، پیش از ورود حتی یک کاربر، با 2 vCPU و 4 GB RAM شروع می‌شود. این سطح، tier ارزیابی است. این مقادیر نقطه شروع هستند، نه اندازه‌گیری‌های انجام‌شده در این راهنما؛ حجم واقعی اسناد شما عدد نهایی را تعیین می‌کند. ردیف آخر اصلاً حداقل منتشرشده نیست. این مقدار تقریباً نقطه‌ای است که پس از آن، حافظه دیگر به مسئله‌ای که دائماً به آن فکر کنید تبدیل نمی‌شود.

درباره پلن‌های کوچک با خودتان صریح باشید. یک VPS با 1 GB یا 2 GB ابتدا stack را اجرا می‌کند، اما در نخستین import یا نخستین گزارش طولانی از کار می‌افتد؛ زیرا 10 container در حال اجرای طولانی، buffer pool مربوط به MariaDB و یک worker پایتون که در حال ساخت گزارش است، در این مقدار حافظه جا نمی‌شوند. این خرابی به‌صورت graceful رخ نمی‌دهد. kernel out of memory killer یک container را متوقف می‌کند و سپس docker inspect مربوط به آن، "OOMKilled": true را با exit code 137 نشان می‌دهد. اگر یک worker در میانه اجرای job متوقف شود، سند submit‌شده‌ای باقی می‌ماند که کار background آن نیمه‌تمام است.

برای شرکتی که هر روز از ERPNext استفاده می‌کند، 8 GB RAM، 4 vCPU و 100 GB فضای SSD، حداقل واقع‌بینانه است. RAM زودتر تمام می‌شود. فضای disk سریع‌تر از انتظار رشد می‌کند، زیرا هر attachment و هر backup محلی روی همان volume پایگاه داده ذخیره می‌شود.

یازده container و وظیفه هرکدام

پس از بالا آمدن stack و اجرای ده container، docker compose ps را اجرا کنید. یک container دیگر، یعنی configurator، کار خود را یک‌بار انجام می‌دهد و خارج می‌شود؛ مجموع یازده container از اینجا می‌آید.

  • backend برنامه Frappe را با gunicorn اجرا می‌کند. bench در همین container قرار دارد.
  • frontend همان nginx است. این سرویس assetهای static را ارائه می‌کند و همه درخواست‌های دیگر را به backend می‌فرستد.
  • queue-short و queue-long workerهای RQ (Redis Queue) هستند. آن‌ها jobهای پس‌زمینه مانند ایمیل خروجی، import و ساخت report را اجرا می‌کنند.
  • scheduler jobهای زمان‌بندی‌شده را اجرا می‌کند؛ از جمله reportهای زمان‌بندی‌شده و سندهای auto repeat.
  • websocket فرایند socket.io در پشت live updateهای مرورگر است.
  • db همان MariaDB است.
  • redis-cache و redis-queue دو instance جداگانه از Redis هستند؛ یکی برای cache و دیگری برای job queue.
  • proxy همان Traefik است که override مربوط به HTTPS آن را اضافه می‌کند. این سرویس مالک پورت‌های 80 و 443 است و گواهی‌ها را دریافت می‌کند.

یادگیری این تفکیک ارزشمند است، چون مشخص می‌کند کدام log را باید بخوانید. ایمیل گیرکرده مشکل worker صف است؛ بنابراین docker compose logs -f queue-short command مناسب است. صفحه‌ای که بارگذاری می‌شود اما badge اعلان آن هرگز به‌روزرسانی نمی‌شود، مشکل websocket دارد. خواندن logهای backend برای هرکدام از این دو مشکل، یک بعدازظهر کامل را هدر می‌دهد.

نصب با فایل‌های compose مربوط به production، نه نسخهٔ نمایشی

مخزن، pwd.yml را ارائه می‌کند و README نیز صریحاً دربارهٔ آن هشدار می‌دهد: «این setup فقط برای ارزیابی‌های کوتاه‌مدت در نظر گرفته شده است. نمی‌توانید برنامه‌های سفارشی را روی این setup نصب کنید.» از آن برای بررسی ERPNext در یک بعدازظهر استفاده کنید. شرکت خود را روی آن اجرا نکنید.

sudo apt update && sudo apt install -y git
curl -fsSL https://get.docker.com | bash
git clone https://github.com/frappe/frappe_docker
cd frappe_docker
mkdir -p ~/gitops
cp example.env ~/gitops/erpnext.env

~/gitops/erpnext.env را باز کنید و 4 مقدار را تغییر دهید. ERPNEXT_VERSION برچسب image را ثابت می‌کند. DB_PASSWORD در فایل نمونه به‌صورت 123 ارائه شده است. SITES_RULE قانون مسیریابی Traefik است و LETSENCRYPT_EMAIL هشدارهای گواهی را دریافت می‌کند.

ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.com

اکنون یک فایل compose تولید کنید و سپس آن را اجرا کنید.

docker compose --project-name erpnext \
  --env-file ~/gitops/erpnext.env \
  -f compose.yaml \
  -f overrides/compose.mariadb.yaml \
  -f overrides/compose.redis.yaml \
  -f overrides/compose.https.yaml \
  config > ~/gitops/erpnext.yaml

docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d

config هیچ چیزی را شروع نمی‌کند. این دستور فایل پایه را با overrideها ادغام می‌کند و نتیجه را در حالی چاپ می‌کند که همهٔ متغیرها از قبل جایگزین شده‌اند. سپس همان فایل تولیدشده را اجرا می‌کنید. این مرحلهٔ اضافی ارزش خود را دارد: stack در حال اجرا یک فایل واحد است که می‌توانید آن را بخوانید و commit کنید؛ بنابراین وقتی کسی فایل env را ویرایش می‌کند یا repository را pull می‌کنید، در حین اجرا تغییر نخواهد کرد. نحوهٔ ادغام چند فایل Docker Compose قوانین override را با جزئیات توضیح می‌دهد.

منتظر بمانید تا db شروع شود و configurator خارج شود؛ این کار چند ثانیه طول می‌کشد. سپس site را ایجاد کنید.

docker compose --project-name erpnext exec backend \
  bench new-site --mariadb-user-host-login-scope=% \
  --db-root-password '<your DB_PASSWORD>' \
  --install-app erpnext \
  --admin-password '<a strong admin password>' \
  erp.example.com

آن را بررسی کنید:

docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-apps

list-apps باید frappe و erpnext را همراه با نسخه‌هایشان چاپ کند. یک ps سالم باید 10 سرویس را در وضعیت running و هیچ سرویسی را در وضعیت restarting نشان دهد.

در این مرحله معمولاً 2 مشکل رخ می‌دهد. --mariadb-user-host-login-scope=% در Docker اختیاری نیست. container برنامه از طریق شبکهٔ Docker به MariaDB متصل می‌شود؛ بنابراین به‌عنوان یک میزبان راه دور شناسایی می‌شود و کاربری از پایگاه داده که دسترسی آن به localhost محدود شده است، نمی‌تواند از آنجا وارد شود. در نتیجه، ایجاد site با خطای دسترسی MariaDB رد می‌شود و نام کاربر root در خطا می‌آید. محدودهٔ % به کاربر site جدید اجازه می‌دهد از هر میزبانی در آن شبکهٔ خصوصی دسترسی داشته باشد.

مشکل دوم نام site است. frontend به‌طور پیش‌فرض بر اساس header مربوط به HTTP Host، site موردنظر برای ارائه را انتخاب می‌کند؛ بنابراین siteای که با نام erpnext ایجاد شده است، در erp.example.com قابل دسترسی نیست، حتی اگر هر دو site وجود داشته باشند. همانند مثال بالا، نام site را بر اساس دامنه انتخاب کنید یا FRAPPE_SITE_NAME_HEADER را در فایل env روی نام site تنظیم کنید و فایل compose را دوباره تولید کنید.

HTTPS و پیش‌نیازهای عملکرد آن

پیکربندی compose.https.yaml، سرویس Traefik را روی پورت 443 اجرا می‌کند، ترافیک پورت 80 را به آن هدایت کرده و گواهی‌های لازم را از Let's Encrypt درخواست می‌کند. پروتکل TLS (امنیت لایه انتقال) مانع از آن می‌شود که فاکتورها و کوکی‌های نشست (session cookie) به‌صورت متن ساده در شبکه منتقل شوند.

دو شرط باید برقرار باشد تا گواهی صادر شود. رکورد DNS A برای erp.example.com باید از قبل به VPS اشاره کند. پورت‌های 80 و 443 باید از طریق اینترنت در دسترس باشند، زیرا Let's Encrypt مالکیت شما بر دامنه را از طریق چالش HTTP-01 روی پورت 80 تایید می‌کند. فایروال شبکه در پنل ارائه‌دهنده و همچنین فایروال داخلی سرور را بررسی کنید. این دو کنترل‌های مجزایی هستند و فایروال پنل همان موردی است که معمولاً فراموش می‌شود.

گواهی‌ها در volume مربوط به cert-data در مسیر /letsencrypt/acme.json ذخیره می‌شوند. اگر مرورگر به‌جای گواهی شما، گواهی پیش‌فرض را نشان می‌دهد، نام سرویس پروکسی را در docker compose --project-name erpnext ps پیدا کرده و لاگ‌های آن را برای یافتن خطای ACME (محیط مدیریت خودکار گواهی) بررسی کنید. آیا برنامه‌های وب دیگری روی همان سرور اجرا می‌کنید؟ یک نمونه Traefik در مقابل چندین برنامه Docker Compose نشان می‌دهد که چگونه به‌جای رقابت بر سر پورت 443، از پروکسی به‌صورت اشتراکی استفاده کنید. برنامه دوم روی چنین سروری اغلب با مشتری در ارتباط است و یک میز پشتیبانی Chatwoot خودمیزبان پشت همان پروکسی قرار می‌گیرد تا افرادی که با فاکتورها کار می‌کنند، بتوانند ایمیل‌ها و چت‌های مشتریان را نیز در یک مکان پاسخ دهند.

ایمیل خروجی، یا چرا فاکتورها از سرور خارج نمی‌شوند

این مرحله‌ای است که اکثر راهنماهای ERPNext از آن عبور می‌کنند، در حالی که تعیین‌کننده کارآمدی سیستم است. بدون ایمیل خروجی فعال، هیچ فاکتوری به دست مشتری نمی‌رسد، بازنشانی رمز عبور انجام نمی‌شود و گزارش‌های زمان‌بندی‌شده ارسال نخواهند شد. این پشته (stack) شامل هیچ سرور ایمیلی نیست.

تلاش نکنید ایمیل را مستقیماً از طریق VPS روی پورت 25 ارسال کنید. اکثر ارائه‌دهندگان، پورت 25 خروجی را در اکانت‌های جدید مسدود می‌کنند و هر ایمیلی هم که خارج شود، به دلیل نداشتن اعتبار (reputation) برای آدرس IP جدید VPS، رد شده یا به عنوان اسپم شناخته می‌شود. از یک relay احراز هویت‌شده روی پورت 587 استفاده کنید.

مسیر پشتیبانی‌شده، صفحه Email Account در رابط کاربری ERPNext است که رمز عبور را به‌صورت رمزنگاری‌شده ذخیره می‌کند. همچنین می‌توانید کلیدها را در فایل پیکربندی سایت بنویسید:

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config mail_server smtp.example.com

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config mail_port 587 --parse

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config use_tls 1 --parse

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config mail_login 'erp@example.com'

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config auto_email_id 'erp@example.com'

فایل --parse مقدار 587 را به عنوان یک عدد ذخیره می‌کند، نه به صورت رشته "587". فایل را بازخوانی کنید و مطمئن شوید که این دو مقدار فاقد کوتیشن هستند:

docker compose --project-name erpnext exec backend \
  cat sites/erp.example.com/site_config.json

مقدار mail_password را از طریق صفحه Email Account تنظیم کنید و نه از طریق خط فرمان، تا به‌صورت رمزنگاری‌شده ذخیره شود و هرگز در تاریخچه shell شما ثبت نگردد.

سپس یک پیام واقعی ارسال کنید. یک Sales Invoice ایجاد کنید، آن را به آدرسی که به آن دسترسی دارید ایمیل کنید و در حین انجام این کار، صف را مشاهده کنید:

docker compose --project-name erpnext logs -f queue-short

ایمیل خروجی یک job پس‌زمینه است، بنابراین پیامی که هرگز نمی‌رسد، معمولاً به عنوان یک job ناموفق در آن لاگ ظاهر می‌شود تا یک خطا در مرورگر. رکوردهای SPF (مخفف sender policy framework) و DKIM (مخفف domainkeys identified mail) را برای دامنه فرستنده منتشر کنید و سپس یک سیاست DMARC اضافه کنید. بدون این موارد، حتی یک فاکتور از نظر فنی صحیح نیز در پوشه اسپم مشتری قرار می‌گیرد. اگر ترجیح می‌دهید کل مسیر را تحت کنترل داشته باشید، یک سرور ایمیل Mailcow خودمیزبان یک relay تحت کنترل شما، روی سروری جدا از ERP فراهم می‌کند.

پشتیبان‌هایی که واقعاً قابل بازیابی هستند

یک dump پایگاه داده به‌تنهایی پشتیبان ERPNext نیست. فایل‌های پیوست و فایل‌های خصوصی در دایرکتوری sites قرار دارند، نه در MariaDB. اگر فقط پایگاه داده را بازیابی کنید، همه سفارش‌های خرید بارگذاری‌شده به لینک‌های خراب تبدیل می‌شوند.

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com backup --with-files

این دستور چهار فایل را در sites/erp.example.com/private/backups داخل volume مربوط به sites می‌نویسد:

  • یک dump از نوع -database.sql.gz
  • یک archive از فایل‌های عمومی از نوع -files.tar
  • یک archive از فایل‌های خصوصی از نوع -private-files.tar
  • یک کپی از configuration مربوط به سایت از نوع -site_config_backup.json

فایل چهارم همان فایلی است که افراد دور می‌اندازند، درحالی‌که بیشترین مشکل را ایجاد می‌کند. این فایل شامل encryption_key است؛ همان کلیدی که Frappe برای رمزگذاری passwordهای ذخیره‌شده استفاده می‌کند: اعتبارنامه‌های حساب‌های email، کلیدهای درگاه پرداخت و secretهای همه integrationها. اگر پایگاه داده را بدون کلید متناظر بازیابی کنید، سایت به‌طور عادی بارگذاری می‌شود، اما ارسال email با خطای زیر شکست می‌خورد:

frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.json

همیشه هر چهار فایل را در کنار هم نگه دارید.

سپس آن‌ها را از سرور خارج کنید. پشتیبان داخل volume در برابر از دست رفتن سرور دوام نمی‌آورد و bench نیز آن را حذف می‌کند: به‌طور پیش‌فرض، backupهای قدیمی‌تر از 23 ساعت را از آن دایرکتوری حذف می‌کند. این مقدار پیش‌فرض پیش از Frappe 16.20.0 و 15.114.0 برابر با 24 ساعت بود و کلید keep_backups_for_hours در configuration سایت می‌تواند آن را override کند.

docker compose --project-name erpnext cp \
  backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
  ~/erpnext-backups

این دستور را از طریق cron اجرا کنید و سپس دایرکتوری را به مکانی منتقل کنید که خودتان آن را مدیریت نمی‌کنید. پشتیبان‌های رمزگذاری‌شده restic در storage خارج از سایت ابزار مناسبی است، زیرا پیش از upload داده‌ها را رمزگذاری می‌کند و restic check قابل‌خواندن‌بودن repository را همچنان بررسی می‌کند. پشتیبان ERP کپی کاملی از ledger شماست؛ بنابراین باید به‌صورت رمزگذاری‌شده در حالت سکون، روی سخت‌افزاری نگهداری شود که این سرور نیست.

پیش از نیاز به بازیابی، آن را تست کنید

بک‌آپی که تست نشده باشد، صرفاً یک حدس است. آن را در یک سایت دوم روی همان سرور تست کنید و هرگز روی سایت اصلی بازیابی نکنید.

docker compose --project-name erpnext exec backend \
  bench new-site --mariadb-user-host-login-scope=% \
  --db-root-password '<your DB_PASSWORD>' \
  --admin-password '<a strong admin password>' \
  restore-test.example.com

docker compose --project-name erpnext exec backend \
  bench --site restore-test.example.com --force restore \
  sites/erp.example.com/private/backups/<stamp>-erp.example.com-database.sql.gz \
  --with-public-files sites/erp.example.com/private/backups/<stamp>-erp.example.com-files.tar \
  --with-private-files sites/erp.example.com/private/backups/<stamp>-erp.example.com-private-files.tar \
  --db-root-password '<your DB_PASSWORD>'

کلید رمزنگاری را از تنظیمات بک‌آپ کپی کرده و در سایت بازیابی‌شده قرار دهید، در غیر این صورت یکپارچگی‌های آن از کار می‌افتند:

docker compose --project-name erpnext exec backend \
  bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'

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

پس از پایان کار، سایت تست را حذف کنید:

docker compose --project-name erpnext exec backend \
  bench drop-site restore-test.example.com

اهمیت pin کردن نسخه در ERPNext

در یک سایت استاتیک، tag بدون pin شدن برای image یعنی یک restart غیرمنتظره. در ERPNext، یعنی اجرای migration روی schema. bench migrate جدول‌های database را بازنویسی می‌کند و ممکن است داده‌های document را نیز تغییر دهد؛ این فرایند undo ندارد. بازگردانی به نسخه قبل از backup انجام می‌شود، نه با docker compose down.

بنابراین tag را pin کنید. ERPNEXT_VERSION=v16.32.1 نسخه‌ای بود که در pwd.yml خود repository در August 2026 pin شده بود. در 2026-10-12، هر دو pwd.yml و example.env مقدار v16.50.0 را pin کرده بودند. هیچ‌یک از این دو مقدار را بدون بررسی، در پیکربندی بعدی استفاده نکنید. releaseهای فعلی در صفحه releaseهای frappe/erpnext فهرست شده‌اند و tagهای موجود image در Docker Hub قرار دارند. پیش از ارتقا، یادداشت‌های نسخه‌ای را که قصد انتقال به آن را دارید بخوانید.

خود فرایند ارتقا با backup و maintenance mode شروع می‌شود.

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com backup --with-files

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-maintenance-mode on

ERPNEXT_VERSION را در ~/gitops/erpnext.env ویرایش کنید، سپس آن را render کنید، image را pull کنید و migration را اجرا کنید.

docker compose --project-name erpnext \
  --env-file ~/gitops/erpnext.env \
  -f compose.yaml \
  -f overrides/compose.mariadb.yaml \
  -f overrides/compose.redis.yaml \
  -f overrides/compose.https.yaml \
  config > ~/gitops/erpnext.yaml

docker compose --project-name erpnext -f ~/gitops/erpnext.yaml pull
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com migrate

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-maintenance-mode off

maintenance mode اهمیت دارد، زیرا migrate هنگام اجرا schema را تغییر می‌دهد. اگر کاربر در برابر جدولی که migration آن کامل نشده است document ارسال کند، ممکن است مجبور شوید recordها را به‌صورت دستی اصلاح کنید.

در هر مرحله فقط یک major version را ارتقا دهید و بین هر مرحله backup بگیرید. کد migration در هر release برای ارتقا از release قبلی نوشته شده است؛ بنابراین رد کردن major versionها باعث می‌شود migrationها در ترکیبی اجرا شوند که هیچ‌کس آن را آزمایش نکرده است.

این repository همچنین overrides/compose.migrator.yaml را ارائه می‌کند که containerای اضافه می‌کند و در هر start، bench --site all migrate را اجرا می‌کند. این روش راحت است. اما اگر tag تغییر کرده باشد، docker compose up می‌تواند database عملیاتی شما را بدون نظارت migration کند. در یک سیستم کسب‌وکار، اجرای migrate باید تصمیمی باشد که همان صبح گرفته‌اید.

ایمن‌سازی سروری که حاوی سوابق مشتریان است

در اولین ورود، رمز عبور Administrator را تغییر دهید. فایل compose ارزیابی، مقدار admin را به عنوان رمز عبور پیش‌فرض در نظر می‌گیرد و این عادت اغلب تا محیط عملیاتی (production) ادامه می‌یابد.

مقدار DB_PASSWORD را از 123 در فایل example.env تغییر دهید. این مقدار در نهایت به صورت متن ساده در ~/gitops/erpnext.yaml رندر می‌شود؛ بنابراین فایل را chmod 600 کنید و آن را از هر مخزن git دور نگه دارید. برای امنیت بیشتر، overrides/compose.mariadb-secrets.yaml رمز عبور را به‌جای متغیر محیطی، از یک فایل Docker secret می‌خواند. مطلب مدیریت فایل‌های env و secret در Docker Compose به بررسی مزایا و معایب این روش می‌پردازد.

فقط آنچه نیاز دارید را در دسترس قرار دهید. با استفاده از override مربوط به HTTPS، تنها پورت‌های 80 و 443 در معرض دید قرار می‌گیرند. برای تسهیل اتصال کلاینت دیتابیس، هیچ mapping مربوط به ports را به سرویس db اضافه نکنید؛ چرا که این کار MariaDB را روی اینترنت عمومی قرار می‌دهد. به‌جای آن از docker compose --project-name erpnext exec backend bench mariadb استفاده کنید. روی میزبان (host)، پورت‌های 22، 80 و 443 را مجاز کنید، بقیه را مسدود نمایید و فایروال شبکه جداگانه ارائه‌دهنده سرویس را نیز بررسی کنید.

برای تمامی حساب‌هایی که نقش System Manager دارند، احراز هویت دو مرحله‌ای (2FA) را در System Settings فعال کنید. این نقش می‌تواند تمام اسناد را بخواند و از تمام جداول خروجی بگیرد، بنابراین با آن به عنوان یک حساب مدیریتی برخورد کنید، نه یک حساب کاربری ساده. اگر چندین برنامه را به صورت self-hosted اجرا می‌کنید، استفاده از Authentik به عنوان یک ارائه‌دهنده SSO برای سرویس‌های شخصی بهتر از مدیریت یک رمز عبور مجزا برای هر برنامه است.

میزبان را وصله‌گذاری (patch) کنید و برای به‌روزرسانی‌های هسته (kernel)، سیستم را reboot کنید. پیش از آنکه به بالا آمدن خودکار stack اطمینان کنید، فایل رندر شده را برای سیاست restart در هر سرویس بررسی کنید، زیرا stack بدون این سیاست پس از reboot بالا نمی‌آید. مطلب راه‌اندازی مجدد stack در Docker Compose پس از reboot به جنبه‌های مربوط به systemd می‌پردازد.

زمانی که ERPNext دیگر روی یک VPS پاسخگو نیست

یک VPS ممکن است برای مدت طولانی نیازهای یک شرکت کوچک را برطرف کند. نشانه‌هایی که ثابت می‌کنند این سرور دیگر کافی نیست:

  • صف کارهای پس‌زمینه (Background jobs) انباشته می‌شود و ایمیل‌ها و فایل‌های واردشده با تأخیر چند دقیقه‌ای یا چند ساعتی پردازش می‌شوند.
  • دستور docker inspect وضعیت کانتینرها را با "OOMKilled": true یا کد خروج 137 گزارش می‌دهد.
  • گزارش‌هایی که قبلاً 2 ثانیه زمان می‌بردند، اکنون 30 ثانیه طول می‌کشند و MariaDB پردازشی است که بیشترین درگیری CPU را دارد.
  • زمان اجرای پشتیبان‌گیری (Backup) آن‌قدر طولانی می‌شود که با زمان‌بندی اجرای بعدی تداخل پیدا می‌کند.

ابتدا منابعی را به MariaDB اختصاص دهید که با سرویس‌های دیگر مشترک نباشد، زیرا دیتابیس و workerهای Python برای حافظه با یکدیگر رقابت می‌کنند و buffer pool بخشی است که به حافظه بیشتری نیاز دارد. ارتقای سرور اپلیکیشن معمولاً کمتر از آنچه تصور می‌شود تأثیرگذار است. اجرای دیتابیس در Docker یا روی host این تصمیم را بررسی می‌کند و تنظیم محدودیت حافظه در Docker Compose از بلعیده شدن منابع توسط یک کانتینر و ایجاد اختلال در سایر کانتینرها جلوگیری می‌کند.

پس از آن، به‌جای افزایش ظرفیت وب، workerهای صف (queue workers) را اضافه کنید. کارهای کند در ERPNext مربوط به پردازش‌های پس‌زمینه هستند: تولید گزارش و وارد کردن داده‌های حجیم. هزینه کانتینرهای worker بیشتر، کمتر از ارتقای کل سرور است و مستقیماً مشکلی را که کاربران از آن شکایت دارند، حل می‌کند.

FAQ

ERPNext روی یک VPS به چه مقدار RAM نیاز دارد؟

راهنمای منتشرشده با 4 گیگابایت رم و 2 هسته vCPU شروع می‌شود که این سطح فقط برای ارزیابی است. برای شرکتی که روزانه از آن استفاده می‌کند، 8 گیگابایت رم و 4 هسته vCPU به همراه 100 گیگابایت فضای SSD در نظر بگیرید. در مقادیر کمتر از این، قابلیت out of memory killer در هسته سیستم‌عامل، کانتینرها را تحت فشار متوقف می‌کند که docker inspect آن را به صورت "OOMKilled": true با کد خروج 137 گزارش می‌دهد. این مقادیر صرفاً نقاط شروع هستند و نه اندازه‌گیری‌های دقیق؛ بنابراین در طول ماه اول، میزان مصرف حافظه خود را مانیتور کنید.

آیا می‌توانم pwd.yml را در محیط production اجرا کنم؟

خیر. فایل README پروژه توضیح می‌دهد که این فایل فقط برای ارزیابی‌های کوتاه‌مدت در نظر گرفته شده است و اشاره می‌کند که نمی‌توانید برنامه‌های سفارشی (custom apps) را در آن نصب کنید. از compose.yaml به همراه overrideهای MariaDB، Redis و HTTPS استفاده کنید، آن‌ها را با docker compose config در یک فایل واحد ادغام کنید و سپس آن فایل را اجرا نمایید.

چرا سایت ERPNext من بلافاصله پس از ایجاد، غیرقابل دسترس است؟

فرانت‌اند به‌طور پیش‌فرض بر اساس هدر HTTP Host تصمیم می‌گیرد که کدام سایت را نمایش دهد، بنابراین نام سایت باید با دامنه موجود در مرورگر مطابقت داشته باشد. سایتی که با نام erpnext ایجاد شده است، در erp.example.com سرویس‌دهی نمی‌شود. یا سایت را با استفاده از نام دامنه ایجاد کنید، یا در فایل env مقدار FRAPPE_SITE_NAME_HEADER را روی نام سایت تنظیم کنید، فایل compose را دوباره render کرده و stack را restart کنید.

چه مواردی باید در بک‌آپ ERPNext موجود باشد؟

چهار فایل که باید با هم نگهداری شوند: دامپ -database.sql.gz، آرشیوهای -files.tar و -private-files.tar، و کپی تنظیمات -site_config_backup.json. اجرای bench --site erp.example.com backup --with-files هر چهار مورد را تولید می‌کند. کپی تنظیمات حاوی encryption_key است؛ بنابراین بازیابی بدون آن، رمزهای عبور ذخیره‌شده برای یکپارچه‌سازی‌ها را غیرقابل رمزگشایی می‌کند که به صورت خطای Encryption key is invalid! Please check site_config.json ظاهر می‌شود.

چگونه ERPNext را بدون آسیب به داده‌ها ارتقا دهم؟

با استفاده از --with-files بک‌آپ بگیرید، حالت maintenance را فعال کنید، مقدار ERPNEXT_VERSION را در فایل env تغییر دهید، فایل compose را دوباره render کنید، pull انجام دهید، stack را بالا بیاورید، سپس bench --site erp.example.com migrate را اجرا کرده و حالت maintenance را غیرفعال کنید. هر بار فقط یک نسخه اصلی (major version) ارتقا دهید و ابتدا یادداشت‌های انتشار (release notes) را بخوانید، زیرا migrate ساختار دیتابیس (schema) و داده‌های اسناد را بازنویسی می‌کند و راه بازگشتی ندارد. بازگشت به نسخه قبل (rollback) به معنای بازیابی بک‌آپی است که در ابتدا تهیه کرده‌اید.

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