All Products
Search
Document Center

CDN:FAQ konfigurasi CNAME

Last Updated:Jun 16, 2026

Setelah menambahkan nama domain yang dipercepat ke CDN, layanan tersebut akan menetapkan alamat CNAME. Anda harus memetakan rekaman DNS untuk nama domain yang dipercepat ke alamat CNAME ini agar akselerasi CDN aktif.

Verifikasi status rekaman CNAME

Setelah mengonfigurasi rekaman CNAME di Konsol CDN, gunakan perintah nslookup atau dig untuk memverifikasi konfigurasi. Jangan gunakan perintah ping karena dapat mengembalikan informasi DNS yang tidak akurat.

Windows

nslookup -type=CNAME <nama domain yang dipercepat>

Jika hasil yang dikembalikan sesuai dengan alamat CNAME yang disediakan oleh CDN, maka rekaman CNAME telah berlaku.

Linux/macOS

Pada Linux atau macOS, jalankan perintah dig untuk memverifikasi konfigurasi:

  • Kueri hanya alamat target CNAME (disarankan):

    dig +short <nama domain yang dipercepat> CNAME

    Jika hasilnya sesuai dengan alamat CNAME yang disediakan oleh CDN, maka rekaman CNAME telah berlaku. Contoh output:

    dig +short cdn.example.com CNAME
    cdn.example.com.w.alikunlun.com.
  • Kueri informasi detail nama domain:

    dig <nama domain yang dipercepat> CNAME

    Jika nilai CNAME pada bagian ANSWER SECTION sesuai dengan alamat CNAME yang disediakan oleh CDN, maka rekaman CNAME telah berlaku.

Atasi error NXDOMAIN atau "record not found"

Ikuti langkah-langkah berikut untuk mengatasi masalah ini:

  1. Verifikasi ejaan nama domain: Pastikan nama domain yang dimasukkan dalam perintah sudah benar.

  2. Periksa konfigurasi DNS: Masuk ke Konsol DNS dan pastikan rekaman CNAME ada serta rekaman host-nya benar. Rekaman host harus berupa awalan dari nama domain yang dipercepat, bukan nama domain lengkapnya. Misalnya, jika nama domain yang dipercepat Anda adalah cdn.example.com, maka rekaman host-nya harus cdn, bukan cdn.example.com.

  3. Tunggu propagasi rekaman DNS: Setelah mengubah rekaman DNS, perlu waktu hingga perubahan tersebut tersebar secara global. Tunggu beberapa saat agar rekaman tersebut tersebar, lalu coba lagi.

    Catatan

    Waktu yang dibutuhkan agar rekaman DNS tersebar secara global bergantung pada Time to Live (TTL)-nya. Misalnya, jika rekaman sebelumnya memiliki TTL 10 menit, maka rekaman baru akan membutuhkan setidaknya 10 menit untuk berlaku. Sebelum mengubah rekaman CNAME, kami menyarankan Anda mengatur TTL rekaman aslinya menjadi nilai yang lebih pendek, seperti 60 detik.

Atasi konflik rekaman A

Rekaman A dan rekaman CNAME tidak dapat eksis bersamaan untuk rekaman host yang sama. Error konflik berarti sudah ada rekaman jenis lain untuk rekaman host tersebut. Untuk mengatasinya, ikuti langkah-langkah berikut:

  1. Masuk ke Konsol DNS dan temukan rekaman A yang bentrok (atau tipe rekaman lain seperti MX, TXT, dll.).

  2. Hapus atau nonaktifkan sementara rekaman yang bentrok tersebut.

  3. Tambahkan kembali rekaman CNAME dan atur nilainya ke alamat CNAME yang ditetapkan oleh CDN.

Catatan
  • Menghapus rekaman A akan mengganggu trafik ke origin. Lakukan pengujian terlebih dahulu pada subdomain untuk memastikan akselerasi CDN berfungsi dengan benar sebelum bermigrasi ke domain utama.

  • Lakukan operasi ini pada jam sepi.

  • Jika Anda mengaktifkan pemeriksaan kesehatan di Global Traffic Manager (GTM), GTM mungkin secara otomatis membuat rekaman DNS yang bentrok. Atasi masalah tersebut di GTM terlebih dahulu sebelum menambahkan rekaman CNAME.

Atasi status konsol yang tidak sesuai

Konfigurasi biasanya membutuhkan waktu 5 hingga 30 menit untuk berlaku, tergantung pada TTL rekaman DNS. Setelah propagasi global selesai, status di Konsol CDN akan diperbarui untuk menunjukkan bahwa layanan aktif. Muat ulang halaman konsol setelah beberapa menit untuk memeriksa.

Jika status domain tidak diperbarui setelah waktu yang wajar, ikuti langkah-langkah berikut untuk pemecahan masalah:

  1. Periksa apakah rekaman host sudah benar: Rekaman host harus sesuai dengan awalan nama domain yang dipercepat Anda. Misalnya, rekaman host untuk a.example.com adalah a, dan rekaman host untuk example.com adalah @. Kesalahan umum adalah memasukkan www padahal nama domain yang dipercepat bukan www.example.com.

  2. Periksa apakah nilai rekaman CNAME sudah benar: Nilai rekaman harus persis sesuai dengan alamat CNAME yang ditampilkan di Konsol CDN. Kami menyarankan Anda menyalin alamat tersebut langsung dari konsol.

  3. Verifikasi dengan nslookup atau dig: Pastikan CNAME yang dikembalikan mengarah ke alamat yang ditetapkan oleh CDN.

  4. Periksa adanya rekaman yang bentrok: Pastikan Anda telah menghapus rekaman A atau rekaman lain yang bentrok untuk rekaman host yang sama.

Atasi ketidaksesuaian status "CNAME not configured"

Dalam skenario berikut, Konsol CDN mungkin melaporkan bahwa CNAME belum dikonfigurasi meskipun akselerasi berfungsi dengan benar. Hal ini tidak memengaruhi layanan:

  • Wilayah akselerasi tidak mencakup Tiongkok daratan: Jika Anda mengatur wilayah akselerasi ke Global (tidak termasuk Tiongkok daratan) (yang sesuai dengan parameter API Scope diatur ke overseas), pemeriksaan CNAME dari dalam Tiongkok daratan mungkin salah melaporkan bahwa CNAME belum dikonfigurasi. Hal ini merupakan perilaku yang diharapkan dan tidak memengaruhi layanan di wilayah target. Untuk memverifikasi bahwa akselerasi aktif di luar Tiongkok daratan:

    1. Gunakan perintah nslookup atau dig, atau periksa di Konsol CDN untuk memastikan nama domain meresolusi ke alamat CNAME yang ditetapkan oleh CDN.

    2. Akses resource yang dipercepat dari jaringan di luar Tiongkok daratan. Lalu, gunakan developer tools browser Anda untuk memeriksa header respons. Jika nilai bidang X-Cache adalah HIT, itu menandakan cache hit, yang mengonfirmasi bahwa akselerasi berfungsi.

  • DNS split-horizon dikonfigurasi: Jika penyedia DNS Anda menggunakan rekaman berbeda untuk wilayah berbeda—misalnya, mengarahkan trafik dari Tiongkok daratan ke alamat CNAME CDN dan trafik lainnya ke IP origin—konsol mungkin melaporkan "CNAME not configured" karena beberapa wilayah tidak mengarah ke CDN. Anda dapat mengabaikan pesan ini selama pengguna di wilayah target dapat mengakses resource yang dipercepat dengan benar.

  • Waktu tunda propagasi DNS: Setelah menambahkan atau mengubah rekaman CNAME, propagasi DNS global dapat memakan waktu beberapa menit hingga beberapa jam, tergantung pada pengaturan TTL. Konsol mungkin menampilkan "CNAME not configured" selama periode ini. Periksa kembali nanti.

Beberapa rekaman CNAME untuk satu domain

Tidak. Hanya satu nilai rekaman CNAME yang diizinkan per rekaman host. Beberapa rekaman CNAME dapat menyebabkan error akses, seperti error 403.

Solusi: Pertahankan hanya satu rekaman CNAME untuk rekaman host tersebut, yang mengarah ke alamat CNAME domain yang dipercepat Anda. Hapus semua rekaman tambahan.

Rekaman CNAME wildcard dan subdomain

Setelah mengonfigurasi rekaman CNAME untuk domain wildcard seperti *.example.com, semua subdomain yang tidak memiliki rekaman DNS sendiri (misalnya, a.example.com dan b.example.com) akan mewarisi rekaman wildcard tersebut. Jika subdomain tertentu tidak memerlukan akselerasi CDN, konfigurasikan rekaman A terpisah atau tipe rekaman lain untuk subdomain tersebut. Rekaman DNS spesifik untuk subdomain memiliki prioritas lebih tinggi daripada rekaman wildcard.

Catatan

Aturan prioritas resolusi dapat berbeda-beda tergantung penyedia DNS.