All Products
Search
Document Center

CDN:Konfigurasikan halaman error kustom

Last Updated:Jun 22, 2026

Anda dapat mengonfigurasi Alibaba Cloud CDN untuk menampilkan halaman error kustom ketika klien meminta konten yang tidak tersedia atau terjadi error. Alih-alih menampilkan pesan error default, Titik Kehadiran (POP) CDN akan menyajikan halaman yang Anda tentukan, sehingga memberikan pengalaman pengguna yang lebih membantu dan sesuai dengan branding Anda.

Informasi latar belakang

Alibaba Cloud CDN memungkinkan Anda mengalihkan pengguna ke halaman error kustom saat kode status HTTP tertentu dikembalikan.

Ketika klien meminta resource dari layanan web Anda yang tidak ditemukan, server origin biasanya mengembalikan halaman error 404 default. Untuk meningkatkan pengalaman pengguna, Anda dapat mengonfigurasi halaman error kustom dengan menentukan URL tujuan pengalihan saat kode status respons HTTP atau HTTPS tertentu dikembalikan.

Catatan

Jika halaman error kustom Anda menggunakan resource yang dipercepat oleh Alibaba Cloud CDN, biaya pengiriman konten standar akan berlaku.

Kode status yang didukung

Anda hanya dapat mengonfigurasi halaman error kustom untuk kode status berikut: 400, 403, 404, 405, 414, 416, 500, 501, 502, 503, dan 504.

Status code

Description

400

Permintaan mengandung kesalahan sintaksis.

403

Server memahami permintaan tetapi menolak memberikan otorisasi.

404

Server tidak dapat menemukan resource yang diminta.

405

Server mengenali metode permintaan tetapi tidak mendukungnya untuk resource target.

414

URL permintaan terlalu panjang bagi server untuk diproses.

416

Server tidak dapat menyajikan rentang yang diminta.

500

Server mengalami kondisi tak terduga yang menghambatnya memenuhi permintaan.

501

Server tidak mendukung fungsionalitas yang diperlukan untuk memenuhi permintaan.

502

Server, saat bertindak sebagai gateway atau proxy, menerima respons tidak valid dari server hulu.

503

Server sementara tidak dapat menangani permintaan, sering kali karena maintenance atau kelebihan beban.

504

Server, saat bertindak sebagai gateway atau proxy, tidak menerima respons tepat waktu dari server hulu.

Prosedur

  1. Masuk ke CDN console.

  2. Di panel navigasi kiri, klik Domain Names.

  3. Pada halaman Domain Names, temukan nama domain target lalu klik Manage di kolom Actions.

  4. Di panel navigasi domain, klik Cache.

  5. Klik tab Custom Pages.

  6. Klik Customize untuk mengonfigurasi kode status dan URL halaman error kustom.

    Sebagai contoh, pilih 404 untuk Error Code. Bidang Description akan terisi secara otomatis. Di bidang Redirect Link, masukkan URL halaman error kustom Anda, misalnya http://example.aliyundoc.com/error404.html, lalu klik OK.

  7. Klik OK untuk menyimpan konfigurasi.

    Setelah berhasil mengonfigurasi halaman error kustom, Anda dapat menemukan entri tersebut dalam daftar Custom Pages dan klik Modify atau Delete untuk mengelolanya.

Contoh konfigurasi

Untuk menampilkan halaman kustom saat terjadi error 404, asumsikan Anda memiliki halaman bernama error404.html di Direktori root server origin Anda. Halaman ini dapat diakses melalui nama domain yang dipercepat example.aliyundoc.com. Anda dapat mengonfigurasi halaman error kustom untuk kode status 404 dengan pengaturan berikut.

  • Error Code: 404

  • Redirect Link: URL halaman kustom Anda. Contoh: http://example.aliyundoc.com/error404.html.

  • Result: Ketika permintaan klien memicu error 404, pengguna akan dialihkan ke http://example.aliyundoc.com/error404.html.

FAQ

Menghindari loop pengalihan untuk halaman 403

Saat Anda mengonfigurasi halaman error kustom untuk kode status 403, menentukan URL pengalihan dapat menyebabkan loop pengalihan. Untuk menghindari masalah ini, gunakan metode berikut:

  1. Gunakan fitur Rewrite Access URL di CDN console alih-alih menetapkan URL pengalihan dalam konfigurasi halaman error kustom.

  2. Tetapkan path yang akan ditulis ulang menjadi / dan path target ke halaman error statis, seperti /error/403.html.

Penting

Pastikan halaman error 403 itu sendiri tidak memicu pengalihan 403 lainnya. Jika tidak, loop pengalihan akan terjadi dan pengguna tidak dapat mengakses halaman tersebut.

Referensi API

BatchSetCdnDomainConfig