Todos os produtos
Search
Central de documentação

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

Última atualização: Sep 25, 2026

Depois de mapear um nome de domínio personalizado para um bucket específico ao adicionar um registro CNAME, você pode usar o domínio para acessar recursos do OSS. Este tópico descreve como usar um nome de domínio personalizado.

Mapear um nome de domínio personalizado

Por exemplo, suponha que o nome de domínio personalizado seja example.com e que você acessava todas as imagens por uma URL no formato http://img.example.com/x.jpg. Nesse caso, você pode mapear o domínio personalizado após migrar os recursos para o OSS. Isso permite continuar o acesso às imagens pelo endereço original. Para mais informações, consulte Access OSS using a custom domain name.

Usar um nome de domínio personalizado

Para usar um nome de domínio personalizado como ponto de extremidade no SDK, defina o parâmetro cname como true.

const OSS = require('ali-oss')

const client = new OSS({
  // Use a custom domain name as the Endpoint.
  endpoint: 'http://img.example.com', 
  // Obtain access credentials from environment variables. Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Set yourRegion to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set the Region to cn-hangzhou.
  region: 'yourRegion',
  cname: true
});
Importante

Um nome de domínio personalizado é mapeado para um bucket específico. Portanto, você não pode usar a operação list_buckets ao utilizar um domínio personalizado como ponto de extremidade.