Recupere espaço em disco do Synapse Media sem afetar os arquivos compartilhados.

Se o repositório de mídia do Synapse estiver preenchendo o disco, primeiro confirme qual diretório ou volume está crescendo e, em seguida, use as configurações de retenção suportadas pelo Synapse ou a API de administração para remover a mídia. Não exclua arquivos diretamente do diretório media_store: o Synapse mantém os metadados da mídia em seu banco de dados e a remoção de arquivos por trás do Synapse pode deixar referências quebradas ou dificultar a auditoria da limpeza. A política mais segura depende de se o espaço está sendo usado por uploads locais, mídia em cache de outros servidores domésticos, miniaturas ou outro serviço que compartilha o mesmo disco.

O que está ocupando o espaço?

O repositório de mídia do Synapse armazena avatares, anexos e miniaturas carregados localmente. Ele também armazena em cache mídias obtidas de servidores Matrix remotos e recursos usados ​​para pré-visualizações de URLs. Esses recursos são distintos do banco de dados do Synapse, dos logs do contêiner e de qualquer repositório de mídia externo. Um sistema de arquivos raiz completo não prova, por si só, que essa media_storeseja a causa.

No host ou dentro do contêiner que possui os dados montados, compare o uso do sistema de arquivos com o diretório de dados do Synapse. Substitua o caminho de exemplo pelo valor da sua implantação:

df -h
du -h --max-depth=1 /path/to/synapse-data
du -sh /path/to/synapse-data/media_store

media_store_pathO padrão do Synapse é usar o diretório `/etc/sysctl` media_store, geralmente localizado no diretório de dados, mas as instalações podem sobrescrevê-lo. Os contêineres podem gravar em um volume montado cujo armazenamento real esteja no host. Verifique o homeserver.yamlarquivo `/etc/sysctl`, os mapeamentos de volume do seu contêiner ou a configuração de volume persistente do seu orquestrador antes de concluir que é seguro alterar um caminho no host. Se o diretório de mídia não for o maior consumidor de memória, investigue o componente que duestá sendo exibido.

Escolha uma política de limpeza que se adeque à mídia.

Comportamento verificado: a configuração do Synapse media_retentionpode expirar mídias locais e mídias remotas em cache após períodos sem acesso. O acesso inclui carregar mídias em uma sala ou baixá-las. Se um item nunca foi acessado, o Synapse usa a data e hora de sua criação. Tanto a mídia original quanto suas miniaturas são removidas. A limpeza é executada no processo de trabalho do repositório de mídia, que pode ser o processo principal do Synapse.

Depende do seu caso de uso: arquivos armazenados em cache remotamente geralmente podem ser recuperados do servidor de origem quando solicitados após a remoção. Arquivos enviados localmente são hospedados pelo seu servidor, portanto, excluí-los pode tornar anexos ou avatares antigos indisponíveis. Escolha a retenção local somente se seus usuários aceitarem essa consequência; um tempo de vida local mais longo ou a ausência de limpeza local automática pode ser mais apropriado para uma comunidade que trata anexos antigos como um arquivo morto.

O que retenção não significa: colocar um arquivo em quarentena bloqueia o acesso, mas não exclui o arquivo nem suas miniaturas. Isso não liberará o espaço em disco necessário. Se você precisar preservar um item em quarentena enquanto remove outros dados, mantenha a distinção clara: quarentena é um controle de moderação, enquanto retenção e exclusão são controles de armazenamento.

Ative a retenção automática no Synapse.

Faça backup da configuração ativa antes de editá-la. Adicione uma media_retentionseção de nível superior ou atualize uma existente. Por exemplo, esta política expira a mídia local após 180 dias sem acesso e as entradas de cache remoto após 30 dias:

media_retention:
  local_media_lifetime: 180d
  remote_media_lifetime: 30d

Esses valores são exemplos, não recomendações universais. Defina o período local de acordo com suas obrigações de retenção e expectativas para conteúdo antigo da sala. Se você deseja controlar o cache apenas para mídia remota, configure apenas remote_media_lifetimeo período de retenção; um tempo de vida não definido ou nulo significa que esse tipo de mídia não será removido automaticamente. O Synapse também informa que mídias em quarentena e mídias locais protegidas contra quarentena são excluídas da limpeza de retenção.

Aplique a configuração usando o processo normal de reinicialização ou recarregamento da implantação e verifique se o worker do repositório de mídia está em execução enable_media_repo: true. Se o Synapse usar um worker de mídia separado, configure a política onde o serviço de repositório de mídia está habilitado. Uma edição válida de YAML não recupera imediatamente todo o espaço: o worker precisa executar a limpeza e somente as mídias mais antigas que o limite de acesso escolhido são consideradas.

Recupere espaço mais rapidamente com a API de administração.

Se o disco já estiver crítico, o Synapse oferece endpoints administrativos para limpeza. Essas ações removem permanentemente os arquivos de mídia. Antes de usá-las, faça backup do banco de dados e dos dados de mídia, confirme se a URL direciona para o seu próprio servidor doméstico e use um token de acesso de administrador do servidor via HTTPS. Mantenha o token fora do histórico do shell e dos logs compartilhados.

Para limpar o cache de mídias remotas antigas, chame o endpoint documentado com um timestamp limite em milissegundos desde a época Unix:

POST /_synapse/admin/v1/purge_media_cache?before_ts=<unix_timestamp_in_ms>

Por exemplo, um shell pode calcular um limite de 30 dias atrás com GNU date:

cutoff=$(date -u -d '30 days ago' +%s000)
curl -X POST "https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$cutoff" \
  -H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN"

A resposta informa quantos itens em cache foram excluídos. Se os usuários solicitarem esses arquivos remotos novamente, o Synapse os buscará novamente no servidor de origem; isso pode restaurar o uso de disco para mídias populares.

A API de exclusão de mídia local pode excluir arquivos de mídia locais com base na data do último acesso e, opcionalmente, em um tamanho mínimo. O endpoint atual é `localmediadelete` POST /_synapse/admin/v1/media/delete?before_ts=…; o endpoint antigo, que continha `localmediadelete`, <server_name>foi descontinuado desde o Synapse 1.78.0. O limite é a data do último acesso, não a data de upload, e a keep_profilesopção `limit` tem o valor padrão `true`. Como essa exclusão pode remover arquivos que os usuários esperam que permaneçam disponíveis, prefira a retenção configurada, a menos que você tenha definido um limite apropriado e aceite o efeito. Consulte a documentação oficial da API para obter informações sobre os parâmetros e a versão do Synapse instalada.

Conceitos errôneos comuns a evitar

  • "Excluir uma sala apagará seus arquivos de mídia." Não presuma isso. O histórico da sala, os arquivos de mídia e as cópias em cache são gerenciados por meio de operações diferentes. Use a API de administração de mídia ou a política de retenção para gerenciar a mídia especificamente.
  • "A quarentena libera espaço em disco." Não libera: mídias e miniaturas em quarentena permanecem no disco. Use uma operação de exclusão ou retenção quando o objetivo for recuperar espaço de armazenamento.
  • “Todos os arquivos de mídia no repositório são uploads dos meus usuários.” O repositório também inclui cache remoto e dados de pré-visualização de URLs. Compare os subdiretórios do repositório e a configuração de armazenamento do Synapse antes de optar por uma limpeza.
  • "Excluir arquivos manualmente é equivalente à limpeza feita pelo Synapse." Não é uma alternativa suportada. Deixe o Synapse atualizar seus metadados por meio do processo de retenção ou da API de administração.

Verifique se o uso do disco está diminuindo.

Após a conclusão da limpeza, verifique df -hnovamente o tamanho do diretório de mídia. Para uma limpeza via API, confirme a contagem de arquivos excluídos na resposta e compare o diretório relevante antes e depois. Verifique os logs do Synapse em busca de erros de configuração ou do worker. Se o diretório continuar grande, verifique se sua implantação grava a mídia em um provedor configurado ou em um volume separado; a API de exclusão de mídia local do Synapse não afeta a mídia armazenada em um repositório de mídia externo. Não presuma que uma resposta bem-sucedida da API reduzirá o sistema de arquivos do host se os arquivos estiverem localizados em outro lugar.

Referências oficiais

Deixar um comentário

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Diagnostique se o Synapse atingiu seu limite de arquivos abertos por processo, configure um comando systemd para o serviço ou worker correto e verifique o limite em tempo real.

O Element exibe a mensagem “Falha ao descriptografar”? Restaure a chave da sala perdida.

O Element exibe a mensagem “Falha ao descriptografar”? Restaure a chave da sala perdida.

Descubra se o erro está limitado a um navegador ou a um evento específico e, em seguida, use a chave de recuperação do Element ou um dispositivo confiável sem arriscar seu histórico criptografado restante.

Limpe mensagens e arquivos de mídia antigos do Synapse sem perder dados.

Utilize as APIs de limpeza de histórico e mídia do Synapse ou as configurações de retenção para remover dados obsoletos com segurança e, em seguida, verifique a conclusão e a recuperação do espaço em disco.

Crie um bot de eco do Matrix em Python com a biblioteca Simple-Matrix-Bot-Lib.

Crie um bot de eco do Matrix em Python com a biblioteca Simple-Matrix-Bot-Lib.

Instale a biblioteca atual, conecte uma conta Matrix dedicada e execute um pequeno bot !echo com gerenciamento de credenciais mais seguro e um teste claro.

Conecte o Matrix ao WhatsApp, Telegram e Discord com pontes separadas.

Conecte o Matrix ao WhatsApp, Telegram e Discord com pontes separadas.

Configure três bridges Mautrix com registros, logins e testes separados — e evite surpresas com a rede Docker, políticas de conta e sincronização.

Recupere espaço em disco do Synapse Media sem afetar os arquivos compartilhados.

Descubra o que está ocupando espaço no armazenamento do Synapse, defina um período seguro de retenção de mídia e limpe o cache remoto sem excluir arquivos diretamente do disco.

Desativar usuários inativos do Matrix sem excluir o histórico da sala.

Desativar usuários inativos do Matrix sem excluir o histórico da sala.

Analise a atividade do dispositivo, desative contas Synapse inativas confirmadas por meio da API de administração e saiba o que a opção de apagar realmente remove.

Reduza a pressão de memória do PostgreSQL no Matrix Synapse

Descubra se a memória usada pelo PostgreSQL provém de consultas, buffers compartilhados, conexões ou manutenção e, em seguida, faça alterações direcionadas e seguras para o Synapse.

Por que as conexões entre salas do Matrix Synapse estão lentas — e o que verificar

Por que as conexões entre salas do Matrix Synapse estão lentas — e o que verificar

Antes de alterar as configurações do Synapse, verifique se a lentidão na entrada de salas Matrix em um servidor remoto, o recuo da federação, a carga do banco de dados local ou a fila de remetentes de saída estão sendo afetados.

Encerrar cadastros na Matrix ou exigir tokens de convite no Synapse

Impeça a criação de contas abertas em um servidor Synapse auto-hospedado ou mantenha os cadastros apenas por convite com tokens de registro de uso limitado.