راهنمای کاربر · 14/15
استقرار
اجرای نسخهٔ وب روی Coolify یا Docker ساده در چند دقیقه، متغیرهای محیطی مهم، و چه چیزی باید پشتیبان داشته باشد.
چه چیزی مستقر میکنید
یک کانتینر: Node 24 که سرور SvelteKit را اجرا میکند، با SQLite داخل یک Volume. بدون دیتابیس خارجی، کش، صف یا cron. حجم ایمیج حدود ۳۸۰ مگابایت؛ در تست استرس با ۲٬۰۰۰ هنرجو مصرف حافظهٔ پروسه زیر ۳۵۰ مگابایت ماند.
Coolify
- Add resource → Application → Git repository. مخزن و شاخهٔ
mainرا انتخاب کنید. - Build pack: Dockerfile. فایل Dockerfile ریشهٔ مخزن، برنامه را میسازد و اجرا میکند. پورت 3000.
- Storage → Add volume، روی /data. اینجا دیتابیس، عکسها، پشتیبانها و کلید دستگاه نگه داشته میشوند. بدون آن، هر استقرار مجدد خالی شروع میشود.
- متغیرهای محیطی (پایین): دستکم
ORIGINوTZ. - 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 کنید. مهاجرتهای دیتابیس هنگام شروع خودکار اجرا میشوند؛ نسخهٔ اسکیما در تنظیمات → درباره نمایش داده میشود.