Este guia fornecerá aos administradores instruções abrangentes sobre como carregar imagens e anexos no site do Discourse.
Nível de usuário necessário: Administrador
Discourse oferece suporte robusto para uploads, imagens e anexos, permitindo que os usuários enriqueçam suas postagens e compartilhem arquivos com outras pessoas. Entender como funcionam os uploads, imagens e anexos no Discourse pode ajudar você a gerenciar melhor sua comunidade e proporcionar uma melhor experiência ao usuário.
Carregando Arquivos e Imagens
No Discourse, os usuários podem carregar arquivos e imagens diretamente em suas postagens usando o botão de upload no editor de postagem.
O ícone do botão de upload muda dependendo dos tipos de upload permitidos. Se apenas tipos de arquivo de imagem forem permitidos, o ícone de upload aparecerá como um ícone de imagem.
No entanto, se outros tipos de arquivo forem permitidos, o ícone de upload aparecerá como um ícone de upload geral.
O Discourse também oferece suporte ao upload de imagens incorporadas de outros sites e, quando uma imagem é carregada, o Discourse cria vários tamanhos da imagem, que são usados em diferentes contextos no site.
Toda vez que um usuário carrega um novo arquivo para o fórum, o Discourse salva o arquivo na pasta do servidor /var/discourse/shared/standalone/uploads/default/.
Tipos de Arquivo Permitidos
Por padrão, o Discourse permite tipos de arquivo de imagem (jpg, jpeg, png, gif, heic, heif, webp, avif e svg).
Os administradores também podem adicionar mais extensões de arquivo às configurações do site authorized extensions (extensões autorizadas) e authorized extensions for staff (extensões autorizadas para a equipe) para permitir outros tipos de arquivos, como .pdf, .docx, .mp3, etc.
Remover todos os tipos de arquivo da lista de
authorized extensionsdesabilitará os uploads no seu site. Se você não quiser armazenar uploads no servidor do seu site, você pode desabilitá-los, instruir seus usuários a publicar uploads apenas em sites externos e, em seguida, compartilhar os links para os uploads no seu site.
Tamanhos de Arquivo Permitidos
O tamanho máximo padrão para imagens é definido como 10240 kB (10 MB). Esse limite pode ser ajustado alterando a configuração do site max image size kb com base nas necessidades da sua comunidade.
O tamanho máximo padrão para uploads que não são de imagem é definido como 10240 kB (10 MB). Esse limite pode ser ajustado modificando a configuração do site max attachment size kb.
max image size kbé102400 kB(100 MB). O valor máximo paramax attachment size kbé1024000 kB(~1000 MB).Se você for um cliente hospedado, o máximo para ambas as configurações é de 30 MB. Clientes Enterprise têm mais flexibilidade. Entre em contato com a equipe de suporte se você tiver um plano Enterprise e precisar explorar suas opções.
Arquivos Grandes
Se você compartilha muitos arquivos ou arquivos muito grandes regularmente, recomendamos que use o Google Drive, Dropbox ou outro serviço de compartilhamento de arquivos em nuvem. Você também pode usar um serviço de streaming como YouTube ou SoundCloud para hospedar seus arquivos de mídia grandes. Em seguida, você pode obter um link de lá e colá-lo em sua postagem. Insira o link em sua própria linha, cercado por linhas vazias, para exibir o arquivo em um reprodutor de mídia, se suportado, ou uma prévia de resumo.
Excluindo Uploads
Nenhuma interface de gerenciamento de arquivos é fornecida no Discourse. Para remover arquivos, exclua as postagens que os contêm ou edite as postagens para remover os links de anexo. Arquivos órfãos serão removidos automaticamente após um período de carência de 48 horas.
Consulte Cleaning up Uploads and Purging Uploads from S3 para detalhes adicionais sobre a exclusão de uploads no seu site.
Uploads de Arquivos e Armazenamento S3
A seção a seguir é aplicável apenas para instalações #self-hosted
A seção a seguir é aplicável apenas para instalações O Discourse permite que você configure provedores de Object Storage compatíveis com S3 para armazenar uploads.
Você pode seguir estes guias sobre como configurar uploads de arquivos e imagens para S3 ou configurar um provedor de armazenamento de objetos compatível com S3 para uploads: Setting up file and image uploads to S3 e Configure an S3 compatible object storage provider for uploads.
Uploads S3 e Backups do Site
Se você estiver usando S3 para uploads, talvez queira considerar como isso afeta sua estratégia de backup. O Discourse permite que você configure backups automáticos e você pode optar por armazenar esses backups no S3. No entanto, se você estiver usando S3 para uploads e backups, talvez precise considerar o impacto na largura de banda e nos custos de armazenamento. Para mais informações, confira este tópico: Configure automatic backups for Discourse.
Uploads S3 e CDNs
Se você estiver usando uma CDN em conjunto com uploads S3, precisará garantir que ela esteja configurada corretamente. O Discourse tem um guia sobre como habilitar uma CDN para o seu Discourse, que abrange o uso de S3: Enable a CDN for your Discourse.
Uploads Seguros
O Discourse tem um recurso chamado “Secure Uploads” (Uploads Seguros) que restringe o acesso a arquivos enviados para que apenas usuários com as permissões necessárias possam visualizar ou baixar os arquivos. Isso é particularmente útil para comunidades privadas ou para conteúdo que não deve ser publicamente acessível.
Para usar este recurso, você deve ter uploads S3 habilitados no seu site e seu bucket S3 não deve ter uma política de bucket pública. Todos os uploads existentes devem ter um ACL S3 de leitura pública.
No entanto, habilitar uploads seguros pode aumentar a complexidade da sua configuração, impactar potencialmente o desempenho do site e aumentar o tamanho dos seus backups.
Para saber mais sobre como habilitar uploads seguros no seu site, consulte: Secure Uploads
Tópicos Adicionais