استضافة Intlayer ذاتياً

يمكن تشغيل Intlayer بالكامل على بنيتك التحتية الخاصة — دون الحاجة إلى حساب Intlayer Cloud. يُشغّل أمر واحد مكدساً جاهزاً للإنتاج:

curl -fsSL https://intlayer.org/install.sh | sh

يقوم المثبّت بتنزيل ملف docker-compose.yml وملف .env، ويولّد الأسرار المطلوبة تلقائياً، ويبدأ تشغيل جميع الحاويات بـ docker compose up -d.

جدول المحتويات

البنية المعمارية

                ┌─────────────────────────────┐ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐                └─────────────────────────────┘   │ VITE_BACKEND_URL                ┌─────────────────────────────┐   │                │  backend (Fastify/Bun)  :3100│ ◀─┘                └──────────────┬──────────────┘          ┌──────────┬─────────┼──────────┬───────────┐          ▼          ▼         ▼          ▼           ▼     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium     (1-node RS)             (S3 API)     (SMTP)        (in-image)                             minio:9001   mailpit:8025                             (console)    (web UI)

يتم تضمين Chromium (المستخدم لتوليد لقطات الشاشة عبر Puppeteer) داخل صورة الخادم الخلفي — لا حاجة لحاوية منفصلة.

المتطلبات الأساسية

• Docker ≥ 24 وDocker Compose ≥ v2. إذا كان أحدهما مفقوداً، يطبع المثبّت رابط التثبيت ويخرج.
• المنافذ 3000، 3100، 8025، 9000، و9001 متاحة على المضيف.
• مضيف Linux أو macOS (أو WSL2 على Windows).

البدء السريع

curl -fsSL https://intlayer.org/install.sh | sh

ما يقوم به المثبّت:

1. يتحقق من وجود docker وdocker compose.
2. يُنزّل docker-compose.yml و.env.example إلى ./intlayer/.
3. إذا لم يكن هناك .env، ينسخ المثال ويولّد أسراراً عشوائية لـ BETTER_AUTH_SECRET وS3_ACCESS_KEY_ID وS3_SECRET_ACCESS_KEY عبر openssl rand.
4. يُشغّل docker compose pull + docker compose up -d.
5. يطبع عناوين URL: لوحة التحكم :3000، API :3100، واجهة البريد الإلكتروني :8025، وحدة تحكم MinIO :9001.

بعد تشغيل المكدس، افتح http://localhost:3000 وأنشئ حسابك الأول.

الخدمات

المنافذ الداخلية (mongo، redis) غير معرّضة للمضيف افتراضياً.

يجب أن يكون منفذ MinIO 9000 قابلاً للوصول من المتصفح لأن الأصول المرفوعة (الصور الرمزية، لقطات الشاشة) تُحمَّل مباشرة من S3_PUBLIC_URL=http://localhost:9000/intlayer.

متغيرات البيئة

يولّد المثبّت ملف .env جاهزاً للاستخدام. يصف الجدول أدناه كل متغير.

المطلوبة (مولّدة تلقائياً أو مطلوبة)

اختيارية (تتدهور الميزات بشكل سلس عند غيابها)

ربط مشروعك بـ Intlayer

بمجرد تشغيل المكدس، وجّه مشروعك نحو الخادم الخلفي ولوحة التحكم المستضافَين ذاتياً بدلاً من intlayer.org.

تهيئة المشروع

import type { IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  editor: {
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,

    /**
     * عنوان URL للوحة تحكم CMS المستضافة ذاتياً.
     * الافتراضي: https://app.intlayer.org
     */
    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000

    /**
     * عنوان URL لواجهة برمجة تطبيقات الخادم الخلفي المستضافة ذاتياً.
     * الافتراضي: https://back.intlayer.org
     */
    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
  },
};

export default config;

اضبط متغيرات البيئة في ملف .env الخاص بمشروعك:

INTLAYER_CMS_URL=http://localhost:3000INTLAYER_BACKEND_URL=http://localhost:3100INTLAYER_CLIENT_ID=<your-client-id>INTLAYER_CLIENT_SECRET=<your-client-secret>

أنشئ بيانات اعتماد الوصول في لوحة التحكم المستضافة ذاتياً ضمن المشاريع ← مفاتيح الوصول على http://localhost:3000/projects.

SDK الخاص بـ @intlayer/api

عند استخدام SDK الخاص بـ @intlayer/api برمجياً، مرّر backendURL بشكل صريح:

import { createIntlayerCMS } from "@intlayer/api";import { dictionaryEndpoint } from "@intlayer/api/dictionary";const cms = createIntlayerCMS({  editor: {    clientId: process.env.INTLAYER_CLIENT_ID,    clientSecret: process.env.INTLAYER_CLIENT_SECRET,    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100  },});const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();

الترقية

إعادة تشغيل المثبّت على نشر قائم تنفّذ ترقية متدحرجة:

curl -fsSL https://intlayer.org/install.sh | sh

يجلب هذا الأمر أحدث الصور ويعيد تشغيل الحاويات باستخدام docker compose pull && docker compose up -d. يتم الاحتفاظ بالأحجام الموجودة (mongo-data، redis-data، minio-data) — دون فقدان للبيانات.

للترقية يدوياً من داخل مجلد ./intlayer/:

docker compose pulldocker compose up -d

النسخ الاحتياطي والاستعادة

تعيش جميع البيانات الدائمة في ثلاثة أحجام Docker مسماة.

النسخ الاحتياطي

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/mongo-data.tar.gz /datadocker run --rm \  -v intlayer_redis-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/redis-data.tar.gz /datadocker run --rm \  -v intlayer_minio-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/minio-data.tar.gz /data

الاستعادة

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar xzf /backup/mongo-data.tar.gz -C /# كرر لـ redis-data و minio-data

استخدام وكيل عكسي (Nginx / Caddy)

للنشر في الإنتاج، ضع وكيلاً عكسياً أمام حاويات التطبيق والخادم الخلفي بدلاً من كشفها مباشرة.

مثال Nginx

server {    listen 80;    server_name cms.example.com;    location / {        proxy_pass http://localhost:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}server {    listen 80;    server_name api.example.com;    location / {        proxy_pass http://localhost:3100;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}

حدّث متغيرات البيئة التالية في .env لتتناسب مع نطاقاتك العامة:

BACKEND_URL=https://api.example.comAPP_URL=https://cms.example.comDOMAIN=example.comVITE_BACKEND_URL=https://api.example.comVITE_DOMAIN=example.com

تُخبز متغيرات VITE_* في صورة لوحة التحكم عند وقت البناء. إذا غيّرتها بعد بناء الصورة، ستحتاج إلى إعادة بناء صورة app (docker compose build app) أو استخدام حقن التهيئة في وقت التشغيل.

استكشاف الأخطاء وإصلاحها

الخادم الخلفي يتعطل عند الإقلاع

يجب أن يكون MongoDB وRedis في حالة صحية قبل بدء تشغيل الخادم الخلفي. يستخدم ملف compose depends_on مع condition: service_healthy. إذا رأيت إعادات تشغيل متكررة للخادم الخلفي، تحقق من اجتياز فحوصات صحة mongo وredis:

docker compose psdocker compose logs mongodocker compose logs redis

لوحة التحكم لا تستطيع الوصول إلى API

تحقق من أن VITE_BACKEND_URL يطابق عنوان URL حيث يمكن الوصول إلى الخادم الخلفي من المتصفح (ليس شبكة Docker). إذا غيّرت منفذ الخادم الخلفي أو أضفت وكيلاً عكسياً، أعد بناء صورة لوحة التحكم:

docker compose build appdocker compose up -d app

البريد الإلكتروني لا يُرسل

افتراضياً، يتم التقاط جميع البريد الصادر بواسطة Mailpit. افتح http://localhost:8025 لرؤية الرسائل المرسلة. لإرسال بريد إلكتروني حقيقي، اضبط MAIL_PROVIDER=resend وRESEND_API_KEY=<your-key> في .env، ثم أعد تشغيل الخادم الخلفي:

docker compose restart backend

دلو MinIO مفقود

إذا لم تُشغَّل خدمة minio-init المؤقتة (أو شُغّلت قبل أن يكون MinIO جاهزاً)، أنشئ الدلو يدوياً:

docker compose run --rm minio-init

روابط مفيدة

• توثيق Intlayer CMS
• مرجع التهيئة
• CMS SDK — @intlayer/api