Para receber alertas confiáveis do Element para Android sem os serviços do Google, instale a versão do Element para F-Droid e um distribuidor UnifiedPush, como o ntfy, e selecione esse distribuidor no Element. Em um servidor Matrix auto-hospedado, a rota de notificação também deve alcançar um gateway push compatível — o ntfy fornece um gateway Matrix, seja por meio de seu serviço público ou de um servidor hospedado por você. Sem um distribuidor, a versão para F-Droid pode usar polling em segundo plano, mas o Android pode atrasar essa alternativa quando o aplicativo estiver ocioso.
Entenda o caminho de notificação
O Matrix Push funciona em cadeia: o Synapse envia uma solicitação de notificação para um gateway push; o gateway a retransmite para um aplicativo distribuidor no telefone; o distribuidor ativa o Element para que ele possa processar o evento e exibir uma notificação do Android. Uma falha em qualquer etapa pode se manifestar como "As notificações do Element estão com problemas". A instalação de um novo servidor doméstico não fornece, por si só, um distribuidor push para o telefone.
A documentação do projeto Element Android distingue as versões do aplicativo. A versão para Google Play usa um distribuidor FCM embutido por padrão quando nenhum outro distribuidor é selecionado. A versão para F-Droid exclui essa biblioteca dependente do Google; se nenhum distribuidor compatível estiver instalado, ela usa polling. Ambas as versões suportam um distribuidor UnifiedPush externo quando o recurso está habilitado e o usuário opta por usá-lo. Para um telefone sem os serviços do Google, F-Droid com ntfy é a opção mais simples documentada.
Nesta configuração, o ntfy desempenha duas funções: seu servidor é um gateway push compatível com Matrix e seu aplicativo Android é o distribuidor do UnifiedPush. Essas funções estão relacionadas, mas são distintas. Você pode usar o serviço público do ntfy para uma configuração mais simples ou operar um servidor ntfy se desejar controlar a infraestrutura do gateway. Hospedar o servidor doméstico do Matrix por conta própria não exige que você também hospede o ntfy por conta própria.
Configure o Element com um distribuidor UnifiedPush.
- Instale a versão do Element para Android disponível no F-Droid. Use uma versão atualizada do repositório do F-Droid. Se você já tiver o Element instalado de outra fonte, verifique a origem e a versão do aplicativo antes de alterar as configurações de notificação; a versão da Play Store pode selecionar o FCM por padrão.
- Instale o ntfy a partir de uma fonte disponível no seu dispositivo. O guia oficial do UnifiedPush lista o F-Droid e o download direto como opções. Abra o ntfy e conceda permissão de notificação do Android. Nas configurações do ntfy, use o servidor público padrão para um teste rápido ou insira o URL do seu próprio servidor HTTPS ntfy.
- Escolha ntfy no Element. Inicie sessão na sua conta Matrix. Quando o Element oferecer uma opção de serviço de notificações, selecione ntfy. Se você ignorou a mensagem ou ela não apareceu, abra as configurações de notificações do Element e a tela de solução de problemas de notificações; os nomes exatos podem variar de acordo com a versão do aplicativo. Certifique-se de que o serviço de notificações esteja ativado para a conta e que o distribuidor esteja selecionado.
- Permita que ambos os aplicativos sejam executados em segundo plano. Nas configurações de aplicativos do Android, permita as notificações para Element e ntfy. Defina o uso da bateria ou a atividade em segundo plano como irrestrita para ambos, se o seu dispositivo oferecer essa opção. Os fabricantes de dispositivos usam nomes diferentes e podem adicionar seus próprios controles de suspensão de aplicativos; portanto, verifique as configurações de bateria do telefone se a entrega parar somente depois que a tela for desligada.
Por exemplo, se um Fairphone ou um dispositivo Android sem serviços do Google receber mensagens apenas enquanto o Element estiver aberto, instale o distribuidor ntfy e selecione-o primeiro no Element. Em seguida, teste novamente com o Element em segundo plano. Se as notificações ainda falharem, verifique se o próprio ntfy recebe uma mensagem de teste antes de alterar as configurações do Synapse.
Verifique o gateway de push auto-hospedado
Se você executar seu próprio servidor ntfy, ele deverá ser acessível via HTTPS tanto pelo Synapse quanto pelos telefones, e seu gateway Matrix deverá estar configurado. O guia Element atual usa o endpoint de exemplo https://ntfy.example.com/_matrix/push/v1/notify. Abra a URL correspondente ao seu domínio em um navegador; um gateway Matrix ntfy configurado deverá retornar uma resposta indicando [inserir URL aqui] . Caso contrário, {"unifiedpush":{"gateway":"matrix"}}confirme o DNS, a confiança no certificado TLS, as regras do firewall e as configurações do servidor ntfy .base-url
Por padrão, o Synapse bloqueia solicitações de saída para intervalos de IP privados. Se o seu servidor NTfy estiver acessível apenas em um endereço privado, as orientações de solução de problemas do UnifiedPush recomendam permitir o IP do servidor push, conforme o Synapse o vê. Adicione apenas o endereço específico na ip_range_whitelistconfiguração de nível superior em homeserver.yaml, por exemplo:
ip_range_whitelist:
- '192.168.1.20'
Use o endereço do seu gateway real, não este exemplo. Esta exceção permite que o Synapse faça solicitações de saída para esse endereço e deve ser mantida o mais restrita possível, de acordo com as limitações da sua rede. Reinicie o Synapse após alterar a configuração. Se você já utiliza um proxy HTTP, observe que o Synapse indica que a configuração do intervalo de IP é ignorada quando um proxy está em uso.
Encontre o elo defeituoso com um teste controlado.
- Primeiro, teste o distribuidor. Envie uma notificação de teste para um tópico através do seu servidor NTfy e confirme se ela aparece no telefone. Caso contrário, solucione problemas de conectividade NTfy, permissão de notificação do Android ou restrições de bateria antes de investigar o Matrix.
- Execute a ferramenta de solução de problemas de notificações do Element. As verificações podem ajudar a mostrar se um distribuidor foi detectado e se o Element registrou notificações push. Se o teste for aprovado na camada ntfy, mas não para eventos Matrix, inspecione os logs do Synapse e confirme se o servidor doméstico consegue acessar a URL do gateway ntfy.
- Envie uma mensagem Matrix enquanto o Element estiver fechado. Use outro aplicativo para enviar a mensagem para a conta conectada no celular. Uma notificação bem-sucedida confirma a rota de ponta a ponta. Se a notificação chegar somente após reabrir o Element, verifique as restrições de execução em segundo plano e a seleção do serviço de notificação do aplicativo.
Não trate polling e push como idênticos. O polling pode ser útil como alternativa quando nenhum distribuidor estiver instalado, mas pode consumir mais recursos em segundo plano e apresentar menor frequência devido ao gerenciamento de energia do Android. Se alertas imediatos forem importantes, teste com o Element fechado e a tela desligada e, em seguida, ajuste as configurações de segundo plano do dispositivo ou o caminho do servidor push com base na falha do teste.
Referências oficiais