# Ativar o Kapsule CDN no Seu Site

Source: https://support.kapsulehost.com/pt-pt/cdn-enabling

O Kapsule CDN armazena em cache o seu site na edge, para que os visitantes em qualquer parte do mundo sejam servidos a partir de um local próximo em vez do seu servidor de origem, e ativá-lo é um único interruptor no site que pretende acelerar.

Não existe um produto CDN separado para comprar: ele vem incluído no plano de alojamento em que o site se encontra. Ativa-se a partir do menu do próprio site no KPanel, aguarda-se alguns minutos até o certificado de edge ser emitido, e o seu domínio começa a ser servido a partir da nossa rede de edge. Duas coisas têm de ser verdade primeiro, e este guia aborda ambas: o site precisa de um domínio personalizado, e o seu plano precisa de incluir o CDN.

## O Que Faz o Kapsule CDN

Quando o CDN está ativado, os pedidos para o seu domínio chegam primeiro à nossa rede de edge. Tudo o que é armazenável em cache é respondido a partir do local mais próximo entre mais de 119 locais globais. Tudo o que não é armazenável em cache, ou que expirou, é obtido a partir da sua origem e depois mantido na edge para o visitante seguinte.

| Funcionalidade | O que obtém |
|---|---|
| Cache de edge | Recursos estáticos servidos a partir de mais de 119 locais globais |
| SSL de edge | Um certificado de edge é aprovisionado automaticamente para o seu domínio |
| Otimização de imagens (Kapsule CDN+) | Redimensionamento e compressão em tempo real, comutável |
| Entrega de WebP (Kapsule CDN+) | Um formato de imagem moderno servido aos navegadores que o suportam |
| Controlos de TTL de cache | Durações separadas para edge e navegador, em segundos |
| Medidor de largura de banda | Uso mensal em tempo real, lido a partir da edge. A largura de banda é ilimitada |
| Limpeza de cache | Limpe um URL ou todo o site a partir do mesmo ecrã |

## Que Planos Incluem o CDN

O CDN é um direito do plano, pelo que o que o seu site obtém depende do plano em que esse site se encontra. Existem dois níveis, e o emblema no topo da página do CDN indica-lhe qual está ativo:

- O **Kapsule CDN** abrange o cache de edge global, o certificado SSL de edge emitido automaticamente, e a limpeza de cache.
- O **Kapsule CDN+** acrescenta proteção contra DDoS, encaminhamento inteligente na edge, otimização de imagens com entrega de WebP, e controlos de cache no KPanel, além do anterior.

**A largura de banda na edge é ilimitada em todos os planos desta tabela.** Não existe um limite por
plano para o que a edge serve, nem um ponto a partir do qual a edge deixe de servir. O que difere entre
os dois níveis é o conjunto de funcionalidades acima, não uma quantidade de tráfego. O único limite
que se aplica é relativo à conta como um todo e não por plano, e encontra-se na nota sobre a Política
de Uso Justo abaixo.

| Plano | Nível de CDN |
|---|---|
| Start (Web Hosting) | Kapsule CDN |
| Pro (Web Hosting) | Kapsule CDN+ |
| Agency (Web Hosting) | Kapsule CDN+ |
| Scale (Web Hosting) | Kapsule CDN+ |
| Cloud Power (Web Hosting) | Kapsule CDN+ |
| WordPress Start | Kapsule CDN |
| WordPress Pro | Kapsule CDN+ |
| Managed WP Start | Kapsule CDN |
| Managed WP Pro | Kapsule CDN+ |
| Managed WC Start | Kapsule CDN |
| Managed WC Pro | Kapsule CDN+ |
| Concierge Start | Kapsule CDN+ |
| Concierge Pro | Kapsule CDN+ |
| Concierge Scale | Kapsule CDN+ |

> **Note:** As contas de dimensão muito grande são abrangidas pela [Política de Uso Justo](https://kapsulehost.com/pt-pt/legal/fair-use),
> que publica um único limite para a conta como um todo em vez de um limite por plano, e diz, em todas as
> palavras, que lhe enviamos um e-mail no dia em que o ultrapassa e nunca limitamos, nunca faturamos
> retroativamente e nunca suspendemos sem aviso.

> **Note:** Os planos Managed WordPress e Managed WooCommerce têm um limite mensal separado de largura de banda do
> **site**, que é uma medição diferente da edge. Ultrapassá-lo nunca é um corte nem uma cobrança: a
> largura de banda de alojamento não é faturada, e enviamos-lhe um e-mail para que saiba. [O Que É
> Limitado no Seu Plano](https://support.kapsulehost.com/pt-pt/site-slow-resource-limits) aborda este tema.

Pode comparar e alterar planos em [kpanel.kapsulehost.com/plans/hosting](https://kpanel.kapsulehost.com/plans/hosting), ou consultar [Atualizar o Seu Plano](https://support.kapsulehost.com/pt-pt/upgrading-your-plan).

## Antes de Começar

> **Note:** O Kapsule CDN precisa de um domínio personalizado. Se o seu site ainda estiver num subdomínio partilhado da KapsuleHost, a página do CDN mostra o aviso **O Kapsule CDN precisa de um domínio personalizado** com um botão **Conectar um Domínio Personalizado** em vez do controlo de ativação. Conecte primeiro o seu próprio domínio ao site, e depois volte.

O motivo é técnico e não comercial: a edge tem de emitir um certificado SSL para o nome de anfitrião que serve, e isso exige um nome de anfitrião cujo DNS possa ser apontado para a edge. Um nome de anfitrião partilhado da KapsuleHost é gerido por nós e não pode ser reapontado em seu nome, pelo que o pedido de certificado nunca seria concluído e o site pareceria ativado mas estaria a servir erros. Em vez disso, bloqueamos isso logo no momento do clique. Consulte [Adicionar um Domínio Personalizado ao Seu Site](https://support.kapsulehost.com/pt-pt/custom-domain-for-website) para os passos de ligação.

## Ativar o CDN Altera o Seu DNS

Vale a pena compreender isto antes de clicar, porque costuma surpreender as pessoas.

Ativar o CDN não deixa o seu DNS intocado. O seu domínio tem de resolver para a nossa rede de edge em vez de diretamente para a sua origem, pelo que ativar o CDN reescreve dois registos do site:

- Um **CNAME em `www`** apontando para a edge. Qualquer registo A ou AAAA existente em `www` é removido primeiro, porque um CNAME não pode coexistir com eles.
- Um **ALIAS no domínio nu** apontando para a mesma edge, para que o tráfego para o seu domínio sem o `www` também passe pelo CDN. Qualquer registo A ou AAAA no domínio nu é removido.

> **Note:** Se o seu domínio estiver nos servidores de nomes da KapsuleHost, fazemos ambas essas alterações por si, automaticamente, como parte da ativação do CDN. Não precisa de mexer em nada. Se o DNS do seu domínio estiver alojado noutro local, essa automatização não pode funcionar, os registos não serão alterados, e o certificado de edge nunca será emitido. [Compreender os Servidores de Nomes](https://support.kapsulehost.com/pt-pt/nameservers) explica em que caso se encontra.

> **Warning:** Não remova nem substitua esses registos enquanto o CDN estiver ativo. Colocar novamente um registo A em `www` ou no domínio nu retira esse tráfego da edge, e pode interromper a renovação do certificado. Se precisar de DNS personalizado para o site, altere-o com o CDN desativado, e depois ative o CDN novamente.

O site só é marcado como tendo o CDN ativado quando o DNS do domínio principal tiver efetivamente sido escrito e apontado para a edge. Se esse passo não for bem-sucedido, o painel continua a mostrar o CDN como desativado, em vez de dizer que está ativado enquanto o seu tráfego ainda vai para outro lado.

## Como Ativar o CDN

1. Inicie sessão no [KPanel](https://kpanel.kapsulehost.com).
2. Clique em **Websites** na barra lateral esquerda, e depois clique no site que pretende acelerar.
3. No menu do próprio site, abra **Desempenho**, e depois **Kapsule CDN**.
4. A página abre com o aviso **CDN desativado para este site**. Clique em **Ativar CDN**.
5. Aparece uma confirmação: "Aprovisionamento do CDN em fila. O certificado de edge pode demorar até 5 minutos."

O endereço direto é `/websites/<site-id>/cdn`.

![Página do Kapsule CDN para um site no KPanel](https://support.kapsulehost.com/help/screenshots/cdn-enabling.613bdae0.webp)

### Como É a Espera

Nada de visível acontece nos primeiros minutos, e isso é esperado, não uma avaria. Eis a sequência:

1. Os registos DNS descritos acima são escritos para o seu domínio.
2. Esses registos têm de se propagar antes de um certificado poder ser emitido para o nome de anfitrião. Isso é uma limitação de tempo do DNS, não uma fila que possamos saltar.
3. A edge solicita o certificado. Se o DNS ainda não se tiver propagado, o pedido fica pendente e é repetido automaticamente até ser bem-sucedido.
4. Assim que o certificado é emitido, o site muda para CDN ativado.

> **Note:** Reserve até cerca de cinco minutos, e recarregue a página em vez de clicar novamente em **Ativar CDN**. Durante a espera, a página continua a mostrar o CDN como desativado, porque só reporta como ativado quando o seu tráfego pode genuinamente alcançar a edge. Isso é deliberado: um estado meio ativado que afirmasse estar ligado seria pior do que um honesto "ainda não".

Assim que o certificado é emitido, o aviso muda para **CDN ativado** com a nota "CDN ativo. O seu domínio serve conteúdo a partir da edge", e o conjunto completo de cartões de controlo aparece abaixo. Nesse momento, o HTTPS é forçado no nome de anfitrião.

> **Tip:** Não existe nenhuma entrada **CDN** na barra lateral principal do KPanel. O CDN pertence a um site, por isso fica um nível abaixo, dentro de **Desempenho**.

## Definições Que Pode Alterar

### TTLs de Cache

O cartão **TTLs de Cache** contém dois números, ambos em segundos, ambos com o valor predefinido de 3600 (uma hora):

- **TTL de Edge (segundos)**: durante quanto tempo a edge mantém uma cópia antes de voltar à sua origem.
- **TTL do Navegador (segundos)**: durante quanto tempo o próprio navegador do visitante mantém a sua cópia.

Números mais baixos significam conteúdo mais fresco e mais pedidos à sua origem. Números mais altos significam melhor desempenho e conteúdo mais desatualizado até fazer uma limpeza. As alterações são guardadas assim que as define e são enviadas para a edge de imediato.

### Otimização de Imagens

A otimização de imagens é uma funcionalidade do **Kapsule CDN+**. Num plano com Kapsule CDN+, o cartão **Otimização de imagens** tem dois interruptores, e ambos estão ativados quando o CDN é ligado pela primeira vez:

- **Otimização de imagens em tempo real**: redimensiona e comprime imagens no primeiro pedido, e depois armazena em cache o resultado otimizado na edge.
- **Servir WebP para navegadores suportados**: entrega WebP a navegadores que anunciam suporte, e o formato original a todos os outros.

Vale a pena deixar ambos ativados em quase todos os sites. Desative a otimização de imagens apenas se servir imagens que têm de chegar idênticas byte a byte ao original.

Num plano com Kapsule CDN, o cartão é substituído por uma nota a dizer que a otimização de imagens vem com o Kapsule CDN+, com uma ligação para os planos que a incluem. Mudar o plano do site para um com Kapsule CDN+ ativa a otimização de imagens de imediato. Mudar para um plano sem essa funcionalidade tem efeito na sua próxima renovação, e a otimização de imagens desativa-se nessa altura.

## Monitorizar a Sua Largura de Banda

O cartão **Largura de banda deste mês** lê dados em tempo real a partir da edge e é reiniciado no primeiro dia de cada mês. Mostra o que já serviu, e indica **Largura de banda ilimitada** ao lado, porque não há nada contra o qual contabilizá-la: a leitura existe para que possa ver o trabalho que a edge está a fazer por si, não para que tenha de ficar abaixo de um número.

> **Note:** Não existe nenhum ponto a partir do qual o fornecimento pela edge pare, nem nenhum valor que possa ultrapassar. O cartão é uma leitura, nunca um medidor com limite. Se a sua conta for suficientemente grande para que a [Política de Uso Justo](https://kapsulehost.com/pt-pt/legal/fair-use), que se aplica à conta como um todo, seja relevante, essa política publica o limite, e enviamos-lhe um e-mail no dia em que o atinge, em vez de alterar a forma como o seu site é servido.

Se o cartão mostrar "Uso indisponível", significa simplesmente que o valor em tempo real não pôde ser obtido nesse momento. É um problema de apresentação, não um sinal de que o CDN está em baixo. Recarregue a página dentro de um minuto.

## Desativar o CDN

1. Abra **Desempenho**, e depois **Kapsule CDN** no site.
2. Desça até ao cartão **Desativar CDN**, que indica "O tráfego volta para o seu servidor de origem."
3. Clique em **Desativar**.

O tráfego volta imediatamente para a sua origem, e a zona de edge do site é removida, pelo que a largura de banda deixa de ser acumulada. Pode ativá-lo novamente a qualquer momento, mas os registos DNS e o certificado de edge têm de ser configurados de novo, por isso reserve mais alguns minutos.

## Resolução de Problemas

**"O Kapsule CDN precisa de um domínio personalizado."** O site ainda está num nome de anfitrião partilhado da KapsuleHost. Conecte o seu próprio domínio, e depois ative o CDN nesse domínio. Este é o motivo mais comum para o interruptor falhar.

**"O Kapsule CDN não está incluído no seu plano atual."** O plano associado a este site não tem direito a CDN. Mude o site para um dos planos listados acima e o interruptor fica disponível. Consulte [Atualizar o Seu Plano](https://support.kapsulehost.com/pt-pt/upgrading-your-plan).

**O aviso continua a dizer que o CDN está desativado após um minuto.** Os registos DNS têm de se propagar antes de o certificado poder ser emitido, o que demora até cerca de cinco minutos. Aguarde, e depois recarregue.

**Já passou muito mais do que cinco minutos e o CDN continua desativado.** A causa mais provável é o DNS do seu domínio não estar alojado connosco, pelo que os registos não puderam ser escritos automaticamente. Verifique para onde apontam os seus servidores de nomes. Se o seu domínio estiver nos servidores de nomes da KapsuleHost e continuar bloqueado, contacte-nos.

**O meu site voltou a apontar para a origem depois de eu editar o DNS.** Readicionar um registo A em `www` ou no domínio nu substitui os registos que encaminham o tráfego para a edge. Desative o CDN, resolva o DNS de que precisa, e depois ative-o novamente.

**O emblema do CDN está a aparecer mas as minhas alterações não.** Isso é o cache a funcionar como previsto. Limpe o URL que alterou, ou todo o site: consulte [Limpar a Cache do Kapsule CDN](https://support.kapsulehost.com/pt-pt/cdn-cache-purge).

**O site não ficou mais rápido.** O CDN acelera a entrega, não a geração de páginas. Se as suas páginas são lentas a construir na origem, armazene-as em cache por mais tempo ou corrija primeiro a origem. [Melhorar a Velocidade do Site](https://support.kapsulehost.com/pt-pt/website-speed) aborda o lado da origem.

Se o emblema ainda não tiver aparecido quinze minutos depois de ter ativado o CDN, envie-nos um e-mail para [support@kapsulehost.com](mailto:support@kapsulehost.com) com o domínio do site e analisaremos a emissão do certificado.
