CDN
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.
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.
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.
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.
Em Endereço da CDN, digite o endereço (o padrão é minha-cidade). O FiveDash mostra Livre ou Em uso. Clique em Continuar.
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.
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.
| 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 |
Todo arquivo tem um link público neste formato:
https://cdn.fivex.sh/<endereco>/<pasta>/<arquivo>
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).
| 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.”) |
| 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.
| 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. |
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/<endereco>. 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. | 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. | 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. | — |
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 |
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 e Integrações.
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.