دليل التثبيت
تحتاج إلى مفتاح ترخيص قبل البدء: ينزّل المُثبِّت الحزمة من خادمنا ويتحقق من المفتاح أولاً. أنشئ حساباً مجانياً للحصول على مفتاح تجربة لمدة 7 أيام خلال دقيقة.
ابدأ التجربة المجانيةالمتطلبات
- خادم Linux (Ubuntu 22.04 أو أحدث)، معالجان، 4 جيجابايت ذاكرة، 40 جيجابايت تخزين
- Docker Engine 24+ مع Docker Compose v2
- نطاق أو نطاق فرعي لواجهة API، وآخر لواجهة الإدارة
- بروكسي عكسي يدعم HTTPS (Plesk، أو Caddy، أو Traefik)
- بيانات اعتماد SMTP لإرسال البريد
شغّل المُثبِّت
أمر واحد على خادمك كمستخدم root. ينزّل الحزمة، ويولّد كلمات السر، ويبني الحاويات ويشغّلها، وينفّذ الترحيلات. استبدل your-domain.com بالنطاق الذي ستقدّم عليه Hostinvo — فهو يضبط عنوان التطبيق ونطاق الجلسات وCORS، وبدونه لن تتمكن من تسجيل الدخول بعد التثبيت.
curl -fsSL https://api.hostinvo.dev/install.sh | bash -s -- --license YOUR-LICENCE-KEY --domain your-domain.comوجّه نطاقاً إليه
يستمع المُثبِّت على المضيف المحلي فقط ويطبع المنفذ الذي اختاره. ضع بروكسي عكسي أمامه. في Plesk: أضف النطاق، ثم إعدادات Apache و nginx ← توجيهات nginx إضافية، ثم أصدر شهادة Let's Encrypt.
location ~ / {
proxy_pass http://127.0.0.1:PORT;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_read_timeout 120s;
client_max_body_size 32m;
}أنشئ حساب المالك
يطبع المُثبِّت رابط إعداد يُستخدم مرة واحدة وينتهي بـ ?token=. افتحه وأنشئ حساب المالك. عامله كأنه كلمة مرور: من يملكه يستطيع إنشاء حساب المالك، ومن يفتح /install بدونه يرى صفحة مُقفلة. يتوقف الرابط عن العمل فور اكتمال الإعداد. فقدته؟ اطبعه من جديد على الخادم بالأمر أدناه. إذا كان لديك مفتاح ترخيص فعّله هنا، وإلا ستبدأ تجربة 7 أيام تلقائياً.
docker compose -f docker-compose.prod.yml exec app php artisan install:linkاضبط العنوان والبريد
يبقى البريد على سجلّ الملفات حتى تُدخل بيانات SMTP حقيقية، حتى لا يعطّل خادم بريد مفقود التثبيت. حدّث APP_URL وقيم MAIL_* ثم أعد تشغيل التطبيق.
nano /opt/hostinvo/backend/.env.production
cd /opt/hostinvo && docker compose -f docker-compose.prod.yml restart appخيارات المُثبِّت
- --port PORT — يختار المُثبِّت أول منفذ حر من 8080 تلقائياً؛ استخدم هذا لتحديده.
- --bind 0.0.0.0 — يعرض المنفذ مباشرة بدل ربطه بالمضيف المحلي خلف بروكسي.
- --dir PATH — مجلد التثبيت (الافتراضي /opt/hostinvo).
- --reset — إعادة تثبيت من الصفر: يحذف مجلد التثبيت السابق وقواعد البيانات والتخزين المؤقت. يُتلف كل البيانات، ولازم عند إعادة التثبيت لأن كل تثبيت يولّد كلمة مرور قاعدة بيانات جديدة.
- إذا فشل التثبيت، يطبع المُثبِّت سبب الفشل ويحتفظ بسجلّ كامل في /tmp — أرفقه عند طلب الدعم.
للحصول على التفاصيل الكاملة — بما في ذلك نشر الواجهة الأمامية، النسخ الاحتياطي، واستكشاف الأخطاء — راجع دليل التثبيت الكامل المرفق مع حزمة الإصدار الخاصة بك.