全部产品
Search
文档中心

Object Storage Service:Menggunakan nama domain kustom (Browser.js SDK)

更新时间:Nov 30, 2025

Saat Anda mengunggah file (objek) ke bucket, OSS secara otomatis menghasilkan URL yang dapat digunakan untuk akses langsung. Untuk mengakses file melalui nama domain kustom, Anda harus menyambungkan nama domain kustom tersebut ke bucket dan menambahkan rekaman CNAME.

Persiapan

Anda harus telah menyambungkan nama domain kustom. Untuk informasi selengkapnya, lihat Akses OSS menggunakan nama domain kustom.

Catatan penggunaan

  • Saat menggunakan alat pengemasan seperti Webpack dan Browserify, instal OSS SDK untuk Browser.js dengan menjalankan perintah npm install ali-oss.

  • Jika Anda ingin mengakses bucket OSS dari browser tetapi bucket tersebut belum dikonfigurasi dengan aturan CORS, browser akan menolak permintaan tersebut. Oleh karena itu, Anda harus mengonfigurasi aturan CORS pada bucket untuk mengizinkan akses dari browser. Untuk informasi selengkapnya, lihat Instalasi.

  • Dalam kebanyakan kasus, OSS SDK untuk Browser.js digunakan di browser. Untuk mencegah pasangan AccessKey Anda terpapar, kami menyarankan agar Anda menggunakan kredensial akses temporary yang diperoleh dari Security Token Service (STS) untuk mengakses OSS.

    Kredensial akses temporary terdiri atas pasangan AccessKey dan token keamanan. Pasangan AccessKey mencakup ID AccessKey dan Rahasia AccessKey. Untuk informasi selengkapnya tentang cara memperoleh kredensial akses temporary, lihat Gunakan STS untuk otorisasi akses temporary.

Kode contoh

Kode berikut menunjukkan cara menginisialisasi SDK dengan nama domain kustom.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Document</title>
    <script src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.18.0.min.js"></script>
  </head>
  <body>
    <script>
      const client = new OSS({
        // Tentukan nama domain kustom. Contohnya, example.com.
        // Setel yourRegion ke wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel yourRegion ke oss-cn-hangzhou.
        region: 'yourRegion',
        endpoint: "example.com",
        authorizationV4: true,
        // Pasangan AccessKey temporary (ID AccessKey dan Rahasia AccessKey) yang diperoleh dari STS.
        accessKeyId: "yourAccessKeyId",
        accessKeySecret: "yourAccessKeySecret",
        // Token keamanan (SecurityToken) yang diperoleh dari STS.
        stsToken: 'yourSecurityToken',
        // Tentukan nama bucket. Contohnya, examplebucket.
        bucket: "examplebucket",
        cname: true,
      });    
          
    </script>
  </body>
</html>
Penting

Antarmuka list_buckets tidak tersedia saat Anda menggunakan nama domain kustom.