All Products
Search
Document Center

ApsaraVideo VOD:FAQ untuk CDN ApsaraVideo VOD

Last Updated:Sep 12, 2026

Topik ini menjawab pertanyaan umum mengenai CDN untuk ApsaraVideo VOD.

Kategori pertanyaan

Pembelian dan penagihan

Masalah akses dan pengecualian

Menambahkan dan menguraikan nama domain

Cache

Pengambilan asal dan server origin

HTTPS

Refresh dan prefetch

Keamanan

Lihat paket transfer data baru Anda

Catatan

Anda hanya dapat mengkueri rincian penggunaan paket sumber daya yang sedang aktif atau telah kedaluwarsa dalam satu tahun terakhir.

  1. Login ke Biaya dan Pengeluaran.

  2. Di panel navigasi sebelah kiri, pilih Kelola Instans Terpesan.

  3. Di halaman Kelola Instans Terpesan, atur Jenis Sumber Daya menjadi Paket Sumber Daya untuk melihat rincian penggunaan paket sumber daya.

    Anda dapat mengatur Nama Produk menjadi ApsaraVideo VOD atau menggunakan kondisi filter lain seperti waktu efektif dan status untuk mengkueri paket sumber daya.国际站中文

Ketidaksesuaian data trafik

Masalah

Data trafik untuk nama domain yang dipercepat yang diperoleh dari fitur pemantauan data atau penggunaan sumber daya di Konsol ApsaraVideo VOD atau API berbeda dengan data trafik yang dihitung dari log. Data trafik dari log biasanya lebih rendah.

Penyebab

Trafik yang dihitung dari log didasarkan pada bidang response_size dan hanya mengukur trafik lapisan aplikasi. Trafik lapisan jaringan sebenarnya biasanya 7% hingga 15% lebih tinggi daripada trafik lapisan aplikasi. Perbedaan ini terutama disebabkan oleh dua jenis overhead jaringan utama:

  • Header paket TCP/IP: Sebelum transmisi jaringan, data lapisan aplikasi dikemas menjadi paket TCP di lapisan transport dan kemudian menjadi paket IP di lapisan jaringan. Ukuran maksimum paket IP adalah 1.500 byte, yang mencakup header TCP 20 byte dan header IP 20 byte. Header-header ini juga mengonsumsi trafik jaringan tetapi tidak dicatat dalam log lapisan aplikasi. Overhead header ini menyumbang setidaknya 2,74% dari trafik yang dicatat dalam log (40 byte header untuk setiap 1.460 byte data aplikasi). Semakin kecil data aplikasi, semakin besar persentase overhead header. Overhead ini biasanya sekitar 3%.

  • Pengiriman ulang TCP: Di lingkungan jaringan yang kompleks, kehilangan paket dapat terjadi karena kemacetan jaringan atau kegagalan perangkat. Biasanya, 3% hingga 10% paket data dijatuhkan dan harus dikirim ulang. Kernel sistem operasi menangani pengiriman ulang ini di lapisan tumpukan protokol, dan tidak dicatat dalam log lapisan aplikasi. Proses ini mengonsumsi sumber daya jaringan tambahan.

Karena overhead ini, praktik umum di industri adalah menambahkan margin 7% hingga 15% ke trafik lapisan aplikasi untuk menghitung trafik yang dapat ditagih. CDN untuk ApsaraVideo VOD menerapkan overhead rata-rata sebesar 10%. Oleh karena itu, trafik yang sebenarnya dapat ditagih, yang juga merupakan trafik yang ditampilkan dalam kueri pemantauan, adalah 1,1 kali trafik yang dicatat dalam log. Ini dikenal sebagai koefisien TCP sebesar 1,1.

Penagihan untuk percepatan di Tiongkok daratan

Jika server origin Anda berada di Hong Kong (Tiongkok), Makau (Tiongkok), Taiwan (Tiongkok), atau wilayah lain di luar Tiongkok daratan, dan Anda menggunakan POP CDN di Tiongkok daratan untuk percepatan, Anda akan dikenai biaya berdasarkan tarif standar untuk percepatan CDN di Tiongkok daratan.

CDN ditagih berdasarkan trafik arah keluar dari POP CDN. Oleh karena itu, Anda dikenai biaya berdasarkan tarif untuk Tiongkok daratan. Namun, pengaturan ini dapat memengaruhi kinerja karena latensi dapat terjadi ketika POP CDN di Tiongkok daratan melakukan pengambilan asal dari server di luar Tiongkok daratan. Jika server origin dan pengguna Anda berada di luar Tiongkok daratan, kami merekomendasikan agar Anda mengaktifkan Akselerator Global.

Penggunaan paket sumber daya lintas layanan

Tidak. ApsaraVideo VOD adalah layanan independen. Saat Anda menggunakan ApsaraVideo VOD, Anda dikenai biaya untuk sumber daya penyimpanan, transkoding, trafik, atau bandwidth yang dikonsumsi. Paket ApsaraVideo VOD berisi paket sumber daya seperti paket transfer data, paket penyimpanan, dan paket transkoding. Anda hanya dapat menggunakan paket sumber daya tersebut untuk membayar sumber daya yang dikonsumsi di ApsaraVideo VOD.

Biaya trafik tak terduga

Paket transfer data ApsaraVideo VOD hanya berlaku jika Anda telah mengonfigurasi nama domain yang dipercepat dan memilih metode pengukuran bayar-berdasarkan-transfer-data untuk layanan percepatan. Setelah paket transfer data berlaku, paket tersebut hanya mengimbangi transfer data yang dipercepat dan tidak mencakup trafik arah keluar OSS. Penggunaan berlebih ditagih berdasarkan skema bayar sesuai penggunaan. Jika Anda dikenai biaya transfer data, periksa situasi berikut:

  • Nama domain yang dipercepat telah dikonfigurasi

    • Jika nama domain yang dipercepat belum sepenuhnya dikonfigurasi, paket sumber daya tidak dapat mengimbangi biaya. Misalnya, Anda mungkin telah menambahkan nama domain tetapi belum mengonfigurasi rekaman CNAME. Pastikan nama domain berada dalam status Running. Panduan Cepat ApsaraVideo VOD.

    • Jika Anda menggunakan alamat OSS langsung alih-alih nama domain yang dipercepat untuk mengakses sumber daya, biaya lalu lintas keluar penyimpanan akan dikenakan. Penagihan lalu lintas keluar penyimpanan.

    • Periksa apakah penggunaan Anda melebihi kapasitas paket. Jika ya, perpanjang paket sumber daya. Perpanjang paket sumber daya.

  • Tidak ada nama domain yang dipercepat yang dikonfigurasi

    Jika Anda tidak mengonfigurasi nama domain yang dipercepat di ApsaraVideo VOD, layanan akan mengembalikan URL origin OSS secara default. Memutar atau mengunduh sumber daya dari ApsaraVideo VOD menggunakan jenis URL ini akan menghasilkan biaya trafik arah keluar penyimpanan.

Penagihan untuk trafik serangan

Anda dikenai biaya untuk bandwidth yang dikonsumsi oleh serangan atau trafik yang dibengkakkan secara berbahaya. Biaya ini berlaku karena sumber daya bandwidth ApsaraVideo VOD dikonsumsi.

Untuk menangani trafik yang dibengkakkan secara berbahaya atau serangan, Anda dapat meningkatkan keamanan video atau mengonfigurasi peringatan bandwidth puncak.

  • Aktifkan fitur keamanan video

    Jika bisnis Anda berisiko terkena serangan, kami sarankan Anda untuk meningkatkan keamanan video Anda untuk mempersulit serangan. ApsaraVideo VOD menyediakan mekanisme keamanan konten yang komprehensif untuk melindungi konten video Anda dari hotlinking, pengunduhan ilegal, dan distribusi. Mekanisme ini membantu Anda memenuhi persyaratan keamanan dalam berbagai skenario bisnis. Untuk informasi selengkapnya, lihat Keamanan media.

  • Aktifkan pemantauan bandwidth puncak

    Anda dapat mengatur ambang batas bandwidth untuk nama domain Anda. Ketika ambang batas tercapai, Anda akan menerima notifikasi SMS. Untuk informasi lebih lanjut, lihat Pemantauan bandwidth puncak.

Penagihan untuk kode status 4xx

Ya. Untuk melindungi nama domain yang dipercepat Anda dari serangan dan trafik penipuan, Anda dapat mengonfigurasi fitur kontrol akses seperti perlindungan hotlink, penandatanganan URL, otentikasi jarak jauh, daftar hitam dan daftar putih IP, serta daftar hitam dan daftar putih user-agent (UA). Ketika permintaan berbahaya sesuai dengan aturan kontrol akses, POP CDN mengembalikan kode status 4xx untuk memblokir akses ke sumber daya Anda. Dalam kasus ini, POP CDN mengonsumsi sumber daya CPU untuk memproses permintaan berbahaya dan mengonsumsi sumber daya trafik dan bandwidth untuk mengembalikan kode status 4xx. Oleh karena itu, Anda tetap dikenai biaya untuk trafik dan bandwidth yang dikonsumsi. Untuk informasi lebih lanjut tentang penagihan trafik di ApsaraVideo VOD, lihat Penagihan layanan dasar.

Kesalahan 404 saat mengakses sumber daya

Ketika server web mengembalikan kode status HTTP 404, itu menunjukkan bahwa sumber daya yang diminta tidak ada di server. Hal ini dapat terjadi jika aturan pembuatan URL telah berubah, file web diganti namanya atau dipindahkan, atau tautan yang diimpor mengandung kesalahan ejaan.

Catatan

Pastikan lokasi penyimpanan sumber daya sesuai dengan nama domain. Jika beberapa lokasi penyimpanan ada di wilayah yang sama tetapi hanya satu nama domain yang dikonfigurasi, Konsol ApsaraVideo VOD memprioritaskan pengembalian URL CDN untuk wilayah tersebut. Jika Anda mengakses sumber daya di lokasi penyimpanan yang tidak diikat ke nama domain, kesalahan 404 akan dikembalikan.

Mengisolasi masalah CDN atau server origin

  1. Buka Alat Diagnostik Pengguna Alikunlun dan pastikan jaringan lokal Anda berfungsi dengan baik.

  2. Tambahkan entri yang memetakan alamat IP server origin ke nama domainnya di file hosts lokal Anda untuk menguji akses situs secara langsung. Jika terjadi kesalahan saat Anda mengakses server origin, masalahnya ada pada server origin Anda. Hubungi administrator situs Anda untuk memperbaikinya.

    # Copyright (c) 1993-2009 Microsoft Corp.
    #
    # Ini adalah contoh file HOSTS yang digunakan oleh Microsoft TCP/IP untuk Windows.
    #
    # File ini berisi pemetaan alamat IP ke nama host. Setiap
    # entri harus ditempatkan pada baris terpisah. Alamat IP harus
    # ditempatkan di kolom pertama diikuti oleh nama host yang sesuai.
    # Alamat IP dan nama host harus dipisahkan oleh setidaknya satu
    # spasi.
    #
    # Selain itu, komentar (seperti ini) dapat dimasukkan pada baris individual
    # atau mengikuti nama mesin yang dilambangkan dengan simbol '#'.
    #
    # Contoh:
    #
    #      102.54.94.97     rhino.acme.com          # server sumber
    #      38.25.63.10      x.acme.com              # host klien x
    # Resolusi nama localhost ditangani dalam DNS itu sendiri.
    #    127.0.0.1       localhost
    #    ::1             localhost
    10.10.10.10 www.example.com
  3. Beri komentar pada entri yang Anda tambahkan ke file hosts pada langkah sebelumnya. Kemudian, jalankan perintah ping untuk menguji nama domain yang dipercepat. Jika perintah mengembalikan respons yang berhasil, POP CDN berfungsi dengan baik.

    C:\Users\admin>ping www.example.com
    Pinging www.example.com [101.x.x.x] with 32 bytes of data:
    Reply from 101.x.x.x: bytes=32 time=3ms TTL=54
    Reply from 101.x.x.x: bytes=32 time=3ms TTL=54
    Reply from 101.x.x.x: bytes=32 time=3ms TTL=54
    Reply from 101.x.x.x: bytes=32 time=4ms TTL=54
    Statistik ping untuk 101.x.x.x:
        Paket: Dikirim = 4, Diterima = 4, Hilang = 0 (0% loss),
    Perkiraan waktu perjalanan bolak-balik dalam milidetik:
        Minimum = 3ms, Maksimum = 4ms, Rata-rata = 3ms

Bagaimana cara mengatasi tersendatnya pemutaran dan kesalahan 4008/4009?

Jika pemutaran tersendat atau terjadi kesalahan 4008 atau 4009 selama pemutaran video, atasi masalah tersebut sebagai berikut:

  1. Gunakan alat diagnostik tautan pemutaran untuk menjalankan diagnosis mandiri pada tautan pemutaran video.

  2. Periksa apakah lingkungan jaringan klien (misalnya, jaringan 4G) stabil dan bandwidth downstream tidak lebih rendah daripada bitrate video. Kami merekomendasikan agar Anda mengganti jaringan untuk menguji pemutaran.

  3. Periksa apakah URL pemutaran atau alamat segmen TS dapat diakses, untuk mengesampingkan respons abnormal dari POP CDN.

  4. Jika Anda menggunakan pemutaran HLS terenkripsi, periksa apakah parameter loadDataTimeout dalam konfigurasi pemutar diatur terlalu rendah.

  5. Gunakan alat developer browser Anda untuk memeriksa detail permintaan dan periksa apakah segmen tertentu mengalami timeout saat dimuat (sesuai dengan kesalahan 4008) atau mengembalikan 0 byte (sesuai dengan kesalahan 4009).

Akselerator Global tidak meningkatkan kecepatan akses

Periksa hal-hal berikut untuk mengatasi masalah:

  • Ketika pengguna di luar Tiongkok daratan mencoba mengakses sumber daya, periksa alamat IP tempat nama domain diselesaikan. Hal ini membantu Anda menentukan apakah konfigurasi untuk POP di luar Tiongkok daratan telah berlaku.

  • Kinerja POP di luar Tiongkok daratan juga bergantung pada volume permintaan. Kecepatan akses meningkat hanya ketika volume permintaan tinggi. Jika jumlah permintaan rendah, lebih sedikit permintaan yang mengenai cache. Dalam kasus ini, menambahkan POP di luar Tiongkok daratan tidak secara signifikan meningkatkan kecepatan akses bagi pengguna di wilayah tersebut.

Pratinjau video MP4 tidak berfungsi

Fitur pratinjau di ApsaraVideo VOD mendukung format file MP4 dan HLS. Untuk video MP4, metadata harus terletak di awal file. Video dengan metadata di akhir file tidak dapat dipratinjau. Saat Anda menggunakan ApsaraVideo VOD untuk mentranskode video ke format MP4, layanan tersebut menempatkan metadata di awal file. Untuk mengatasi masalah ini, Anda dapat mentranskode video MP4 tersebut. Untuk informasi selengkapnya tentang transkoding, lihat Transkoding audio dan video.

Apakah saya perlu mengizinkan akses jaringan untuk memutar video ApsaraVideo VOD dari jaringan internal?

CDN untuk ApsaraVideo VOD tidak mendukung akses dari jaringan internal (VPC). Untuk memutar sumber daya ApsaraVideo VOD dari jaringan internal, gunakan salah satu metode berikut:

  1. Izinkan nama domain: Aktifkan akses internet arah keluar, dan izinkan akses ke nama domain API vod.<RegionId>.aliyuncs.com:443 dan ke nama domain yang dipercepat CDN Anda. Metode ini tidak mengharuskan Anda memelihara alamat IP dinamis.

  2. Dapatkan alamat IP node CDN: Panggil operasi API DescribeUserVipsByDomain untuk mendapatkan alamat IP node CDN Level 1 (L1), dan tambahkan alamat IP tersebut ke daftar putih firewall Anda. Karena alamat IP node CDN dialokasikan secara dinamis, perbarui daftar putih secara berkala.

  3. Gunakan nama domain internal OSS: Ganti nama domain yang dipercepat dengan nama domain internal OSS dalam format outin-<bucket_id>.oss-<RegionId>-internal.aliyuncs.com untuk melewati CDN dan mengakses langsung server origin.

Nama domain wildcard

ApsaraVideo VOD mendukung penambahan nama domain wildcard dengan menggunakan operasi API AddVodDomain. Nama domain wildcard harus diawali dengan titik (.), misalnya, .aliyundoc.com.

Kesalahan "Nama root domain dicadangkan"

Jika Anda gagal menambahkan nama domain di Konsol ApsaraVideo VOD dan menerima kesalahan The root name of your domain is reserved by other account dengan pesan The root name of your domain is reserved by other account, please contact our Business Advisors, ini berarti nama domain root telah ditambahkan ke Alibaba Cloud CDN, DCDN, atau ApsaraVideo VOD di bawah Akun Alibaba Cloud yang berbeda.

Jika Anda tidak dapat mengatasi masalah tersebut, ajukan tiket. Untuk informasi selengkapnya tentang cara mengajukan tiket, lihat Hubungi kami.

Kesalahan "Nama domain sudah ada"

Jika Anda gagal menambahkan nama domain di Konsol ApsaraVideo VOD dan menerima kesalahan This domain name already exists, ini berarti nama domain tersebut telah ditambahkan ke produk Alibaba Cloud lainnya.

Nama domain yang dipercepat tidak dapat ditambahkan lebih dari sekali. Jika Anda menerima kesalahan ini, periksa apakah nama domain Anda telah ditambahkan ke produk cloud lainnya, seperti ApsaraVideo Live, DCDN, dan SCDN.

Jika Anda tidak dapat mengatasi masalah, ajukan tiket. Untuk informasi selengkapnya tentang cara mengajukan tiket, lihat Hubungi kami.

Verifikasi rekaman CNAME

Jangan gunakan perintah ping untuk verifikasi. Perintah ping dapat mengembalikan informasi resolusi yang tidak akurat. Sebagai gantinya, gunakan alat kueri seperti nslookup atau dig.

  • Windows

    Di Command Prompt (CMD) atau PowerShell pada sistem Windows, jalankan perintah berikut untuk mengkueri rekaman CNAME:

    nslookup -type=CNAME <accelerated_domain_name>

    Jika hasil yang dikembalikan cocok dengan nilai CNAME yang disediakan oleh layanan CDN, rekaman CNAME telah berlaku.

    PS C:\Users\admin> nslookup -type=cname cdn.example.com
    Server:  UnKnown
    Address: 100.100.x.x
    
    Non-authoritative answer:
    cdn.example.com       canonical name = cdn.example.com.w.alikunlun.com
  • Linux/macOS

    Di terminal pada sistem Linux atau Mac OS, gunakan perintah dig untuk verifikasi:

    • Kueri hanya alamat target CNAME (Direkomendasikan):

      dig +short <accelerated_domain_name> CNAME

      Jika hasil yang dikembalikan cocok dengan nilai CNAME yang disediakan oleh layanan CDN, rekaman CNAME telah berlaku. Berikut adalah contoh hasil:

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

      dig <accelerated_domain_name> CNAME

      Jika nilai CNAME di bagian ANSWER SECTION sama dengan nilai CNAME yang disediakan oleh CDN, ini menunjukkan bahwa resolusi CNAME telah berlaku.

      ; <<>> DiG 9.10.6 <<>> cdn.example.com CNAME
      ;; global options: +cmd
      ;; Got answer:
      ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 62811
      ;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1
      ;; OPT PSEUDOSECTION:
      ; EDNS: version: 0, flags:; udp: 4000
      ;; QUESTION SECTION:
      ;cdn.example.com.               IN      CNAME
      ;; ANSWER SECTION:
      cdn.example.com.     600     IN      CNAME   cdn.example.com.w.alikunlun.com.
      ;; Query time: 67 msec
      ;; SERVER: 30.30.x.x#53(30.30.x.x)
      ;; WHEN: Wed Sep 24 19:05:30 CST 2025
      ;; MSG SIZE  rcvd: 92

Nama domain yang dipercepat gagal dalam tinjauan

Semua nama domain yang ditambahkan ke ApsaraVideo VOD harus menjalani tinjauan konten. Jika nama domain Anda gagal ditambahkan, mungkin tidak memenuhi aturan akses. Untuk informasi lebih lanjut tentang standar dan batasan untuk menambahkan nama domain, lihat Persyaratan nama domain.

Jika nama domain Anda gagal dalam tinjauan, login ke Konsol ApsaraVideo VOD. Buka halaman Configuration Management > CDN Configuration > Domain Names untuk melihat alasan kegagalannya. Hapus nama domain yang gagal dalam tinjauan, sesuaikan konten website Anda berdasarkan alasannya, lalu tambahkan kembali nama domain tersebut untuk menunggu tinjauan.

Dapatkah nama domain yang dipercepat ApsaraVideo VOD sama dengan domain utama website?

Tidak. Jangan gunakan nama domain yang sama untuk domain utama website dan nama domain yang dipercepat ApsaraVideo VOD. Arahkan domain utama, seperti www.example.com, ke server web Anda sendiri. Tambahkan subdomain terpisah, seperti vod.example.com, ke ApsaraVideo VOD sebagai nama domain yang dipercepat, dan gunakan subdomain tersebut untuk pemutaran video.

Meningkatkan rasio hit cache yang rendah

Rasio hit cache yang rendah berarti permintaan pengguna sering diarahkan ke server origin, yang dapat menurunkan kinerja percepatan karena tautan jaringan publik yang tidak stabil. Anda dapat meningkatkan rasio hit cache dengan melakukan prefetch URL, mengonfigurasi aturan kedaluwarsa cache, dan menyaring parameter variabel dalam URL.

Tabel berikut menjelaskan solusinya.

Kebijakan

Faktor dan skenario

Metode konfigurasi

Lakukan prefetch sumber daya populer sebelum jam sibuk

Faktor: Jika sumber daya tidak diprefetch ke POP CDN sebelum acara operasional besar atau rilis versi baru, sejumlah besar sumber daya harus diambil dari server origin. Hal ini mengakibatkan rasio hit cache yang rendah.

Skenario:

  • Acara operasional

    Sebelum acara besar, lakukan prefetch sumber daya statis di halaman acara ke POP CDN. Setelah acara dimulai, semua permintaan pengguna untuk sumber daya statis ini dilayani langsung dari cache di POP CDN.

  • Rilis paket instalasi

    Sebelum merilis paket instalasi atau peningkatan baru, lakukan prefetch sumber daya ke POP CDN. Setelah produk diluncurkan secara resmi, permintaan unduhan dari banyak pengguna dilayani langsung oleh POP CDN. Hal ini meningkatkan kecepatan unduhan, secara signifikan mengurangi beban pada server origin, dan meningkatkan pengalaman pengguna.

Hapus cache dan prefetch

Konfigurasikan waktu hidup (TTL) yang sesuai

Faktor:

  • Tidak ada kebijakan cache yang dikonfigurasi di CDN. Semua permintaan pengguna diarahkan ke server origin.

  • Waktu hidup (TTL) yang dikonfigurasi di CDN terlalu singkat, yang menyebabkan sumber daya cache sering kedaluwarsa dan mengakibatkan rasio hit cache yang rendah.

Skenario: Sumber daya statis dipublikasikan di server origin tetapi tidak di-cache di POP CDN, atau sumber daya yang di-cache di POP kedaluwarsa dengan cepat.

Rekomendasi konfigurasi:

  • Untuk file statis yang jarang diperbarui, seperti gambar dan unduhan aplikasi, kami merekomendasikan agar Anda mengatur TTL cache menjadi satu bulan atau lebih lama.

  • Untuk file statis yang sering diperbarui, seperti file JS, CSS, dan MP4, Anda dapat mengatur TTL cache berdasarkan kebutuhan bisnis Anda.

  • Untuk file dinamis, seperti file PHP, JSP, dan ASP, kami merekomendasikan agar Anda mengatur TTL cache menjadi 0 detik untuk menonaktifkan caching.

Pengaturan cache

Abaikan parameter dalam URL

Faktor: Saat URL permintaan berisi query string atau parameter variabel lainnya, URL berbeda yang mengakses sumber daya yang sama memicu pengambilan asal terpisah. Hal ini menurunkan rasio hit cache.

Skenario: Anda ingin menyajikan sumber daya yang sama dari URL berbeda yang hanya berbeda berdasarkan parameternya.

Mengabaikan parameter

Konfigurasikan kebijakan pengambilan asal Range untuk file besar

Faktor: Pengguna mungkin menghentikan unduhan di tengah jalan atau hanya menonton sebagian video. Dalam kasus ini, pengguna hanya perlu mengakses rentang tertentu dari file. Namun, POP CDN meminta seluruh file dari server origin. Akibatnya, POP CDN mengunduh lebih banyak data dari server origin daripada yang dilayani kepada pengguna, yang menurunkan rasio hit cache.

Skenario: Pengguna mengunduh paket instalasi aplikasi atau menonton sumber daya video.

Konfigurasi pengambilan asal Range

Akses sumber daya lambat setelah percepatan

Nama domain yang dipercepat menambahkan lapisan POP CDN ke jaringan, mendistribusikan sumber daya dari server origin Anda ke POP yang lebih dekat dengan pengguna Anda. Hal ini memungkinkan klien untuk meminta dan mengambil sumber daya dari POP CDN terdekat, mengurangi pengambilan asal dan meningkatkan kecepatan akses. Oleh karena itu, akses yang lambat dapat disebabkan oleh masalah berikut:

  • Masalah jaringan lokal di sisi klien, seperti bandwidth downstream yang tidak mencukupi atau konfigurasi yang salah.

  • Koneksi jaringan yang buruk dan latensi tinggi antara klien dan POP CDN.

  • POP CDN yang tidak berfungsi dengan baik atau memiliki waktu respons yang lambat.

  • Konten sumber daya berukuran besar, mengakibatkan waktu unduh yang lama.

  • Koneksi jaringan yang buruk selama pengambilan asal dari POP CDN ke server origin.

  • Server origin itu sendiri memiliki waktu respons yang lambat.

Kesalahan lintas origin "Access-Control-Allow-Origin"

Permintaan untuk sumber daya yang dipercepat gagal dengan kesalahan The 'Access-Control-Allow-Origin' header has a value 'xxx' that is not equal to the supplied origin. Panel Konsol di alat developer browser menunjukkan kesalahan lintas origin CORS karena origin permintaan (https://vr-mc01.xxx) tidak cocok dengan nilai header respons Access-Control-Allow-Origin (https://vr-web01.xxx). Ketidakcocokan ini menyebabkan sumber daya gagal dimuat (net::ERR_FAILED) dan memicu kesalahan runtime JS berikutnya. Kesalahan ini menunjukkan bahwa nilai header lintas origin Access-Control-Allow-Origin dalam respons CDN tidak cocok dengan header Origin lintas origin dari permintaan klien, yang menyebabkan browser memblokir respons tersebut. Misalnya, header lintas origin permintaan adalah "Origin:http://Domain-A", tetapi header lintas origin respons adalah "Access-Control-Allow-Origin:http://Domain-B".

Masalah ini dapat terjadi karena salah satu alasan berikut:

  • Header lintas origin yang dikonfigurasi di CDN tidak cocok dengan header Origin dari permintaan klien.

  • Header lintas origin dari server origin di-cache oleh CDN.

  • Cache browser sudah usang.

Dapatkah nama domain yang dipercepat ApsaraVideo VOD menggunakan sertifikat SSL untuk domain utama?

Tidak. Anda tidak dapat langsung menggunakan sertifikat untuk domain utama sebagai sertifikat untuk nama domain yang dipercepat. Konfigurasikan sertifikat yang sesuai dengan nama domain yang dipercepat, seperti sertifikat untuk subdomain, sertifikat wildcard, atau sertifikat domain tunggal.

Apa yang harus saya lakukan jika konfigurasi sertifikat HTTPS gagal karena saya memasukkan file CSR?

Konfigurasi gagal ketika Anda memasukkan permintaan penandatanganan sertifikat (CSR) sebagai konten sertifikat. CSR adalah file permintaan sertifikat yang dimulai dengan -----BEGIN CERTIFICATE REQUEST-----; ini bukan sertifikat yang diterbitkan.

Untuk memperbaiki konfigurasi:

  1. Buka detail instans sertifikat di Layanan Manajemen Sertifikat.

  2. Temukan konten sertifikat lengkap yang diterbitkan, yang dimulai dengan -----BEGIN CERTIFICATE-----, dan kunci privat yang sesuai.

  3. Login ke Konsol ApsaraVideo VOD. Buka Configuration Management > CDN Configuration > Domain Names.

  4. Pilih nama domain yang dipercepat, buka Pengaturan HTTPS, tempel sertifikat lengkap yang diterbitkan dan kunci privat yang sesuai, lalu simpan konfigurasi.

Apa yang harus saya lakukan jika penerapan sertifikat SSL melaporkan InsufficientQuota?

InsufficientQuota menunjukkan bahwa kuota penerapan sertifikat yang tersedia tidak mencukupi. Gunakan salah satu metode berikut:

  • Beli kuota penerapan yang diperlukan di konsol Layanan Manajemen Sertifikat, lalu coba lagi penerapannya.

  • Perbarui sertifikat secara manual tanpa biaya. Login ke Konsol ApsaraVideo VOD. Buka Configuration Management > CDN Configuration > Domain Names. Pilih nama domain, buka Pengaturan HTTPS, dan perbarui sertifikat.

Jika kesalahan tetap berlanjut, coba lagi dengan nama sertifikat kustom yang tidak mengandung karakter Tiongkok.

Apakah permintaan HTTP masih dapat mengakses sumber daya setelah HTTPS diaktifkan?

Ya. Setelah Anda mengonfigurasi sertifikat SSL untuk nama domain dan mengaktifkan percepatan aman HTTPS, baik permintaan HTTP maupun permintaan HTTPS dapat mengakses sumber daya. Akses protokol ganda ini menjaga jalur sumber daya video yang ada tetap valid dan mempertahankan akses tanpa gangguan.

URL callback transkoding bukan HTTPS

Callback ApsaraVideo VOD saat ini tidak mendukung HTTPS. Jika Anda telah mengonfigurasi sertifikat HTTPS dengan benar di ApsaraVideo VOD, Anda dapat secara manual mengganti http:// dengan https:// di URL sumber daya setelah Anda menerima pesan callback.

Catatan

Callback untuk snapshot dan gambar mini mencakup URL HTTPS, tetapi callback untuk transkoding mengembalikan URL HTTP.

Perbarui file dengan nama yang sama

Anda dapat mengirimkan permintaan refresh dari konsol atau dengan menggunakan API. Untuk informasi lebih lanjut tentang cara merefresh sumber daya, lihat Hapus cache dan prefetch. Anda dapat mengirimkan hingga 2.000 permintaan refresh per hari untuk setiap Akun Alibaba Cloud. Setiap permintaan dapat berisi hingga 1.000 URL. Anda juga dapat merefresh konten di hingga 100 direktori per hari. Untuk informasi tentang operasi API terkait, lihat API Refresh dan Prefetch.

Sumber daya tidak diperbarui setelah refresh atau prefetch

Lakukan langkah-langkah berikut untuk mengatasi dan menyelesaikan masalah:

  • Bersihkan cache browser Anda, lalu refresh halaman untuk melihat apakah sumber daya telah diperbarui.

  • Ikat nama domain situs langsung ke server origin dengan memodifikasi file hosts lokal. Kemudian, akses server origin secara langsung untuk memeriksa apakah sumber dayanya telah diperbarui. Jika belum diperbarui, perbarui sumber daya di server origin, lalu gunakan layanan CDN untuk percepatan.

  • Login ke Konsol ApsaraVideo VOD dan periksa apakah tugas refresh atau prefetch telah selesai. Jika belum, kami merekomendasikan agar Anda menjalankan tugas tersebut lagi.

Blokir alamat IP berbahaya

Anda dapat mengonfigurasi daftar hitam IP untuk memblokir dan menolak akses dari alamat IP tertentu. Untuk informasi lebih lanjut, lihat Konfigurasi daftar hitam atau daftar putih IP.

IP di daftar hitam masih dapat mengakses sumber daya

Periksa apakah alamat IP yang dikonfigurasi di Konsol ApsaraVideo VOD benar. Untuk membatasi alamat IP klien secara akurat, Anda harus menambahkan alamat IP dari header X-Forwarded-For ke daftar hitam. Untuk informasi lebih lanjut tentang cara mendapatkan alamat IP klien, lihat Ambil alamat IP asal klien.

Catatan
  • Layanan CDN, yang bertindak sebagai server, tidak dapat mengontrol upaya akses klien. Setelah Anda mengonfigurasi daftar hitam IP, permintaan dari alamat IP yang masuk daftar hitam yang dikirim ke CDN akan menerima kode kesalahan 403. Anda dapat melihat log untuk permintaan ini. Untuk informasi lebih lanjut tentang cara melihat log, lihat Unduh log.

  • Ketika kode kesalahan 403 dikembalikan, Anda dikenai biaya untuk trafik yang dihasilkan. Karena tidak ada konten sumber daya aktual yang dikirimkan, hanya header respons yang menghasilkan trafik, dan biayanya minimal. Untuk informasi lebih lanjut, lihat Apakah saya dikenai biaya jika POP CDN mengembalikan kode status 4xx?.

Perlindungan hotlink menyebabkan kesalahan 403

Masalah

Setelah Anda mengonfigurasi perlindungan hotlink, mengakses sumber daya yang dipercepat di ApsaraVideo VOD mengembalikan kesalahan 403.

Penyebab

Pengaturan perlindungan hotlink salah, atau header Referer dalam permintaan kosong.

Solusi

  1. Identifikasi penyebab masalah.

    • Jalankan perintah curl untuk menguji akses ke nama domain yang dipercepat.

      curl -voa -e "http://demo.aliyundoc.com" http://example.aliyundoc.com

      Kesalahan 403 dengan pesan denied by Referer ACL, seperti yang ditunjukkan dalam contoh output berikut, menunjukkan bahwa pengaturan perlindungan hotlink salah. Dalam contoh ini, header HTTP permintaan berisi bidang Referer dengan nilai demo.aliyundoc.com.

      * Rebuilt URL to: http://example.aliyundoc.com/
      *   Trying 101.x.x.144...
      * TCP_NODELAY set
      * Connected to example.aliyundoc.com (101.x.x.144) port 80 (#0)
      > GET / HTTP/1.1
      > Host: example.aliyundoc.com
      > User-Agent: curl/7.54.0
      > Accept: */*
      > Referer: http://demo.aliyundoc.com
      >
      < HTTP/1.1 403 Forbidden
      < Server: Tengine
      < Date: Sat, 08 Dec 2023 12:36:17 GMT
      < Content-Type: text/html
      < Content-Length: 254
      < Connection: keep-alive
      < X-Tengine-Error: denied by Referer ACL
      ...
      * Connection #0 to host example.aliyundoc.com left intact
    • Jalankan perintah curl untuk menguji akses ke nama domain yang dipercepat tanpa header Referer.

      curl -voa http://example.aliyundoc.com

      Jika sistem mengembalikan kesalahan 403 dan pesan denied by Referer ACL, seperti yang ditunjukkan dalam contoh output berikut, ini menunjukkan bahwa perlindungan hotlink dikonfigurasi untuk memblokir permintaan dengan header Referer kosong. Dalam contoh ini, header HTTP permintaan tidak memiliki bidang Referer.

      * Rebuilt URL to: http://example.aliyundoc.com/
      *   Trying 101.x.x.148...
      * TCP_NODELAY set
      * Connected to example.aliyundoc.com (101.x.x.148) port 80 (#0)
      > GET / HTTP/1.1
      > Host: example.aliyundoc.com
      > User-Agent: curl/7.54.0
      > Accept: */*
      >
      < HTTP/1.1 403 Forbidden
      < Server: Tengine
      < Date: Sat, 08 Dec 2023 12:48:50 GMT
      < Content-Type: text/html
      < Content-Length: 254
      < Connection: keep-alive
      < X-Tengine-Error: denied by Referer ACL
      ...
      * Connection #0 to host example.aliyundoc.com left intact
    • Buka URL yang dipercepat oleh domain di browser Chrome dan buka alat developer. Jika header permintaan tidak berisi bidang Referer dan terjadi kesalahan 403, seperti yang ditunjukkan dalam contoh output berikut, ini menunjukkan bahwa perlindungan hotlink dikonfigurasi untuk memblokir permintaan dengan header Referer kosong.

      403 Forbidden
      You don't have permission to access the URL on this server.
      Powered by Tengine
      
      Response Headers:
      Server: Tengine
      X-Tengine-Error: denied by Referer ACL
      ...
      
      Request Headers:
      Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
      Host: example.aliyundoc.com
      User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36
      ...
  2. Selesaikan masalah berdasarkan penyebabnya.

    • Solusi untuk pengaturan perlindungan hotlink yang salah

      Periksa apakah nilai Referer demo.aliyundoc.com diizinkan oleh aturan perlindungan hotlink yang dikonfigurasi untuk nama domain yang dipercepat example.aliyundoc.com.

      Login ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Domain Names. Temukan nama domain target dan klik Konfigurasi di kolom Tindakan. Kemudian, pilih Resource Access Control > Perlindungan Hotlink Berbasis Referer > Modify. Jika jenis Referer diatur ke Whitelist dan Referer yang diminta tidak sesuai dengan daftar putih, tambahkan nama domain demo.aliyundoc.com ke daftar tersebut. Misalnya, jika Perlindungan Hotlink Berbasis Referer dikonfigurasi sebagai Daftar Putih dengan aturan *.example.com, dan opsi untuk Izinkan Akses ke URL Sumber Daya dari Bilah Alamat Browser dan Izinkan Bidang Referer Kosong untuk Mengakses Sumber Daya CDN tidak dipilih, permintaan dari demo.aliyundoc.com akan diblokir.

    • Solusi untuk header Referer kosong

      Login ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Domain Names. Temukan nama domain target dan klik Konfigurasi di kolom Tindakan. Kemudian, pilih Resource Access Control > Perlindungan Hotlink Berbasis Referer > Modify. Pilih kotak centang Allow Access to Resource URL from Browser Address Bar.

      Catatan

      Mengizinkan permintaan dengan header Referer kosong meningkatkan risiko hotlinking.

Alat developer tidak dapat digunakan karena Web Player SDK memicu anti-debugging (debugger) setelah dimuat

Versi produksi aliplayer-min.js mencakup mekanisme perlindungan anti-debugging bawaan. Di lingkungan yang tidak sah, atau ketika alat developer browser terbuka, secara otomatis menyisipkan pernyataan debugger untuk mencegah penggunaan tidak sah atau perubahan kode. Mekanisme ini tidak dapat dinonaktifkan melalui konfigurasi.

Jika Anda mencurigai bahwa lingkungan lokal Anda berbeda dari versi resmi, Anda dapat mengunjungi halaman pengaturan pemutar resmi untuk membandingkan dan menguji.

Kata kunci: anti-debugging, debugger, aliplayer-min.js, alat developer, debugging browser.

Bagaimana cara menyinkronkan subtitle dan lirik dengan pemutaran di Web Player SDK?

Secara default, Web Player SDK menampilkan subtitle VTT di bawah video, menggunakan gaya yang sama dengan subtitle video.

SDK tidak mendukung secara native lirik bergulir bergaya pemutar musik atau lirik yang disorot di tengah. Untuk menyinkronkan lirik dengan file audio MP3, konversi lirik ke format VTT dan gunakan sebagai subtitle eksternal. Pastikan stempel waktu VTT secara tepat sesuai dengan progres pemutaran audio. Kemudian dengarkan event pembaruan waktu pemutaran pemutar, uraikan konten VTT sendiri, dan kembangkan komponen UI khusus untuk merender lirik.

Kata kunci: subtitle VTT, sinkronisasi lirik, lirik bergulir, lirik MP3, subtitle eksternal, UI khusus.

Web Player melaporkan kesalahan atau menampilkan Loading lama setelah dilanjutkan dari latar belakang

Penyebab: Ketika browser mereklaim sumber daya di latar belakang, pemutar menjadi tidak aktif. Atau, kredensial PlayAuth mungkin telah kedaluwarsa (periode validitas maksimum adalah 3.000 detik).

Solusi: Dengarkan event visibilitychange. Ketika halaman berpindah ke latar belakang, panggil player.pause() dan simpan currentTime di sessionStorage. Ketika halaman kembali ke latar depan, dapatkan PlayAuth baru dan panggil replayByVid(vid, newPlayAuth) untuk mengatur ulang pemutaran. Dengarkan event ready atau canplay, dan dalam callback baca waktu dari sessionStorage dan panggil player.seek() untuk melanjutkan progres pemutaran.

Saran optimasi: Atur vodRetry ke 0 dan waitingTimeout ke 10 detik untuk mempersingkat waktu tunggu, atau secara proaktif memperbarui token 5 menit sebelum kredensial kedaluwarsa.

Bagaimana cara menggunakan dan menghapus cache lokal ListPlayer (enableLocalCache)?

Kondisi agar cache berlaku: Format video harus MP4 dan diputar berdasarkan URL. Jika URL berisi parameter autentikasi, hapus parameter autentikasi tersebut saat menghitung kunci cache.

Pemutaran offline: Setelah Anda mengatur enableLocalCache ke YES, pemutaran dapat dilanjutkan secara offline tanpa gangguan dan tanpa mengonsumsi trafik tambahan.

Menghapus cache: Panggil [AliPlayerGlobalSettings clearCaches] untuk menghapus semua cache video. Ini berlaku untuk skenario seperti selama pemutaran, setelah logout, atau pembersihan manual.

Catatan

Metode asli setCacheConfig sudah tidak digunakan lagi. Gunakan API enableLocalCache sebagai gantinya.

Bagaimana mekanisme verifikasi Lisensi Web Player SDK bekerja, dan bagaimana menangani skenario khusus (VPN/iframe)?

Mekanisme verifikasi: Web Player SDK memverifikasi Lisensi berdasarkan nama domain saat ini di bilah alamat browser atau Referer. Nama domain ini harus sesuai dengan nama domain yang diikat saat Anda mengajukan Lisensi.

Skenario proxy VPN: Mengakses halaman melalui VPN dapat menyebabkan kesalahan ketidakcocokan nama domain. Kami merekomendasikan agar Anda menggunakan pengalihan 302 terpadu ke halaman di nama domain yang sah, atau menyematkan halaman pemutaran di iframe di halaman VPN (pastikan halaman yang dimuat di dalam iframe berada di nama domain yang sah).

Batasan penyematan iframe: Jika halaman induk berada di nama domain yang tidak sah dan halaman anak (iframe) berada di nama domain yang sah, verifikasi Lisensi dapat lolos secara normal. Namun, perhatikan bahwa browser bawaan WeChat mungkin membatasi iframe lintas domain, dan komunikasi antara halaman induk dan anak memerlukan konfigurasi postMessage.

Kata kunci: pengikatan domain Lisensi, proxy VPN, penyematan iframe, batasan lintas domain, postMessage.

Setelah Web Player merefresh PlayAuth yang kedaluwarsa, bagaimana cara melanjutkan pemutaran dari posisi tertentu?

Batasan saat ini: Saat Anda menggunakan metode replayByVidAndPlayAuth untuk merefresh PlayAuth, pemutaran dimulai kembali dari awal. Melanjutkan secara otomatis dari posisi tertentu belum didukung.

Solusi yang direkomendasikan: Saat event pause terpicu, catat waktu pemutaran saat ini (simpan di localStorage atau variabel memori). Saat Anda menangkap kode kesalahan kedaluwarsa PlayAuth 4002, pertama-tama refresh PlayAuth, lalu panggil secara manual seek ke waktu yang sebelumnya dicatat untuk melanjutkan pemutaran.

Strategi cadangan: Di event error, simpan waktu valid terakhir yang diketahui sebagai cadangan, untuk menghindari penentuan posisi yang tidak akurat yang disebabkan oleh kesalahan buffering.

Kata kunci: kedaluwarsa PlayAuth, melanjutkan pemutaran, replayByVidAndPlayAuth, kode kesalahan 4002, pemulihan seek, kegagalan getCurrentTime.

Web Player di WebView Android memiliki audio tetapi tidak ada video

Atasi masalah tersebut sebagai berikut:

  1. Periksa apakah akselerasi perangkat keras diaktifkan. Atur android:hardwareAccelerated="true" di AndroidManifest.xml, atau atur webView.setLayerType(View.LAYER_TYPE_SOFTWARE, null) di kode Anda untuk mencoba rendering perangkat lunak.

  2. Periksa kompatibilitas format encoding video. WebView lama mungkin tidak mendukung High Profile H.265/H.264. Kami merekomendasikan agar Anda mentranskode video ke format yang kompatibel.

  3. Tingkatkan Web Player SDK ke versi terbaru (misalnya, 2.37.6 atau lebih baru) untuk memperbaiki masalah kompatibilitas yang diketahui.

  4. Cetak versi WebView untuk memeriksa apakah kernel sudah usang.

Web Player menampilkan layar hitam atau terus memuat saat autoplay bernilai false dan tidak ada gambar sampul

Penyebab: Jika atribut poster tidak diatur, pemutar tidak memiliki konten default untuk ditampilkan.

Solusi: Atur atribut poster untuk menentukan gambar sampul, atau dengarkan event seperti ready untuk mengelola status pemutar dan menyesuaikan tampilan UI.

Mengapa video dapat diputar di Browser 360 tetapi tidak di Chrome atau Edge, dan bagaimana cara memperbaikinya?

Penyebab: Browser 360 memiliki lebih banyak decoder bawaan atau menggunakan kernel kompatibilitas (seperti mode IE), sedangkan Chrome dan Edge memberlakukan persyaratan yang lebih ketat pada format video, protokol, dan kebijakan keamanan.

Solusi: Ajukan Lisensi gratis Alibaba Cloud Player SDK dan integrasikan kode pemutar website untuk meningkatkan kompatibilitas.

Pemutar tidak merespons saat menarik aliran langsung dengan setDataSource, dan melaporkan "Connect didn't get any data from stream"

Panggil metode mulai pemutaran di callback prepared pemutar, untuk memastikan penarikan aliran dan mulai pemutaran hanya setelah pemutar siap.

Bagaimana cara menutup atau menyembunyikan antarmuka alat diagnostik yang muncul otomatis oleh Web Player?

Alat diagnostik tidak berjalan terus-menerus. Menutup tab atau kembali ke halaman pemutaran akan keluar dari alat tersebut. Jika Anda perlu menyembunyikannya selama operasi untuk menghindari pengungkapan informasi, tulis ulang kode dengan menggunakan fitur UI kesalahan khusus H5 Web Player untuk menentukan ulang gaya (misalnya, hanya menyisakan tombol refresh).

Video tidak dapat diputar di browser iOS tertentu, seperti UC Browser

Saran pemecahan masalah:

  1. Ganti lingkungan jaringan untuk mengesampingkan masalah jaringan.

  2. Tambahkan alat vconsole di halaman web untuk melihat log kesalahan spesifik dan menemukan penyebabnya.

  3. Kami merekomendasikan menggunakan Web Player Alibaba Cloud untuk dukungan kompatibilitas yang lebih baik.

Setelah mengonfigurasi hlsOption.abrEwmaDefaultEstimate, apakah saya memerlukan skrip tambahan?

abrEwmaDefaultEstimate adalah perkiraan awal pemutar mengenai lingkungan jaringan saat ini, yang digunakan untuk membandingkan dengan nilai BANDWIDTH di file m3u8 saat memilih bitrate. Selama pemutaran, pemutar memperbarui perkiraan bandwidth berdasarkan kecepatan unduh aktual dan menggantikan pengaturan awal. Tidak diperlukan skrip tambahan.

Setelah meningkatkan SDK Pemutar ApsaraVideo, beberapa video masih gagal diputar atau terus menampilkan Loading di iOS

Kami merekomendasikan untuk meningkatkan SDK Pemutar ke versi terbaru untuk menyelesaikan masalah kompatibilitas HLS native. Jika masalah tetap berlanjut setelah peningkatan, periksa konfigurasi backend dan konfigurasi sertifikat nama domain Anda.