全部产品
Search
文档中心

ApsaraVideo VOD:Menulis Ulang URL dalam Permintaan Asal

更新时间:Feb 10, 2026

ApsaraVideo VOD memungkinkan Anda menulis ulang URL dalam permintaan back-to-origin. Penulisan ulang ini tidak memengaruhi perutean internal atau kunci cache Alibaba Cloud CDN. Fitur ini hanya berlaku ketika node CDN mengirim permintaan back-to-origin ke server origin Anda. Topik ini menjelaskan cara mengonfigurasi penulisan ulang URL asal.

Cara Kerja

POPs mencocokkan jalur origin dengan URL sumber daya yang diminta di server origin berdasarkan aturan Penulisan ulang URL, lalu meneruskan permintaan dengan parameter tertentu ke server origin.

  • Dalam aturan penulisan ulang, jika parameter Flag diatur ke None atau Break, hanya jalur sumber daya dalam URL yang ditulis ulang.1

  • Jika parameter Flag diatur ke enhance break, baik jalur sumber daya maupun query string ditulis ulang.2

Catatan Penggunaan

  • Anda dapat mengonfigurasi hingga 50 aturan Origin Path Rewrite untuk setiap nama domain.

  • Sistem menerapkan aturan penulisan ulang pada tab Origin Path Rewrite secara berurutan dari atas ke bawah. Mengubah urutan aturan dapat menghasilkan hasil penulisan ulang yang berbeda.

  • Fitur Origin URL Rewrite dapat bertentangan dengan fitur Ignore Parameters pada tab Domain Names > Performance Optimization jika Anda mengonfigurasi aturan untuk menulis ulang parameter URL. Pastikan Anda menghindari konflik saat mengonfigurasi kedua fitur tersebut.

Prosedur

  1. Masuk ke ApsaraVideo VOD console.

  2. Pada panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Domain Names.

  3. Klik Configure untuk nama domain target.

  4. Pada panel navigasi sebelah kiri, klik Back-to-Origin.

  5. Klik tab Origin URL Rewrite.

  6. Klik Add. Lalu konfigurasikan Source Path, Destination Path, dan Flag sesuai kebutuhan Anda.

    Penting

    Sistem menerapkan aturan penulisan ulang secara berurutan dari atas ke bawah pada tab Origin URL Rewrite. Mengubah urutan aturan dapat memengaruhi hasil penulisan ulang.

    Parameter

    Contoh

    Deskripsi

    Path to be rewritten

    ^/hello$

    Masukkan URL yang dimulai dengan garis miring (/). Jangan sertakan http:// atau nama domain. Ekspresi Reguler yang Kompatibel Perl (PCRE) didukung.

    Destination Path

    /hello/test

    Masukkan URL yang dimulai dengan garis miring (/). URL tidak boleh mengandung http:// atau nama domain.

    Execution rule

    Empty

    Jika beberapa aturan dikonfigurasi, sistem memprosesnya dari atas ke bawah. Semua aturan yang cocok dieksekusi dalam urutan ini.

    break

    • Jika beberapa aturan Penulisan ulang URL ditetapkan dan suatu aturan cocok, aturan sisanya dilewati.

    • Fitur ini hanya menulis ulang jalur sumber daya dalam URL. Parameter URL tetap tidak berubah. Gunakan fitur back-to-origin parameter rewrite untuk menulis ulang parameter URL.

    enhance break

    • Jika beberapa aturan Penulisan ulang URL dikonfigurasi dan URL permintaan cocok dengan aturan saat ini, aturan lain dilewati setelah aturan saat ini dieksekusi.

    • Mirip dengan `break`, tetapi menambahkan kemampuan untuk menulis ulang parameter URL, .

  7. Klik OK untuk mengaktifkan aturan penulisan ulang.

    Anda dapat mengklik Modify atau Delete dalam daftar aturan pada halaman Origin URL Rewrite untuk mengubah atau menghapus aturan yang telah dikonfigurasi.

Contoh Konfigurasi

Contoh 1: Terapkan aturan dengan flag Empty

Path to Be Rewritten

^/hello$

Target Path

/index.html

Flag

None

Expected result

Original request: http://example.com/hello

Final request: http://example.com/index.html

Sistem melanjutkan pencocokan permintaan terhadap aturan Penulisan ulang URL lain yang tercantum pada tab Origin Path Rewrite.

Contoh 2: Terapkan aturan dengan flag break

Path to Be Rewritten

^/hello.jpg$

Target Path

/image/hello.jpg

Flag

break

Expected result

Original request: http://example.com/hello.jpg

Final request: http://example.com/image/hello.jpg

Sistem menghentikan pencocokan permintaan terhadap aturan Penulisan ulang URL lain yang tercantum pada tab Origin Path Rewrite.

Contoh 3: Terapkan aturan dengan flag enhance break

Path to Be Rewritten

^/hello.jpg?code=123$

Target Path

/image/hello.jpg?code=321

Flag

enhance break

Expected result

Original request: http://example.com/hello.jpg?code=123

Final request: http://example.com/image/hello.jpg?code=321

Sistem menghentikan pencocokan permintaan terhadap aturan Penulisan ulang URL lain yang tercantum pada tab Origin Path Rewrite.

Contoh 4: Tambahkan awalan URL ke direktori root ketika nama file bersifat variabel

Tambahkan jalur /image ke URL semua file dalam direktori root. Misalnya, tulis ulang /xxx dalam URL menjadi /image/xxx. Dalam contoh ini, xxx adalah nama file, seperti hello.jpg atau hello.html.

Path to Be Rewritten

^(.*)$

Catatan

^ mencocokkan string dari awal string. (.*) adalah kelompok, di mana . mencocokkan karakter apa pun kecuali line feed. * mencocokkan karakter atau kelompok sebelumnya nol atau lebih kali. Anda dapat menggunakan $1 dalam jalur target untuk mereferensikan konten variabel dari kelompok tersebut. $ mencocokkan string hingga akhir string. ^(.*)$ mencocokkan string dari awal hingga akhir string, yang dapat berisi karakter apa pun kecuali line break, lalu menangkap konten yang cocok ke dalam satu kelompok. Misalnya, untuk string "hello world", ^(.*)$ mencocokkan seluruh string dan menangkap "hello world" ke dalam kelompok pertama.

Target Path

/image$1

Catatan

/image mencocokkan string "/image". $1 mereferensikan konten kelompok pertama, $2 mereferensikan konten kelompok kedua, dan seterusnya. /image$1 mencocokkan string "/image" diikuti oleh konten kelompok pertama. Misalnya, jika konten kelompok pertama adalah "abc", /image$1 mencocokkan string "/imageabc". Perhatikan bahwa $1 mereferensikan konten kelompok, bukan literal "$1". Jika Anda ingin mencocokkan literal "$1", gunakan string yang di-escape "\$1".

Flag

break

Expected result

  • Original request: http://example.com/hello.jpg

    Final request: http://example.com/image/hello.jpg

  • Original request: http://example.com/hello.html

    Final request: http://example.com/image/hello.html

Sistem menghentikan pencocokan permintaan terhadap aturan Penulisan ulang URL lain yang tercantum pada tab origin path Rewrite.

Contoh 5: Tambahkan awalan URL ke direktori tertentu ketika nama file bersifat variabel

Tambahkan jalur /image ke URL semua file dalam direktori /live. Misalnya, tulis ulang /live/xxx dalam URL menjadi /image/live/xxx. Dalam contoh ini, xxx adalah nama file, seperti hello.jpg atau hello.html.

Path to Be Rewritten

^/live/(.*)$

Target Path

/image/live/$1

Flag

break

Expected result

  • Original request: http://example.com/live/hello.jpg

    Final request: http://example.com/image/live/hello.jpg

  • Original request: http://example.com/live/hello.html

    Final request: http://example.com/image/live/hello.html

Sistem menghentikan pencocokan permintaan terhadap aturan Penulisan ulang URL lain yang tercantum pada tab origin path Rewrite.

Contoh 6: Terapkan flag Empty ketika beberapa aturan cocok

Konfigurasikan dua aturan, seperti yang ditunjukkan pada gambar berikut:

域名管理-改写回源URL1.png

Expected result:

  • Original request: http://example.com/image_01.png

  • Final request: http://example.com/image/image_02.png

    Catatan

    Permintaan cocok dengan aturan pertama dan jalur origin ditulis ulang menjadi http://example.com/image_02.png. Kemudian, permintaan tersebut cocok dengan aturan kedua dan jalur origin ditulis ulang menjadi http://example.com/image/image_02.png.

Contoh 7: Terapkan flag break ketika beberapa aturan cocok

Konfigurasikan dua aturan, seperti yang ditunjukkan pada gambar berikut:

域名管理-改写回源URL2.png

Expected result:

  • Original request: http://example.com/image_01.png

  • Final request: http://example.com/image_02.png

    Catatan

    Permintaan cocok dengan aturan pertama dan URL permintaan ditulis ulang menjadi http://example.com/image_02.png. Aturan lain dilewati.

Referensi

Batch Domain Name Configuration