Compreendendo uploads, imagens e anexos

:bookmark: Este guia fornecerá aos administradores instruções abrangentes sobre como carregar imagens e anexos em seu site Discourse.

:person_raising_hand: Nível de usuário necessário: Administrador

O Discourse oferece suporte robusto para uploads, imagens e anexos, permitindo que os usuários enriqueçam suas postagens e compartilhem arquivos com outras pessoas. Compreender como os uploads, imagens e anexos funcionam no Discourse pode ajudá-lo 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 postagens.

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.

image

No entanto, se outros tipos de arquivo forem permitidos, o ícone de upload aparecerá como um ícone de upload geral.

image

O Discourse também suporta o upload e incorporação de imagens 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 no fórum, o Discourse salva o arquivo na pasta /var/discourse/shared/standalone/uploads/default/ do servidor.

Tipos de Arquivo Permitidos

Por padrão, o Discourse permite tipos de arquivo de imagem (jpg, jpeg, png, gif, heic, heif, webp e avif).

Os administradores também podem adicionar mais extensões de arquivo às configurações do site authorized extensions e authorized extensions for staff para permitir outros tipos de arquivos, como .pdf, .docx, .mp3, etc.

:person_tipping_hand: Remover todos os tipos de arquivo da lista de authorized extensions desativará os uploads em seu site. Se você não quiser armazenar uploads no servidor do seu site, pode desativá-los, instruir seus usuários a publicar uploads apenas em sites externos e, em seguida, compartilhar os links para os uploads em seu site.

Tamanhos de Arquivo Permitidos

O tamanho máximo padrão para imagens é definido em 4096 kB (4 MB). Esse limite pode ser ajustado alterando a configuração do site max image size kb com base nas necessidades de sua comunidade.

O tamanho máximo padrão para uploads que não são de imagem é definido em 8192kB (8 MB). Esse limite pode ser ajustado modificando a configuração do site max attachment size kb.

:person_tipping_hand: O tamanho máximo em kb para ambas essas configurações é 30720 kB / 30 MB.

Arquivos Grandes

Se você estiver compartilhando muitos arquivos ou arquivos muito grandes regularmente, recomendamos que você use o Google Drive, Dropbox ou outro serviço de compartilhamento de arquivos na 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 resumida.

Excluindo Uploads

Não há 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 obter detalhes adicionais sobre como excluir uploads em seu site.

Uploads de Arquivos e Armazenamento S3

:discourse: A seção a seguir é aplicável apenas para instalações #self-hosted e sites hospedados Enterprise.

O Discourse permite que você configure provedores de Armazenamento de Objetos 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 escolher armazenar esses backups no S3. No entanto, se você estiver usando S3 para uploads e backups, pode precisar considerar o impacto nos custos de largura de banda e 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 seu Discourse, que cobre o uso de S3: Enable a CDN for your Discourse.

Uploads Seguros

O Discourse tem um recurso chamado “Secure Uploads” que restringe o acesso a arquivos carregados 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 acessível publicamente.

Para usar este recurso, você deve ter uploads S3 habilitados em 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 de sua configuração, impactar potencialmente o desempenho do site e aumentar o tamanho de seus backups.

Para saber mais sobre como habilitar uploads seguros em seu site, consulte: Secure Uploads


Tópicos Adicionais

9 curtidas

Olá. Tenho várias perguntas:

  1. As imagens são armazenadas em uma pasta ou são organizadas em pastas por data, como no WordPress?
  2. Ao excluir um tópico, as imagens e anexos desse tópico também são excluídos?
1 curtida

Essa é uma boa pergunta. Elas são armazenadas como um hash do arquivo, então o mesmo arquivo enviado duas vezes (mesmo com nomes diferentes) terá apenas uma cópia. Isso deve ser adicionado ao OP.

Acredito que isso foi abordado.

4 curtidas

É possível fazer upload de arquivos grandes automaticamente para um serviço de compartilhamento de arquivos na nuvem para que o usuário não precise fazer nada?

Se eu usar o S3, é possível fazer upload de arquivos grandes diretamente?

2 curtidas

Eu também tenho essa ideia, estou tentando desenvolver um plugin de upload de arquivos grandes. Ele será carregado diretamente no serviço de compartilhamento de arquivos na nuvem.

2 curtidas

Algum progresso na atualização?
-James

1 curtida