Object Storage Service：Bagaimana cara mengonfigurasi perilaku pratinjau untuk objek di OSS?

Skenario 1: Unduhan paksa akibat kebijakan keamanan OSS

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

• Penyebab: Untuk mencegah risiko keamanan yang dapat terjadi saat file seperti HTML dieksekusi langsung di browser, OSS memaksa unduhan. Perilaku ini berlaku ketika Anda menggunakan OSS default domain name atau acceleration endpoint untuk mengakses bucket yang dibuat setelah tanggal tertentu. Untuk wilayah dan jenis file tertentu, OSS menambahkan header respons x-oss-force-download: true dan Content-Disposition: attachment.

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

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

• Prosedur:

  1. Menyambungkan nama domain kustom ke bucket: Masuk ke Konsol OSS. Di halaman Domain Names untuk bucket target, sambungkan nama domain kustom Anda yang telah memiliki Pendaftaran ICP.

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

  3. Akses file dengan nama domain baru: Setelah konfigurasi selesai, gunakan URL nama domain kustom Anda untuk mengakses file tersebut sehingga file dapat ditampilkan dalam pratinjau online.

Skenario 2: Unduhan paksa akibat pengaturan metadata file

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

• Penyebab: Bidang Content-Disposition dalam metadata file secara eksplisit diatur ke attachment. Pengaturan ini memberi tahu browser untuk mengunduh file sebagai lampiran alih-alih menampilkannya inline. Pengaturan ini sering digunakan untuk tautan unduhan sementara. Jika tidak dihapus, semua upaya selanjutnya untuk mengakses file akan memicu unduhan.

• Solusi: Ubah metadata Content-Disposition file menjadi inline

  • Ubah di konsol

    1. Masuk ke Konsol OSS. Buka halaman Object Management > Objects dari 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

    # Mengatur Content-Disposition file tertentu menjadi inline
    ossutil set-meta oss://your-bucket/your-object.pdf Content-Disposition:inline

Skenario 3: Browser tidak dapat menampilkan pratinjau file karena Content-Type yang salah

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

• Penyebab: Metadata Content-Type (juga dikenal sebagai tipe Multipurpose Internet Mail Extensions (MIME)) file tersebut salah atau tidak ada. Misalnya, jika Content-Type file citra JPG salah diatur menjadi application/octet-stream, browser akan mengunduh file tersebut karena tidak dapat mengenali jenis file tersebut.

• Solusi: Atur Content-Type yang benar untuk file tersebut

  • Ubah di konsol

    1. Masuk ke Konsol OSS. Buka halaman Object Management > Objects dari 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:

    • Citra: 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

    # Mengatur Content-Type file tertentu menjadi image/jpeg
    ossutil set-meta oss://your-bucket/your-object.jpg Content-Type:image/jpeg

Perubahan metadata tidak berlaku: Periksa cache CDN

Jika Anda menggunakan Alibaba Cloud Content Delivery Network (CDN) untuk mempercepat akses ke OSS, perubahan metadata file—seperti Content-Type atau Content-Disposition—mungkin tidak langsung berlaku karena titik keberadaan (PoP) CDN masih menyajikan versi cache dengan konfigurasi lama.

Solusi: Masuk ke konsol CDN dan purge cache untuk URL file yang telah dimodifikasi. Untuk informasi lebih lanjut, lihat Refresh dan prefetch sumber daya.

Cara memaksa file diunduh alih-alih ditampilkan dalam pratinjau

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

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

• Metode 2: Konfigurasikan 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 file sumber di OSS dan berguna untuk konfigurasi fleksibel secara batch berdasarkan path atau jenis file tertentu.

Browser tidak mendukung pratinjau format file tersebut

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

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

Nama domain default OSS

Titik akhir percepatan