در پایان این راهنما، برای یک نام در Zone ستون دو آدرس IPv4 میگذاریم تا درخواست با موقعیت تشخیصدادهشده در ایران 1.2.3.3 بگیرد و بقیه 5.6.7.7.
این تنظیم از API نسخه ۲.۱ انجام میشود و با دکمه ابر (QuickCDN) سازگار نیست. برای مبنای تشخیص موقعیت، اولویت ECS بر IP فرستنده و تفاوت با قانون آپاستریم، پاسخ جغرافیایی DNS با GeoDNS را مطالعه میکنیم.
مرجع مسیرها: CDN and DNS (v2.1). ساخت توکن و WorkspaceUUID در مدیریت دامنه خود را با API خودکار کنید است.
ناسازگار با دکمه ابر (quickcdn)
GeoDNS با دکمه ابر قابل استفاده نیست. اگر در فهرست آپاستریم نامی با پیشوند
quickcdn-داریم، اول دکمه ابر را خاموش میکنیم و CDN را بهصورت دستی — آپاستریم و قانون مسیر جدا از DNS — میسازیم. تا وقتی پاسخ عمومی DNS آدرس Anycast باشد، تفکیک جغرافیایی روی IPهای رکورد دیده نمیشود.
پیشنیازها
- دامنه با مدیریت DNS در ستون — اولین دامنه را به DNS ستون منتقل کنید
- توکن Bearer با نقش
dns-editor - شناسهی فضای کاری (
workspaceUUID) از فضاهای کاری - ابر همان نام خاموش باشد؛ آپاستریم
quickcdn-…برای آن نام نباشد
مراحل
- توکن و
workspaceUUIDرا آماده میکنیم. - فهرست Zoneها را میگیریم و Zone دامنه را از
spec.originپیدا میکنیم. مقدارmetadata.nameهمان<NAME>است:
curl -sS -X GET \
"https://api.sotoon.ir/delivery/v2.1/global/workspaces/<workspaceUUID>/domainzones" \
-H "Authorization: Bearer <TOKEN>"- در صورت نیاز همان Zone را جدا میخوانیم تا رکوردهای فعلی از بین نروند:
curl -sS -X GET \
"https://api.sotoon.ir/delivery/v2.1/global/workspaces/<workspaceUUID>/domainzones/<NAME>" \
-H "Authorization: Bearer <TOKEN>"پارامتر
<NAME>
<NAME>همانmetadata.nameآبجکت DomainZone است، نه لزوما نام دامنه.
- آرایه
optsباید با آرایه آدرسها همطول باشد. عنصر اول برای رکورد اول است و عنصر دوم برای رکورد دوم. آنچه باید منطبق شود را باgeoمیسازیم؛ اینجا یک کشور است و میتواند چند کشور باشد. برای بقیه،blockedGeoهمان کشور را از رکورد دوم کنار میگذارد.
نمونه: زیردامنه testir روی example.com؛ ایران 1.2.3.3 و بقیه 5.6.7.7:
curl -sS -X PATCH \
"https://api.sotoon.ir/delivery/v2.1/global/workspaces/<workspaceUUID>/domainzones/<NAME>" \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/merge-patch+json" \
-d '{
"spec": {
"records": {
"testir": [
{
"type": "A",
"ttl": 10,
"A": ["1.2.3.3", "5.6.7.7"],
"opts": [
{
"geo": [
{ "country": "IR" }
]
},
{
"blockedGeo": [
{ "country": "IR" }
]
}
]
}
]
}
}
}'testir را با پیشوند واقعی عوض میکنیم. برای ریشه دامنه کلید @ است.
| ایندکس | آدرس | شرط | رفتار |
|---|---|---|---|
0 | 1.2.3.3 | geo: کشور IR | فقط وقتی موقعیت مبنا ایران باشد |
1 | 5.6.7.7 | blockedGeo: کشور IR | برای همه جز ایران |
کد کشور دو حرفی ISO 3166-1 alpha-2 است. برای چند کشور، در همان geo برای هر کشور یک عنصر جدا با فیلد country میگذاریم. این پیکربندی بر اساس کشور است؛ continent را جایگزین country نمیکنیم. پذیرفته شدن این فیلد در اعتبارسنجی API بهتنهایی به معنی تطبیق قاره هنگام پاسخدهی DNS نیست.
merge-patch
برای
PATCHجزیی ازContent-Type: application/merge-patch+jsonاستفاده میکنیم. این نمونه فقط کلیدtestirرا عوض میکند و بقیه نامهایspec.recordsمیمانند. اگر روی همان نام رکورد دیگری مثلTXTهست، آن را هم در همین آرایه نگه میداریم؛ وگرنه با جایگزینی آرایه حذف میشود.
بررسی صحت
- دوباره همان Zone را با
GETمیخوانیم. درspec.records.testirباید دو آدرس و دو عنصرoptsدیده شود. - کد پاسخ
PATCHوGETنباید401/403باشد؛ در غیر این صورت توکن و نقشdns-editorرا بررسی میکنیم. اگر404است،<NAME>را باmetadata.nameمقایسه میکنیم. - چند دقیقه — دستکم به اندازه TTL رکورد — صبر میکنیم.
- از یکی از NSهای ستون که در پنل نمایش داده میشود کویری میزنیم تا کش Resolver محلی را دور بزنیم:
dig @a.ns.sotoon53.ir testir.example.com Aدر دستور بالا نامسرور را با یکی از نامسرورهای نمایشدادهشده در تب DNS پنل و نام دامنه را با نام رکورد واقعی جایگزین میکنیم.
در کویری مستقیم بالا، اگر ECS ارسال نکنیم، IP عمومی فرستندهی کویری مبنای تشخیص موقعیت است. اگر این IP در ایران تشخیص داده شود، پاسخ باید 1.2.3.3 باشد و اگر خارج از ایران تشخیص داده شود، 5.6.7.7.
برای بررسی از طریق Resolver، پاسخ را بر اساس آدرس ECS و در نبود آن IP خروجی Resolver ارزیابی میکنیم. مثال کلاینت خارج از ایران و Resolver داخل ایران در پاسخ جغرافیایی DNS با GeoDNS آمده است.
