مدیریت آموزشگاه

راهنمای کاربر · 14/15

استقرار

اجرای نسخهٔ وب روی Coolify یا Docker ساده در چند دقیقه، متغیرهای محیطی مهم، و چه چیزی باید پشتیبان داشته باشد.

چه چیزی مستقر می‌کنید

یک کانتینر: Node 24 که سرور SvelteKit را اجرا می‌کند، با SQLite داخل یک Volume. بدون دیتابیس خارجی، کش، صف یا cron. حجم ایمیج حدود ۳۸۰ مگابایت؛ در تست استرس با ۲٬۰۰۰ هنرجو مصرف حافظهٔ پروسه زیر ۳۵۰ مگابایت ماند.

Coolify

  1. Add resource → Application → Git repository. مخزن و شاخهٔ main را انتخاب کنید.
  2. Build pack: Dockerfile. فایل Dockerfile ریشهٔ مخزن، برنامه را می‌سازد و اجرا می‌کند. پورت 3000.
  3. Storage → Add volume، روی /data. اینجا دیتابیس، عکس‌ها، پشتیبان‌ها و کلید دستگاه نگه داشته می‌شوند. بدون آن، هر استقرار مجدد خالی شروع می‌شود.
  4. متغیرهای محیطی (پایین): دست‌کم ORIGIN و TZ.
  5. Deploy. Coolify ترافیک HTTPS را به کانتینر می‌رساند؛ healthcheck روی /health می‌زند.

آدرس را باز کنید، حساب مدیر را بسازید، آنبوردینگ را تمام کنید.

Docker Compose

git clone https://github.com/AAA-It-uae/academy-manager-site.git
cd academy-manager-site
ORIGIN=https://academy.example.com TZ=Asia/Tehran docker compose up -d --build

متغیرهای محیطی

متغیر پیش‌فرض کاربرد
ORIGIN آدرس عمومی، مثلاً https://academy.example.com. پشت پروکسی الزامی است؛ اگر origin نخواند، ارسال فرم‌ها رد می‌شود.
TZ UTC منطقهٔ زمانی سرور: «امروز»، تاریخ حضور و غیاب و ساعت پشتیبان خودکار از آن استفاده می‌کنند.
DATA_DIR /data محل دیتابیس، عکس‌ها و پشتیبان‌ها.
APP_LOCALES en,ar,fa زبان‌های ارائه‌شده، به ترتیب نمایش.
DEFAULT_LOCALE en زبان قبل از آنبوردینگ.
APP_CURRENCIES AED,USD,IRT ارزهای ارائه‌شده؛ اولی پیش‌فرض است.
SESSION_DAYS 30 طول نشست ورود.
MAX_UPLOAD_MB / BODY_SIZE_LIMIT 64 / 64M بزرگ‌ترین عکس یا فایل پشتیبان قابل آپلود.
WORKERS 1 تعداد پروسه‌ها؛ auto از همهٔ هسته‌ها استفاده می‌کند.
SECURE_COOKIES مطابق پروتکل اجبار فلگ Secure کوکی به روشن یا خاموش.

پشتیبان از خود سرور

Volume روی /data همه‌چیز است. با ابزار میزبان از آن اسنپ‌شات بگیرید و برای نسخه‌های قابل حمل و رمزشده که هر جا، حتی روی گوشی، بازیابی می‌شوند از ساخت پشتیبان خود برنامه استفاده کنید.

به‌روزرسانی

از Git دوباره Deploy کنید. مهاجرت‌های دیتابیس هنگام شروع خودکار اجرا می‌شوند؛ نسخهٔ اسکیما در تنظیمات → درباره نمایش داده می‌شود.