پرش به مطلب اصلی

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

🖼
تصویر: افزودن دامنه سفارشی در داشبوردplaceholder — تصویر را اینجا جایگزین کنید

به‌صورت پیش‌فرض، هر اپلیکیشن ابرکلیک روی زیردامنه‌ای به شکل زیر در دسترس است:

<slug>.apps.abrclick.cloud

اگر می‌خواهید اپلیکیشن خود را روی دامنه یا زیردامنه اختصاصی خودتان سرو کنید — مثلاً app.example.com یا www.mysite.ir — می‌توانید از قابلیت دامنه اختصاصی استفاده کنید.

پلن موردنیاز

دامنه اختصاصی از پلن باران به بالا در دسترس است. کاربران پلن رایگان (ابر) باید ابتدا ارتقاء پلن دهند.


افزودن دامنه از داشبورد

  1. وارد داشبورد ابرکلیک شوید.
  2. به اپلیکیشن موردنظر بروید.
  3. از منوی سمت راست، گزینه تنظیمات → دامنه‌ها را انتخاب کنید.
  4. روی دکمه افزودن دامنه کلیک کرده و آدرس دامنه خود را وارد کنید (مثلاً app.example.com).
  5. پس از ذخیره، پلتفرم یک هدف CNAME به شما نشان می‌دهد.

هدف CNAME به شکل زیر خواهد بود:

<app-slug>.apps.abrclick.cloud

تنظیم DNS

زیردامنه (توصیه‌شده)

برای زیردامنه‌هایی مثل app.example.com یا www.mysite.ir، یک رکورد CNAME اضافه کنید:

نوعناممقدار
CNAMEapp<app-slug>.apps.abrclick.cloud
پنل DNS

اگر از ابرآروان (ArvanCloud) برای مدیریت DNS استفاده می‌کنید، از پنل CDN آن وارد بخش رکوردهای DNS شده و رکورد CNAME را بدون فعال‌کردن ابر (CDN) اضافه کنید تا اعتبارسنجی SSL درست کار کند.

دامنه اصلی (Apex Domain)

دامنه اصلی (مثلاً example.com بدون www) از نظر فنی نمی‌تواند رکورد CNAME داشته باشد. برای این حالت دو گزینه دارید:

گزینه اول — استفاده از ANAME/ALIAS (اگر ارائه‌دهنده DNS پشتیبانی کند):

نوعناممقدار
ALIAS یا ANAME@<app-slug>.apps.abrclick.cloud

گزینه دوم — استفاده از ابرآروان با رکورد A:

ابرآروان قابلیت Flatten CNAME دارد که به شما امکان می‌دهد رکورد CNAME را روی دامنه اصلی ثبت کنید. این گزینه را از داشبورد DNS آروان انتخاب کنید.


فعال‌سازی SSL خودکار

پس از تنظیم DNS، ابرکلیک به‌صورت خودکار گواهینامه SSL را از طریق Let's Encrypt صادر می‌کند. اعتبارسنجی دامنه با DNS-01 challenge delegation انجام می‌شود: یک رکورد CNAME با نام _acme-challenge به‌طور خودکار برای دامنه شما ایجاد می‌شود.

مراحل:

  1. پلتفرم رکورد CNAME دامنه شما را بررسی می‌کند.
  2. سپس یک رکورد _acme-challenge CNAME برای اعتبارسنجی ایجاد می‌کند.
  3. پس از تأیید، گواهینامه TLS صادر می‌شود.
  4. وضعیت دامنه در داشبورد به فعال (سبز) تغییر می‌کند.
  5. ترافیک HTTP به‌صورت خودکار به HTTPS ریدایرکت می‌شود.
مسیریابی دامنه

هر دامنه سفارشی می‌تواند به پورت و مسیر خاص خود اشاره کند (برای اپلیکیشن‌هایی با چند endpoint).

نکته مهم

تا زمانی که رکورد DNS به درستی تنظیم نشده باشد، SSL صادر نمی‌شود. مطمئن شوید CNAME دقیقاً به <app-slug>.apps.abrclick.cloud اشاره می‌کند.


اعتبارسنجی DNS

پس از ثبت رکورد DNS، پلتفرم به‌صورت دوره‌ای وضعیت را بررسی می‌کند. می‌توانید برای تأیید دستی از ابزار زیر استفاده کنید:

# بررسی رکورد CNAME
dig CNAME app.example.com

# بررسی وضعیت SSL
curl -I https://app.example.com

وضعیت‌های ممکن در داشبورد:

وضعیتمعنا
در انتظار تأییدرکورد DNS هنوز شناسایی نشده
در حال صدور گواهینامهDNS تأیید شد، SSL در حال صدور
فعالهمه‌چیز آماده است
خطا در DNSرکورد CNAME اشتباه است

تنظیم www و دامنه اصلی به‌طور همزمان

برای اینکه هم www.example.com و هم example.com کار کنند:

مرحله ۱: هر دو دامنه را جداگانه از داشبورد اضافه کنید.

مرحله ۲: رکوردهای DNS را تنظیم کنید:

نوعناممقدار
CNAMEwww<app-slug>.apps.abrclick.cloud
ALIAS/ANAME@<app-slug>.apps.abrclick.cloud

مرحله ۳: در تنظیمات اپلیکیشن، مشخص کنید کدام دامنه اصلی است. ترافیک دامنه دیگر به آن ریدایرکت می‌شود.


زمان انتشار DNS

تغییرات DNS ممکن است بین ۵ تا ۶۰ دقیقه طول بکشد، بسته به:

  • مقدار TTL رکورد DNS شما
  • ارائه‌دهنده DNS
  • Cache در شبکه
کاهش زمان انتشار

قبل از تغییر رکورد، TTL را به مقدار کمتری مثل ۳۰۰ ثانیه کاهش دهید تا تغییرات سریع‌تر اعمال شوند.


دامنه Wildcard

دامنه wildcard (مثلاً *.example.com) از پلن رعد به بالا در دسترس است.

پلندامنه Wildcard
ابر (رایگان)پشتیبانی نمی‌شود
بارانپشتیبانی نمی‌شود
برفپشتیبانی نمی‌شود
رعد و بالاترپشتیبانی می‌شود

برای فعال‌سازی wildcard، رکورد CNAME زیر را اضافه کنید:

نوعناممقدار
CNAME*<app-slug>.apps.abrclick.cloud
گواهینامه Wildcard SSL

برای دامنه wildcard، گواهینامه SSL نیز به‌صورت wildcard (*.example.com) صادر می‌شود.


سوالات رایج

چرا وضعیت دامنه بعد از ۱ ساعت هنوز «در انتظار» است؟

با دستور dig CNAME app.example.com بررسی کنید که رکورد CNAME به درستی تنظیم شده باشد. اگر رکورد نمایش داده نمی‌شود، در پنل DNS ارائه‌دهنده خود دوباره بررسی کنید.

آیا می‌توانم همزمان چند دامنه به یک اپ متصل کنم؟

بله. می‌توانید چند دامنه مختلف را به یک اپلیکیشن اضافه کنید. هر دامنه گواهینامه SSL مستقل خود را دریافت می‌کند.

آیا پس از تغییر پلن، دامنه‌هایم حذف می‌شوند؟

اگر به پلن پایین‌تری downgrade کنید و پلن جدید از دامنه اختصاصی پشتیبانی نکند، دامنه‌ها غیرفعال می‌شوند — اما حذف نمی‌شوند. با ارتقاء مجدد پلن، دوباره فعال خواهند شد.