Todos os produtos
Search
Central de documentação

Object Storage Service:0048-00000102

Última atualização: Jul 03, 2026

Descrição do problema

Ao acessar um objeto no navegador usando um nome de domínio padrão do Object Storage Service (OSS), o arquivo pode ser baixado diretamente em vez de visualizado.

Causas

Para buckets criados após as 17:00 de 24 de setembro de 2019, ao usar um nome de domínio do OSS para acessar um arquivo cujo Content-Type corresponde a um dos tipos abaixo,

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 os dois cabeçalhos a seguir à resposta:

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

Em navegadores padrão, o cabeçalho Content-Disposition: attachment instrui o navegador a baixar o objeto em vez de visualizá-lo.

Exemplos de problemas

Considere um bucket criado após as 17:00 de 24 de setembro de 2019 que contenha um objeto chamado apple.jpeg com Content-Type definido como image/jpeg. Ao acessar esse objeto pelo navegador usando um nome de domínio padrão do OSS, o serviço adiciona dois cabeçalhos à resposta. O cabeçalho Content-Disposition: attachment faz com que o navegador baixe o arquivo em vez de 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 forçam o baixe, acesse o objeto usando um nome de domínio personalizado. Para mais informações, consulte Mapear nomes de domínio personalizados.