ApsaraVideo VOD:Perguntas frequentes sobre CDN para ApsaraVideo VOD

Categorias de perguntas

Compra e faturamento

• Como visualizo meu novo plano de transferência de dados do ApsaraVideo VOD?

• Por que os dados de tráfego diferem entre monitoramento, relatórios de uso e logs?

• Se meu servidor de origem estiver fora da China continental, como sou cobrado pelo uso de POPs do CDN na China continental para aceleração?

• Após adquirir um pacote do ApsaraVideo VOD, posso usar os planos de recursos incluídos para CDN ou OSS?

• Adquiri um plano de transferência de dados do ApsaraVideo VOD. Por que ainda estou sendo cobrado por tráfego?

• Sou cobrado por tráfego e solicitações resultantes de ataques ou atividades maliciosas?

• Sou cobrado se um POP do CDN retornar um código de status 4xx?

Problemas de acesso e exceções

• Recebo um erro 404 ao usar um nome de domínio configurado para acessar recursos do ApsaraVideo VOD

• Como determinar se um problema de acesso ao CDN é causado por um POP do CDN ou pelo servidor de origem

• Como solucionar travamentos na reprodução e erros 4008/4009?

• O Global Accelerator não melhora a velocidade de acesso para usuários fora da China continental

• No ApsaraVideo VOD, as pré-visualizações de vídeo MP4 não funcionam para um nome de domínio acelerado, mesmo com o recurso de pré-visualização ativado

• Preciso permitir acesso à rede para reproduzir vídeos do ApsaraVideo VOD a partir de uma rede interna?

Adicionar e resolver um nome de domínio

• O ApsaraVideo VOD suporta nomes de domínio curinga para aceleração?

• O que fazer sobre o erro "The root name of your domain is reserved by other account"?

• O que fazer sobre o erro "This domain name already exists"?

• Como testo se um registro CNAME está configurado corretamente?

• Um nome de domínio acelerado recém-adicionado falha na revisão

• Um nome de domínio acelerado do ApsaraVideo VOD pode ser igual ao domínio principal do site?

Cache

• Como melhorar uma baixa taxa de acerto de cache

• Por que o acesso aos recursos está lento após configurar um nome de domínio acelerado?

Busca na origem e servidor de origem

• Um erro de cross-origin "The 'Access-Control-Allow-Origin' header has a value 'xxx' that is not equal to the supplied origin" ocorre ao solicitar recursos acelerados

HTTPS

• Um nome de domínio acelerado do ApsaraVideo VOD pode usar o certificado SSL do domínio principal?

• O que faço se a configuração do certificado HTTPS falhar porque inseri um arquivo CSR?

• O que faço se a implantação do certificado SSL reportar InsufficientQuota?

• Solicitações HTTP ainda podem acessar recursos após a ativação do HTTPS?

• Por que a URL de callback de transcodificação não é HTTPS após vincular um nome de domínio no ApsaraVideo VOD?

Atualização e pré-busca

• Como atualizo arquivos com o mesmo nome após configurar um nome de domínio acelerado?

• Por que os recursos não são atualizados após uma atualização ou pré-busca?

Segurança

• Como bloqueio o acesso de endereços IP maliciosos?

• Um endereço IP na lista de bloqueios de IP ainda consegue solicitar acesso

• Por que a proteção contra hotlinking causa um erro 403 ao acessar recursos acelerados?

• Posso configurar limitação de tráfego e proteção contra hotlinking sem um nome de domínio acelerado?

Visualizar seu novo plano de transferência de dados

Discrepâncias nos dados de tráfego

Problema

Os dados de tráfego de um nome de domínio acelerado obtidos pelos recursos de monitoramento de dados ou uso de recursos no console do ApsaraVideo VOD ou via API diferem dos dados calculados a partir dos logs. Geralmente, os dados provenientes dos logs são menores.

Causa

O tráfego calculado a partir dos logs baseia-se no campo response_size e mede apenas o tráfego da camada de aplicação. O tráfego real da camada de rede costuma ser de 7% a 15% superior ao da camada de aplicação. Essa diferença deve-se principalmente a dois tipos de sobrecarga de rede:

• Cabeçalhos de pacotes TCP/IP: Antes da transmissão pela rede, os dados da camada de aplicação são encapsulados em pacotes TCP na camada de transporte e, em seguida, em pacotes IP na camada de rede. Um pacote IP tem tamanho máximo de 1.500 bytes, incluindo um cabeçalho TCP de 20 bytes e um cabeçalho IP de 20 bytes. Esses cabeçalhos também consomem tráfego de rede, mas não são registrados nos logs da camada de aplicação. Essa sobrecarga de cabeçalho representa pelo menos 2,74% do tráfego registrado nos logs (40 bytes de cabeçalho para cada 1.460 bytes de dados de aplicação). Quanto menores os dados da aplicação, maior a porcentagem de sobrecarga dos cabeçalhos. Normalmente, essa sobrecarga fica em torno de 3%.

• Retransmissão TCP: Em ambientes de rede complexos, pode ocorrer perda de pacotes devido a congestionamento ou falhas em dispositivos. Geralmente, de 3% a 10% dos pacotes de dados são descartados e precisam ser retransmitidos. O kernel do sistema operacional gerencia essas retransmissões na camada da pilha de protocolos, e elas não aparecem nos logs da camada de aplicação. Esse processo consome recursos adicionais de rede.

Devido a essa sobrecarga, é prática comum no mercado adicionar uma margem de 7% a 15% ao tráfego da camada de aplicação para calcular o tráfego faturável final. O CDN para ApsaraVideo VOD aplica uma sobrecarga média de 10%. Portanto, o tráfego faturável real — que também corresponde ao tráfego exibido nas consultas de monitoramento — equivale a 1,1 vez o tráfego registrado nos logs. Esse fator é conhecido como coeficiente TCP de 1,1.

Faturamento de aceleração na China continental

Se o seu servidor de origem estiver em Hong Kong (China), Macau (China), Taiwan (China) ou em outras regiões fora da China continental, e você utilizar pontos de presença (POPs) do CDN na China continental para aceleração, a cobrança seguirá as tarifas padrão de aceleração de CDN na China continental.

O faturamento do CDN baseia-se no tráfego de saída dos POPs do CDN. Assim, a cobrança ocorre conforme as taxas da China continental. No entanto, essa configuração pode impactar o desempenho, pois pode haver latência quando os POPs na China continental realizam buscas na origem em servidores localizados fora dessa região. Caso tanto o servidor de origem quanto os usuários estejam fora da China continental, recomendamos ativar o Global Accelerator.

Uso de planos de recursos entre serviços

Não. O ApsaraVideo VOD é um serviço independente. Ao utilizá-lo, você paga pelos recursos de armazenamento, transcodificação, tráfego ou largura de banda consumidos. Um pacote do ApsaraVideo VOD contém planos de recursos, como planos de transferência de dados, planos de armazenamento e planos de transcodificação. Esses planos servem exclusivamente para pagar pelos recursos consumidos dentro do próprio ApsaraVideo VOD.

Cobranças inesperadas de tráfego

Um plano de transferência de dados do ApsaraVideo VOD entra em vigor somente se você tiver configurado um nome de domínio acelerado e selecionado o método de medição pay-by-data-transfer para o serviço de aceleração. Após entrar em vigor, o plano compensa apenas a transferência de dados acelerada e não cobre o tráfego de saída do OSS. O uso excedente é faturado no modelo pagamento conforme o uso. Se você incorrer em cobranças de transferência de dados, verifique as seguintes situações:

• Um nome de domínio acelerado está configurado

  • Se a configuração do nome de domínio acelerado estiver incompleta, os planos de recursos não poderão compensar as taxas. Por exemplo, você pode ter adicionado o nome de domínio, mas não configurado um registro CNAME. Certifique-se de que o nome de domínio esteja no estado Running. Início rápido do ApsaraVideo VOD.

  • Se você usar o endereço direto do OSS em vez do nome de domínio acelerado para acessar recursos, haverá cobrança de tráfego de saída de armazenamento. Faturamento de tráfego de saída de armazenamento.

  • Verifique se o uso excede a capacidade do plano. Nesse caso, renove o plano de recursos. Renovar um plano de recursos.

• Nenhum nome de domínio acelerado está configurado

  Se nenhum nome de domínio acelerado estiver configurado no ApsaraVideo VOD, o serviço retornará, por padrão, uma URL de origem do OSS. Reproduzir ou baixar recursos do ApsaraVideo VOD usando esse tipo de URL gera taxas de tráfego de saída de armazenamento.

Faturamento de tráfego de ataque

Há cobrança pela largura de banda consumida por ataques ou tráfego inflado maliciosamente. Essas cobranças ocorrem porque os recursos de largura de banda do ApsaraVideo VOD são consumidos.

Para lidar com tráfego inflado maliciosamente ou ataques, melhore a segurança dos vídeos ou configure alertas de pico de largura de banda.

• Ative recursos de segurança de vídeo

  Se o seu negócio corre risco de ataques, recomendamos fortalecer a segurança dos vídeos para dificultar essas ações. O ApsaraVideo VOD oferece um mecanismo abrangente de segurança de conteúdo para proteger seus vídeos contra hotlinking, downloads ilegais e distribuição não autorizada. Esse mecanismo ajuda a atender aos requisitos de segurança em diferentes cenários de negócios. Para mais informações, consulte Segurança de mídia.

• Ative o monitoramento de pico de largura de banda

  Defina um limiar de largura de banda para o seu nome de domínio. Ao atingir esse limiar, você receberá uma notificação por SMS. Para mais informações, consulte Monitoramento de pico de largura de banda.

Faturamento de códigos de status 4xx

Sim. Para proteger seus nomes de domínio acelerados contra ataques e tráfego fraudulento, configure recursos de controle de acesso, como proteção contra hotlinking, assinatura de URL, autenticação remota, listas de bloqueios e permissões de IP e listas de bloqueios e permissões de user-agent (UA). Quando uma solicitação maliciosa corresponde a uma regra de controle de acesso, o POP do CDN retorna um código de status 4xx para bloquear o acesso aos seus recursos. Nesse caso, o POP do CDN consome recursos de CPU para processar a solicitação maliciosa e utiliza recursos de tráfego e largura de banda para retornar o código de status 4xx. Portanto, você ainda será cobrado pelo tráfego e pela largura de banda consumidos. Para mais informações sobre o faturamento de tráfego no ApsaraVideo VOD, consulte Faturamento de serviços básicos.

Erros 404 ao acessar recursos

Quando um servidor web retorna um código de status HTTP 404, isso indica que o recurso solicitado não existe no servidor. Isso pode acontecer se as regras de geração de URL tiverem sido alteradas, se um arquivo web tiver sido renomeado ou movido, ou se um link importado contiver um erro de ortografia.

Isolar problemas de CDN ou do servidor de origem

1. Acesse o Alikunlun User Diagnostic Tool e confirme se sua rede local está funcionando corretamente.

2. Adicione uma entrada mapeando o endereço IP do servidor de origem para o respectivo nome de domínio no arquivo hosts local para testar o acesso diretamente. Se ocorrer um erro ao acessar o servidor de origem, o problema estará nele. Entre em contato com o administrador do site para corrigi-lo.

   # Copyright (c) 1993-2009 Microsoft Corp.
   #
   # This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
   #
   # This file contains the mappings of IP addresses to host names. Each
   # entry should be kept on an individual line. The IP address should
   # be placed in the first column followed by the corresponding host name.
   # The IP address and the host name should be separated by at least one
   # space.
   #
   # Additionally, comments (such as these) may be inserted on individual
   # lines or following the machine name denoted by a '#' symbol.
   #
   # For example:
   #
   #      102.54.94.97     rhino.acme.com          # source server
   #      38.25.63.10      x.acme.com              # x client host
   # localhost name resolution is handled within DNS itself.
   #    127.0.0.1       localhost
   #    ::1             localhost
   10.10.10.10 www.example.com

3. Comente a entrada adicionada ao arquivo hosts na etapa anterior. Em seguida, execute o comando ping para testar o nome de domínio acelerado. Se o comando retornar uma resposta bem-sucedida, o POP do CDN está funcionando corretamente.

   C:\Users\admin>ping www.example.com
   Pinging www.example.com [101.x.x.x] with 32 bytes of data:
   Reply from 101.x.x.x: bytes=32 time=3ms TTL=54
   Reply from 101.x.x.x: bytes=32 time=3ms TTL=54
   Reply from 101.x.x.x: bytes=32 time=3ms TTL=54
   Reply from 101.x.x.x: bytes=32 time=4ms TTL=54
   Ping statistics for 101.x.x.x:
       Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
   Approximate round trip times in milli-seconds:
       Minimum = 3ms, Maximum = 4ms, Average = 3ms

Como solucionar travamentos na reprodução e erros 4008/4009?

Se a reprodução travar ou se ocorrer um erro 4008 ou 4009 durante a reprodução do vídeo, siga os passos abaixo para solucionar o problema:

1. Utilize a ferramenta de diagnóstico de link de reprodução para executar um diagnóstico autônomo do link de reprodução do vídeo.

2. Verifique se o ambiente de rede do cliente (por exemplo, uma rede 4G) está estável e se a largura de banda de download não é inferior à taxa de bits do vídeo. Recomendamos alternar entre redes para testar a reprodução.

3. Confirme se a URL de reprodução ou os endereços dos segmentos TS estão acessíveis, para descartar respostas anormais de um POP do CDN.

4. Se estiver usando reprodução HLS criptografada, verifique se o parâmetro loadDataTimeout na configuração do player está definido com um valor muito baixo.

5. Use as ferramentas de desenvolvedor do navegador para inspecionar os detalhes da solicitação e verificar se algum segmento específico apresenta tempo limite esgotado durante o carregamento (correspondente ao erro 4008) ou retorna 0 bytes (correspondente ao erro 4009).

O Global Accelerator não melhora a velocidade de acesso

Verifique os itens a seguir para solucionar o problema:

• Quando um usuário fora da China continental tentar acessar um recurso, verifique o endereço IP para o qual o nome de domínio resolve. Isso ajuda a determinar se as configurações dos POPs fora da China continental entraram em vigor.

• O desempenho dos POPs fora da China continental também depende do volume de solicitações. A velocidade de acesso melhora apenas quando o volume de solicitações é alto. Se o número de solicitações for baixo, menos solicitações atingirão o cache. Nesse caso, adicionar POPs fora da China continental não melhora significativamente a velocidade de acesso para usuários nessas regiões.

Pré-visualizações de vídeo MP4 não funcionam

O recurso de pré-visualização no ApsaraVideo VOD suporta os formatos de arquivo MP4 e HLS. Para vídeos MP4, os metadados devem estar localizados no início do arquivo. Vídeos com metadados no final do arquivo não podem ser pré-visualizados. Ao usar o ApsaraVideo VOD para transcodificar um vídeo para o formato MP4, o serviço posiciona os metadados no início do arquivo. Para resolver esse problema, transcodifique o vídeo MP4. Para mais informações sobre transcodificação, consulte Transcodificação de áudio e vídeo.

Preciso permitir acesso à rede para reproduzir vídeos do ApsaraVideo VOD a partir de uma rede interna?

O CDN para ApsaraVideo VOD não suporta acesso a partir de uma rede interna (VPC). Para reproduzir recursos do ApsaraVideo VOD em uma rede interna, utilize um dos métodos a seguir:

1. Permita os nomes de domínio: Habilite o acesso de saída à internet e permita o acesso ao nome de domínio da API vod.<RegionId>.aliyuncs.com:443 e ao seu nome de domínio acelerado do CDN. Este método não exige a manutenção de endereços IP dinâmicos.

2. Obtenha endereços IP de nós do CDN: Chame a operação da API DescribeUserVipsByDomain para obter os endereços IP dos nós de CDN Nível 1 (L1) e adicione-os à lista de permissões do firewall. Como os endereços IP dos nós do CDN são alocados dinamicamente, atualize a lista de permissões periodicamente.

3. Use um nome de domínio interno do OSS: Substitua o nome de domínio acelerado por um nome de domínio interno do OSS no formato outin-<bucket_id>.oss-<RegionId>-internal.aliyuncs.com para ignorar o CDN e acessar diretamente o servidor de origem.

Nomes de domínio curinga

O ApsaraVideo VOD permite adicionar nomes de domínio curinga por meio da operação da API AddVodDomain. Um nome de domínio curinga deve começar com um ponto (.), por exemplo, .aliyundoc.com.

Erro "Root domain reserved"

Se a adição de um nome de domínio falhar no console do ApsaraVideo VOD e você receber o erro The root name of your domain is reserved by other account com a mensagem The root name of your domain is reserved by other account, please contact our Business Advisors, isso significa que o domínio raiz já foi adicionado ao Alibaba Cloud CDN, DCDN ou ApsaraVideo VOD em outra conta da Alibaba Cloud.

Se não conseguir resolver o problema, abra um ticket. Para mais informações sobre como abrir um ticket, consulte Entre em contato conosco.

Erro "Domain name already exists"

Se a adição de um nome de domínio falhar no console do ApsaraVideo VOD e você receber o erro This domain name already exists, isso significa que o nome de domínio já foi adicionado a outro produto da Alibaba Cloud.

Um nome de domínio acelerado não pode ser adicionado mais de uma vez. Se receber esse erro, verifique se o seu nome de domínio já foi adicionado a outros produtos cloud, como ApsaraVideo Live, DCDN e SCDN.

Se não conseguir resolver o problema, abra um ticket. Para mais informações sobre como abrir um ticket, consulte Entre em contato conosco.

Verificar um registro CNAME

Não utilize o comando ping para verificação. O comando ping pode retornar informações de resolução imprecisas. Em vez disso, use ferramentas de consulta como nslookup ou dig.

• Windows

  No Prompt de Comando (CMD) ou PowerShell em um sistema Windows, execute o seguinte comando para consultar o registro CNAME:

  nslookup -type=CNAME <accelerated_domain_name>

  Se o resultado retornado corresponder ao valor CNAME fornecido pelo serviço de CDN, o registro CNAME entrou em vigor.

  PS C:\Users\admin> nslookup -type=cname cdn.example.com
  Server:  UnKnown
  Address: 100.100.x.x
  
  Non-authoritative answer:
  cdn.example.com       canonical name = cdn.example.com.w.alikunlun.com

• Linux/macOS

  No terminal de um sistema Linux ou Mac OS, use o comando dig para verificar:

  • Consultar apenas o endereço de destino do CNAME (Recomendado):

    dig +short <accelerated_domain_name> CNAME

    Se o resultado retornado corresponder ao valor CNAME fornecido pelo serviço de CDN, o registro CNAME entrou em vigor. Abaixo está um exemplo de resultado:

    dig +short cdn.example.com CNAME
    cdn.example.com.w.alikunlun.com.

  • Consultar informações detalhadas do nome de domínio:

    dig <accelerated_domain_name> CNAME

    Se o valor CNAME na ANSWER SECTION for igual ao valor CNAME fornecido pelo CDN, isso indica que a resolução CNAME entrou em vigor.

    ; <<>> DiG 9.10.6 <<>> cdn.example.com CNAME
    ;; global options: +cmd
    ;; Got answer:
    ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 62811
    ;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1
    ;; OPT PSEUDOSECTION:
    ; EDNS: version: 0, flags:; udp: 4000
    ;; QUESTION SECTION:
    ;cdn.example.com.               IN      CNAME
    ;; ANSWER SECTION:
    cdn.example.com.     600     IN      CNAME   cdn.example.com.w.alikunlun.com.
    ;; Query time: 67 msec
    ;; SERVER: 30.30.x.x#53(30.30.x.x)
    ;; WHEN: Wed Sep 24 19:05:30 CST 2025
    ;; MSG SIZE  rcvd: 92

Nome de domínio acelerado reprovado na revisão

Todos os nomes de domínio adicionados ao ApsaraVideo VOD devem passar por uma revisão de conteúdo. Se a adição do seu nome de domínio falhar, ele pode não atender às regras de acesso. Para mais informações sobre os padrões e limitações para adição de nomes de domínio, consulte Requisitos de nome de domínio.

Se o seu nome de domínio for reprovado na revisão, faça login no console do ApsaraVideo VOD. Acesse a página Configuration Management > CDN Configuration > Domain Names para visualizar o motivo da falha. Exclua o nome de domínio reprovado, ajuste o conteúdo do site conforme o motivo indicado e adicione o nome de domínio novamente para aguardar a revisão.

Um nome de domínio acelerado do ApsaraVideo VOD pode ser igual ao domínio principal do site?

Não. Não utilize o mesmo nome de domínio para o domínio principal do site e para o nome de domínio acelerado do ApsaraVideo VOD. Aponte o domínio principal, como www.example.com, para o seu próprio servidor web. Adicione um subdomínio separado, como vod.example.com, ao ApsaraVideo VOD como nome de domínio acelerado e utilize esse subdomínio para a reprodução de vídeos.

Melhorar uma baixa taxa de acerto de cache

Uma baixa taxa de acerto de cache significa que as solicitações dos usuários são frequentemente redirecionadas ao servidor de origem, o que pode degradar o desempenho da aceleração devido a links instáveis na rede pública. É possível melhorar a taxa de acerto de cache fazendo pré-busca de URLs, configurando regras de expiração de cache e filtrando parâmetros variáveis nas URLs.

A tabela a seguir descreve as soluções.

Acesso lento a recursos após a aceleração

Um nome de domínio acelerado adiciona uma camada de POPs do CDN à rede, distribuindo recursos do seu servidor de origem para POPs mais próximos dos usuários. Isso permite que os clientes solicitem e recuperem recursos de um POP do CDN próximo, reduzindo as buscas na origem e melhorando a velocidade de acesso. Portanto, o acesso lento pode ser causado pelos seguintes problemas:

• Problemas na rede local do lado do cliente, como largura de banda de download insuficiente ou configuração incorreta.

• Conexão de rede ruim e alta latência entre o cliente e o POP do CDN.

• Um POP do CDN que não está funcionando corretamente ou tem tempo de resposta lento.

• O conteúdo do recurso é grande, resultando em um longo tempo de download.

• Conexão de rede ruim durante a busca na origem do POP do CDN para o servidor de origem.

• O próprio servidor de origem tem um tempo de resposta lento.

Erro de cross-origin "Access-Control-Allow-Origin"

Uma solicitação para um recurso acelerado falha com o erro The 'Access-Control-Allow-Origin' header has a value 'xxx' that is not equal to the supplied origin. O painel Console das ferramentas de desenvolvedor do navegador mostra um erro de cross-origin CORS porque a origem da solicitação (https://vr-mc01.xxx) não corresponde ao valor do cabeçalho de resposta Access-Control-Allow-Origin (https://vr-web01.xxx). Essa incompatibilidade faz com que o recurso falhe ao carregar (net::ERR_FAILED) e aciona erros subsequentes de runtime JS. Esse erro indica que o valor do cabeçalho cross-origin Access-Control-Allow-Origin na resposta do CDN não corresponde ao cabeçalho cross-origin Origin da solicitação do cliente, o que faz o navegador bloquear a resposta. Por exemplo, o cabeçalho cross-origin da solicitação é "Origin:http://Domain-A", mas o cabeçalho cross-origin da resposta é "Access-Control-Allow-Origin:http://Domain-B".

Esse problema pode ocorrer por um dos seguintes motivos:

• O cabeçalho cross-origin configurado no CDN não corresponde ao cabeçalho Origin da solicitação do cliente.

• O cabeçalho cross-origin do servidor de origem foi armazenado em cache pelo CDN.

• O cache do navegador está desatualizado.

Um nome de domínio acelerado do ApsaraVideo VOD pode usar o certificado SSL do domínio principal?

Não. Não é possível usar diretamente o certificado do domínio principal como certificado de um nome de domínio acelerado. Configure um certificado compatível com o nome de domínio acelerado, como um certificado para o subdomínio, um certificado curinga ou um certificado de domínio único.

O que fazer se a configuração do certificado HTTPS falhar porque inseri um arquivo CSR?

A configuração falha quando você insere uma solicitação de assinatura de certificado (CSR) como conteúdo do certificado. Um CSR é um arquivo de solicitação de certificado que começa com -----BEGIN CERTIFICATE REQUEST-----; ele não é um certificado emitido.

Para corrigir a configuração:

1. Abra os detalhes da instância do certificado no Certificate Management Service.

2. Localize o conteúdo completo do certificado emitido, que começa com -----BEGIN CERTIFICATE-----, e sua chave privada correspondente.

3. Faça login no console do ApsaraVideo VOD. Acesse Configuration Management > CDN Configuration > Domain Names.

4. Selecione o nome de domínio acelerado, abra HTTPS Settings, cole o certificado emitido completo e a chave privada correspondente e salve a configuração.

O que fazer se a implantação do certificado SSL reportar InsufficientQuota?

InsufficientQuota indica que a cota disponível para implantação de certificados é insuficiente. Utilize um dos métodos a seguir:

• Adquira a cota de implantação necessária no console do Certificate Management Service e tente a implantação novamente.

• Atualize o certificado manualmente sem custo. Faça login no console do ApsaraVideo VOD. Acesse Configuration Management > CDN Configuration > Domain Names. Selecione o nome de domínio, abra HTTPS Settings e atualize o certificado.

Se o erro persistir, tente novamente com um nome de certificado personalizado que não contenha caracteres chineses.

Solicitações HTTP ainda podem acessar recursos após a ativação do HTTPS?

Sim. Após configurar um certificado SSL para o nome de domínio e ativar a aceleração segura HTTPS, tanto solicitações HTTP quanto HTTPS podem acessar os recursos. Esse acesso de protocolo duplo mantém os caminhos existentes de recursos de vídeo válidos e garante acesso ininterrupto.

URL de callback de transcodificação não é HTTPS

Os callbacks do ApsaraVideo VOD atualmente não suportam HTTPS. Se você configurou corretamente um certificado HTTPS no ApsaraVideo VOD, substitua manualmente http:// por https:// na URL do recurso após receber a mensagem de callback.

Atualizar arquivos com o mesmo nome

Envie solicitações de atualização pelo console ou via API. Para mais informações sobre como atualizar recursos, consulte Limpar e pré-buscar. É possível enviar até 2.000 solicitações de atualização por dia para cada conta da Alibaba Cloud. Cada solicitação pode conter até 1.000 URLs. Também é possível atualizar conteúdo em até 100 diretórios por dia. Para informações sobre as operações de API relacionadas, consulte API de Atualização e Pré-busca.

Recursos não atualizados após atualização ou pré-busca

Execute as etapas a seguir para solucionar e resolver o problema:

• Limpe o cache do navegador e atualize a página para verificar se o recurso foi atualizado.

• Vincule o nome de domínio do site diretamente ao servidor de origem modificando o arquivo hosts local. Em seguida, acesse o servidor de origem diretamente para verificar se os recursos foram atualizados. Se não estiverem atualizados, atualize os recursos no servidor de origem e depois utilize o serviço de CDN para aceleração.

• Faça login no console do ApsaraVideo VOD e verifique se a tarefa de atualização ou pré-busca foi concluída. Caso contrário, recomendamos executar a tarefa novamente.

Bloquear endereços IP maliciosos

Configure uma lista de bloqueios de IP para impedir e negar o acesso de endereços IP específicos. Para mais informações, consulte Configurar uma lista de bloqueios ou permissões de IP.

IP na lista de bloqueios ainda consegue acessar recursos

Verifique se o endereço IP configurado no console do ApsaraVideo VOD está correto. Para restringir com precisão os endereços IP dos clientes, adicione os endereços IP do cabeçalho X-Forwarded-For à lista de bloqueios. Para mais informações sobre como obter o endereço IP do cliente, consulte Recuperar os endereços IP de origem dos clientes.

Proteção contra hotlinking causa erro 403

Problema

Após configurar a proteção contra hotlinking, o acesso a recursos acelerados no ApsaraVideo VOD retorna um erro 403.

Causa

As configurações de proteção contra hotlinking estão incorretas ou o cabeçalho Referer na solicitação está vazio.

Solução

1. Identifique a causa do problema.

   • Execute o comando curl para testar o acesso ao nome de domínio acelerado.

     curl -voa -e "http://demo.aliyundoc.com" http://example.aliyundoc.com

     Um erro 403 com a mensagem denied by Referer ACL, conforme mostrado no exemplo de saída a seguir, indica que as configurações de proteção contra hotlinking estão incorretas. Neste exemplo, o cabeçalho HTTP da solicitação contém um campo Referer com o valor demo.aliyundoc.com.

     * Rebuilt URL to: http://example.aliyundoc.com/
     *   Trying 101.x.x.144...
     * TCP_NODELAY set
     * Connected to example.aliyundoc.com (101.x.x.144) port 80 (#0)
     > GET / HTTP/1.1
     > Host: example.aliyundoc.com
     > User-Agent: curl/7.54.0
     > Accept: */*
     > Referer: http://demo.aliyundoc.com
     >
     < HTTP/1.1 403 Forbidden
     < Server: Tengine
     < Date: Sat, 08 Dec 2023 12:36:17 GMT
     < Content-Type: text/html
     < Content-Length: 254
     < Connection: keep-alive
     < X-Tengine-Error: denied by Referer ACL
     ...
     * Connection #0 to host example.aliyundoc.com left intact

   • Execute o comando curl para testar o acesso ao nome de domínio acelerado sem um cabeçalho Referer.

     curl -voa http://example.aliyundoc.com

     Se o sistema retornar um erro 403 e a mensagem denied by Referer ACL, conforme mostrado no exemplo de saída a seguir, isso indica que a proteção contra hotlinking está configurada para bloquear solicitações com cabeçalho Referer vazio. Neste exemplo, o cabeçalho HTTP da solicitação não possui campo Referer.

     * Rebuilt URL to: http://example.aliyundoc.com/
     *   Trying 101.x.x.148...
     * TCP_NODELAY set
     * Connected to example.aliyundoc.com (101.x.x.148) port 80 (#0)
     > GET / HTTP/1.1
     > Host: example.aliyundoc.com
     > User-Agent: curl/7.54.0
     > Accept: */*
     >
     < HTTP/1.1 403 Forbidden
     < Server: Tengine
     < Date: Sat, 08 Dec 2023 12:48:50 GMT
     < Content-Type: text/html
     < Content-Length: 254
     < Connection: keep-alive
     < X-Tengine-Error: denied by Referer ACL
     ...
     * Connection #0 to host example.aliyundoc.com left intact

   • Abra uma URL acelerada pelo nome de domínio em um navegador Chrome e abra as ferramentas de desenvolvedor. Se os cabeçalhos da solicitação não contiverem um campo Referer e ocorrer um erro 403, conforme mostrado no exemplo de saída a seguir, isso indica que a proteção contra hotlinking está configurada para bloquear solicitações com cabeçalho Referer vazio.

     403 Forbidden
     You don't have permission to access the URL on this server.
     Powered by Tengine
     
     Response Headers:
     Server: Tengine
     X-Tengine-Error: denied by Referer ACL
     ...
     
     Request Headers:
     Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
     Host: example.aliyundoc.com
     User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36
     ...

2. Resolva o problema com base na causa identificada.

   • Solução para configurações incorretas de proteção contra hotlinking

     Verifique se o valor Referer demo.aliyundoc.com é permitido pelas regras de proteção contra hotlinking configuradas para o nome de domínio acelerado example.aliyundoc.com.

     Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Configuration Management > CDN Configuration > Domain Names. Localize o nome de domínio desejado e clique em Configure na coluna Actions. Em seguida, escolha Resource Access Control > Referer-based Hotlink Protection > Modify. Se o tipo de Referer estiver definido como Whitelist e o Referer solicitado não corresponder à lista de permissões, adicione o nome de domínio demo.aliyundoc.com à lista. Por exemplo, se a Referer-based Hotlink Protection estiver configurada como Whitelist com a regra *.example.com, e as opções Allow Access to Resource URL from Browser Address Bar e Allow Empty Referer Field to Access CDN Resources não estiverem selecionadas, uma solicitação de demo.aliyundoc.com seria bloqueada.

   • Solução para cabeçalho Referer vazio

     Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Configuration Management > CDN Configuration > Domain Names. Localize o nome de domínio desejado e clique em Configure na coluna Actions. Em seguida, escolha Resource Access Control > Referer-based Hotlink Protection > Modify. Marque a caixa de seleção Allow Access to Resource URL from Browser Address Bar.

     Nota

     Permitir solicitações com cabeçalho Referer vazio aumenta o risco de hotlinking.

Posso configurar limitação de tráfego e proteção contra hotlinking sem um nome de domínio acelerado?

Não. Os recursos de limitação de tráfego e Resource Access Control no ApsaraVideo VOD, incluindo proteção contra hotlinking, dependem de um nome de domínio acelerado. Se você não adicionou um nome de domínio acelerado, não poderá configurar essas políticas de segurança e elas não entrarão em vigor.

As ferramentas de desenvolvedor não podem ser usadas porque o Web Player SDK aciona anti-depuração (debugger) após ser carregado

A versão de produção do aliplayer-min.js inclui um mecanismo de proteção anti-depuração integrado. Em um ambiente não autorizado ou quando as ferramentas de desenvolvedor do navegador estão abertas, ele insere automaticamente uma instrução debugger para evitar uso não autorizado ou adulteração de código. Esse mecanismo não pode ser desativado por configuração.

Se suspeitar que seu ambiente local difere da versão oficial, visite a página de configurações do player oficial para comparar e testar.

Palavras-chave: anti-depuração, debugger, aliplayer-min.js, ferramentas de desenvolvedor, depuração no navegador.

Como sincronizar legendas e letras de música com a reprodução no Web Player SDK?

Por padrão, o Web Player SDK exibe legendas VTT abaixo do vídeo, usando o mesmo estilo das legendas de vídeo.

O SDK não suporta nativamente rolagem no estilo de player de música ou letras destacadas centralizadas. Para sincronizar letras com um arquivo de áudio MP3, converta as letras para o formato VTT e use-as como legendas externas. Certifique-se de que os timestamps VTT correspondam precisamente ao progresso da reprodução do áudio. Em seguida, escute o evento de atualização de tempo de reprodução do player, analise o conteúdo VTT por conta própria e desenvolva um componente de UI personalizado para renderizar as letras.

Palavras-chave: legendas VTT, sincronização de letras, letras com rolagem, letras MP3, legendas externas, UI personalizada.

O Web Player reporta um erro ou mostra Loading por muito tempo após retomar do segundo plano

Causa: Quando um navegador recupera recursos em segundo plano, o player torna-se inativo. Alternativamente, a credencial PlayAuth pode ter expirado (o período máximo de validade é de 3000 segundos).

Solução: Escute o evento visibilitychange. Quando a página for para o segundo plano, chame player.pause() e armazene currentTime em sessionStorage. Quando a página retornar ao primeiro plano, obtenha um novo PlayAuth e chame replayByVid(vid, newPlayAuth) para reiniciar a reprodução. Escute o evento ready ou canplay e, no callback, leia o tempo do sessionStorage e chame player.seek() para retomar o progresso da reprodução.

Sugestões de otimização: Defina vodRetry como 0 e waitingTimeout como 10 segundos para reduzir o tempo de espera, ou atualize proativamente o token 5 minutos antes da credencial expirar.

Como usar e limpar o cache local do ListPlayer (enableLocalCache)?

Condições para o cache entrar em vigor: O formato do vídeo deve ser MP4 e reproduzido por URL. Se a URL contiver parâmetros de autenticação, remova-os ao calcular a chave de cache.

Reprodução offline: Após definir enableLocalCache como YES, a reprodução pode continuar offline sem interrupções e sem consumir tráfego adicional.

Limpeza do cache: Chame [AliPlayerGlobalSettings clearCaches] para limpar todos os caches de vídeo. Isso se aplica a cenários como durante a reprodução, após logout ou limpeza manual.

Como funciona o mecanismo de verificação de License do Web Player SDK e como lidar com cenários especiais (VPN/iframe)?

Mecanismo de verificação: O Web Player SDK verifica a License com base no nome de domínio atual na barra de endereços do navegador ou no Referer. Esse nome de domínio deve corresponder ao nome de domínio vinculado quando você solicitou a License.

Cenário de proxy VPN: Acessar a página por meio de uma VPN pode causar um erro de incompatibilidade de nome de domínio. Recomendamos usar um redirecionamento 302 unificado para uma página no domínio autorizado ou incorporar a página de reprodução em um iframe na página da VPN (certifique-se de que a página carregada dentro do iframe esteja no domínio autorizado).

Limitação de incorporação iframe: Se a página pai estiver em um domínio não autorizado e a página filha (iframe) estiver no domínio autorizado, a verificação da License pode passar normalmente. No entanto, observe que o navegador integrado do WeChat pode restringir iframes cross-domain, e a comunicação entre as páginas pai e filha requer a configuração de postMessage.

Palavras-chave: Vinculação de domínio da License, proxy VPN, incorporação iframe, restrições cross-domain, postMessage.

Após o Web Player atualizar um PlayAuth expirado, como retomar a reprodução de uma posição específica?

Limitação atual: Ao usar o método replayByVidAndPlayAuth para atualizar o PlayAuth, a reprodução reinicia do começo. Retomar automaticamente de uma posição específica ainda não é suportado.

Solução recomendada: Quando o evento pause for disparado, registre o tempo de reprodução atual (armazene-o em localStorage ou em uma variável de memória). Ao capturar o código de erro de expiração do PlayAuth 4002, primeiro atualize o PlayAuth, então chame manualmente seek para o tempo registrado anteriormente para retomar a reprodução.

Estratégia de fallback: No evento error, salve o último tempo válido conhecido como fallback, para evitar posicionamento impreciso causado por erros de buffer.

Palavras-chave: Expiração do PlayAuth, retomar reprodução, replayByVidAndPlayAuth, código de erro 4002, recuperação via seek, falha em getCurrentTime.

O Web Player em um WebView Android tem áudio, mas não tem vídeo

Solucione o problema da seguinte forma:

1. Verifique se a aceleração de hardware está ativada. Defina android:hardwareAccelerated="true" em AndroidManifest.xml ou defina webView.setLayerType(View.LAYER_TYPE_SOFTWARE, null) no seu código para tentar a renderização por software.

2. Verifique a compatibilidade do formato de codificação do vídeo. WebViews mais antigos podem não suportar High Profile H.265/H.264. Recomendamos transcodificar o vídeo para um formato compatível.

3. Atualize o Web Player SDK para a versão mais recente (por exemplo, 2.37.6 ou posterior) para corrigir problemas conhecidos de compatibilidade.

4. Imprima a versão do WebView para verificar se o kernel está desatualizado.

O Web Player mostra tela preta ou fica carregando quando autoplay é false e não há imagem de capa

Causa: Se o atributo poster não estiver definido, o player não tem conteúdo padrão para exibir.

Solução: Defina o atributo poster para especificar uma imagem de capa ou escute eventos como ready para gerenciar o estado do player e personalizar a exibição da UI.

Por que os vídeos reproduzem no 360 Browser, mas não no Chrome ou Edge, e como corrigir?

Causa: O 360 Browser possui mais decodificadores integrados ou usa um kernel de compatibilidade (como modo IE), enquanto Chrome e Edge impõem requisitos mais rigorosos quanto a formato de vídeo, protocolo e política de segurança.

Solução: Solicite uma License gratuita do Alibaba Cloud Player SDK e integre o código do player do site para melhorar a compatibilidade.

O player não responde ao puxar uma stream ao vivo com setDataSource e reporta "Connect didn't get any data from stream"

Chame o método de início de reprodução no callback prepared do player para garantir que a extração da stream e o início da reprodução ocorram apenas após o player estar pronto.

Como fechar ou ocultar a interface da ferramenta de diagnóstico que o Web Player abre automaticamente?

A ferramenta de diagnóstico não executa persistentemente. Fechar a aba ou retornar à página de reprodução a encerra. Se precisar ocultá-la durante a operação para evitar exposição de informações, reescreva o código usando o recurso de UI de erro personalizada H5 do Web Player para redefinir o estilo (por exemplo, mantenha apenas um botão de atualização).

Vídeos não reproduzem em certos navegadores iOS, como UC Browser

Sugestões de solução de problemas:

1. Alterne entre ambientes de rede para descartar problemas de rede.

2. Adicione a ferramenta vconsole na página web para visualizar os logs de erro específicos e localizar a causa.

3. Recomendamos usar o Alibaba Cloud Web Player para melhor suporte de compatibilidade.

Após configurar hlsOption.abrEwmaDefaultEstimate, preciso de scripts adicionais?

abrEwmaDefaultEstimate é a estimativa inicial do player sobre o ambiente de rede atual, usada para comparar com o valor BANDWIDTH no arquivo m3u8 ao selecionar uma taxa de bits. Durante a reprodução, o player atualiza a estimativa de largura de banda com base na velocidade real de download e substitui a configuração inicial. Nenhum script adicional é necessário.

Após atualizar o ApsaraVideo Player SDK, alguns vídeos ainda falham ao reproduzir ou continuam mostrando Loading no iOS

Recomendamos atualizar o Player SDK para a versão mais recente para resolver problemas de compatibilidade nativa de HLS. Se o problema persistir após a atualização, verifique sua configuração de backend e a configuração do certificado do nome de domínio.