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