# CDN Guarde as imagens, vídeos e sons da cidade num link rápido para o inventário, a concessionária, a loading screen e os prints dos scripts. Source: https://fivedash.fivex.gg/docs/pt/cdn/overview A **CDN** é o depósito da cidade: um lugar só para as imagens, vídeos e sons que o servidor usa, cada arquivo com um link rápido. Ícones do inventário, fotos da concessionária, fundos da loading screen e os prints que os scripts mandam do jogo ficam aqui, sem Imgur caindo e sem link do Discord expirando. Esta página é para o dono e a equipe que cuidam dos arquivos do servidor. ## Antes de começar * **Plano:** o módulo CDN precisa estar no plano da organização. O espaço depende do plano e vale por servidor (cada servidor tem a sua CDN). Veja [Uso e limites](https://fivedash.fivex.gg/docs/pt/cdn/usage-and-limits). * **Criar a CDN:** precisa de **Arquivos** no nível **Gerenciar**. Quem não tem vê "Peça a quem cuida dos arquivos da organização para abrir a CDN e criar o endereço." ## Criar a CDN Em **CDN → Arquivos**, enquanto a CDN não existe, aparece **A CDN de … ainda não foi criada**. Clique em **Criar a CDN** e siga os três passos de **Guarde as mídias da cidade**. ### Escolha o endereço Em **Endereço da CDN**, digite o endereço (o padrão é `minha-cidade`). O FiveDash mostra **Livre** ou **Em uso**. Clique em **Continuar**. ### Monte as pastas Marque as pastas que a cidade usa (lista abaixo). Ajuste **Otimizar imagens** (a qualidade do WebP) e, se quiser, ligue **Começar com arquivos de exemplo**. Clique em **Criar … pastas**, ou em **Começar sem pastas**. ### Envie os primeiros arquivos Escolha a **Pasta de destino** e arraste imagens, vídeos e áudios para a área de envio (ou **escolha no computador**). Cada arquivo ganha um link na hora. Clique em **Abrir a CDN**. ### Pastas sugeridas | Pasta | Nome no link | Para que serve | Já vem marcada | | ------------------- | ---------------- | -------------------------------------------------- | -------------- | | **Inventário** | `itens` | Ícones dos itens, para o ox_inventory e afins | Sim | | **Veículos** | `veiculos` | Fotos da concessionária e da garagem | Sim | | **Loading screen** | `loading-screen` | Fundos, logo e trailer | Sim | | **Screenshots** | `screenshots` | Prints que os scripts enviam do jogo | Sim | | **Logos e banners** | `marca` | Logo, banners do Discord e da loja | Não | | **Roupas** | `roupas` | Prévias de roupas e acessórios | Não | | **Clipes** | `clipes` | Vídeos de eventos e divulgação | Não | | **Sons** | `sons` | Efeitos e músicas para o xsound e o interact-sound | Não | > Os **arquivos de exemplo** são arquivos reais para testar os links. Os envios contam na franquia do plano. ## O link dos arquivos Todo arquivo tem um link público neste formato: ```http https://cdn.fivex.sh/// ``` Por exemplo: `https://cdn.fivex.sh/cidade-exemplo/itens/agua.png`. As subpastas entram no caminho. No plano Ultra, um domínio da cidade pode entregar os mesmos arquivos (veja [Domínio próprio](https://fivedash.fivex.gg/docs/pt/cdn/custom-domain)). | Regra do endereço | Valor | | ----------------- | ----------------------------------------------------------------------------------------------- | | Tamanho | De 3 a 32 caracteres | | Caracteres | Letras minúsculas, números e hífens, sem hífen nas pontas | | Reservados | `admin`, `api`, `cdn`, `assets`, `fivex`, `fivedash`, `static`, `health`, `internal`, `uploads` | | Único | Não pode ser de outra cidade ("Esse endereço já é de outra cidade. Tente outro.") | > Mudar o endereço, renomear ou mover um arquivo muda o link. Os scripts que usam o link antigo precisam do novo. ## Formatos aceitos | Tipo | Formatos | | ------- | ------------------------- | | Imagens | PNG, JPEG, WebP, GIF, SVG | | Vídeos | MP4, WebM, MOV | | Áudios | MP3, OGG, WAV, M4A | Qualquer outro arquivo é recusado no envio. PNG, JPEG e WebP podem ser otimizados em WebP; GIF, SVG, áudio e vídeo são entregues como foram enviados. ## O que tem no módulo | Página | Caminho no painel | O que faz | | ----------------- | ----------------------- | -------------------------------------------------------------------------------------------------------- | | **Arquivos** | **CDN → Arquivos** | Pastas, envio, busca, prévia, links, favoritos e lixeira. | | **Uso** | **CDN → Uso** | Espaço, tráfego, acessos, franquias do mês e arquivos mais acessados. | | **Configurações** | **CDN → Configurações** | Endereço, domínio próprio, imagens, retenção, envios, proteção, cache, chaves de envio e zona de perigo. | ## Configurações Em **CDN → Configurações** ficam as opções de como a CDN entrega, guarda e protege os arquivos. Endereço, imagens, retenção, envios, proteção e cache são salvos juntos pela barra **Salvar**. As chaves de envio e **Apagar a CDN** valem na hora. Com **Configurações** só em **Ver**, a página mostra "Seu acesso permite ver, sem mudar." | Seção | Campo | O que faz | Padrão | | ------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | | **Endereço** | **Endereço público** | O começo de todos os links: `cdn.fivex.sh/`. Ao salvar um endereço novo, os links antigos param de responder. | O escolhido na criação | | **Domínio próprio** | **Subdomínio** | Um subdomínio da cidade para entregar os arquivos (Ultra). Veja [Domínio próprio](https://fivedash.fivex.gg/docs/pt/cdn/custom-domain). | Nenhum | | **Imagens** | **Otimizar imagens** | A qualidade do WebP, de 70% a 100%. Em 100% (**Original**) mantém o formato enviado. | 85% | | **Imagens** | **Largura máxima** | Imagens maiores são reduzidas no envio: **Sem limite**, 1920 px, 2560 px ou 3840 px (4K). | 2560 px | | **Imagens** | **Remover metadados** | Tira localização e dados da câmera das fotos antes de publicar. | Ligado | | **Retenção** | Imagens, Vídeos, Áudios | Apaga sozinho o que envelhece: **Manter sempre**, 7, 14, 30, 60, 90, 180 dias ou 1 ano. Tudo passa pela lixeira antes e some de vez depois de 30 dias. | **Manter sempre** | | **Retenção** | **Favoritos** | Arquivos com estrela ficam, mesmo velhos. | Ligado | | **Retenção** | **Pastas protegidas** | Pastas (com tudo dentro) que a retenção nunca apaga. | Nenhuma | | **Envios** | **Tamanho máximo por arquivo** | O maior áudio ou vídeo que a equipe pode enviar pelo painel: 25, 50, 100 ou 250 MiB. Imagens vão até 20 MiB; a API de scripts, até 20 MiB. | 100 MiB | | **Envios** | **Formatos aceitos** | A lista dos formatos aceitos (só leitura). | — | | **Proteção** | **Só a cidade usa os arquivos** | Bloqueia outros sites de mostrar seus arquivos (e gastar seu tráfego). O jogo, a NUI e a loading screen sempre podem usar. | Desligado | | **Proteção** | **Sites liberados** | Domínios que também podem mostrar os arquivos, como `loja.suacidade.com.br` ou `*.suacidade.com.br`. Clique em **Liberar** para adicionar. Até 50. | Nenhum | | **Cache** | **Tempo em cache** | Por quanto tempo a CDN guarda cópias: 1 dia, 7 dias, 30 dias ou 1 ano. **Limpar cache** faz todo mundo ver a versão nova de um arquivo trocado com o mesmo nome. | 30 dias | | **Chaves de envio** | **Nova chave** | Chaves para scripts que enviam arquivos sozinhos. Veja [Chaves de envio](https://fivedash.fivex.gg/docs/pt/cdn/upload-keys). | Nenhuma | | **Zona de perigo** | **Apagar a CDN** | Tira do ar todos os arquivos, pastas, chaves e o endereço, e volta para a configuração inicial. | — | > As opções de **Imagens** valem para os próximos envios. Quando há processamento, a versão final substitui o original. Na **Retenção**, o rodapé mostra quantos arquivos vão para a lixeira na próxima limpeza (**Ver arquivos**); a limpeza é automática, ao longo do dia. ## Níveis de acesso O acesso é dado em **Configurações → Membros**, módulo **CDN**. | Área | Nível | O que permite | | ----------------- | -------------- | --------------------------------------------------------------- | | **Arquivos** | **Ver** | Ver os arquivos e copiar os links | | **Arquivos** | **Gerenciar** | Enviar, renomear, mover e mandar para a lixeira (e criar a CDN) | | **Arquivos** | **Configurar** | Também apagar para sempre e esvaziar a lixeira | | **Uso** | **Ver** | Espaço, tráfego e arquivos mais acessados | | **Configurações** | **Ver** | Endereço, otimização e chaves de envio | | **Configurações** | **Configurar** | Mudar a otimização, a proteção e criar chaves | ## Perguntas frequentes **Os arquivos são privados?** Não. Os links da CDN são públicos: quem tem o link abre o arquivo. A opção **Só a cidade usa os arquivos** (em **CDN → Configurações → Proteção**) impede outros sites de mostrar seus arquivos, mas o link continua público. **Dá para usar a CDN em scripts que tiram print?** Sim. Crie uma chave de envio e use no screenshot-basic ou por HTTP. Veja [Chaves de envio](https://fivedash.fivex.gg/docs/pt/cdn/upload-keys) e [Integrações](https://fivedash.fivex.gg/docs/pt/cdn/integrations). **Como apago a CDN inteira?** Em **CDN → Configurações → Zona de perigo**, clique em **Apagar a CDN** e confirme em **Apagar tudo**. Todos os arquivos, pastas, chaves e o endereço saem do ar na hora. Não dá para desfazer. Precisa de **Configurar** em **Arquivos** e em **Configurações**. ## Próximos passos [Enviar arquivos](https://fivedash.fivex.gg/docs/pt/cdn/upload-files)Envie, renomeie, mova e apague arquivos. [Chaves de envio](https://fivedash.fivex.gg/docs/pt/cdn/upload-keys)Deixe scripts enviarem arquivos sozinhos. [Uso e limites](https://fivedash.fivex.gg/docs/pt/cdn/usage-and-limits)Espaço, tráfego e franquias do plano. [Integrações](https://fivedash.fivex.gg/docs/pt/cdn/integrations)screenshot-basic, ox_inventory e HTTP.