Todos os produtos
Search
Central de documentação

Object Storage Service:0048-00000103

Última atualização: Sep 22, 2026

Descrição do problema

Ao acessar um arquivo por um navegador usando um nome de domínio padrão do Object Storage Service (OSS), o sistema pode baixar o arquivo diretamente em vez de pré-visualizá-lo.

Causa do problema

Para buckets criados após as 17:00 do dia 29 de setembro de 2019, ao acessar um objeto por meio de um nome de domínio padrão do OSS cujo ContentType seja um dos seguintes tipos, o OSS adiciona dois cabeçalhos à resposta:

image/jpeg
image/gif
image/tiff
image/png
image/webp
image/svg+xml
image/bmp
image/x-ms-bmp
image/x-cmu-raster
image/exr
image/x-icon
image/heic

O OSS adiciona dois cabeçalhos à resposta:

x-oss-force-download: true
Content-Disposition: attachment

Em um navegador padrão, o cabeçalho Content-Disposition: attachment aciona o baixe em vez da pré-visualização.

Exemplos do problema

Considere um bucket criado após as 17:00 do dia 29 de setembro de 2019. Esse bucket contém um objeto chamado apple.jpeg cujo ContentType é image/jpeg. Ao acessar o objeto por um navegador usando um nome de domínio padrão do OSS, a resposta do OSS inclui dois cabeçalhos. O cabeçalho Content-Disposition: attachment faz o navegador baixar o objeto em vez de pré-visualizá-lo.

GET /apple.jpeg HTTP/1.1
HTTP/1.1 200 OK
Content-Type: image/jpeg
Content-Disposition: attachment
x-oss-force-download: true

Solução

Para evitar que o OSS retorne cabeçalhos que forcem o baixe, acesse o objeto por meio de um nome de domínio personalizado. Para obter mais informações, consulte Map custom domain names.