Tous les produits
Search
Centre de documentation

Object Storage Service:Use a custom domain name (Browser.js SDK)

Dernière mise à jour :Aug 18, 2026

Lorsque vous téléchargez un fichier (objet) dans un bucket, OSS génère automatiquement une URL de fichier pour un accès direct. Pour accéder aux fichiers via un nom de domaine personnalisé, associez ce nom de domaine au bucket et ajoutez un enregistrement CNAME.

Prérequis

Associez un nom de domaine personnalisé. Pour plus d'informations, consultez la rubrique Accéder à OSS via un nom de domaine personnalisé.

Remarques

  • Si vous utilisez des outils de regroupement tels que Webpack et Browserify, installez le SDK OSS pour Browser.js en exécutant la commande npm install ali-oss.

  • Si vous tentez d'accéder à un bucket OSS depuis un navigateur sans avoir configuré de règles CORS, le navigateur rejette la requête. Configurez donc des règles CORS pour le bucket afin d'y accéder depuis un navigateur. Pour plus d'informations, consultez la section Installation.

  • Le SDK OSS pour Browser.js s'utilise principalement dans les navigateurs. Pour éviter d'exposer votre paire de clés AccessKey, nous vous recommandons d'utiliser des identifiants d'accès temporaires obtenus via le Security Token Service (STS) pour accéder à OSS.

    Les identifiants d'accès temporaires se composent d'une paire de clés AccessKey et d'un jeton de sécurité. La paire de clés AccessKey comprend un AccessKey ID et un AccessKey Secret. Pour savoir comment obtenir des identifiants d'accès temporaires, consultez la section Utiliser STS pour une autorisation d'accès temporaire.

Exemple de code

Le code suivant montre comment initialiser le SDK avec un nom de domaine personnalisé.

<!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({
        // Specify a custom domain name. For example, example.com.
        // Set yourRegion to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set yourRegion to oss-cn-hangzhou.
        region: 'yourRegion',
        endpoint: "example.com",
        authorizationV4: true,
        // The temporary AccessKey pair (AccessKey ID and AccessKey secret) obtained from STS.
        accessKeyId: "yourAccessKeyId",
        accessKeySecret: "yourAccessKeySecret",
        // The security token (SecurityToken) obtained from STS.
        stsToken: 'yourSecurityToken',
        // Specify the bucket name. For example, examplebucket.
        bucket: "examplebucket",
        cname: true,
      });    
          
    </script>
  </body>
</html>
Important

L'interface list_buckets n'est pas disponible lorsque vous utilisez un nom de domaine personnalisé.