If you are building server-rendered Angular or Next.js apps, check out next-generation Firebase App Hosting, a full-stack solution for modern web frameworks.
یک دامنه سفارشی را متصل کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
با Firebase Hosting لازم نیست از نام‌های دامنه منحصر به فرد و برند محور خود دست بکشید. می‌توانید به جای دامنه تولید شده توسط Firebase برای سایت میزبانی شده توسط Firebase خود، از یک دامنه سفارشی (مانند example.com یا app.example.com ) استفاده کنید.
Firebase Hosting برای هر یک از دامنه‌های شما یک گواهی SSL فراهم می‌کند و محتوای شما را از طریق یک CDN جهانی ارائه می‌دهد.
ادامه‌ی این سند، شما را در طی این مراحل برای اتصال دامنه‌ی سفارشی‌تان راهنمایی می‌کند.
دامنه خود را برای Hosting تنظیم کنید
مطمئن شوید که ویزارد «شروع به کار» را از صفحه Firebase Hosting پروژه خود تکمیل کرده‌اید تا یک سایت Firebase Hosting در پروژه فایربیس خود داشته باشید.
مرحله 1 : اضافه کردن دامنه سفارشی
از صفحه Hosting پروژه خود، وارد ویزارد اتصال دامنه سفارشی شوید:
اگر فقط یک سایت Hosting دارید، روی افزودن دامنه سفارشی کلیک کنید.
اگر بیش از یک سایت Hosting دارید، روی «مشاهده» برای سایت مورد نظر کلیک کنید، سپس روی «افزودن دامنه سفارشی» کلیک کنید.
نام دامنه سفارشی که می‌خواهید به سایت Hosting خود متصل کنید را وارد کنید.
(اختیاری) کادر را علامت بزنید تا همه درخواست‌ها روی دامنه سفارشی به یک دامنه مشخص شده دوم هدایت شوند (به طوری که example.com و www.example.com به محتوای یکسانی هدایت شوند).
برای پیکربندی رکوردهای DNS و تکمیل تنظیم دامنه سفارشی خود، روی ادامه کلیک کنید.
مرحله 2 : تنظیم دامنه سفارشی
در صورت درخواست در ویزارد راه‌اندازی Connect Domain ، دامنه apex خود را تأیید کنید.
این مراحل تضمین می‌کنند که دامنه شما از قبل به هیچ پروژه Firebase متصل نشده است و شما مالک دامنه مشخص شده هستید.
در سایت ارائه دهنده دامنه خود، صفحه مدیریت DNS را پیدا کنید.
یک رکورد جدید با ورودی‌های زیر اضافه و ذخیره کنید:
نوع : یک رکورد TXT اضافه کنید.
Firebase Hosting مستلزم آن است که شما این رکورد TXT را به طور مداوم در تنظیمات DNS خود نگه دارید تا مالکیت دامنه خود را اثبات کنید و به فایربیس اجازه دهید گواهینامه‌های SSL را برای سایت شما اختصاص داده و تمدید کند.
ارائه دهنده دامنه شما ممکن است این اصطلاح را به عنوان "نوع رکورد" فهرست کند.
اثبات مالکیت شما بر یک دامنه‌ی آپکس یا دامنه‌ی ریشه، مالکیت شما بر تمام زیردامنه‌های آن را اثبات می‌کند.
ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "نام میزبان"، "نام" یا "دامنه" فهرست کند.
مقدار : مقدار تأیید منحصر به فرد را در فیلد کپی کنید.
Firebase Hosting این مقدار را برای اثبات مالکیت دامنه شما بررسی می‌کند.
ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان «داده» فهرست کند.
حداکثر ۲۴ ساعت برای انتشار رکوردهای TXT به‌روزرسانی‌شده خود زمان در نظر بگیرید، سپس روی تأیید کلیک کنید.
توجه داشته باشید که می‌توانید برای بستن ایمن پنجره اتصال دامنه و باز کردن مجدد آن در زمان دیگری، روی لغو کلیک کنید. این کار تاثیری بر زمان انتشار ندارد، اما هنگام باز کردن مجدد پنجره از شما خواسته می‌شود نام دامنه خود را دوباره وارد کنید .
پس از گذشت زمان کافی برای انتشار، کلیک روی تأیید (Verify) در پنجره Connect Domain کنسول Firebase به شما امکان می‌دهد فرآیند تهیه گواهی SSL را آغاز کنید.
در بیشتر موارد، بسته به ارائه‌دهنده دامنه شما، انتشار رکوردها و تأیید دامنه شما ظرف چند ساعت انجام می‌شود. برای دستورالعمل‌های دقیق برای اضافه کردن رکوردهای TXT و زمان انتشار، به مستندات ارائه‌دهنده دامنه خود مراجعه کنید.
اگر با کلیک روی «تأیید» ، پیام خطایی نمایش داده شد، ممکن است رکوردهای شما منتشر نشده باشند یا مقادیر شما نادرست باشند.
در ویزارد Add Custom Domain در کنسول Firebase ، گزینه Quick Setup یا Advanced Setup را انتخاب کنید.
راه‌اندازی سریع می‌تواند برای دامنه‌های جدیدی که در حال حاضر ترافیکی دریافت نمی‌کنند یا دامنه‌هایی که قصد انتقال آنها از یک سایت Hosting دیگر را دارید، استفاده شود. راه‌اندازی پیشرفته می‌تواند در صورتی استفاده شود که از قبل دامنه‌ای دارید که درخواست‌هایی را در ارائه‌دهنده میزبانی وب دیگری دریافت می‌کند و به یک انتقال بدون قطعی نیاز دارید.
جادوگر تنظیمات پیشرفته به شما کمک می‌کند تا یک گواهی SSL و ادعای مالکیت ایجاد کنید تا Hosting بتواند قبل از دریافت ترافیک، ترافیک را روی دامنه ارائه دهد.
راه‌اندازی سریع
ویزارد افزودن دامنه سفارشی در کنسول Firebase ، رکوردهای لازم برای به‌روزرسانی جهت اتصال صفحه شما به Firebase Hosting را نشان می‌دهد. با استفاده از ورودی‌های زیر، رکوردها را از دامنه خود در ارائه‌دهنده DNS خود اضافه، حذف و ذخیره کنید:
میزبان (host) که مشخص می‌کنید، دامنه‌ای است که می‌خواهید محتوا را روی آن ارائه دهید؛ این دامنه می‌تواند یک دامنه اصلی (apex domain) یا یک زیردامنه (subdomain) باشد.
ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "نام میزبان"، "نام" یا "دامنه" فهرست کند.
مقدار : آدرس‌های IP ارائه شده را به مقدار رکوردها اختصاص دهید.
ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "داده"، "اشاره به"، "محتوا"، "آدرس" یا "آدرس IP" فهرست کند.
برای آماده‌سازی گواهی SSL خود زمان در نظر بگیرید. این ممکن است تا ۲۴ ساعت پس از اتصال DNS به Firebase Hosting طول بکشد. در بیشتر موارد، بسته به ارائه‌دهنده دامنه شما، انتشار رکوردها و آماده‌سازی گواهی SSL شما ظرف چند ساعت انجام می‌شود.
تنظیمات پیشرفته
حالت تنظیمات پیشرفته‌ی ویزارد Add Custom Domain به شما این امکان را می‌دهد که Hosting طوری پیکربندی کنید که قبل از هدایت ترافیک به سرورهایش، به طور ایمن به دامنه‌ی شما سرویس دهد. به طور کلی، Hosting برای ارائه‌ی موفقیت‌آمیز ترافیک در یک دامنه به سه چیز نیاز دارد:
رکورد مالکیت: یک رکورد TXT به Hosting می‌گوید که کدام سایت را روی دامنه ارائه دهد.
گواهی SSL: یک گواهی مخصوص دامنه که امکان ارتباط رمزگذاری شده بین سرورهای Hosting و کاربران نهایی را فراهم می‌کند.
رکوردهای IP میزبانی: یک یا چند رکورد A و AAAA که تمام درخواست‌های دامنه را به سرورهای Hosting هدایت می‌کنند.
تنظیمات پیشرفته شما را در پیکربندی دامنه‌تان راهنمایی می‌کند تا Hosting بتواند دو الزام اول را از قبل برآورده کند، به طوری که قبل از شروع دریافت ترافیک برای دامنه شما، آماده ارائه محتوای صحیح باشد. این ویزارد این فرآیند را به صورت یک گردش کار دو مرحله‌ای نشان می‌دهد:
آماده سازی دامنه
به‌روزرسانی رکوردهای DNS : یک یا چند رکورد به دامنه خود اضافه کنید:
مالکیت: یک رکورد TXT به شکل `hosting-site=[site_id]`.
CAA (اختیاری): یک جفت رکورد CAA که به مراجع صدور گواهیHosting اجازه می‌دهد تا برای دامنه شما گواهی SSL صادر کنند. فقط در صورتی ارائه می‌شود که Hosting رکوردهای CAA موجود را که مانع از ارائه گواهی می‌شوند، شناسایی کند.
راه‌اندازی گواهی SSL : این ویزارد یک چالش ACME ارائه می‌دهد که مسئولین صدور گواهی Hosting از آن برای صدور گواهی SSL برای دامنه شما استفاده خواهند کرد. می‌توانید بین چالش DNS یا HTTP یکی را انتخاب کنید:
چالش DNS : به سایت‌های مدیریت DNS ارائه‌دهنده دامنه خود مراجعه کنید. یک رکورد TXT با کلید زیر دامنه چالش ACME و مقدار ارائه شده اضافه کنید. حداکثر ۲۴ ساعت برای انتشار رکوردهای TXT خود زمان در نظر بگیرید.
چالش HTTP : فایل متنی ارائه شده را در سایت موجود خود در URL مشخص شده بارگذاری کنید و وجود آن را تأیید کنید.
Hosting قبل از درخواست تأیید از CA خود، سعی خواهد کرد چالش‌های ACME را خودش تأیید کند. اگر CA به هر دلیلی، مثلاً مشکلات سرویس متناوب، نتواند چالش‌های شما را تأیید کند، Hosting باید مجموعه‌ای جدید از چالش‌ها را برای شما ایجاد کند. پس از تأیید موفقیت‌آمیز، ممکن است چند ساعت طول بکشد تا Hosting یک گواهی SSL تهیه کند و اجازه انتشار آن را بدهد.
مستقیم به Hosting
پس از اینکه Hosting مالکیت دامنه شما را تأیید کرد و یک گواهی SSL ارائه داد، به ارائه دهنده DNS خود برگردید و رکوردهای DNS A/AAAA را که درخواست‌ها را به Hosting هدایت می‌کنند، اضافه کنید:
نوع : رکوردهای DNS A/AAAA درخواستی را اضافه کنید.
میزبان : کلید دامنه سفارشی خود را برای هر دو رکورد وارد کنید.
میزبان (host) مورد نظر شما، دامنه‌ای است که می‌خواهید محتوا را روی آن ارائه دهید؛ این دامنه می‌تواند یک دامنه اصلی (apex domain) یا زیردامنه (subdomain) باشد. ارائه‌دهنده دامنه شما ممکن است این عبارت را به عنوان «نام میزبان»، «نام» یا «دامنه» فهرست کند.
مقدار : به هر رکورد DNS A/AAAA یک مقدار اختصاص دهید تا دامنه شما به آدرس‌های IP مشخص شده هدایت شود.
ارائه دهنده دامنه شما ممکن است این عبارت را به عنوان "داده"، "اشاره به"، "محتوا"، "آدرس" یا "آدرس IP" فهرست کند.
منتظر ارائه گواهی SSL باشید
پس از تأیید مالکیت دامنه، ظرف ۲۴ ساعت پس از اینکه رکوردهای DNS A خود را به Firebase Hosting متصل کردید، یک گواهی SSL برای دامنه شما تهیه می‌کنیم و آن را در سراسر CDN جهانی خود مستقر می‌کنیم.
دامنه شما به عنوان یکی از نام‌های جایگزین موضوع (SAN) در گواهی SSL FirebaseApp فهرست خواهد شد. می‌توانید این گواهی را با استفاده از ابزارهای امنیتی مرورگر مشاهده کنید. در حین آماده‌سازی دامنه، ممکن است یک گواهی نامعتبر مشاهده کنید که نام دامنه شما را شامل نمی‌شود. این یک بخش عادی از فرآیند است و پس از در دسترس قرار گرفتن گواهی دامنه شما برطرف خواهد شد.
برای کاربران تنظیمات پیشرفته ، وب‌سایت شما تا زمانی که وضعیت تنظیمات در صفحه Firebase Hosting پروژه شما به Connected به‌روزرسانی شود، توسط ارائه‌دهنده میزبانی قبلی شما میزبانی خواهد شد.
کلید دامنه سفارشی شما
هنگام اضافه کردن یا ویرایش رکوردهای DNS، ارائه دهندگان دامنه مختلف از شما انتظار دارند که ورودی‌های متفاوتی را برای فیلد میزبان در سایت‌های مدیریت DNS آنها وارد کنید. ما ورودی‌های رایج از ارائه دهندگان محبوب را در زیر گردآوری کرده‌ایم. برای دستورالعمل‌های دقیق به مستندات ارائه دهنده دامنه خود مراجعه کنید.
نوع دامنه
کلید دامنه سفارشی
دامنه آپکس
ورودی‌های رایج عبارتند از:
@
نام دامنه‌ی اصلی (برای مثال، example .com )
خالی گذاشتن فیلد میزبان
زیردامنه
ورودی‌های رایج عبارتند از:
نام کامل زیر دامنه (برای مثال، app. example .com )
فقط بخش زیر دامنه (برای مثال، فقط app ، و بدون در نظر گرفتن . example .com )
فقط www برای زیر دامنه www. example .com
ارائه دهندگان دامنه رایج
در اینجا برخی از ارائه دهندگان دامنه رایج و انواع ورودی‌هایی که هر کدام ممکن است نیاز داشته باشند، آورده شده است. این اطلاعات تا حد امکان به‌روز نگه داشته می‌شود، اما برای دستورالعمل‌های دقیق به اسناد ارائه دهنده دامنه خود مراجعه کنید.
کلودفلر
نوع
میزبان
ارزش
ورودی‌های رکورد DNS TXT
تی‌اکس‌تی
example .com
مقدار تأیید در کنسول Firebase ارائه شده است
DNS A ورودی‌ها را ثبت می‌کند
الف
example .com
۱۹۹.۳۶.۱۵۸.۱۰۰
الف
www
۱۹۹.۳۶.۱۵۸.۱۰۰
دی‌ان‌اس ابری گوگل
نوع
میزبان
ارزش
ورودی‌های رکورد DNS TXT
تی‌اکس‌تی
example .com
مقدار تأیید در کنسول Firebase ارائه شده است
DNS A ورودی‌ها را ثبت می‌کند
الف
example .com
۱۹۹.۳۶.۱۵۸.۱۰۰
الف
www
۱۹۹.۳۶.۱۵۸.۱۰۰
نامارزان
نوع
میزبان
ارزش
ورودی‌های رکورد DNS TXT
تی‌اکس‌تی
@
مقدار تأیید در کنسول Firebase ارائه شده است
DNS A ورودی‌ها را ثبت می‌کند
الف
@
۱۹۹.۳۶.۱۵۸.۱۰۰
الف
www
۱۹۹.۳۶.۱۵۸.۱۰۰
فضای مربعی
نوع
میزبان
ارزش
ورودی‌های رکورد DNS TXT
تی‌اکس‌تی
@
مقدار تأیید در کنسول Firebase ارائه شده است
DNS A ورودی‌ها را ثبت می‌کند
الف
@
۱۹۹.۳۶.۱۵۸.۱۰۰
الف
www
۱۹۹.۳۶.۱۵۸.۱۰۰
تنظیم شرح وضعیت برای دامنه‌های سفارشی
وضعیت
توضیحات
نیاز به تنظیم دارد
ممکن است لازم باشد پیکربندی مربوط به رکوردهای DNS خود را تغییر دهید.
در بیشتر موارد، رکوردهای DNS A شما از ارائه دهنده نام دامنه شما به سرورهای Firebase Hosting منتشر نشده‌اند. نکته عیب‌یابی: اگر بیش از ۲۴ ساعت گذشته است، بررسی کنید که رکوردهای خود را به Firebase Hosting ارجاع داده باشید.
در موارد نادرتر، به خصوص اگر از جریان تنظیمات پیشرفته استفاده می‌کنید، چالش‌های SSL ممکن است به دلایل زیر با شکست مواجه شوند:
چالش‌های گواهی SSL با شکست مواجه شد، و توکن (رکوردهای DNS TXT یا فایل آپلود شده ارائه شده به سایت شما) اکنون نامعتبر است. نکته عیب‌یابی: روی مشاهده دامنه کلیک کنید، سپس توکن جدید را به دامنه موجود خود اضافه کنید.
در حال بررسی
شما دامنه سفارشی خود را به درستی تنظیم کرده‌اید، اما Firebase Hosting گواهی SSL ارائه نکرده است.
گاهی اوقات، مشکلات زیر می‌تواند صدور گواهی SSL برای یک دامنه سفارشی را متوقف کند:
سوابق CAA شما بیش از حد محدودکننده است. نکته عیب‌یابی: مطمئن شوید که مراجع صدور گواهینامه `letsencrypt.org` و `pki.goog` مجاز به ایجاد گواهینامه‌های SSL برای دامنه شما هستند.
کد چالش شما نامعتبر است. اگر از تنظیمات پیشرفته استفاده می‌کنید و انتقال ناموفق بوده است، توکن شما (و کد چالش آن) اکنون نامعتبر است. نکته عیب‌یابی: روی مشاهده دامنه کلیک کنید، سپس توکن جدید را به دامنه موجود خود اضافه کنید.
شما برای تعداد زیادی زیردامنه درخواست گواهی داده‌اید. نکته عیب‌یابی: به طور کلی، Firebase Hosting به دلیل محدودیت‌های صدور گواهی SSL، توصیه می‌کند که بیش از 20 زیر دامنه در یک دامنه سفارشی apex وجود نداشته باشد.
گواهی ضرب سکه
یک گواهی SSL برای دامنه شما در حال تولید است.
متصل
دامنه سفارشی شما دارای رکوردهای DNS مناسب و گواهی SSL است. می‌توانید محتوای سایت خود را ارائه دهید.
تاریخ آخرین به‌روزرسانی 2025-10-31 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-10-31 بهوقت ساعت هماهنگ جهانی."],[],[]]
