در پایان این راهنما، برای یک نام در 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های رکورد دیده نمی‌شود.


پیش‌نیازها


مراحل

  1. توکن و workspaceUUID را آماده می‌کنیم.
  2. فهرست 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>"
  1. در صورت نیاز همان 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 است، نه لزوما نام دامنه.

  1. آرایه 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 را با پیشوند واقعی عوض می‌کنیم. برای ریشه دامنه کلید @ است.

ایندکسآدرسشرطرفتار
01.2.3.3geo: کشور IRفقط وقتی موقعیت مبنا ایران باشد
15.6.7.7blockedGeo: کشور 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 هست، آن را هم در همین آرایه نگه می‌داریم؛ وگرنه با جایگزینی آرایه حذف می‌شود.


بررسی صحت

  1. دوباره همان Zone را با GET می‌خوانیم. در spec.records.testir باید دو آدرس و دو عنصر opts دیده شود.
  2. کد پاسخ PATCH و GET نباید 401 / 403 باشد؛ در غیر این صورت توکن و نقش dns-editor را بررسی می‌کنیم. اگر 404 است، <NAME> را با metadata.name مقایسه می‌کنیم.
  3. چند دقیقه — دست‌کم به اندازه TTL رکورد — صبر می‌کنیم.
  4. از یکی از 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 آمده است.


ادامه مسیر