OCMS · مستندات
راهنمای نصب
پیش‌نیازها
| مورد | حداقل |
|---|---|
| سیستم‌عامل | هر لینوکسِ ۶۴ بیتی (Ubuntu 22.04+، Debian 12+، …) |
| نرم‌افزار | Docker Engine 24+ و Docker Compose v2 |
| سخت‌افزار | ۲ هسته، ۲ گیگ رم، ۱۰ گیگ دیسک (برای کاتالوگِ بزرگ بیشتر) |
| شبکه | یک دامنه که به IPِ سرور اشاره کند، و پورت‌های ۸۰ و ۴۴۳ باز |
به Node، PostgreSQL یا وب‌سرورِ جدا روی خودِ سرور نیازی نیست؛ همه در کانتینر اجرا می‌شوند.
گرفتنِ بسته
بستهٔ نصب پس از خرید در اختیارتان قرار می‌گیرد. آن را روی سرور باز کنید:
$ tar xzf ocms-0.1.tar.gz $ cd ocms/deploy
اجرای نصب
اسکریپت یک فایلِ .env با رمزِ تصادفیِ دیتابیس می‌سازد (فقط اگر وجود نداشته باشد)، کانتینرها را می‌سازد و بالا می‌آورد، و در پایان کدِ راه‌اندازی را چاپ می‌کند.
$ ./install.sh shop.example.com
برای گرفتنِ خودکارِ گواهیِ HTTPS با Caddyِ همراه:
$ docker compose --profile tls up -d
اگر سرور پشتِ CDN یا پراکسیِ دیگری است، در .env مقدارِ OCMS_TRUST_PROXY را تعدادِ پراکسی‌ها بگذارید (مثلاً 2 برای CDN + یک nginx). هرگز true نگذارید: آن‌وقت هر بازدیدکننده می‌تواند IPِ خودش را جعل کند.
تکمیل در مرورگر
به https://دامنهٔ-شما/install بروید. این صفحه فقط تا وقتی هست که هنوز مدیری ساخته نشده.
| فیلد | یعنی چه |
|---|---|
| کدِ راه‌اندازی | همان کدی که اسکریپت چاپ کرد. اگر گمش کردید: docker compose exec ocms ocms setup-code |
| نامِ فروشگاه | در سربرگ، عنوانِ صفحه‌ها و PWA نمایش داده می‌شود؛ بعداً قابلِ تغییر است. |
| ایمیل و رمزِ مدیر | اولین حسابِ مدیرِ کل. رمز حداقل ۱۲ نویسه. |
| زبان‌ها و زبانِ اصلی | زبان‌هایی که ویترین نشان می‌دهد. زبانِ اصلی برای بازدیدکننده‌ای است که زبانش فعال نیست. |
| ارز | قیمت‌ها به کوچک‌ترین واحدِ همین ارز ذخیره می‌شوند. عوض‌کردنِ آن قیمت‌های موجود را تبدیل نمی‌کند. |
| قالب | Atelier، Bazaar یا Kiln. بعداً در پنل عوض می‌شود. |
| محصولاتِ نمونه | شش محصولِ نمونه تا فروشگاه را کارکرده ببینید؛ در پنل حذف‌شدنی. |
پس از ساخت، به پنلِ مدیریت (/admin/) هدایت می‌شوید. ویترین در / است.
نتیجهٔ نصب
- ویترین با قالب و زبان‌های انتخابی، صفحهٔ خانه، صفحهٔ محصول، سبد و تسویه.
- پنلِ مدیریت: داشبورد، صفحه‌ساز، محصولات، دسته‌ها، سفارش‌ها، ماژول‌ها، قالب‌ها و تنظیمات.
- ماژول‌های هسته نصب و فعال؛ کارت‌به‌کارت و پرداخت در محل آماده.
قدمِ بعد: دستورالعملِ پس از نصب.
به‌روزرسانی
بستهٔ تازه را روی پوشهٔ قبلی باز کنید و دوباره بسازید. فایلِ .env و داده‌ها دست نمی‌خورند؛ تغییراتِ دیتابیس خودکار اجرا می‌شوند.
$ docker compose up -d --build
پشتیبان‌گیری
$ docker compose exec -T db pg_dump -U ocms ocms | gzip > ocms-$(date +%F).sql.gz
و برگرداندن:
$ gunzip -c ocms-2026-01-01.sql.gz | docker compose exec -T db psql -U ocms ocms
فایلِ .env را هم جداگانه و امن نگه دارید؛ رمزِ دیتابیس در آن است.
رفعِ اشکال
| نشانه | چه کنید |
|---|---|
| صفحه خطای ۴۲۱ می‌دهد | دامنه‌ای که باز کرده‌اید با OCMS_DOMAIN در .env یکی نیست. |
| ورود کار نمی‌کند و کوکی ساخته نمی‌شود | سایت را با HTTPS باز کنید؛ روی HTTPِ ساده OCMS_SECURE_COOKIES=false لازم است (فقط برای آزمون). |
| کدِ راه‌اندازی را ندارید | docker compose exec ocms ocms setup-code |
| گوشیِ ورودِ دومرحله‌ای گم شده | docker compose exec ocms ocms 2fa-reset you@example.com |
| لاگ‌ها | docker compose logs -f ocms |