Object Storage Service:Como configurar o comportamento de visualização no navegador para objetos do OSS?

curl -I "<your object URL>"

Cenário 1: Download forçado devido a uma política de segurança do OSS

Este cenário ocorre quando o cabeçalho de resposta contém x-oss-force-download: true.

• Causa: O OSS adiciona os cabeçalhos x-oss-force-download: true e Content-Disposition: attachment para impedir que certos tipos de arquivo (como HTML) sejam executados nos navegadores. Essa política se aplica ao acessar objetos por meio de um nome de domínio padrão do OSS ou de um endpoint de aceleração em buckets criados após uma data específica.

  Para mais informações sobre as políticas, consulte Apêndice: Referência rápida das regras de download forçado do OSS no final deste tópico.

• Solução: Usar um nome de domínio personalizado para acessar recursos do OSS

• Procedimento:

  1. Mapeie um domínio personalizado: Faça login no console do OSS. Na página Domain Names do bucket, mapeie seu nome de domínio personalizado que possua registro ICP.

  2. Configure um registro CNAME: No provedor de nomes de domínio, como o Alibaba Cloud DNS, adicione um registro CNAME que aponte seu nome de domínio personalizado para o endereço CNAME fornecido pelo OSS.

  3. Acesse o objeto com o novo domínio: Acesse o objeto pela URL do seu domínio personalizado. O objeto agora será visualizado diretamente.

Cenário 2: Download forçado devido às configurações de metadados do objeto

Esse cenário ocorre quando o cabeçalho de resposta contém Content-Disposition: attachment, mas não contém x-oss-force-download.

• Causa: O metadado Content-Disposition do objeto está definido como attachment, o que força o navegador a baixar o objeto em vez de exibi-lo. Se essa configuração não for removida após uso temporário, todas as solicitações subsequentes acionarão um download.

• Solução: Alterar o metadado Content-Disposition do objeto para inline

  • Modificação via console

    1. Faça login no console do OSS e acesse a página Objects na seção Object Management do bucket de destino.

    2. Localize o objeto de destino. Clique em ┇ na coluna Actions e selecione Set Object Metadata.

    3. Na caixa de diálogo exibida, localize o campo Content-Disposition e modifique seu valor para inline.

    4. Clique em OK para salve as configurações.

  • Modificação em lote usando ossutil

    # Set the Content-Disposition of a specific object to inline.
    ossutil set-meta oss://your-bucket/your-object.pdf Content-Disposition:inline

Cenário 3: Falha na visualização do objeto pelo navegador devido a Content-Type incorreto

Neste caso, o cabeçalho de resposta está normal, mas o navegador continua baixando o objeto.

• Causa: O Content-Type (tipo MIME) do objeto está ausente ou incorreto. Por exemplo, uma imagem JPG com Content-Type definido como application/octet-stream será baixada porque o navegador não consegue identificar o tipo de arquivo.

• Solução: Definir o Content-Type correto para o objeto

  • Modificação via console

    1. Faça login no console do OSS e acesse a página Objects na seção Object Management do bucket de destino.

    2. Localize o objeto de destino. Clique em ┇ na coluna Actions e selecione Set Object Metadata.

    3. Na caixa de diálogo exibida, localize o campo Content-Type e altere-o para o valor correto.

    4. Clique em OK para salve as configurações.

    Exemplos de Content-Type correto para tipos comuns de arquivo:

    • Imagens: image/jpeg, image/png, image/gif, image/webp

    • Vídeos: video/mp4

    • Documentos PDF: application/pdf

    • Arquivos HTML: text/html

    • Texto simples: text/plain

  • Modificação em lote usando ossutil

    # Set the Content-Type of a specific object to image/jpeg.
    ossutil set-meta oss://your-bucket/your-object.jpg Content-Type:image/jpeg

Alterações nos metadados não entram em vigor: Verifique o cache da CDN

Se você usa a CDN para acelerar o acesso ao OSS, alterações de metadados como Content-Type ou Content-Disposition podem não entrar em vigor imediatamente, pois os nós da CDN ainda servem a versão em cache.

Solução: Limpe o cache da CDN para a URL do arquivo modificado no console da CDN. Consulte Atualizar e pré-carregar recursos.

Como forçar o download de um objeto em vez de visualizá-lo?

Para sempre forçar o download quando usuários acessarem um arquivo, use um dos métodos a seguir.

• Método 1 (Recomendado): Configurar no OSS. Defina o metadado Content-Disposition do arquivo como attachment, conforme descrito no Cenário 2. Ideal para configurações permanentes por arquivo.

• Método 2: Configurar na CDN. Adicione Content-Disposition: attachment como cabeçalho de resposta de saída em Cache no console da CDN. Isso evita modificar o arquivo de origem e permite configuração em lote por caminho ou tipo de arquivo.

O navegador não suporta o formato de arquivo para visualização

Os navegadores não conseguem visualizar certos formatos profissionais, como .psd, .ai e .sketch. Esses arquivos são baixados independentemente da configuração do OSS e da CDN.

Solução: Instale uma extensão de navegador compatível com o formato ou use um serviço de visualização de documentos, como a Visualização Online do WebOffice.

Nomes de domínio padrão do OSS

Endpoints de aceleração