ربط نطاق خاص

ليس عليك التخلي عن أسماء النطاقات الفريدة التي تركز على علامتك التجارية للتطبيقات التي يتم نشرها على Firebase App Hosting. يمكنك استخدام نطاق خاص (مثل example.com أو app.example.com) بدلاً من نطاق من إنشاء Firebase لـ موقعك الإلكتروني المستضاف على Firebase. Firebase App Hosting توفّر شهادة طبقة المقابس الآمنة (SSL) لكل نطاق من نطاقاتك.

تُطلعك بقية هذا المستند على خطوات ربط نطاق خاص بإحدى الطرق التالية:

• نقل نطاق
• ربط نطاق جديد

لضمان عدم انقطاع الخدمة، يجب تعديل سجلات نظام أسماء النطاقات بترتيب معيّن. اتّبِع التعليمات لنقل نطاق لتجنُّب فترة التوقف عن العمل لتطبيقك.

إذا لم تكن فترة التوقف عن العمل مشكلة، مثلاً عند ربط نطاق جديد بتطبيق الويب، اتّبِع التعليمات لربط نطاق جديد.

ملاحظة: يفترض هذا الدليل أنّك أكملت مهام App Hosting الإعداد الأساسية بحيث يكون لديك نطاق خلفي Firebase App Hosting في مشروعك على Firebase. لقد قدّمنا بعض المعلومات الأساسية حول أنواع السجلات ومعلومات عن الإدخالات الشائعة من موفّري الخدمات المشهورين للرجوع إليها، ولكن احرص على الاطّلاع على مستندات موفّر النطاق للحصول على تعليمات مفصّلة حول الإعداد من جهة المزوّد.

قبل البدء: أنواع سجلات نظام أسماء النطاقات

قد يطلب منك معالج App Hosting إعداد النطاق في App Hosting إضافة سجلّ واحد إلى 5 سجلات لنظام أسماء النطاقات أو إزالتها، وذلك حسب الإعدادات الحالية لنطاقك. يحدّد النوع وظيفة السجلّ. في ما يلي أنواع السجلات التي قد تطلبها خدمة App Hosting:

النوع	الوصف	حصري
A	تحتوي هذه السجلات على قيم IPv4 (مثل 8.8.8.8)، ما يخبر المتصفحات بعنوان IP الذي يجب استخدامه عند محاولة التواصل مع نطاقك.	نعم
AAAA	تحتوي هذه السجلات على قيم IPv6 (مثل 2001:4860:4860::8888)، وهو نوع مختلف من سجلات عناوين IP التي لها الوظيفة نفسها تقريبًا لسجلات A. App Hosting لا تستخدم حاليًا سجلات AAAA، ولكنها ستطلب منك إزالة أي سجلات حالية من نطاقنا، إذا كانت متوفّرة.	نعم
CNAME	تحتوي هذه السجلات على اسم نطاق منفصل يجب استخدامه بدلاً من نطاقك الحالي لحلّ طلبات بحث نظام أسماء النطاقات. لا يُسمح بسجلات CNAME إلا في النطاقات الفرعية (مثل www.example.com). App Hosting تستخدم سجلات CNAME لـ سببَين: الإعداد السهل: تطلب منك خدمة App Hosting، متى أمكن، استخدام CNAME لنطاق تم إعداده مسبقًا ويبدأ بـ _custom-domain.... التحقّق من شهادة طبقة المقابس الآمنة (SSL): App Hosting تستخدم أداة Cloud Certificate Manager لتوفير شهادات طبقة المقابس الآمنة (SSL) لنطاقك الخاص. يسمح سجلّ CNAME في نطاق فرعي _acme-challenge... لـ Certificate Manager بإنشاء الشهادات وتجديدها لك. بعد الإعداد، يجب عدم إزالة هذا السجلّ وإلا ستنتهي صلاحية تغطية الشهادة.	نعم
TXT	تسمح لك هذه السجلات بإرفاق بيانات وصفية عشوائية بنطاقك. App Hosting تسمح لك باستخدام تنسيق معيّن لسجلّ TXT، وهو fah-claim=[UUID]، للإشارة إلى النطاق الخاص الذي يجب أن تعرضه على نطاقك.	لا
CAA	تعمل هذه السجلات كقائمة مسموح بها لتحديد مراجع التصديق المسموح لها بإنشاء شهادات طبقة المقابس الآمنة (SSL) لنطاقك. لا تطلب App Hosting سجلات CAA إلا إذا كانت محظورة من إنشاء شهادات لنطاقك.	لا

قبل البدء: اسم نطاقك الخاص

عند إضافة سجلات نظام أسماء النطاقات أو تعديلها، يتوقع موفّرو النطاقات المختلفون منك إدخال إدخالات مختلفة لحقل المضيف (أو اسم المضيف) ضمن مواقع إدارة نظام أسماء النطاقات. يطلب منك معالج النطاق الخاص App Hosting إدخال هذه القيمة نفسها في حقل الاسم.

لقد جمعنا الإدخالات الشائعة من موفّري الخدمات المشهورين أدناه. يُرجى الرجوع إلى مستندات موفّر النطاق للحصول على تعليمات مفصّلة.

نوع النطاق	اسم النطاق الخاص
النطاق الأساسي	تشمل الإدخالات الشائعة ما يلي: @ اسم النطاق الأساسي (على سبيل المثال، example.com) ترك حقل المضيف فارغًا
النطاق الفرعي	تشمل الإدخالات الشائعة ما يلي: اسم النطاق الفرعي الكامل (على سبيل المثال، app.example.com) جزء النطاق الفرعي فقط (على سبيل المثال، app فقط، مع حذف .example.com)

موفّرو النطاقات الشائعون

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

ملاحظة: في أي وقت، يمكنك التحقّق مما إذا تم تعديل سجلات نظام أسماء النطاقات بشكلٍ صحيح باستخدام خدمة Dig في "مجموعة أدوات وحدة تحكّم المشرف في Google". يُرجى العِلم أنّه حتى إذا تم تعديل سجلاتك، قد تحتاج إلى مزيد من الوقت لنشرها أو توفير شهادة طبقة المقابس الآمنة (SSL).

Cloudflare

المضيف	الإدخال
example.com.	@
www.example.com.	www

Google Cloud DNS

المضيف	الإدخال
example.com.	.example.com.
www.example.com.	www.example.com.

NameCheap

المضيف	الإدخال
example.com.	@
www.example.com.	www

Squarespace

المضيف	الإدخال
example.com.	@
www.example.com.	www

نقل نطاق

إذا أردت نقل نطاقك من موفّر آخر إلى App Hosting بدون أي فترة توقف عن العمل، يمكنك استخدام مسار نقل نطاق في Firebase Console. يرشدك هذا المسار خلال عملية من خطوتَين تُعدّ App Hosting لعرض المحتوى على نطاقك قبل توجيه الزيارات إلى خوادم App Hosting.

الخطوة 1: إضافة نطاق خاص

1. في وحدة التحكم Firebase، انتقِل إلى الاستضافة والخدمات بلا خادم > App Hosting.
2. اختَر نطاقًا خلفيًا باستخدام خيار عرض لوحة البيانات.App Hosting
3. انقر على علامة التبويب الإعدادات ، ثم على إضافة نطاق خاص.
4. أدخِل اسم النطاق الخاص الذي تريد ربطه بموقعك الإلكتروني على App Hosting
5. (اختياري) ضَع علامة في المربّع لإعادة توجيه جميع الطلبات على النطاق الخاص إلى نطاق ثانٍ محدّد (بحيث يتم إعادة التوجيه من example.com وwww.example.com إلى المحتوى نفسه).
6. انقر على متابعة إلى الإعداد لضبط سجلات نظام أسماء النطاقات وإكمال إعداد نطاقك الخاص.

الخطوة 2: إعداد النطاق

1. انقر على علامة التبويب نقل نطاق في معالج إعداد النطاق.
2. اتّبِع التعليمات في الخطوة الأولى، إعداد النطاق، التي تتضمّن مجموعة التغييرات اللازمة لكي تعرض App Hosting النطاق الخلفي المفضّل لديك وتنشئ اتصالات آمنة باستخدام بروتوكول TLS لنطاقك. أضِف السجلات وأزِلها واحفظها من نطاقك في موفّر نظام أسماء النطاقات باستخدام الإدخالات التالية للسجلات المطلوبة:
   • الاسم: أدخِل اسم نطاقك الخاص للسجلات. المضيف الذي تشير إليه هو النطاق الذي تريد عرض المحتوى عليه، ويمكن أن يكون هذا النطاق نطاقًا أساسيًا أو نطاقًا فرعيًا. قد يعرض موفّر النطاق هذا المصطلح على أنّه "اسم المضيف" أو "الاسم" أو "النطاق".
   • نوع السجلّ: أضِف سجلّ نظام أسماء النطاقات المقدَّم.
   • القيمة: خصِّص القيمة المقدَّمة لسجلاتك. قد يعرض موفّر النطاق هذا المصطلح على أنّه "البيانات" أو "يشير إلى" أو "المحتوى" أو "العنوان" أو "عنوان IP". يختلف محتوى حقل القيمة حسب نوع السجلّ، مثلاً، سجلات TXT هي سلاسل.
3. انقر على تأكيد السجلات. App Hosting ستحاول رصد التغييرات التي أجريتها في موفّر النطاق. قد يستغرق نشر التغييرات ما يصل إلى 24 ساعة. يمكنك الاطّلاع على الحالة في العرض الإعدادات > النطاقات في لوحة بيانات النطاق الخلفي.

الخطوة 3: التوجيه إلى App Hosting

1. بعد أن تؤكّد App Hosting تعديلات السجلات من الخطوة السابقة، ينتقل المعالج إلى الخطوة الأخيرة التوجيه إلى App Hosting. تعرض هذه الخطوة تعديلات السجلات التي يجب إجراؤها لتوجيه الزيارات إلى خوادم App Hosting. كما في السابق، أضِف السجلات وأزِلها واحفظها من نطاقك في موفّر نظام أسماء النطاقات باستخدام الإدخالات التالية للسجلات المطلوبة:
   • الاسم: أدخِل اسم نطاقك الخاص للسجلات. المضيف الذي تشير إليه هو النطاق الذي تريد عرض المحتوى عليه، ويمكن أن يكون هذا النطاق نطاقًا أساسيًا أو نطاقًا فرعيًا. قد يعرض موفّر النطاق هذا المصطلح على أنّه "اسم المضيف" أو "الاسم" أو "النطاق".
   • نوع السجلّ: أضِف سجلّ نظام أسماء النطاقات المقدَّم.
   • القيمة: خصِّص القيمة المقدَّمة لسجلاتك. قد يعرض موفّر النطاق هذا المصطلح على أنّه "البيانات" أو "يشير إلى" أو "المحتوى" أو "العنوان" أو "عنوان IP". يختلف محتوى حقل القيمة حسب نوع السجلّ، مثلاً، سجلات TXT هي سلاسل.
2. انقر على تأكيد السجلات. App Hosting ستحاول رصد التغييرات التي أجريتها في موفّر النطاق. قد يستغرق نشر التغييرات ما يصل إلى 24 ساعة. يمكنك الاطّلاع على الحالة في العرض الإعدادات > النطاقات في لوحة بيانات النطاق الخلفي.

ملاحظة مهمة: احرص على إزالة أي سجلات A أو سجلات CNAME تشير إلى موفّرين آخرين. إذا كان أي من أنواع السجلات هذه متوفّرًا، لا يمكن لـ Firebase توفير شهادة طبقة المقابس الآمنة (SSL).

ربط نطاق جديد

إذا لم تكن فترة التوقف عن العمل مشكلة، مثلاً عند ربط نطاق جديد بتطبيق الويب، اتّبِع التعليمات الواردة في هذا القسم.

الخطوة 1: إضافة نطاق خاص

1. في وحدة التحكم Firebase، انتقِل إلى الاستضافة والخدمات بلا خادم > App Hosting.
2. اختَر نطاقًا خلفيًا باستخدام خيار عرض لوحة البيانات.App Hosting
3. انقر على علامة التبويب الإعدادات ، ثم على إضافة نطاق خاص.
4. أدخِل اسم النطاق الخاص الذي تريد ربطه بموقعك الإلكتروني على App Hosting
5. (اختياري) ضَع علامة في المربّع لإعادة توجيه جميع الطلبات على النطاق الخاص إلى نطاق ثانٍ محدّد (بحيث يتم إعادة التوجيه من example.com وwww.example.com إلى المحتوى نفسه).
6. انقر على متابعة إلى الإعداد لضبط سجلات نظام أسماء النطاقات وإكمال إعداد نطاقك الخاص.

الخطوة 2: تأكيد سجلات نظام أسماء النطاقات

1. سيعرض معالج إعداد النطاق في Firebase Console السجلات اللازمة التي يجب تعديلها لتوجيه صفحتك إلى Firebase App Hosting. أضِف السجلات وأزِلها واحفظها من نطاقك في موفّر نظام أسماء النطاقات باستخدام الإدخالات التالية:
   • الاسم: أدخِل اسم نطاقك الخاص للسجلات. المضيف الذي تشير إليه هو النطاق الذي تريد عرض المحتوى عليه، ويمكن أن يكون هذا النطاق نطاقًا أساسيًا أو نطاقًا فرعيًا. قد يعرض موفّر النطاق هذا المصطلح على أنّه "اسم المضيف" أو "الاسم" أو "النطاق".
   • نوع السجلّ: أضِف سجلّ نظام أسماء النطاقات المقدَّم.
   • القيمة: خصِّص القيمة المقدَّمة لسجلاتك. قد يعرض موفّر النطاق هذا المصطلح على أنّه "البيانات" أو "يشير إلى" أو "المحتوى" أو "العنوان" أو "عنوان IP". يختلف محتوى حقل القيمة حسب نوع السجلّ، مثلاً، سجلات TXT هي سلاسل.
2. انقر على تأكيد السجلات. App Hosting ستحاول رصد التغييرات التي أجريتها في موفّر النطاق. قد يستغرق نشر التغييرات ما يصل إلى 24 ساعة. يمكنك الاطّلاع على الحالة في العرض الإعدادات > النطاقات في لوحة بيانات النطاق الخلفي.

ملاحظة مهمة: احرص على إزالة أي سجلات A أو سجلات CNAME تشير إلى موفّرين آخرين. إذا كان أي من أنواع السجلات هذه متوفّرًا، لا يمكن لـ Firebase توفير شهادة طبقة المقابس الآمنة (SSL).

الانتظار إلى حين توفير شهادة طبقة المقابس الآمنة (SSL)

قد تستغرق App Hosting بضع ساعات لتوفير شهادة طبقة المقابس الآمنة (SSL) لنطاقك بعد تعديل سجلات نظام أسماء النطاقات. في بعض الحالات، قد يستغرق ذلك ما يصل إلى 24 ساعة بعد توجيه نظام أسماء النطاقات إلى Firebase App Hosting.

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

ملاحظة: Firebase App Hosting تعيد تلقائيًا توفير شهادات طبقة المقابس الآمنة (SSL) للنطاقات الخاصة، حسب الحاجة.

أوصاف الحالة للنطاقات الخاصة

الحالة	الوصف
يجب الإعداد	قد تحتاج إلى تغيير إعدادات سجلات نظام أسماء النطاقات. في معظم الحالات، لم يتم نشر سجلات A لنظام أسماء النطاقات من موفّر اسم النطاق إلى خوادم Firebase App Hosting. نصيحة لتحديد المشاكل وحلّها: إذا مرّ أكثر من 24 ساعة، تأكَّد من أنّك وجّهت سجلاتك إلى Firebase App Hosting. في حالات نادرة، قد تفشل تحديات طبقة المقابس الآمنة (SSL) لأنّ سجلات نظام أسماء النطاقات تحتوي على سجلات A أو سجلات CNAME تشير إلى موفّري استضافة آخرين. نصيحة لتحديد المشاكل وحلّها: تأكَّد من أنّ سجلات A تشير فقط إلى Firebase App Hosting، وأزِل جميع سجلات CNAME.
في انتظار المراجعة	لقد أعددت نطاقك الخاص بشكلٍ صحيح، ولكن Firebase App Hosting لم توفّر شهادة طبقة المقابس الآمنة (SSL). في بعض الأحيان، يمكن أن تؤدي سجلات CAA المقيّدة بشكلٍ مفرط إلى إيقاف إنشاء شهادة طبقة المقابس الآمنة (SSL) لنطاق خاص. تأكَّد من أنّ مراجع التصديق `letsencrypt.org` و `pki.goog` مسموح لها بإنشاء شهادات طبقة المقابس الآمنة (SSL) لـ نطاقك.
جارٍ إنشاء الشهادة	جارٍ إنشاء شهادة طبقة المقابس الآمنة (SSL) لنطاقك.
Connected	يحتوي نطاقك الخاص على سجلات نظام أسماء النطاقات المناسبة ولديه شهادة طبقة المقابس الآمنة (SSL) . يمكنك عرض محتوى موقعك الإلكتروني.