رفتن به محتوا
cloudhostمستندات
برنامه‌ها و فانکشن‌ها

دامنهٔ اختصاصی

هر برنامه یا فانکشن علاوه بر آدرس خودش روی trustpage.ir، روی دامنهٔ شما هم در دسترس است؛ گواهی HTTPS را ما می‌گیریم و پیش از تمام شدن تمدید می‌کنیم.

افزودن دامنه#

در داشبورد، تنظیمات پروژه ← دامنه‌ها ← «افزودن دامنه». یا از CLI و API. هم زیردامنه (shop.example.ir) و هم خود دامنه (example.ir) پذیرفته است. برای خود دامنه یا www آن، می‌توانید هر دو را با هم اضافه کنید تا یکی به دیگری ریدایرکت شود (پیشنهاد ما: www به خود دامنه).

cloudhost domains add shop.example.ir --project my-site
cloudhost domains add example.ir --project my-site --www apex   # www.example.ir redirects to example.ir
cloudhost domains verify shop.example.ir
cloudhost domains ls

رکوردهای DNS#

پاسخ افزودن، رکوردهایی را که باید نزد سرویس‌دهندهٔ DNS خود بگذارید دقیقاً نشان می‌دهد (داشبورد با دکمهٔ کپی). نام‌ها نسبت به دامنهٔ ثبت‌شده‌اند؛ @ یعنی خود دامنه.

دامنهرکوردمقدار
زیردامنه (shop.example.ir)CNAME shopcname.trustpage.ir
خود دامنه (example.ir)A @، یکی برای هر آدرسآدرسهای درگاه که در پاسخ آمده
همیشه، یک بار برای هر دامنهٔ ثبت‌شدهTXT _cloudhost-verifycloudhost-verify=<token>

رکورد TXT نشان می‌دهد دامنه مال شماست. یک رکورد روی دامنهٔ ثبت‌شده همهٔ نام‌های زیر آن را برای تیم شما پوشش می‌دهد. همیشه خواسته می‌شود، نه فقط وقتی کس دیگری نام را خواسته باشد: رکورد CNAME یا A که پس از حذف یک پروژه جا مانده، هرگز نباید به تیم دیگری اجازهٔ گرفتن نام را بدهد. وقتی مالکیت ثابت شد ثابت می‌ماند و می‌توانید رکورد TXT را بردارید.

  • اگر سرویس‌دهندهٔ شما برای زیردامنه فقط رکورد A می‌گذارد، آدرسهای درگاه هم پذیرفته است.
  • رکورد AAAA که جای دیگری را نشان دهد اشتباه شمرده می‌شود: بازدیدکننده‌ها و بررسی گواهی روی IPv6 به آن‌جا می‌روند.
  • نام‌های عمومی (co.ir)، نام‌های ستاره‌دار (*.example.ir)، آدرس IP و آدرسهای خود پلتفرم پذیرفته نیستند.
  • CDN یا پراکسی جلوی دامنه نگذارید: بررسی گواهی باید مستقیم به ما برسد.

وضعیت‌ها#

وضعیتیعنی
pendingرکوردها هنوز دیده نشده‌اند.
misconfiguredرکوردی هست ولی اشتباه است؛ پیام دقیقاً می‌گوید کدام و چه باید باشد.
verifyingهمه چیز درست است و گواهی تا چند ثانیهٔ دیگر صادر می‌شود.
validبا HTTPS سرو می‌شود؛ HTTP ساده به HTTPS ریدایرکت می‌شود.
errorگواهی گرفته نشد یا تیم دیگری مالکیت نام را ثابت کرده است؛ دلیل نوشته می‌شود و دوباره تلاش می‌کنیم.

دامنه‌های در انتظار را ابتدا هر چند ثانیه و سپس کم‌کم با فاصلهٔ بیشتر بررسی می‌کنیم؛ «بررسی دوباره» در داشبورد یا cloudhost domains verify همین حالا بررسی می‌کند. گواهی ۴۵ روز پیش از پایان تمدید می‌شود؛ اگر تمدید نشود، گواهی فعلی می‌ماند، دوباره تلاش می‌کنیم و اگر ۲۱ روز به پایانش مانده باشد خبرتان می‌کنیم. از دو مرجع صدور گواهی استفاده می‌کنیم؛ اگر دامنه رکورد CAA دارد، باید هر دو را مجاز کند.

ریدایرکت و دامنهٔ شاخه#

یک دامنه می‌تواند به جای سرو کردن، به دامنهٔ دیگری از همان پروژه ریدایرکت کند (پیش‌فرض ۳۰۸؛ ۳۰۱، ۳۰۲ و ۳۰۷ هم هست). مسیر و پارامترها حفظ می‌شوند. یک دامنه هم می‌تواند به جای پروداکشن، پیش‌نمایش یک شاخهٔ git را سرو کند، مثلاً staging.example.ir برای شاخهٔ staging.

cloudhost domains add old-shop.example.ir --project my-site --redirect-to shop.example.ir --redirect-status 301
cloudhost domains add staging.example.ir --project my-site --branch staging

محدودیت‌ها#

پلندامنه برای هر پروژهافزودن در ساعت
رایگان410
حرفه‌ای5030
سازمانیطبق قرارداد100

دستیار هوش مصنوعی#

سرور MCP ابزارهای list_domains، add_domain، verify_domain، update_domain و remove_domain را دارد (MCP).