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

مدیریت DNS

مدیریت DNS در ابرکلیک به شما امکان می‌دهد زون‌های DNS را مستقیماً از داشبورد یا API کنترل کنید. ابرکلیک از PowerDNS به عنوان سرور DNS اتوریتیو استفاده می‌کند.

دو روش اتصال دامنه​

۱. ساده (توصیه‌شده) — CNAME از رجیستری​

🖼
تصویر: پنل مدیریت DNSplaceholder — تصویر را اینجا جایگزین کنید

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

www.yourdomain.com  CNAME  my-app.apps.abrclick.cloud

این روش ساده‌ترین حالت است و DNS شما همچنان نزد رجیستری‌تان می‌ماند.

مناسب برای

اتصال یک یا چند ساب‌دامین به اپ‌های ابرکلیک بدون نیاز به مدیریت کامل DNS.

۲. کامل — انتقال NS به ابرکلیک​

اگر می‌خواهید تمام رکوردهای DNS دامنه‌تان را از داشبورد ابرکلیک مدیریت کنید، باید nameserverهای دامنه را به ابرکلیک تغییر دهید.

مراحل:

  1. در داشبورد به بخش DNS بروید
  2. روی «افزودن دامنه» کلیک کنید
  3. نام دامنه را وارد کنید (مثلاً yourdomain.com)
  4. در پنل رجیستری، nameserverها را به مقادیر نمایش‌داده‌شده تغییر دهید: 
    ns1.abrclick.ir
    ns2.abrclick.ir
  5. منتظر بمانید تا وضعیت زون به فعال تغییر کند
هشدار

تغییر nameserver ممکن است تا ۴۸ ساعت طول بکشد. در این مدت سرویس‌های موجود روی دامنه ممکن است موقتاً مختل شوند. رکوردهای موجود را قبل از انتقال در ابرکلیک ثبت کنید.

مدیریت رکوردها​

افزودن رکورد از داشبورد​

۱. به بخش DNS بروید و زون مورد نظر را انتخاب کنید ۲. روی «افزودن رکورد» کلیک کنید ۳. مقادیر زیر را وارد کنید:

فیلدتوضیحمثال
نوعنوع رکورد DNSA, AAAA, CNAME, MX, TXT, ANAME
نامنام ساب‌دامین یا @ برای rootwww یا @
مقدارمقصد رکورد185.x.x.x یا my-app.apps.abrclick.cloud
TTLمدت کش (ثانیه)300
اولویت (MX)اولویت سرور ایمیل10
استفاده از ANAME برای ریشه دامنه

برای اتصال ریشه دامنه (apex domain مثل yourdomain.com) به یک CNAME-like target، از نوع رکورد ANAME (یا ALIAS) استفاده کنید. این رکورد مانند CNAME عمل می‌کند اما در ریشه دامنه مجاز است.

API — ایجاد یا بروزرسانی رکورد​

curl -X PUT https://api.abrclick.ir/v1/dns/zones/:zoneId/records \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "CNAME",
    "name": "www",
    "value": "my-app.apps.abrclick.cloud",
    "ttl": 300
  }'

این endpoint به صورت upsert عمل می‌کند — اگر رکورد با همان type و name وجود داشته باشد بروز می‌شود، در غیر این صورت ایجاد می‌شود.

API — حذف رکورد​

curl -X DELETE https://api.abrclick.ir/v1/dns/zones/:zoneId/records \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "CNAME",
    "name": "www"
  }'

مثال: اتصال دامنه سفارشی به اپلیکیشن​

فرض کنید اپلیکیشن شما در my-store.apps.abrclick.cloud در دسترس است و می‌خواهید shop.yourdomain.com به آن اشاره کند.

با روش CNAME (رجیستری):

shop.yourdomain.com  CNAME  my-store.apps.abrclick.cloud  TTL=300

با روش زون ابرکلیک (API):

curl -X PUT https://api.abrclick.ir/v1/dns/zones/:zoneId/records \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "CNAME",
    "name": "shop",
    "value": "my-store.apps.abrclick.cloud",
    "ttl": 300
  }'

اتصال ریشه دامنه (apex):

curl -X PUT https://api.abrclick.ir/v1/dns/zones/:zoneId/records \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "ANAME",
    "name": "@",
    "value": "my-store.apps.abrclick.cloud",
    "ttl": 300
  }'
گواهی SSL

پس از ثبت رکورد CNAME، به بخش دامنه‌های سفارشی اپلیکیشن بروید و دامنه را اضافه کنید تا گواهی SSL به‌صورت خودکار صادر شود.

تأیید وضعیت زون​

زون DNS تنها زمانی فعال می‌شود که nameserverهای دامنه به ابرکلیک اشاره کنند. وضعیت زون را می‌توانید از داشبورد یا API (POST /v1/dns/zones/:zoneId/verify) بررسی کنید. همچنین می‌توانید با دستور زیر نیز تأیید کنید:

dig NS yourdomain.com +short

اگر خروجی شامل ns1.abrclick.ir و ns2.abrclick.ir باشد، زون فعال است.

بررسی سریع

از ابزار dnschecker.org می‌توانید انتشار جهانی تغییرات NS را رصد کنید.