إعداد سلوك الاستضافة

باستخدام Firebase Hosting، يمكنك ضبط سلوك استضافة مخصّص للطلبات الموجّهة إلى موقعك الإلكتروني.

ما الذي يمكنك ضبطه في Hosting؟

• حدِّد الملفات التي تريد نشرها في Firebase Hosting من دليل مشروعك المحلي. تعرَّف على كيفية إجراء ذلك.

• عرض صفحة 404/Not Found مخصّصة تعرَّف على كيفية إجراء ذلك.

• اضبط الرمز redirects للصفحات التي نقلتها أو حذفتها. تعرَّف على كيفية إجراء ذلك.

• يمكنك إعداد rewrites لأي من الأغراض التالية:

  • عرض المحتوى نفسه لعدة عناوين URL: كيفية إجراء ذلك

  • عرض وظيفة أو الوصول إلى حاوية Cloud Run من عنوان URL Hosting تعرَّف على كيفية إجراء ذلك: دالة أو حاوية.

  • إنشاء نطاق خاص Dynamic Link تعرَّف على كيفية إجراء ذلك.

• أضِف headers لتمرير معلومات إضافية حول طلب أو ردّ، مثل كيفية تعامل المتصفحات مع الصفحة ومحتواها (المصادقة والتخزين المؤقت والترميز وما إلى ذلك). تعرَّف على كيفية إجراء ذلك.

• يمكنك إعداد عمليات إعادة كتابة خاصة بالتوافق مع اللغات المختلفة (i18n) لعرض محتوى محدّد استنادًا إلى اللغة المفضّلة لدى المستخدم و/أو البلد. كيفية إجراء ذلك (صفحة مختلفة)

أين يتم تحديد إعدادات Hosting؟

يمكنك تحديد إعدادات Firebase Hosting في ملف firebase.json. تنشئ Firebase تلقائيًا ملف firebase.json في الجذر الخاص بدليل مشروعك عند تنفيذ الأمر firebase init.

تنبيه: إذا نفّذت الأمر firebase init مرة أخرى واختَرت Hosting، سيؤدي الأمر إلى استبدال القسم hosting من الملف firebase.json بالإعدادات التلقائية.

يمكنك الاطّلاع على مثال كامل على الإعدادات firebase.json (يغطي Firebase Hosting فقط) في أسفل هذه الصفحة. يُرجى العِلم أنّ ملف firebase.json يمكن أن يحتوي أيضًا على إعدادات لخدمات Firebase الأخرى.

يمكنك التحقّق من محتوى firebase.json الذي تم نشره باستخدام Hosting REST API.

ترتيب أولوية الردود Hosting

قد تتداخل خيارات الإعداد المختلفة Firebase Hosting الموضّحة في هذه الصفحة في بعض الأحيان. في حال حدوث تعارض، يحدّد Hosting استجابته باستخدام ترتيب الأولوية التالي:

1. مساحات الأسماء المحجوزة التي تبدأ بشريحة مسار /__/*
2. عمليات إعادة التوجيه التي تم إعدادها
3. المحتوى الثابت الذي يتطابق تمامًا
4. عمليات إعادة الكتابة التي تم ضبطها
5. صفحة 404 مخصّصة
6. صفحة 404 التلقائية

ملاحظة مهمة: ضمن كل من السمتَين redirects وrewrites، تطبّق Hosting عملية إعادة التوجيه أو إعادة الكتابة المحدّدة بموجب القاعدة الأولى التي تتضمّن نمط عنوان URL يتطابق مع المسار المطلوب. لذلك، عليك ترتيب القواعد بشكل مدروس ضمن كل من السمتَين redirects وrewrites. ستظلّ redirects التي تم ضبطها

لها الأولوية على rewrites.

في حال استخدام عمليات إعادة الكتابة المتوافقة مع المعايير الدولية، يتم توسيع نطاق ترتيب الأولوية الخاص بالمطابقة التامة ومعالجة الخطأ 404 ليشمل "المحتوى المتوافق مع المعايير الدولية".

تحديد الملفات التي سيتم نشرها

تحدّد السمات التلقائية، public وignore، المضمّنة في ملف firebase.json التلقائي، الملفات التي يجب نشرها في مشروعك على Firebase من دليل مشروعك.

يبدو الإعداد التلقائي hosting في ملف firebase.json على النحو التالي:

"hosting": {
  "public": "public",  // the only required attribute for Hosting
  "ignore": [
    "firebase.json",
    "**/.*",
    "**/node_modules/**"
  ]
}

عامة

مطلوبة
تحدّد السمة public الدليل الذي سيتم النشر فيه Firebase Hosting. القيمة التلقائية هي دليل باسم public، ولكن يمكنك تحديد مسار أي دليل طالما أنّه متوفّر في دليل مشروعك.

في ما يلي الاسم التلقائي المحدد للدليل الذي سيتم نشره:

"hosting": {
  "public": "public"

  // ...
}

يمكنك تغيير القيمة التلقائية إلى الدليل الذي تريد نشره:

"hosting": {
  "public": "dist/app"

  // ...
}

تجاهل

اختياري
تحدّد السمة ignore الملفات التي سيتم تجاهلها عند النشر. يمكن أن تستخدم أنماط مطابقة بالطريقة نفسها التي يتعامل بها Git مع .gitignore.

في ما يلي القيم التلقائية للملفات التي سيتم تجاهلها:

"hosting": {
  // ...

  "ignore": [
    "firebase.json",  // the Firebase configuration file (the file described on this page)
    "**/.*",  // files with a leading period should be hidden from the system
    "**/node_modules/**"  // contains dependencies used to create your site but not run it
  ]
}

تخصيص صفحة 404/لم يتم العثور على الصفحة

اختياري
يمكنك عرض خطأ مخصّص 404 Not Found عندما يحاول المستخدم الوصول إلى صفحة غير متوفّرة.

أنشئ ملفًا جديدًا في دليل public الخاص بمشروعك، وأطلِق عليه الاسم 404.html، ثم أضِف محتوى 404 Not Found المخصّص إلى الملف.

ستعرض Firebase Hosting محتوى صفحة الخطأ المخصّصة 404.html هذه إذا أطلق المتصفّح الخطأ 404 Not Found على نطاقك أو نطاقك الفرعي.

ضبط عمليات إعادة التوجيه

اختياري
استخدِم إعادة توجيه عنوان URL لمنع ظهور روابط تالفة إذا نقلت صفحة أو لتقصير عناوين URL. على سبيل المثال، يمكنك إعادة توجيه المتصفح من example.com/team إلى example.com/about.html.

حدِّد عمليات إعادة توجيه عناوين URL من خلال إنشاء السمة redirects التي تحتوي على مصفوفة من الكائنات (تُعرف باسم "قواعد إعادة التوجيه"). في كل قاعدة، حدِّد نمط عنوان URL يؤدي، في حال مطابقته لمسار عنوان URL الخاص بالطلب، إلى أن يستجيب Hosting بإعادة توجيه إلى عنوان URL المقصود المحدّد.

في ما يلي البنية الأساسية لسمة redirects. يعيد هذا المثال توجيه الطلبات إلى /foo من خلال إنشاء طلب جديد إلى /bar.

"hosting": {
  // ...

  // Returns a permanent redirect to "/bar" for requests to "/foo" (but not "/foo/**")
  "redirects": [ {
    "source": "/foo",
    "destination": "/bar",
    "type": 301
  } ]
}

عرض مثال أكثر تفصيلاً للسمة redirects

"hosting": {
  // ...

  // Add the "redirects" attribute within "hosting"
  "redirects": [ {
    // Returns a permanent redirect to "/bar" for requests to "/foo" (but not "/foo/**")
    "source": "/foo",
    "destination": "/bar",
    "type": 301
  }, {
    // Returns a permanent redirect to "/bar" for requests to both "/foo" and "/foo/**"
    "source": "/foo{,/**}"
    "destination": "/bar"
    "type": 301
  }, {
    // Returns a temporary redirect for all requests to files or directories in the "firebase" directory
    "source": "/firebase/**",
    "destination": "https://firebase.google.com/",
    "type": 302
  }, {
    // A regular expression-based redirect equivalent to the above behavior
    "regex": "/firebase/.*",
    "destination": "https://firebase.google.com/",
    "type": 302
  } ]
}

تحتوي السمة redirects على مصفوفة من قواعد إعادة التوجيه، ويجب أن تتضمّن كل قاعدة الحقول الواردة في الجدول أدناه.

تقارن السمة Firebase Hosting القيمة source أو regex بجميع مسارات عناوين URL في بداية كل طلب (قبل أن يحدّد المتصفّح ما إذا كان ملف أو مجلد متوفرًا في هذا المسار). في حال العثور على تطابق، يرسل خادم المصدر Firebase Hosting استجابة إعادة توجيه HTTPS تطلب من المتصفّح إرسال طلب جديد إلى عنوان URL destination.

الحقل		الوصف
redirects
	‫source (يُنصح به) أو regex	نمط عنوان URL يؤدي، في حال مطابقته لعنوان URL للطلب الأوّلي، إلى تفعيل Hosting لتطبيق عملية إعادة التوجيه استخدِم source لتحديد نمط عام (يُنصح به). استخدِم regex لتحديد تعبير عادي RE2.
	destination	عنوان URL ثابت يجب أن يقدّم المتصفّح طلبًا جديدًا إليه يمكن أن يكون عنوان URL هذا مسارًا نسبيًا أو مطلقًا.
	type	رمز استجابة HTTPS استخدام نوع 301 لـ "تم النقل بشكل دائم" استخدام النوع 302 لعملية "العثور" (إعادة توجيه مؤقتة)

ملاحظة مهمة: ضمن السمة redirects، تطبّق Hosting عملية إعادة التوجيه المحدّدة بموجب القاعدة الأولى التي تتضمّن نمط عنوان URL مطابقًا للمسار المطلوب. لذلك، عليك ترتيب القواعد بشكل متعمّد ضمن السمة redirects.

تسجيل أجزاء من عناوين URL لعمليات إعادة التوجيه

اختياري
في بعض الأحيان، قد تحتاج إلى تسجيل شرائح معيّنة من نمط عنوان URL لقاعدة إعادة التوجيه (القيمة source أو regex)، ثم إعادة استخدام هذه الشرائح في مسار destination الخاص بالقاعدة.

تسجيل أجزاء عناوين URL عند استخدام أنماط مطابقة عامة

إذا كنت تستخدم الحقل source (أي تحديد glob لنمط عنوان URL)، يمكنك تسجيل الأجزاء من خلال تضمين البادئة : لتحديد الجزء. إذا كنت بحاجة أيضًا إلى تسجيل مسار عنوان URL المتبقي بعد الجزء، أدرِج * مباشرةً بعد الجزء. على سبيل المثال:

"hosting": {
  // ...

  "redirects": [ {
    "source": "/blog/:post*",  // captures the entire URL segment beginning at "post"
    "destination": "https://blog.myapp.com/:post", // includes the entire URL segment identified and captured by the "source" value
    "type": 301
  }, {
    "source": "/users/:id/profile",  // captures only the URL segment "id", but nothing following
    "destination": "/users/:id/newProfile",  // includes the URL segment identified and captured by the "source" value
    "type": 301
  } ]
}

التقاط أجزاء من عنوان URL عند استخدام تعبيرات RE2 العادية

إذا كنت تستخدم حقل regex (أي تحديد تعبير عادي RE2 لنمط عنوان URL)، يمكنك تسجيل الأقسام باستخدام مجموعات تسجيل RE2 مسماة أو غير مسماة. يمكن استخدام مجموعات الالتقاط المسماة في الحقل destination مع البادئة :، بينما يمكن الإشارة إلى مجموعات الالتقاط غير المسماة من خلال الفهرس الرقمي الخاص بها في القيمة regex، بدءًا من 1. على سبيل المثال:

"hosting": {
  // ...

  "redirects": [ {
    "regex": "/blog/(?P<post>.+)",  // if you're familiar with PCRE, be aware that RE2 requires named capture groups to begin with ?P
    "destination": "https://blog.myapp.com/:post",  // includes the entire URL segment identified and captured by the `regex` value
    "type": 301
  }, {
    "regex": "/users/(\d+)/profile",  // uses the \d directive to only match numerical path segments
    "destination": "/users/:1/newProfile",  // the first capture group to be seen in the `regex` value is named 1, and so on
    "type": 301
  } ]
}

ضبط عمليات إعادة الكتابة

اختياري
استخدِم عملية إعادة كتابة لعرض المحتوى نفسه لعدة عناوين URL. وتكون عمليات إعادة الكتابة مفيدة بشكل خاص مع مطابقة الأنماط، إذ يمكنك قبول أي عنوان URL يطابق النمط والسماح للرمز البرمجي من جهة العميل بتحديد المحتوى الذي سيتم عرضه.

يمكنك أيضًا استخدام عمليات إعادة الكتابة لتوفير الدعم للتطبيقات التي تستخدم HTML5 pushState للتنقّل. عندما يحاول متصفّح فتح مسار عنوان URL يطابق نمط عنوان URL source أو regex المحدّد، سيتم تزويد المتصفّح بمحتوى الملف في عنوان URL destination بدلاً من ذلك.

حدِّد عمليات إعادة كتابة عناوين URL من خلال إنشاء السمة rewrites التي تحتوي على مصفوفة من الكائنات (تُعرف باسم "قواعد إعادة الكتابة"). في كل قاعدة، حدِّد نمط عنوان URL يؤدي، في حال مطابقته لمسار عنوان URL الخاص بالطلب، إلى أن يستجيب Hosting كما لو أنّ الخدمة قد تلقّت عنوان URL الوجهة المحدّد.

في ما يلي البنية الأساسية لسمة rewrites. يعرض هذا المثال الرمز index.html للطلبات التي تستهدف ملفات أو أدلة غير متوفّرة.

"hosting": {
  // ...

  // Serves index.html for requests to files or directories that do not exist
  "rewrites": [ {
    "source": "**",
    "destination": "/index.html"
  } ]
}

عرض مثال أكثر تفصيلاً للسمة rewrites

"hosting": {
// ...

// Add the "rewrites" attribute within "hosting"
"rewrites": [ {
  // Serves index.html for requests to files or directories that do not exist
  "source": "**",
  "destination": "/index.html"
}, {
  // Serves index.html for requests to both "/foo" and "/foo/**"
  // Using "/foo/**" only matches paths like "/foo/xyz", but not "/foo"
  "source": "/foo{,/**}",
  "destination": "/index.html"
}, {
  // A regular expression-based rewrite equivalent to the above behavior
  "regex": "/foo(/.*)?",
  "destination": "/index.html"
}, {
  // Excludes specified pathways from rewrites
  "source": "!/@(js|css)/**",
  "destination": "/index.html"
} ]
}

تحتوي السمة rewrites على مصفوفة من قواعد إعادة الكتابة، ويجب أن تتضمّن كل قاعدة الحقول الواردة في الجدول أدناه.

لا تطبّق Firebase Hosting قاعدة إعادة الكتابة إلا إذا لم يكن هناك ملف أو دليل في مسار عنوان URL يطابق نمط عنوان URL المحدّد source أو regex. عندما يؤدي طلب إلى تفعيل قاعدة إعادة كتابة، يعرض المتصفّح المحتوى الفعلي لملف destination المحدّد بدلاً من عملية إعادة توجيه HTTP.

الحقل		الوصف
rewrites
	‫source (يُنصح به) أو regex	نمط عنوان URL يؤدي، في حال مطابقته لعنوان URL الخاص بالطلب الأوّلي، إلى تفعيل Hosting لتطبيق عملية إعادة الكتابة استخدِم source لتحديد نمط عام (يُنصح به). استخدِم regex لتحديد تعبير عادي RE2.
	destination	ملف محلي يجب أن يكون متوفّرًا يمكن أن يكون عنوان URL هذا مسارًا نسبيًا أو مطلقًا.

ملاحظة مهمة: ضمن السمة rewrites، تطبّق Hosting عملية إعادة الكتابة المحدّدة بموجب القاعدة الأولى التي تتضمّن نمط عنوان URL مطابقًا للمسار المطلوب. لذلك، عليك ترتيب القواعد بشكل متعمّد ضمن السمة rewrites.

طلبات مباشرة إلى دالة

يمكنك استخدام rewrites لعرض دالة من عنوان URL Firebase Hosting. المثال التالي هو مقتطف من عرض محتوى ديناميكي باستخدام Cloud Functions.

على سبيل المثال، لتوجيه جميع الطلبات من الصفحة /bigben على موقعك الإلكتروني Hosting لتنفيذ الدالة bigben:

"hosting": {
  // ...

  // Directs all requests from the page `/bigben` to execute the `bigben` function
  "rewrites": [ {
    "source": "/bigben",
    "function": {
      "functionId": "bigben",
      "region": "us-central1"  // optional (see note below)
      "pinTag": true           // optional (see note below)
    }
  } ]
}

طريقة عمل region داخل الحظر function

في حال حذف region من حزمة function في hosting.rewrites config، تحاول واجهة سطر الأوامر Firebase رصد المنطقة تلقائيًا من رمز المصدر للدالة، والذي يكون us-central1 تلقائيًا في حال عدم تحديده. إذا لم يتوفّر الرمز المصدر للدالة، تحاول واجهة سطر الأوامر رصد المنطقة من الدالة التي تم نشرها. إذا كانت الدالة في مناطق متعددة، يتطلّب سطر الأوامر تحديد region في إعدادات hosting.rewrites.

طريقة عمل pinTag ضمن الكتلة function

تتوفّر ميزة pinTag في Cloud Functions for Firebase (الجيل الثاني) فقط. باستخدام هذه الميزة، يمكنك التأكّد من أنّ كل دالة مخصّصة لإنشاء المحتوى الديناميكي لموقعك الإلكتروني تتم مزامنتها مع موارد Hosting الثابتة وHosting config. تتيح لك هذه الميزة أيضًا معاينة عمليات إعادة الكتابة للوظائف على Hosting قنوات المعاينة.

إذا أضفت "pinTag": true إلى حزمة function من إعدادات hosting.rewrites، سيتم نشر وظيفة "التثبيت" مع موارد Hosting الثابتة وإعداداتها، حتى عند تشغيل firebase deploy --only hosting. إذا أعدت إصدارًا سابقًا من موقعك الإلكتروني، سيتم أيضًا إعادة الإصدار السابق من وظيفة "التثبيت".

ملاحظة: إذا أضفت pinTag إلى عملية إعادة كتابة حالية، عليك أولاً نشر عملية إعادة الكتابة المعدَّلة على قناتك "المباشرة". بعد عملية النشر هذه، يمكنك بعد ذلك معاينة التغييرات التي أجريتها على رمز الدالة في Hosting قنوات المعاينة بدون التأثير في الإصدار العلني.

تعتمد هذه الميزة على علامات Cloud Run، ويبلغ الحد الأقصى لعدد العلامات 1,000 علامة لكل خدمة و2,000 علامة لكل منطقة. وهذا يعني أنّه بعد إجراء مئات عمليات النشر، قد تتوقف النُسخ الأقدم من الموقع الإلكتروني عن العمل.

بعد إضافة قاعدة إعادة الكتابة هذه ونشرها على Firebase (باستخدام firebase deploy)، يمكن الوصول إلى الدالة من خلال عناوين URL التالية:

• النطاقات الفرعية في Firebase:
  PROJECT_ID.web.app/bigben و PROJECT_ID.firebaseapp.com/bigben

• أي نطاقات مخصّصة مرتبطة:
  CUSTOM_DOMAIN/bigben

عندما تعيد Firebase Hosting توجيه حركة المرور إلى إحدى الدوال، تتلقّى الدالة المسار الكامل الأصلي للطلب وسلسلة طلب البحث. على سبيل المثال، يتم تمرير طلب إلى /bigben/hello/world?foo=bar على موقعك الإلكتروني Hosting إلى الدالة مع الاحتفاظ بالمسار الكامل وطلب البحث. تأكَّد من أنّ معالج الدالة مكتوب للتعامل مع عنوان URL المطلق الكامل، وليس فقط المسار الأساسي المحدّد في إعادة الكتابة.

عند إعادة توجيه الطلبات إلى دوال تتضمّن Hosting، تكون طرق طلب HTTP المتوافقة هي GET وPOST وHEAD وPUT وDELETE وPATCH وOPTIONS. ولا تتوفّر طرق أخرى، مثل REPORT أو PROFIND.

الطلبات المباشرة إلى حاوية Cloud Run

يمكنك استخدام rewrites للوصول إلى حاوية Cloud Run من عنوان URL Firebase Hosting. المثال التالي هو مقتطف من عرض محتوى ديناميكي باستخدام Cloud Run.

على سبيل المثال، لتوجيه جميع الطلبات من الصفحة /helloworld على موقعك الإلكتروني Hosting لتشغيل مثيل حاوية helloworld:

"hosting": {
 // ...

 // Directs all requests from the page `/helloworld` to trigger and run a `helloworld` container
 "rewrites": [ {
   "source": "/helloworld",
   "run": {
     "serviceId": "helloworld",  // "service name" (from when you deployed the container image)
     "region": "us-central1"  // optional (if omitted, default is us-central1)
   }
 } ]
}

طريقة عمل pinTag داخل الحظر run

باستخدام هذه الميزة، يمكنك التأكّد من أنّ مراجعة Cloud Runالخدمة التي تستخدمها لإنشاء المحتوى الديناميكي لموقعك الإلكتروني تظل متزامنة مع موارد Hosting الثابتة وإعدادات Hosting. تتيح لك هذه الميزة أيضًا معاينة عمليات إعادة الكتابة في Cloud Run على قنوات معاينة Hosting.

إذا أضفت "pinTag": true إلى حزمة run في hosting.rewrites config، سيتم تثبيت موارد Hosting الثابتة والإعدادات على أحدث مراجعة لخدمة Cloud Run، وذلك في وقت النشر. في حال إعادة إصدار سابق من موقعك الإلكتروني، سيتم أيضًا إعادة إصدار سابق من خدمة Cloud Run "المثبّتة".

تعتمد هذه الميزة على علامات Cloud Run، ويبلغ الحد الأقصى لعدد العلامات 1,000 علامة لكل خدمة و2,000 علامة لكل منطقة. وهذا يعني أنّه بعد إجراء مئات عمليات النشر، قد تتوقف النُسخ الأقدم من الموقع الإلكتروني عن العمل.

بعد إضافة قاعدة إعادة الكتابة هذه ونشرها على Firebase (باستخدام firebase deploy)، يمكن الوصول إلى صورة الحاوية من خلال عناوين URL التالية:

• النطاقات الفرعية في Firebase:
  PROJECT_ID.web.app/helloworld و PROJECT_ID.firebaseapp.com/helloworld

• أي نطاقات مخصّصة مرتبطة:
  CUSTOM_DOMAIN/helloworld

عند إعادة توجيه الطلبات إلى حاويات Cloud Run باستخدام Hosting، طُرق طلب HTTP المتوافقة هي GET وPOST وHEAD وPUT وDELETE وPATCH وOPTIONS. لا تتوافق هذه السمة مع طرق أخرى، مثل REPORT أو PROFIND.

للحصول على أفضل أداء، يمكنك ربط خدمة Cloud Run بخدمة Hosting باستخدام المناطق التالية:

• us-west1
• us-central1
• us-east1
• europe-west1
• asia-east1

يمكن إعادة كتابة المحتوى من Hosting إلى Cloud Run في المناطق التالية:

• asia-east1
• asia-east2
• asia-northeast1
• asia-northeast2
• asia-northeast3
• asia-south1
• asia-south2
• asia-southeast1
• asia-southeast2
• australia-southeast1
• australia-southeast2
• europe-central2
• europe-north1
• europe-southwest1
• europe-west1
• europe-west12
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• europe-west8
• europe-west9
• me-central1
• me-west1
• northamerica-northeast1
• northamerica-northeast2
• southamerica-east1
• southamerica-west1
• us-central1
• us-east1
• us-east4
• us-east5
• us-south1
• us-west1
• us-west2
• us-west3
• us-west4
• us-west1
• us-central1
• us-east1
• europe-west1
• asia-east1

إنشاء نطاق خاص Dynamic Links

ملاحظة: تم إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا، ويجب عدم استخدامها في المشاريع الجديدة. سيتم إيقاف الخدمة نهائيًا قريبًا. اتّبِع دليل نقل البيانات واطّلِع على الأسئلة الشائعة حول إيقاف Dynamic Links نهائيًا لمزيد من المعلومات.

يمكنك استخدام rewrites لإنشاء نطاق مخصّص Dynamic Links. يمكنك الانتقال إلى Dynamic Links المستندات للحصول على معلومات تفصيلية حول إعداد نطاق مخصّص لـ Dynamic Links.

• استخدام نطاقك المخصّص فقط لـ Dynamic Links

  "hosting": {
    // ...
  
    "appAssociation": "AUTO",  // required for Dynamic Links (default is AUTO if not specified)
  
    // Add the "rewrites" attribute within "hosting"
    "rewrites": [ {
      "source": "/**",  // the Dynamic Links start with "https://CUSTOM_DOMAIN/"
      "dynamicLinks": true
    } ]
  }

• تحديد بادئات مسار النطاق المخصّص لاستخدامها في Dynamic Links

  "hosting": {
    // ...
  
    "appAssociation": "AUTO",  // required for Dynamic Links (default is AUTO if not specified)
  
    // Add the "rewrites" attribute within "hosting"
    "rewrites": [ {
      "source": "/promos/**",  // the Dynamic Links start with "https://CUSTOM_DOMAIN/promos/"
      "dynamicLinks": true
    }, {
      "source": "/links/share/**",  // the Dynamic Links start with "https://CUSTOM_DOMAIN/links/share/"
      "dynamicLinks": true
    } ]
  }

يتطلّب ضبط Dynamic Links في ملف firebase.json ما يلي:

الحقل		الوصف
appAssociation		يجب ضبطها على AUTO إذا لم تتضمّن هذه السمة في إعداداتك، ستكون القيمة التلقائية لـ appAssociation هي AUTO. من خلال ضبط هذه السمة على AUTO، يمكن لـ Hosting إنشاء ملفات assetlinks.json وapple-app-site-association ديناميكيًا عند طلبها.
rewrites
	source	مسار تريد استخدامه في Dynamic Links على عكس القواعد التي تعيد كتابة المسارات إلى عناوين URL، لا يمكن أن تحتوي قواعد إعادة الكتابة الخاصة بعناصر Dynamic Links على تعبيرات عادية.
	dynamicLinks	يجب ضبطها على true

ملاحظة مهمة: بالنسبة إلى Dynamic Links، يجب الانتباه بشكل خاص إلى ترتيب الأولوية للمضيفين.

• تأكَّد من أنّ بادئة عنوان URL Dynamic Links لا تتعارض مع إعدادات الاستضافة ذات الأولوية الأعلى (على سبيل المثال، يكون للمحتوى الثابت المستضاف دائمًا أولوية أعلى من عمليات إعادة الكتابة).
• ضمن كل من السمتَين redirects وrewrites، تطبّق السمة Hosting عملية إعادة التوجيه أو إعادة الكتابة المحدّدة بموجب قاعدة الأولوية التي تتضمّن تصميم عنوان URL مطابقًا للمسار المطلوب. لذلك، عليك ترتيب القواعد بشكل مدروس ضمن كل من السمتَين redirects وrewrites.

للحصول على معلومات مفصّلة، يُرجى الرجوع إلى مستندات Dynamic Links.

ضبط العناوين

اختياري
تسمح العناوين للعميل والخادم بتبادل معلومات إضافية مع الطلب أو الرد. يمكن أن تؤثّر بعض مجموعات العناوين في طريقة تعامل المتصفّح مع الصفحة ومحتواها، بما في ذلك التحكّم في الوصول والمصادقة والتخزين المؤقت والترميز.

حدِّد عناوين استجابة مخصّصة خاصة بالملف من خلال إنشاء السمة headers التي تحتوي على مصفوفة من عناصر العناوين. في كل عنصر، حدِّد نمط عنوان URL يؤدي، في حال مطابقته لمسار عنوان URL للطلب، إلى أن يطبّق Hosting عناوين الاستجابة المخصّصة المحدّدة.

في ما يلي البنية الأساسية لسمة headers. يطبّق هذا المثال عنوان CORS على جميع ملفات الخطوط.

"hosting": {
  // ...

  // Applies a CORS header for all font files
  "headers": [ {
    "source": "**/*.@(eot|otf|ttf|ttc|woff|font.css)",
    "headers": [ {
      "key": "Access-Control-Allow-Origin",
      "value": "*"
    } ]
  } ]
}

عرض مثال أكثر تفصيلاً للسمة headers

"hosting": {
  // ...

  // Add the "headers" attribute within "hosting"
  "headers": [ {
    // Applies a CORS header for all font files
    "source": "**/*.@(eot|otf|ttf|ttc|woff|font.css)",
    "headers": [ {
      "key": "Access-Control-Allow-Origin",
      "value": "*"
    } ]
  }, {
    // Overrides the default 1 hour browser cache with a 2 hour cache for all image files
    "source": "**/*.@(jpg|jpeg|gif|png)",
    "headers": [ {
      "key": "Cache-Control",
      "value": "max-age=7200"
    } ]
  }, {
    // A regular expression-based rewrite equivalent to the above behavior
    "regex": ".+/\w+\.(jpg|jpeg|gif|png)$",
    "headers": [ {
      "key": "Cache-Control",
      "value": "max-age=7200"
    } ]
  }, {
    // Sets the cache header for 404 pages to cache for 5 minutes
    "source": "404.html",
    "headers": [ {
      "key": "Cache-Control",
      "value": "max-age=300"
    } ]
  } ]
}

تحتوي السمة headers على مصفوفة من التعريفات، ويجب أن يتضمّن كل تعريف الحقول الواردة في الجدول أدناه.

الحقل			الوصف
headers
	‫source (يُنصح به) أو regex		نمط عنوان URL يؤدي، في حال تطابقه مع عنوان URL للطلب الأوّلي، إلى تفعيل Hosting لتطبيق العنوان المخصّص استخدِم source لتحديد نمط عام (يُنصح به). استخدِم regex لتحديد تعبير عادي RE2. لإنشاء عنوان مطابق لصفحة 404 المخصّصة، استخدِم 404.html كقيمة source أو regex.
	مصفوفة من (عناصر فرعية) headers		العناوين المخصّصة التي يطبّقها Hosting على مسار الطلب يجب أن يتضمّن كل عنوان فرعي زوجًا من key وvalue (راجِع الصفين التاليين).
		key	اسم العنوان، مثلاً Cache-Control
		value	قيمة العنوان، مثل max-age=7200

ملاحظة: تتم مطابقة نمط عنوان URL للرؤوس المخصّصة قبل تطبيق أي قواعد إعادة كتابة.

يمكنك الاطّلاع على مزيد من المعلومات حول Cache-Control في القسم Hosting الذي يصف عرض المحتوى الديناميكي واستضافة الخدمات المصغّرة. يمكنك أيضًا الاطّلاع على مزيد من المعلومات حول عناوين CORS.

ملاحظة مهمة: يؤدي Firebase Hosting إلى استبدال إعدادات Strict-Transport-Security في النطاقات الفرعية التلقائية Hosting (مثل *.web.app)، ولكن سيتم عرض القيمة التي تم ضبطها في أي نطاقات مخصّصة مرتبطة.

التحكّم في إضافات ".html"

اختيارية
تتيح لك السمة cleanUrls التحكّم في ما إذا كان يجب أن تتضمّن عناوين URL الإضافة .html أم لا.

عندما يزيل true وHosting تلقائيًا الامتداد .html من عناوين URL للملفات التي تم تحميلها، إذا تمت إضافة الامتداد .html في الطلب، ينفّذ Hosting عملية إعادة توجيه 301 إلى المسار نفسه ولكن بدون الامتداد .html.

إليك كيفية التحكّم في تضمين .html في عناوين URL من خلال تضمين السمة cleanUrls:

"hosting": {
  // ...

  // Drops `.html` from uploaded URLs
  "cleanUrls": true
}

التحكّم في الشرطات المائلة الأخيرة

اختيارية
تتيح لك السمة trailingSlash التحكّم في ما إذا كان يجب أن تتضمّن عناوين URL الخاصة بالمحتوى الثابت شرطات مائلة في النهاية أم لا.

• عندما تكون قيمة true هي Hosting، تتم إعادة توجيه عناوين URL لإضافة شرطة مائلة في النهاية.
• عندما تكون القيمة false، تعيد عمليات إعادة التوجيه Hosting توجيه عناوين URL لإزالة الشرطة المائلة اللاحقة.
• في حال عدم تحديد ذلك، لا يستخدم Hosting سوى الشرطات المائلة اللاحقة لملفات فهرس الدليل (مثل about/index.html).

إليك كيفية التحكّم في الشرطات المائلة الأخيرة من خلال إضافة السمة trailingSlash:

"hosting": {
  // ...

  // Removes trailing slashes from URLs
  "trailingSlash": false
}

لا تؤثّر السمة trailingSlash في عمليات إعادة الكتابة للمحتوى الديناميكي الذي تعرضه Cloud Functions أو Cloud Run.

مطابقة نمط Glob

تستخدِم خيارات إعداد Firebase Hosting بشكل موسّع ترميز مطابقة أنماط glob مع extglob، على غرار الطريقة التي يتعامل بها Git مع قواعد gitignore والطريقة التي يتعامل بها Bower مع قواعد ignore. صفحة الويكي هذه هي مرجع أكثر تفصيلاً، إلا أنّ ما يلي هو شرح للأمثلة المستخدَمة في هذه الصفحة:

• firebase.json: يطابق الملف firebase.json فقط في الجذر من الدليل public

• ‫**: يطابق أي ملف أو مجلد في أي دليل فرعي

• *: يطابق الملفات والمجلدات في جذر الدليل public فقط

• **/.*: يطابق أي ملف يبدأ بـ . (عادةً الملفات المخفية، مثل تلك الموجودة في المجلد .git) في أي دليل فرعي

• ‫**/node_modules/**: تطابق أي ملف أو مجلد في أي دليل فرعي للمجلد node_modules، والذي يمكن أن يكون بدوره في أي دليل فرعي للمجلد public

• ‫**/*.@(jpg|jpeg|gif|png): تطابق أي ملف في دليل فرعي عشوائي ينتهي بأحد اللاحقات التالية فقط: .jpg أو .jpeg أو .gif أو .png

مثال على إعداد Hosting الكامل

في ما يلي مثال على إعداد firebase.json كامل لـ Firebase Hosting. يُرجى العِلم أنّ ملف firebase.json يمكن أن يحتوي أيضًا على إعدادات لخدمات Firebase الأخرى.

{
  "hosting": {

    "public": "dist/app",  // "public" is the only required attribute for Hosting

    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ],

    "redirects": [ {
      "source": "/foo",
      "destination": "/bar",
      "type": 301
    }, {
      "source": "/firebase/**",
      "destination": "https://www.firebase.com",
      "type": 302
    } ],

    "rewrites": [ {
      // Shows the same content for multiple URLs
      "source": "/app/**",
      "destination": "/app/index.html"
    }, {
      // Configures a custom domain for Dynamic Links
      "source": "/promos/**",
      "dynamicLinks": true
    }, {
      // Directs a request to Cloud Functions
      "source": "/bigben",
      "function": "bigben"
    }, {
      // Directs a request to a Cloud Run containerized app
      "source": "/helloworld",
      "run": {
        "serviceId": "helloworld",
        "region": "us-central1"
      }
    } ],

    "headers": [ {
      "source": "**/*.@(eot|otf|ttf|ttc|woff|font.css)",
      "headers": [ {
        "key": "Access-Control-Allow-Origin",
        "value": "*"
      } ]
    }, {
      "source": "**/*.@(jpg|jpeg|gif|png)",
      "headers": [ {
        "key": "Cache-Control",
        "value": "max-age=7200"
      } ]
    }, {
      "source": "404.html",
      "headers": [ {
        "key": "Cache-Control",
        "value": "max-age=300"
      } ]
    } ],

    "cleanUrls": true,

    "trailingSlash": false,

    // Required to configure custom domains for Dynamic Links
    "appAssociation": "AUTO",

  }
}