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

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

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

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

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

قبل‌از شروع: انواع سابقه DNS

بسته به پیکربندی فعلی دامنه‌تان، ممکن است جادوی App Hosting راه‌اندازی دامنه از شما بخواهد ۱ تا ۵ سابقه ساناد را اضافه یا حذف کنید. نوع رکورد عملکرد آن را تعیین می‌کند. این‌ها انواع سوابقی است که App Hosting ممکن است درخواست کند:

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

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

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

ورودی‌های رایج از ارائه‌دهندگان پرطرفدار را در زیر گردآوری کرده‌ایم. برای دستورالعمل‌های دقیق، به اسناد ارائه‌دهنده دامنه‌تان مراجعه کنید.

نوع دامنه نام دامنه سفارشی
دامنه Apex

ورودی‌های رایج عبارت‌اند از:

  • @
  • نام دامنه رأس (برای مثال، example.com)
  • خالی گذاشتن فیلد میزبان
زیردامنه

ورودی‌های رایج عبارت‌اند از:

  • نام کامل زیردامنه (برای مثال، app.example.com)
  • فقط بخش زیردامنه (برای مثال، فقط app، و حذف .example.com)

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

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

انتقال دامنه

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

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

  1. در کنسول Firebase، به میزبانی و بدون سرور > میزبانی برنامه بروید.
  2. بااستفاده از گزینه مشاهده داشبورد، یک پسای App Hosting انتخاب کنید.
  3. برگه تنظیمات را انتخاب کنید، سپس روی افزودن دامنه سفارشی کلیک کنید.
  4. نام دامنه سفارشی را که می‌خواهید به سایت App Hosting متصل شود وارد کنید.
  5. (اختیاری) چارگوش را علامت بزنید تا همه درخواست‌های دامنه سفارشی به دامنه مشخص‌شده دوم هدایت شود (به‌طوری که example.com و www.example.com به همان محتوا هدایت شوند).
  6. روی ادامه راه‌اندازی کلیک کنید تا سوابق ساناد را پیکربندی کنید و راه‌اندازی دامنه سفارشی را تکمیل کنید.

مرحله ۲: آماده کردن دامنه

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

مرحله ۳: هدایت به App Hosting

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

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

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

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

  1. در کنسول Firebase، به میزبانی و بدون سرور > میزبانی برنامه بروید.
  2. بااستفاده از گزینه مشاهده داشبورد، یک پسای App Hosting انتخاب کنید.
  3. برگه تنظیمات را انتخاب کنید، سپس روی افزودن دامنه سفارشی کلیک کنید.
  4. نام دامنه سفارشی را که می‌خواهید به سایت App Hosting متصل شود وارد کنید.
  5. (اختیاری) چارگوش را علامت بزنید تا همه درخواست‌های دامنه سفارشی به دامنه مشخص‌شده دوم هدایت شود (به‌طوری که example.com و www.example.com به همان محتوا هدایت شوند).
  6. روی ادامه راه‌اندازی کلیک کنید تا سوابق ساناد را پیکربندی کنید و راه‌اندازی دامنه سفارشی را تکمیل کنید.

مرحله ۲: تأیید کردن رکوردهای ساناد

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

منتظر آماده‌سازی گواهینامه SSL بمانید

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

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

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

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

وضعیت شرح
به راه‌اندازی نیاز دارد

ممکن است لازم باشد پیکربندی را با گزارش‌های ساناد خودتان تغییر دهید.

  • در بیشتر موارد، سوابق ساناد A شما از ارائه‌دهنده نام دامنه به سرورهای Firebase App Hosting منتشر نشده است.
    نکته عیب‌یابی: اگر بیش‌از ۲۴ ساعت گذشته است، بررسی کنید که سوابقتان را به Firebase App Hosting ارجاع داده باشید.

  • در موارد نادرتر، ممکن است چالش‌های SSL ناموفق باشد زیرا سوابق ساناد شما دارای سوابق A یا سوابق CNAME است که به ارائه‌دهندگان خدمات میزبانی وب دیگر اشاره می‌کند.
    نکته عیب‌یابی: بررسی کنید که سوابق A شما فقط به Firebase App Hosting اشاره داشته باشد و همه سوابق CNAME را بردارید.
درانتظار

دامنه سفارشی‌تان را به‌درستی راه‌اندازی کرده‌اید ولی Firebase App Hosting گواهینامه SSL را تدارک ندیده است.

گاهی اوقات، گزارش‌های CAA بیش‌ازحد محدودکننده می‌تواند صدور گواهینامه SSL را برای دامنه سفارشی متوقف کند. مطمئن شوید که مراجع صدور گواهینامه `letsencrypt.org` و `pki.goog` مجاز به ایجاد گواهینامه‌های SSL برای دامنه شما باشند.
گواهی ضرب کردن

گواهینامه SSL برای دامنه شما درحال تولید است.
متصل

دامنه سفارشی شما سوابق ساناد مناسب و گواهینامه SSL دارد.
می‌توانید محتوای سایتتان را ارائه دهید.