Object Storage Service：Cara mengonfigurasi perilaku pratinjau browser untuk objek OSS?

Skenario 1: Pengunduhan paksa akibat kebijakan keamanan OSS

Skenario ini terjadi ketika header respons berisi x-oss-force-download: true.

• Penyebab: Untuk mencegah risiko keamanan yang muncul ketika jenis file tertentu, seperti HTML, dieksekusi langsung di browser, OSS menerapkan kebijakan keamanan. Saat Anda menggunakan OSS default domain name atau acceleration endpoint untuk mengakses objek di bucket yang dibuat setelah waktu tertentu, OSS menambahkan header x-oss-force-download: true dan Content-Disposition: attachment ke respons. Hal ini memaksa browser untuk mengunduh objek.

  Untuk informasi lebih lanjut tentang kebijakan tersebut, lihat Lampiran: Referensi cepat aturan pengunduhan paksa OSS di akhir topik ini.

• Solusi: Gunakan nama domain kustom untuk mengakses sumber daya OSS.

• Prosedur:

  1. Petakan nama domain kustom ke bucket: Masuk ke Konsol OSS. Di halaman Domain Names bucket target, petakan nama domain kustom Anda yang telah memiliki Pendaftaran ICP ke bucket tersebut.

  2. Konfigurasi rekaman CNAME: Buka penyedia layanan nama domain Anda, seperti Alibaba Cloud DNS. Tambahkan rekaman CNAME yang mengarahkan nama domain kustom Anda ke alamat CNAME yang disediakan oleh OSS.

  3. Akses objek menggunakan nama domain baru: Setelah konfigurasi selesai, gunakan URL nama domain kustom Anda untuk mengakses objek. Objek tersebut kemudian dapat dipratinjau secara online.

Skenario 2: Pengunduhan paksa akibat pengaturan metadata objek

Skenario ini terjadi ketika header respons berisi Content-Disposition: attachment tetapi tidak berisi x-oss-force-download.

• Penyebab: Bidang Content-Disposition dalam metadata objek secara eksplisit diatur ke attachment. Pengaturan ini menginstruksikan browser untuk mengunduh objek sebagai lampiran alih-alih menampilkannya secara inline. Pengaturan ini sering digunakan untuk menghasilkan tautan unduh sementara. Jika pengaturan ini tidak dihapus, semua permintaan selanjutnya untuk objek tersebut akan memicu pengunduhan.

• Solusi: Ubah metadata Content-Disposition objek menjadi inline.

  • Ubah melalui konsol

    1. Masuk ke Konsol OSS. Di panel navigasi sebelah kiri, buka halaman Files > Objects bucket target.

    2. Temukan objek target. Di kolom Actions, pilih ... > Set Object Metadata.

    3. Pada kotak dialog yang muncul, temukan bidang Content-Disposition dan ubah nilainya menjadi inline.

    4. Klik OK untuk menyimpan pengaturan.

  • Ubah secara batch menggunakan ossutil

    # Atur Content-Disposition objek yang ditentukan menjadi inline.
    ossutil set-props oss://your-bucket/your-object.pdf --content-disposition inline --metadata-directive update

Skenario 3: Browser gagal mempratinjau objek karena Content-Type yang salah

Skenario ini terjadi ketika header respons normal, tetapi browser tetap mengunduh objek.

• Penyebab: Metadata Content-Type (juga dikenal sebagai Multipurpose Internet Mail Extensions (MIME) type) objek tidak tersedia atau salah. Misalnya, jika Content-Type gambar JPG salah diatur ke application/octet-stream, browser akan mengunduh objek karena tidak dapat mengenali jenis file sebenarnya.

• Solusi: Tetapkan Content-Type yang benar untuk objek tersebut.

  • Ubah melalui konsol

    1. Masuk ke Konsol OSS. Di panel navigasi sebelah kiri, buka halaman Files > Objects bucket target.

    2. Temukan objek target. Di kolom Actions, pilih ... > Set Object Metadata.

    3. Pada kotak dialog yang muncul, temukan bidang Content-Type dan ubah nilainya menjadi nilai yang benar.

    4. Klik OK untuk menyimpan pengaturan.

    Contoh Content-Type yang benar untuk jenis file umum:

    • Gambar: image/jpeg, image/png, image/gif, image/webp

    • Video: video/mp4

    • Dokumen PDF: application/pdf

    • File HTML: text/html

    • Teks biasa: text/plain

  • Ubah secara batch menggunakan ossutil

    # Atur Content-Type objek yang ditentukan menjadi image/jpeg.
    ossutil set-props oss://your-bucket/your-object.jpg --content-type image/jpeg --metadata-directive update

Perubahan metadata tidak berlaku: Periksa cache CDN

Jika Anda menggunakan Alibaba Cloud Content Delivery Network (CDN) untuk mempercepat akses ke OSS, perubahan pada metadata objek, seperti Content-Type atau Content-Disposition, mungkin tidak langsung berlaku. Hal ini karena titik kehadiran (POPs) CDN mungkin masih menyajikan versi cache dengan konfigurasi lama.

Solusi: Masuk ke konsol CDN dan purge cache untuk URL objek yang telah dimodifikasi. Untuk informasi lebih lanjut, lihat Refresh and prefetch resources.

Cara memaksa objek diunduh alih-alih dipratinjau

Jika Anda ingin selalu memaksa pengunduhan saat pengguna mengakses objek, Anda dapat menggunakan salah satu metode berikut.

• Metode 1 (Direkomendasikan): Konfigurasi di OSS. Seperti dijelaskan dalam Skenario 2, atur metadata Content-Disposition objek menjadi attachment. Metode ini ideal untuk menerapkan pengaturan permanen pada satu objek.

• Metode 2: Konfigurasi di CDN. Jika Anda menggunakan CDN, Anda dapat menambahkan header Content-Disposition: attachment di konsol CDN. Anda dapat mengonfigurasi ini sebagai header respons outbound di Cache Settings. Metode ini tidak memerlukan perubahan pada objek sumber di OSS dan berguna untuk konfigurasi fleksibel secara batch berdasarkan path atau jenis file tertentu.

Browser tidak mendukung format file untuk pratinjau

Browser utama tidak mendukung pratinjau online untuk beberapa format file profesional, seperti .psd, .ai, atau .sketch. Dalam kasus ini, browser akan mengunduh file meskipun konfigurasi OSS dan CDN sudah benar.

Solusi: Anda dapat menginstal plugin browser yang mendukung pratinjau format file tersebut. Anda juga dapat menggunakan layanan pratinjau dokumen profesional, seperti WebOffice Online Preview.

OSS default domain names

Acceleration endpoint