یک دامنه سفارشی را متصل کنید

لازم نیست نام دامنه منحصربفرد و مبتنی بر برند خود را برای برنامه‌های مستقر در Firebase App Hosting رها کنید. می توانید به جای دامنه ایجاد شده توسط Firebase برای سایت میزبان Firebase از یک دامنه سفارشی (مانند example.com یا app.example.com ) استفاده کنید. Firebase App Hosting یک گواهی SSL برای هر یک از دامنه های شما ارائه می دهد.

بقیه این سند شما را از طریق مراحل اتصال یک دامنه سفارشی به یکی از راه‌های زیر راهنمایی می‌کند:

• مهاجرت یک دامنه
• یک دامنه جدید وصل کنید

برای اطمینان از خدمات بدون وقفه، سوابق DNS شما باید به ترتیب خاصی به روز شوند. دستورالعمل‌های انتقال دامنه را دنبال کنید تا از خرابی برنامه خود جلوگیری کنید.

اگر زمان خرابی نگران کننده نیست، مانند زمانی که دامنه جدیدی را به برنامه وب خود متصل می کنید، دستورالعمل ها را برای اتصال دامنه جدید دنبال کنید.

قبل از شروع: انواع رکورد DNS

جادوگر دامنه تنظیم App Hosting می‌تواند از شما بخواهد بسته به پیکربندی فعلی دامنه، 1 تا 5 رکورد DNS را اضافه یا حذف کنید. نوع رکورد عملکرد آن را تعیین می کند. اینها انواع رکوردهایی هستند که App Hosting ممکن است درخواست کند:

تایپ کنید	توضیحات	انحصاری
الف	این رکوردها حاوی مقادیر IPv4 هستند (مثلاً 8.8.8.8)، که به مرورگرها می‌گوید هنگام تلاش برای تماس با دامنه شما از چه آدرسی استفاده کنند.	بله
AAAA	این رکوردها حاوی مقادیر IPv6 هستند (مثلاً 2001:4860:4860::8888)، نوع دیگری از رکورد آدرس با عملکردی تقریباً مشابه با رکوردهای A. App Hosting در حال حاضر از سوابق AAAA استفاده نمی کند، اما از شما می خواهد که در صورت وجود، موارد موجود را از دامنه ما حذف کنید.	بله
CNAME	این رکوردها حاوی یک نام دامنه جداگانه هستند که باید به جای دامنه فعلی شما برای حل پرس و جوهای DNS استفاده شود. رکوردهای CNAME فقط در زیر دامنه ها مجاز هستند (به عنوان مثال www.example.com). App Hosting به دو دلیل از رکوردهای CNAME استفاده می کند: ورود آسان: در صورت امکان، App Hosting از شما می خواهد که CNAME را به یک دامنه از پیش پیکربندی شده که با _custom-domain... . تأیید گواهی SSL: App Hosting از Cloud Certificate Manager برای ارائه گواهی‌های SSL برای دامنه سفارشی شما استفاده می‌کند. یک رکورد CNAME در یک زیر دامنه _acme-challenge... به مدیر گواهی اجازه می دهد تا گواهی ها را برای شما ایجاد و تمدید کند. پس از ورود، این سابقه نباید حذف شود وگرنه پوشش گواهی شما از بین خواهد رفت.	بله
TXT	این سوابق به شما امکان می دهد متادیتا دلخواه را به دامنه خود متصل کنید. App Hosting به شما امکان می دهد از فرمت خاصی از رکورد TXT، fah-claim=[UUID] استفاده کنید تا مشخص کنید که کدام دامنه سفارشی باید در دامنه شما ارائه شود.	خیر
CAA	این رکوردها به عنوان یک لیست مجاز برای تعیین مقامات گواهی که مجاز به برش گواهینامه های SSL برای دامنه شما هستند عمل می کنند. App Hosting فقط در صورتی سوابق CAA را درخواست می‌کند که از صدور گواهی‌های مربوط به دامنه شما مسدود شده باشد.	خیر

قبل از شروع: نام دامنه سفارشی شما

هنگام افزودن یا ویرایش رکوردهای DNS، ارائه دهندگان دامنه مختلف از شما انتظار دارند که ورودی های مختلفی را برای قسمت میزبان (یا نام میزبان ) در سایت های مدیریت DNS خود وارد کنید. جادوگر دامنه سفارشی App Hosting از شما می‌خواهد که همین مقدار را در قسمت نام وارد کنید.

ما ورودی های رایج را از ارائه دهندگان محبوب در زیر گردآوری کرده ایم. برای دستورالعمل های دقیق به مستندات ارائه دهنده دامنه خود مراجعه کنید .

نوع دامنه	نام دامنه سفارشی
دامنه Apex	ورودی های رایج عبارتند از: @ نام دامنه apex ( example .com ) قسمت Host را خالی بگذارید
زیر دامنه	ورودی های رایج عبارتند از: نام کامل زیر دامنه (به عنوان مثال، app. example .com ) فقط بخش زیر دامنه (مثلاً فقط app و کنار گذاشتن . example .com )

ارائه دهندگان دامنه رایج

در اینجا برخی از ارائه دهندگان دامنه رایج و انواع ورودی هایی که ممکن است هر کدام نیاز داشته باشند، آورده شده است. این اطلاعات تا حد امکان به روز نگه داشته می شوند، اما برای دستورالعمل های دقیق به اسناد ارائه دهنده دامنه خود مراجعه کنید .

Cloudflare

میزبان	ورودی
example.com.	@
www.example.com.	www

Google Cloud DNS

میزبان	ورودی
example.com.	.example.com.
www.example.com.	www .

نام ارزان

میزبان	ورودی
example.com.	@
www.example.com.	www

فضای مربعی

میزبان	ورودی
example.com.	@
www.example.com.	www

مهاجرت یک دامنه

اگر می‌خواهید دامنه خود را از یک ارائه‌دهنده دیگر به App Hosting بدون هیچ زمان قطعی انتقال دهید، می‌توانید از انتقال جریان دامنه در کنسول Firebase استفاده کنید. این جریان شما را از طریق یک فرآیند دو مرحله ای راهنمایی می کند که App Hosting برای ارائه محتوا در دامنه شما قبل از هدایت ترافیک به سرورهای App Hosting آماده می کند.

مرحله 1: افزودن دامنه سفارشی

1. صفحه App Hosting پروژه خود را باز کنید.
2. با استفاده از گزینه View Dashboard، یک باطن App Hosting انتخاب کنید.
3. برگه تنظیمات را انتخاب کنید، سپس روی افزودن دامنه سفارشی کلیک کنید.
4. نام دامنه سفارشی را که می‌خواهید به سایت App Hosting خود متصل شود وارد کنید.
5. (اختیاری) کادر را علامت بزنید تا همه درخواست‌های موجود در دامنه سفارشی به دامنه مشخص‌شده دوم هدایت شوند (مانند example.com و www.example.com به همان محتوا هدایت شوند).
6. برای پیکربندی رکوردهای DNS و پایان راه‌اندازی دامنه سفارشی خود، روی Continue to setup کلیک کنید.

مرحله 2: دامنه را آماده کنید

1. تب Migrate a domain را در Set up domain wizard انتخاب کنید.
2. دستورالعمل‌های مرحله اول، آماده‌سازی دامنه را دنبال کنید، که شامل مجموعه‌ای از تغییرات لازم برای App Hosting برای ارائه خدمات باطن دلخواه شما و ایجاد اتصالات TLS امن برای دامنه شما است. با ورودی های زیر برای سوابق مورد نیاز، رکوردها را از دامنه خود در ارائه دهنده DNS خود اضافه، حذف و ذخیره کنید:
   • نام : نام دامنه سفارشی خود را برای سوابق وارد کنید. میزبانی که نشان می دهید دامنه ای است که می خواهید محتوا را در آن ارائه دهید. این دامنه می تواند یک دامنه یا ساب دامنه باشد. ارائه‌دهنده دامنه شما ممکن است این عبارت را به‌عنوان «نام میزبان»، «نام» یا «دامنه» فهرست کند.
   • نوع ضبط : رکورد DNS ارائه شده را اضافه کنید.
   • مقدار : مقدار ارائه شده را به سوابق خود اختصاص دهید. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان «داده»، «نقاط به»، «محتوا»، «آدرس» یا «آدرس IP» فهرست کند. محتوای فیلد مقدار بسته به نوع رکورد متفاوت است، رکوردهای A و AAAA دارای آدرس IP به عنوان مقادیر هستند در حالی که رکوردهای TXT رشته ای هستند.
3. تأیید سوابق را انتخاب کنید. App Hosting سعی می کند تغییراتی را که در ارائه دهنده دامنه خود ایجاد کرده اید شناسایی کند. انتشار تغییرات ممکن است تا 24 ساعت طول بکشد. می توانید وضعیت را در تنظیمات > نمای دامنه ها در داشبورد باطن بررسی کنید.

مرحله 3: مستقیم به App Hosting

1. پس از اینکه App Hosting به‌روزرسانی‌های رکورد مرحله قبل را تأیید کرد، جادوگر به مرحله نهایی App Hosting پیش می‌رود. این مرحله به‌روزرسانی‌هایی را که باید برای هدایت ترافیک دامنه خود به سرورهای App Hosting انجام دهید، نمایش می‌دهد. مانند قبل، سوابق را از دامنه خود در ارائه دهنده DNS خود با ورودی های زیر برای سوابق مورد نیاز اضافه، حذف و ذخیره کنید:
   • نام : نام دامنه سفارشی خود را برای سوابق وارد کنید. میزبانی که نشان می دهید دامنه ای است که می خواهید محتوا را در آن ارائه دهید. این دامنه می تواند یک دامنه یا ساب دامنه باشد. ارائه‌دهنده دامنه شما ممکن است این عبارت را به‌عنوان «نام میزبان»، «نام» یا «دامنه» فهرست کند.
   • نوع ضبط : رکورد DNS ارائه شده را اضافه کنید.
   • مقدار : مقدار ارائه شده را به سوابق خود اختصاص دهید. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان «داده»، «نقاط به»، «محتوا»، «آدرس» یا «آدرس IP» فهرست کند. محتوای فیلد مقدار بسته به نوع رکورد متفاوت است، رکوردهای A و AAAA دارای آدرس IP به عنوان مقادیر هستند در حالی که رکوردهای TXT رشته ای هستند.
2. تأیید سوابق را انتخاب کنید. App Hosting سعی می کند تغییراتی را که در ارائه دهنده دامنه خود ایجاد کرده اید شناسایی کند. انتشار تغییرات ممکن است تا 24 ساعت طول بکشد. می توانید وضعیت را در تنظیمات > نمای دامنه ها در داشبورد باطن بررسی کنید.

یک دامنه جدید وصل کنید

اگر زمان خرابی نگران کننده نیست، مانند زمانی که دامنه جدیدی را به برنامه وب خود متصل می کنید، دستورالعمل های این بخش را دنبال کنید.

مرحله 1: افزودن دامنه سفارشی

1. صفحه App Hosting پروژه خود را باز کنید.
2. با استفاده از گزینه View Dashboard، یک باطن App Hosting انتخاب کنید.
3. برگه تنظیمات را انتخاب کنید، سپس روی افزودن دامنه سفارشی کلیک کنید.
4. نام دامنه سفارشی را که می‌خواهید به سایت App Hosting خود متصل شود وارد کنید.
5. (اختیاری) کادر را علامت بزنید تا همه درخواست‌های موجود در دامنه سفارشی به دامنه مشخص‌شده دوم هدایت شوند (مانند example.com و www.example.com به همان محتوا هدایت شوند).
6. برای پیکربندی رکوردهای DNS و پایان راه‌اندازی دامنه سفارشی خود، روی Continue to setup کلیک کنید.

مرحله 2: بررسی سوابق DNS

1. جادوگر راه اندازی دامنه کنسول Firebase سوابق لازم را نشان می دهد که باید به روز شوند تا صفحه شما را به میزبانی برنامه Firebase نشان دهد. با ورودی های زیر سوابق را از دامنه خود در ارائه دهنده DNS خود اضافه، حذف و ذخیره کنید:
   • نام : نام دامنه سفارشی خود را برای سوابق وارد کنید. میزبانی که نشان می دهید دامنه ای است که می خواهید محتوا را در آن ارائه دهید. این دامنه می تواند یک دامنه یا ساب دامنه باشد. ارائه‌دهنده دامنه شما ممکن است این عبارت را به‌عنوان «نام میزبان»، «نام» یا «دامنه» فهرست کند.
   • نوع ضبط : رکورد DNS ارائه شده را اضافه کنید.
   • مقدار : مقدار ارائه شده را به سوابق خود اختصاص دهید. ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان «داده»، «نقاط به»، «محتوا»، «آدرس» یا «آدرس IP» فهرست کند. محتوای فیلد مقدار بسته به نوع رکورد متفاوت است، رکوردهای A و AAAA دارای آدرس IP به عنوان مقادیر هستند در حالی که رکوردهای TXT رشته ای هستند.
2. تأیید سوابق را انتخاب کنید. App Hosting سعی می کند تغییراتی را که در ارائه دهنده دامنه خود ایجاد کرده اید شناسایی کند. انتشار تغییرات ممکن است تا 24 ساعت طول بکشد. می توانید وضعیت را در تنظیمات > نمای دامنه ها در داشبورد باطن بررسی کنید.

منتظر ارائه گواهی SSL باشید

پس از به‌روزرسانی سوابق DNS App Hosting ارائه گواهی SSL برای دامنه شما ممکن است چند ساعت طول بکشد. در برخی موارد، پس از اینکه DNS خود را به Firebase App Hosting هدایت کردید، ممکن است تا 24 ساعت طول بکشد.

می توانید این گواهی را با استفاده از ابزارهای امنیتی مرورگر مشاهده کنید. هنگامی که دامنه در حال آماده سازی است، ممکن است گواهی نامعتبر ببینید یا در اتصال به دامنه خود مشکل داشته باشید. این یک بخش عادی از فرآیند است و پس از دردسترس شدن گواهی دامنه شما برطرف خواهد شد.

توجه: Firebase App Hosting به‌طور خودکار گواهی‌های SSL را در صورت نیاز برای دامنه‌های سفارشی تجدید می‌کند.

توضیحات وضعیت برای دامنه های سفارشی

وضعیت	توضیحات
نیاز به راه اندازی دارد	ممکن است لازم باشد پیکربندی را با سوابق DNS خود تغییر دهید. در بیشتر موارد، سوابق DNS A شما از ارائه دهنده نام دامنه شما به سرورهای Firebase App Hosting منتشر نشده است. نکته عیب‌یابی: اگر بیش از 24 ساعت گذشته است، بررسی کنید که سوابق خود را به Firebase App Hosting ارجاع داده‌اید. در موارد نادرتر، چالش‌های SSL ممکن است با شکست مواجه شوند زیرا سوابق DNS شما دارای سوابق A یا سوابق CNAME هستند که به ارائه‌دهندگان میزبانی دیگر اشاره می‌کنند. نکته عیب‌یابی: بررسی کنید که سوابق A شما فقط به Firebase App Hosting باشد و تمام رکوردهای CNAME را حذف کنید.
در انتظار	دامنه سفارشی خود را به درستی تنظیم کردید، اما Firebase App Hosting گواهی SSL ارائه نکرده است. گاهی اوقات، سوابق بیش از حد محدود کننده CAA می‌توانند تولید گواهی SSL را برای یک دامنه سفارشی متوقف کنند. اطمینان حاصل کنید که مقامات گواهی «letsencrypt.org» و «pki.goog» مجاز به ایجاد گواهینامه SSL برای دامنه شما هستند.
گواهی ضرب	یک گواهی SSL برای دامنه شما در حال تولید است.
متصل شد	دامنه سفارشی شما دارای سوابق DNS مناسب و دارای گواهی SSL است. شما می توانید محتوای سایت خود را ارائه دهید.