logologo
البدء
الدليل
التطوير
الإضافات
API
English
简体中文
日本語
한국어
Deutsch
Français
Español
Português
Русский
Italiano
Türkçe
Українська
Tiếng Việt
Bahasa Indonesia
ไทย
Polski
Nederlands
Čeština
العربية
עברית
हिन्दी
Svenska
البدء
الدليل
التطوير
الإضافات
API
logologo
كيف يعمل NocoBase
مقارنة طرق التثبيت والإصدارات

تثبيت NocoBase

تثبيت Docker
تثبيت create-nocobase-app
تثبيت من كود Git المصدري
متغيرات البيئة

ترقية NocoBase

ترقية تثبيت Docker
ترقية تثبيت create-nocobase-app
ترقية تثبيت من كود Git المصدري

النشر

نشر بيئة الإنتاج

وكيل الموارد الثابتة

nginx
caddy
cdn

أوامر التشغيل الشائعة

docker compose
pm2
كيفية النشر بشكل أسرع
تثبيت وترقية الإضافات
Previous Pageمقارنة طرق التثبيت والإصدارات
Next Pageتثبيت create-nocobase-app
إشعار الترجمة بالذكاء الاصطناعي

تمت ترجمة هذه الوثائق تلقائيًا بواسطة الذكاء الاصطناعي.

#تثبيت Docker

المتطلبات الأساسية
  • تأكد من تثبيت Docker و Docker Compose.
  • تأكد من أن خدمة Docker قيد التشغيل.

#1. إنشاء ملف docker-compose.yml

# أنشئ مجلدًا باسم my-project (أو أي اسم آخر) لتخزين ملفات النظام التي ينشئها NocoBase
mkdir my-project && cd my-project

# أنشئ ملف docker-compose.yml فارغًا
vi docker-compose.yml

#2. تهيئة ملف docker-compose.yml

اختر إصدار NocoBase (مقارنة الإصدارات) ونوع قاعدة البيانات، ثم انسخ التهيئة المناسبة إلى ملف docker-compose.yml.

ملاحظات التهيئة
  • اختر صورة (Image): latest latest-full beta beta-full alpha alpha-full 1.7.14 1.7.14-full
    • لبيئات الإنتاج، يُنصح بتحديد رقم إصدار ثابت لتجنب التحديثات التلقائية غير المقصودة. عرض جميع الإصدارات
    • صورة Docker Hub: nocobase/nocobase:latest-full
    • تتضمن الصورة الكاملة (full image) عميل PostgreSQL 16/17، وعميل MySQL 8.0، وعميل Oracle 19.25 اللازمة لإضافات إدارة النسخ الاحتياطي والترحيل، بالإضافة إلى LibreOffice المطلوب لطباعة القوالب (PDF).
    • إذا كنت بحاجة إلى بناء صورتك الخاصة، يمكنك الرجوع إلى Dockerfile (الإصدار المختصر) و Dockerfile-full (الإصدار الكامل) الرسميين.
  • تعديل APP_KEY: يرجى استبدال your-secret-key بسلسلة عشوائية، تُستخدم لتشفير المعلومات الحساسة مثل رموز المستخدم (tokens).
  • استخدام قاعدة بيانات موجودة: إذا كان لديك خدمة قاعدة بيانات موجودة بالفعل، يرجى تغيير DB_HOST إلى عنوان خادم قاعدة البيانات، وحذف أو التعليق على تهيئة خدمة قاعدة البيانات (مثل خدمات postgres، mysql، mariadb).
  • تعيين المنافذ (Port mapping): بشكل افتراضي، يتم تعيين المنفذ 80 للحاوية إلى المنفذ 13000 للمضيف. يمكنك تعديله حسب الحاجة.
إصدار بيتا (2.0-beta)
إصدار ألفا (2.0-alpha)
أحدث إصدار (1.9)
PostgreSQL
MySQL
MariaDB
networks:
  nocobase:
    driver: bridge

services:
  app:
    image: nocobase/nocobase:beta-full
    restart: always
    networks:
      - nocobase
    depends_on:
      - postgres
    environment:
      # مفتاح التطبيق، يُستخدم لإنشاء رموز المستخدم (tokens) وغيرها
      # إذا تم تغيير APP_KEY، ستصبح الرموز القديمة غير صالحة
      # يمكن أن يكون أي سلسلة عشوائية، وتأكد من عدم تسريبها
      - APP_KEY=your-secret-key
      # نوع قاعدة البيانات، يدعم postgres, mysql, mariadb
      - DB_DIALECT=postgres
      # مضيف قاعدة البيانات، يمكن استبداله بعنوان IP لخادم قاعدة بيانات موجود
      - DB_HOST=postgres
      # Database port
      - DB_PORT=5432
      # اسم قاعدة البيانات
      - DB_DATABASE=nocobase
      # مستخدم قاعدة البيانات
      - DB_USER=nocobase
      # كلمة مرور قاعدة البيانات
      - DB_PASSWORD=nocobase
      # المنطقة الزمنية
      - TZ=Asia/Shanghai

    volumes:
      - ./storage:/app/nocobase/storage
    ports:
      - '13000:80'
    # init: true

  # إذا كنت تستخدم خدمة قاعدة بيانات موجودة، يمكنك تخطي تشغيل postgres
  postgres:
    image: postgres:16
    restart: always
    command: postgres -c wal_level=logical
    environment:
      POSTGRES_USER: nocobase
      POSTGRES_DB: nocobase
      POSTGRES_PASSWORD: nocobase
    volumes:
      - ./storage/db/postgres:/var/lib/postgresql/data
    networks:
      - nocobase

#3. تثبيت NocoBase وتشغيله

# اسحب أحدث صورة (image)
docker compose pull

# شغّل في الخلفية (سيتم تنفيذ التثبيت تلقائيًا عند التشغيل الأول)
docker compose up -d

# اعرض سجلات التثبيت والتشغيل
docker compose logs -f app

app-postgres-app-1  | nginx started
app-postgres-app-1  | yarn run v1.22.15
app-postgres-app-1  | $ cross-env DOTENV_CONFIG_PATH=.env node -r dotenv/config packages/app/server/lib/index.js install -s
app-postgres-app-1  | Done in 2.72s.
app-postgres-app-1  | yarn run v1.22.15
app-postgres-app-1  | $ pm2-runtime start --node-args="-r dotenv/config" packages/app/server/lib/index.js -- start
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: Launching in no daemon mode
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: App [index:0] starting in -fork mode-
app-postgres-app-1  | 2022-04-28T15:45:38: PM2 log: App [index:0] online
app-postgres-app-1  | 🚀 NocoBase server running at: http://localhost:13000/

#4. تسجيل الدخول إلى NocoBase

افتح http://localhost:13000 في متصفحك. اسم المستخدم وكلمة المرور الافتراضيان هما admin@nocobase.com و admin123.

تنبيه أمني للحساب

بعد تسجيل الدخول لأول مرة، يرجى تغيير كلمة المرور الافتراضية فورًا لضمان أمان النظام.