Perguntas frequentes sobre aceleração de CDN para OSS - CDN: Central de Documentação do Alibaba Cloud

Este tópico descreve problemas comuns e soluções ao usar o CDN para acelerar o acesso a recursos do OSS. Aborda cenários como verificação de aceleração, implantação de HTTPS, busca na origem para buckets privados, políticas de cache, processamento de imagens e snapshots de vídeo, além da configuração de proteção contra hotlink.

Verificando a aceleração de CDN para OSS

Etapa 1: Verificar o registro CNAME

Por exemplo, se você utiliza o Alibaba Cloud DNS, faça login no Console de Gerenciamento de DNS, selecione Authoritative DNS e clique em DNS Settings ao lado do nome de domínio.
Verifique se um registro CNAME (por exemplo, oss.example.com.w.kunlunaq.com) foi adicionado para o nome de domínio acelerado (por exemplo, oss.example.com) e se seu status está definido como Enabled.

Etapa 2: Validar o domínio com nslookup

Abra o Prompt de Comando (Windows) ou o Terminal (macOS/Linux).
Execute nslookup -type=CNAME <accelerated_domain_name>. Se o valor CNAME retornado corresponder ao fornecido no console do CDN para o nome de domínio acelerado, a aceleração do CDN estará ativa.

Caso ainda não tenha configurado um registro CNAME, consulte Configure a CNAME record.

Acelerando um bucket privado do OSS com CDN

Se a origem do seu nome de domínio acelerado for um bucket privado, ative Access Private OSS Buckets para esse domínio. Isso permite que o CDN acelere o acesso aos recursos no bucket privado.

Após ativar esse recurso, todos os recursos do bucket privado ficam acessíveis por meio do nome de domínio acelerado, e o método original de autenticação privada baseada em URL deixa de ser aplicado. Utilize os recursos de proteção contra hotlink e autenticação de URL do CDN para proteger seus recursos contra acessos não autorizados. Para mais informações, consulte Configure a Referer Whitelist or Blacklist e Configure URL authentication.

Implantando certificados HTTPS para aceleração de CDN

Ao usar o CDN para acelerar o acesso ao OSS, basta implantar um certificado HTTPS no CDN. Para mais informações, consulte Configure an HTTPS certificate.

Se o seu certificado for gerenciado pelo Alibaba Cloud Digital Certificate Management Service (anteriormente SSL Certificate Service), também é possível implantá-lo diretamente pelo console do Digital Certificate Management Service. Para mais detalhes, consulte Deploy an SSL certificate to Alibaba Cloud services.

Erro 403 Forbidden

Etapas de solução de problemas:

Verifique a mensagem de erro na página. Se aparecerem mensagens como You don't have permission to access the URL on this server ou You are forbidden to list buckets, acompanhadas de detalhes como denied by IP ACL = not in whitelist, use essas informações para identificar rapidamente a política de bloqueio.
Se a única mensagem for You don't have permission to access the URL on this server sem outros detalhes, verifique as configurações de autenticação de URL e autenticação remota do CDN.

Se as imagens de um nome de domínio falharem ao carregar com um erro de permissão negada:

Verifique a opção de busca na origem para bucket privado: Faça login no console do CDN, acesse a página Domain Management do nome de domínio alvo e confirme se a busca na origem para bucket privado do Alibaba Cloud OSS está ativada. Caso contrário, o CDN não terá permissão para acessar recursos privados do OSS, resultando em erro 403.
Revise a configuração da lista de permissões/bloqueios de Referer: Acesse as configurações do domínio e verifique se o Referer da solicitação consta na lista de permissões. Se a solicitação estiver sendo bloqueada por uma regra de Referer, adicione o Referer alvo à lista de permissões.

Se você configurou hospedagem de site estático no OSS e o arquivo de índice (por exemplo, index.html) ou o próprio bucket for privado, ative o recurso Access Private OSS Buckets. Em seguida, configure uma regra de reescrita de URL no CDN para redirecionar as URLs de acesso ao arquivo de índice configurado (por exemplo, index.html). O nó de borda do CDN emitirá um redirecionamento 302, solicitando que o cliente requisite o conteúdo do index.html. Esse processo habilita a hospedagem de site estático. Para configurações detalhadas, consulte Rewrite an access URL. Para configurar a regra, defina Path to Rewrite como ^/$, Target Path como /index.html e Action como Redirect.

Acesso lento após ativar o CDN

Ao usar um nome de domínio acelerado para acessar um recurso pela primeira vez, a solicitação é enviada a um nó de borda do CDN. Como o recurso ainda não está em cache nesse nó, ele realiza uma busca na origem no OSS, armazena o recurso em cache e então o retorna ao cliente. Solicitações subsequentes para o mesmo recurso são atendidas diretamente pelo nó de borda do CDN. Portanto, o primeiro acesso pode ser mais lento do que seria sem a aceleração do CDN.

Utilize o recurso de pré-aquecimento do CDN para armazenar recursos do OSS nos nós de borda antecipadamente. Isso garante que a primeira solicitação do cliente seja atendida diretamente por um nó de borda do CDN, sem necessidade de busca na origem. Para instruções, consulte Refresh and preheat resources.

Política de cache para reduzir buscas na origem

Sem a configuração de um tempo de expiração de cache, ou se o tempo definido for muito curto, o CDN poderá realizar buscas frequentes na origem. Isso aumenta o tráfego de origem para o OSS e os custos associados, além de reduzir a velocidade de acesso. Configure os tempos de expiração de cache conforme suas necessidades de negócio:

Para arquivos estáticos raramente atualizados, como imagens e instaladores de aplicativos, defina o tempo de vida (TTL) para um mês ou mais.
No caso de arquivos estáticos atualizados frequentemente, como arquivos JS e CSS, ajuste o TTL de acordo com sua frequência de atualização.

Para mais informações, consulte Configure cache expiration rules.

Garantindo que os usuários acessem os recursos mais recentes

Após modificar um arquivo no OSS, para garantir que os nós do CDN atualizem automaticamente o cache e os clientes recebam o conteúdo atualizado, ative o recurso de atualização automática de cache do CDN no console do OSS. Para instruções específicas, consulte a seção "Ativar atualização automática de cache do CDN" em Configure automatic CDN cache refresh.

Esse recurso não garante que uma tarefa de atualização seja enviada com sucesso ou em tempo hábil. Se você precisar de atualizações em tempo real ou quiser acompanhar o status da atualização, utilize o recurso de atualização do CDN. Para mais informações, consulte Refresh and preheat resources.

Impossibilidade de ativar a atualização automática do CDN no console do OSS

Não é possível ativar a atualização automática de cache do CDN e aparece a mensagem: "Please bind this domain name in OSS first".

Solução: Na coluna Map Custom Domain Name, clique em Unbound para o domínio correspondente e siga as instruções na tela para vincular o domínio. Se você já vinculou o domínio ao CDN e seu DNS está resolvido para o CNAME do CDN, não modifique o registro DNS após vincular o domínio do OSS. Caso contrário, o service de aceleração do CDN não funcionará.

Parâmetros de processamento de imagem do OSS ineficazes

Ao usar o CDN para acelerar o OSS, as solicitações chegam primeiro a um nó de borda do CDN. Se o recurso 'Ignore Parameters' estiver ativado no CDN, o nó removerá quaisquer parâmetros após o ? na URL da solicitação. Se o recurso já estiver em cache, o CDN não realizará uma busca na origem e o processamento de imagem do OSS não será aplicado. Para mais informações, consulte Ignore parameters.

Desative o recurso 'Ignore Parameters'. Quando uma solicitação inclui parâmetros, ela aciona uma busca na origem no OSS, e o processamento de imagem funciona conforme esperado.

Após desativar o 'Ignore Parameters', a taxa de acerto de cache pode diminuir, pois cada solicitação com parâmetros acionará uma busca na origem. Alternativamente, utilize o recurso image processing fornecido pelo CDN para executar o processamento de imagem nos próprios nós de borda.

Configuração especial para snapshots de vídeo

Ao usar o recurso de snapshot de vídeo do OSS (com parâmetros como x-oss-process=video/snapshot,t_1000), se o 'Ignore Parameters' estiver ativado para o domínio do CDN, a URL original do vídeo e a URL com parâmetros de snapshot serão armazenadas em cache como o mesmo recurso. Isso pode fazer com que a imagem do snapshot seja retornada ao acessar o vídeo, ou que o vídeo original seja retornado ao solicitar o snapshot.

Solução: No console do CDN, use o recurso 'Ignore URL Parameters' e mude para o modo que retém parâmetros especificados. Adicione x-oss-process à lista de parâmetros retidos. Isso permite que URLs com parâmetros de snapshot sejam armazenadas em cache separadamente, evitando conflitos com o cache do vídeo original. Após alterar a configuração, atualize o diretório que contém os arquivos de vídeo.

Excluindo arquivos ou diretórios do cache do CDN

Ao acelerar o OSS com CDN, pode ser necessário ignorar o cache do CDN para certos arquivos ou diretórios, garantindo que cada solicitação busque a versão mais recente diretamente no OSS. Existem duas formas de fazer isso, dependendo das suas práticas de gerenciamento:

Configuração no lado do CDN (Recomendado): Gerencie regras de cache no console do CDN. Este método é ideal para cenários onde uma equipe de operações realiza o gerenciamento centralizado. Acesse Cache e defina a duração do cache como 0. Depois que a regra entrar em vigor, quando o CDN receber solicitações para esses caminhos, ele realizará uma busca na origem no OSS e não armazenará a resposta em cache.
Configuração no lado do OSS: Defina cabeçalhos de resposta para arquivos do OSS. Indicado para cenários onde o armazenamento e o gerenciamento de conteúdo são separados. No console do CDN, certifique-se de que a política de cache priorize os cabeçalhos da origem; caso contrário, regras personalizadas do CDN podem substituí-los. Em seguida, no console do OSS, navegue até File Management > Files, selecione o arquivo alvo e defina o valor de Cache-Control conforme necessário:

Valor de Cache-control	Caso de uso	Descrição
`no-cache`	Recomendado: Para conteúdo que exige a busca da versão mais recente a cada acesso, como arquivos HTML, arquivos de configuração ou metadados de versão.	O CDN não armazena o conteúdo em cache. O navegador revalida com a origem usando um ETag.
`no-store`	Cenários de alta sensibilidade: Para conteúdo que não deve ser armazenado em nenhum momento, como dados de privacidade do usuário, tokens ou informações financeiras.	Nem o CDN nem o navegador armazenam o conteúdo em cache. Uma solicitação completa é feita a cada vez.
`private`	Conteúdo personalizado: Para páginas que contêm conteúdo específico do usuário e não podem ser compartilhadas em um cache multiusuário.	O CDN não armazena o conteúdo em cache, mas o navegador ainda pode armazená-lo.

Ambas as soluções aplicam-se apenas a novas solicitações. Se o arquivo já estiver em cache, essas novas configurações não limparão automaticamente o cache nos nós de borda, então os usuários ainda poderão ver a versão antiga. É necessário também atualizar o cache do CDN. Insira a URL ou diretório alvo e atualize-o. As solicitações subsequentes seguirão as novas regras e buscarão o conteúdo mais recente no OSS.

Baixa taxa de acerto de cache e buscas frequentes na origem

Solução de problemas

Execute curl -I no mesmo recurso várias vezes e verifique os cabeçalhos de resposta Age e X-Cache. Um cabeçalho Age: 0 ou X-Cache: MISS indica uma busca na origem.

Soluções

O TTL da regra de cache está definido como muito curto ou como "Do not cache". Ajuste as regras de cache para aumentar o tempo de expiração.
O recurso 'Ignore Parameters' está ativado, mas a URL contém parâmetros necessários para controle de versão ou processamento de imagem, como ?v=1.1 ou x-oss-process. Isso faz com que o CDN trate URLs com parâmetros diferentes como o mesmo recurso, levando a erros de conteúdo ou falhas de funcionalidade. Nesse caso, desative o recurso 'Ignore Parameters'.
O cabeçalho de resposta da origem, como Cache-Control: no-cache, instrui o CDN a não armazenar o conteúdo em cache. Nessa situação, ajuste a política de cache da origem ou configure o CDN para ignorar a política da origem.

Baixa taxa de acerto de cache e buscas frequentes na origem

Solução de problemas: Execute curl -I no mesmo recurso várias vezes e verifique os cabeçalhos de resposta Age e X-Cache. Um cabeçalho Age: 0 ou X-Cache: MISS indica uma busca na origem.

Soluções:

O TTL da regra de cache está definido como muito curto ou como "Do not cache". Ajuste as regras de cache para aumentar o tempo de expiração.
O recurso 'Ignore Parameters' está ativado, mas a URL contém parâmetros necessários para controle de versão ou processamento de imagem, como ?v=1.1 ou x-oss-process. Isso faz com que o CDN trate URLs com parâmetros diferentes como o mesmo recurso, levando a erros de conteúdo ou falhas de funcionalidade. Nesse caso, desative o recurso 'Ignore Parameters'.
O cabeçalho de resposta da origem, como Cache-Control: no-cache, instrui o CDN a não armazenar o conteúdo em cache. Nessa situação, ajuste a política de cache da origem ou defina um tempo de expiração de cache no CDN para substituir a política da origem.

Vídeo não reproduz porque o link é identificado como imagem

Causa: O navegador determina o tipo de recurso pelo cabeçalho de resposta Content-Type. Se o Content-Type de um arquivo de vídeo no OSS estiver incorretamente definido como um tipo de imagem (como image/jpeg), o CDN repassa esse cabeçalho, fazendo com que o navegador processe o vídeo como uma imagem. Esse problema não pode ser resolvido simplesmente adicionando parâmetros à URL.

Solução (escolha uma):

Recomendado: Modificar o cabeçalho de resposta no console do CDN: Faça login no console do CDN, acesse as configurações do domínio alvo e adicione uma regra para forçar o Content-Type para video/mp4. Aplique essa regra com base na extensão do arquivo.
Correção na origem: Faça login no console do OSS, localize o arquivo de vídeo correspondente e altere manualmente seu Content-Type para video/mp4 nos detalhes do arquivo.

Suporte do OSSBrowser a domínios acelerados por CDN

A ferramenta cliente OSSBrowser não suporta login com um nome de domínio acelerado por CDN. Ela aceita apenas endpoints nativos do OSS.