لازم نیست نام دامنه‌های منحصر به فرد و برند محور خود را برای برنامه‌هایی که در Firebase App Hosting مستقر هستند، کنار بگذارید. می‌توانید به جای دامنه تولید شده توسط Firebase برای سایت میزبانی شده توسط Firebase خود، از یک دامنه سفارشی (مانند example.com یا app.example.com ) استفاده کنید. Firebase App Hosting برای هر یک از دامنه‌های شما یک گواهی SSL ارائه می‌دهد.
ادامه‌ی این سند، شما را با مراحل اتصال یک دامنه‌ی سفارشی به یکی از روش‌های زیر آشنا می‌کند:
برای اطمینان از سرویس بدون وقفه، رکوردهای DNS شما باید به ترتیب خاصی به‌روزرسانی شوند. برای جلوگیری از خرابی برنامه خود، دستورالعمل‌ها را برای انتقال دامنه دنبال کنید.
اگر زمان از کارافتادگی نگران‌کننده نیست، مثلاً وقتی دامنه‌ای را که جدیداً به برنامه وب شما اضافه شده است، متصل می‌کنید، دستورالعمل‌های اتصال دامنه جدید را دنبال کنید.
قبل از شروع: انواع رکورد DNS
بسته به پیکربندی فعلی دامنه‌تان، ویزارد تنظیمات دامنه App Hosting ممکن است از شما بخواهد ۱ تا ۵ رکورد DNS اضافه یا حذف کنید. نوع یک رکورد، عملکرد آن را تعیین می‌کند. انواع رکوردهایی که App Hosting ممکن است درخواست کند عبارتند از:
| نوع | توضیحات | اختصاصی |
|---|---|---|
| الف | این رکوردها حاوی مقادیر IPv4 (مثلاً 8.8.8.8) هستند که به مرورگرها می‌گویند هنگام تلاش برای اتصال به دامنه شما از چه آدرسی استفاده کنند. | بله |
| آآآآ | این رکوردها حاوی مقادیر IPv6 هستند (مثلاً 2001:4860:4860::8888)، نوع متفاوتی از رکورد آدرس با تقریباً همان عملکرد رکوردهای A. App Hosting در حال حاضر از رکوردهای AAAA استفاده نمی‌کند، اما از شما می‌خواهد که در صورت وجود، هرگونه رکورد موجود را از دامنه ما حذف کنید. | بله |
| نام | این رکوردها حاوی یک نام دامنه جداگانه هستند که باید به جای دامنه فعلی شما برای حل و فصل درخواست‌های DNS استفاده شوند. رکوردهای CNAME فقط در زیر دامنه‌ها (مثلاً www.example.com) مجاز هستند. App Hosting از رکوردهای CNAME به دو دلیل استفاده می‌کند:
| بله |
| تی‌اکس‌تی | این رکوردها به شما امکان می‌دهند فراداده‌های دلخواه را به دامنه خود پیوست کنید. App Hosting به شما امکان می‌دهد از یک فرمت خاص از رکورد TXT، fah-claim=[UUID] ، برای مشخص کردن دامنه سفارشی که باید در دامنه شما ارائه شود، استفاده کنید. | خیر |
| کا | این رکوردها به عنوان یک لیست مجاز برای مشخص کردن مراجع صدور گواهینامه که مجاز به صدور گواهینامه SSL برای دامنه شما هستند، عمل می‌کنند. App Hosting فقط در صورتی رکوردهای CAA را درخواست می‌کند که در غیر این صورت از صدور گواهینامه برای دامنه شما منع شده باشد. | خیر |
قبل از شروع: نام دامنه سفارشی شما
هنگام اضافه کردن یا ویرایش رکوردهای DNS، ارائه دهندگان دامنه مختلف انتظار دارند که شما ورودی‌های متفاوتی را برای فیلد میزبان (یا نام میزبان ) در سایت‌های مدیریت DNS خود وارد کنید. جادوگر دامنه سفارشی App Hosting از شما می‌خواهد که همین مقدار را در فیلد نام وارد کنید.
ما ورودی‌های رایج از ارائه‌دهندگان محبوب را در زیر گردآوری کرده‌ایم. برای دستورالعمل‌های دقیق به مستندات ارائه‌دهنده دامنه خود مراجعه کنید .
| نوع دامنه | نام دامنه سفارشی |
|---|---|
| دامنه آپکس | ورودی‌های رایج عبارتند از:
|
| زیردامنه | ورودی‌های رایج عبارتند از:
|
ارائه دهندگان دامنه رایج
در اینجا برخی از ارائه دهندگان دامنه رایج و انواع ورودی‌هایی که هر کدام ممکن است نیاز داشته باشند، آورده شده است. این اطلاعات تا حد امکان به‌روز نگه داشته می‌شود، اما برای دستورالعمل‌های دقیق به اسناد ارائه دهنده دامنه خود مراجعه کنید .
مهاجرت یک دامنه
اگر می‌خواهید دامنه خود را از ارائه‌دهنده دیگری به App Hosting بدون هیچ گونه قطعی منتقل کنید، می‌توانید از جریان Migrate a domain در کنسول Firebase استفاده کنید. این جریان شما را در یک فرآیند دو مرحله‌ای راهنمایی می‌کند که App Hosting برای ارائه محتوا در دامنه شما قبل از هدایت ترافیک به سرورهای App Hosting آماده می‌کند.
مرحله 1: اضافه کردن دامنه سفارشی
- صفحه App Hosting پروژه خود را باز کنید.
- با استفاده از گزینه View Dashboard، یک بخش App Hosting backend) انتخاب کنید.
- برگه تنظیمات را انتخاب کنید، سپس روی افزودن دامنه سفارشی کلیک کنید.
- نام دامنه سفارشی که می‌خواهید به سایت App Hosting خود متصل کنید را وارد کنید.
- (اختیاری) کادر را علامت بزنید تا همه درخواست‌ها روی دامنه سفارشی به یک دامنه مشخص شده دوم هدایت شوند (به طوری که
example.comوwww.example.comبه محتوای یکسانی هدایت شوند). - برای پیکربندی رکوردهای DNS و تکمیل تنظیم دامنه سفارشی خود، روی ادامه برای راه‌اندازی کلیک کنید.
مرحله 2: آماده سازی دامنه
- برگه «انتقال دامنه» را از ویزارد «تنظیم دامنه» انتخاب کنید.
- دستورالعمل‌های مرحله اول، یعنی آماده‌سازی دامنه ، را دنبال کنید که شامل مجموعه‌ای از تغییرات لازم برای App Hosting جهت ارائه خدمات به backend دلخواه شما و ایجاد اتصالات TLS امن برای دامنه شما می‌شود. رکوردها را از دامنه خود در ارائه‌دهنده DNS خود با ورودی‌های زیر برای رکوردهای مورد نیاز اضافه، حذف و ذخیره کنید:
- نام : نام دامنه دلخواه خود را برای رکوردها وارد کنید. میزبان مورد نظر شما، دامنه‌ای است که می‌خواهید محتوا را روی آن ارائه دهید؛ این دامنه می‌تواند یک دامنه اصلی یا زیر دامنه باشد. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "نام میزبان"، "نام" یا "دامنه" فهرست کند.
- نوع رکورد : رکورد DNS ارائه شده را اضافه کنید.
- مقدار : مقدار ارائه شده را به رکوردهای خود اختصاص دهید. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "داده"، "نقاط دسترسی"، "محتوا"، "آدرس" یا "آدرس IP" فهرست کند. محتوای فیلد مقدار بر اساس نوع رکورد متفاوت است. به عنوان مثال، رکوردهای TXT رشته هستند.
- گزینه «تأیید سوابق» را انتخاب کنید. App Hosting تلاش خواهد کرد تا تغییراتی را که در ارائه‌دهنده دامنه خود ایجاد کرده‌اید، شناسایی کند. اعمال تغییرات می‌تواند تا ۲۴ ساعت طول بکشد. می‌توانید وضعیت را در نمای «تنظیمات > دامنه‌ها» در داشبورد مدیریت بررسی کنید.
مرحله 3: مستقیماً به App Hosting
- پس از اینکه App Hosting به‌روزرسانی‌های رکورد از مرحله قبل را تأیید کرد، ویزارد به مرحله نهایی Direct to App Hosting می‌رود. این مرحله به‌روزرسانی‌های رکوردی را که باید برای هدایت ترافیک دامنه خود به سرورهای App Hosting انجام دهید، نمایش می‌دهد. مانند قبل، رکوردها را از دامنه خود در ارائه دهنده DNS خود با ورودی‌های زیر برای رکوردهای مورد نیاز اضافه، حذف و ذخیره کنید:
- نام : نام دامنه دلخواه خود را برای رکوردها وارد کنید. میزبان مورد نظر شما، دامنه‌ای است که می‌خواهید محتوا را روی آن ارائه دهید؛ این دامنه می‌تواند یک دامنه اصلی یا زیر دامنه باشد. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "نام میزبان"، "نام" یا "دامنه" فهرست کند.
- نوع رکورد : رکورد DNS ارائه شده را اضافه کنید.
- مقدار : مقدار ارائه شده را به رکوردهای خود اختصاص دهید. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "داده"، "نقاط دسترسی"، "محتوا"، "آدرس" یا "آدرس IP" فهرست کند. محتوای فیلد مقدار بر اساس نوع رکورد متفاوت است. به عنوان مثال، رکوردهای TXT رشته هستند.
- گزینه «تأیید سوابق» را انتخاب کنید. App Hosting تلاش خواهد کرد تا تغییراتی را که در ارائه‌دهنده دامنه خود ایجاد کرده‌اید، شناسایی کند. اعمال تغییرات می‌تواند تا ۲۴ ساعت طول بکشد. می‌توانید وضعیت را در نمای «تنظیمات > دامنه‌ها» در داشبورد مدیریت بررسی کنید.
اتصال دامنه جدید
اگر زمان از کار افتادن سرور نگران‌کننده نیست، مثلاً وقتی که دامنه‌ای را به برنامه وب خود متصل می‌کنید، دستورالعمل‌های این بخش را دنبال کنید.
مرحله 1: اضافه کردن دامنه سفارشی
- صفحه App Hosting پروژه خود را باز کنید.
- با استفاده از گزینه View Dashboard، یک بخش App Hosting backend) انتخاب کنید.
- برگه تنظیمات را انتخاب کنید، سپس روی افزودن دامنه سفارشی کلیک کنید.
- نام دامنه سفارشی که می‌خواهید به سایت App Hosting خود متصل کنید را وارد کنید.
- (اختیاری) کادر را علامت بزنید تا همه درخواست‌ها روی دامنه سفارشی به یک دامنه مشخص شده دوم هدایت شوند (به طوری که
example.comوwww.example.comبه محتوای یکسانی هدایت شوند). - برای پیکربندی رکوردهای DNS و تکمیل تنظیم دامنه سفارشی خود، روی ادامه برای راه‌اندازی کلیک کنید.
مرحله ۲: بررسی رکوردهای DNS
- ویزارد تنظیم دامنه در کنسول Firebase، رکوردهای لازم برای به‌روزرسانی صفحه شما به Firebase App Hosting را نشان می‌دهد. با استفاده از ورودی‌های زیر، رکوردها را از دامنه خود در ارائه‌دهنده DNS خود اضافه، حذف و ذخیره کنید:
- نام : نام دامنه دلخواه خود را برای رکوردها وارد کنید. میزبان مورد نظر شما، دامنه‌ای است که می‌خواهید محتوا را روی آن ارائه دهید؛ این دامنه می‌تواند یک دامنه اصلی یا زیر دامنه باشد. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "نام میزبان"، "نام" یا "دامنه" فهرست کند.
- نوع رکورد : رکورد DNS ارائه شده را اضافه کنید.
- مقدار : مقدار ارائه شده را به رکوردهای خود اختصاص دهید. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "داده"، "نقاط دسترسی"، "محتوا"، "آدرس" یا "آدرس IP" فهرست کند. محتوای فیلد مقدار بر اساس نوع رکورد متفاوت است. به عنوان مثال، رکوردهای TXT رشته هستند.
- گزینه «تأیید سوابق» را انتخاب کنید. App Hosting تلاش خواهد کرد تا تغییراتی را که در ارائه‌دهنده دامنه خود ایجاد کرده‌اید، شناسایی کند. اعمال تغییرات می‌تواند تا ۲۴ ساعت طول بکشد. می‌توانید وضعیت را در نمای «تنظیمات > دامنه‌ها» در داشبورد مدیریت بررسی کنید.
منتظر ارائه گواهی SSL باشید
پس از به‌روزرسانی رکوردهای App Hosting ، ارائه گواهی SSL برای دامنه شما می‌تواند تا چند ساعت طول بکشد. در برخی موارد، ممکن است تا ۲۴ ساعت پس از اتصال DNS به Firebase App Hosting ، این کار زمان ببرد.
شما می‌توانید این گواهی را با استفاده از ابزارهای امنیتی مرورگر مشاهده کنید. در حین آماده‌سازی دامنه، ممکن است گواهی نامعتبری را مشاهده کنید یا در اتصال به دامنه خود با مشکل مواجه شوید. این یک بخش عادی از فرآیند است و پس از در دسترس قرار گرفتن گواهی دامنه شما برطرف خواهد شد.
توجه: Firebase App Hosting به طور خودکار گواهینامه‌های SSL را در صورت نیاز برای دامنه‌های سفارشی مجدداً ارائه می‌دهد.
شرح وضعیت برای دامنه‌های سفارشی
| وضعیت | توضیحات |
|---|---|
| نیاز به تنظیم دارد | ممکن است لازم باشد پیکربندی مربوط به رکوردهای DNS خود را تغییر دهید.
|
| در حال بررسی | شما دامنه سفارشی خود را به درستی تنظیم کرده‌اید، اما Firebase App Hosting گواهی SSL ارائه نکرده است. گاهی اوقات، رکوردهای CAA بیش از حد محدودکننده می‌توانند صدور گواهی SSL برای یک دامنه سفارشی را متوقف کنند. اطمینان حاصل کنید که مراجع صدور گواهی `letsencrypt.org` و `pki.goog` مجاز به ایجاد گواهی SSL برای دامنه شما هستند. |
| گواهی ضرب سکه | یک گواهی SSL برای دامنه شما در حال تولید است. |
| متصل | دامنه سفارشی شما دارای رکوردهای DNS مناسب و گواهی SSL است. |