Execute um servidor doméstico Matrix leve no Raspberry Pi 4

Sim, um Raspberry Pi 4 pode executar o Conduit, e o projeto publica versões para ARM64. Para um pequeno servidor doméstico pessoal ou familiar, as escolhas de configuração mais importantes são um sistema operacional de 64 bits, um nome de servidor Matrix permanente, armazenamento persistente e roteamento HTTPS funcionando. O Conduit se descreve atualmente como beta, portanto, mantenha-o atualizado e não assuma que um Pi 4 tenha uma capacidade específica de usuários suportada; o projeto não publica um benchmark de capacidade para o Raspberry Pi 4.

O Conduit é a solução ideal para este Raspberry Pi?

O Conduit é um servidor doméstico Matrix leve com o RocksDB como banco de dados backend recomendado. Sua documentação oficial de implantação lista um aarch64binário e uma imagem OCI, que corresponde a uma instalação do sistema operacional Raspberry Pi de 64 bits. O changelog do projeto listava a versão v0.10.15, datada de 30 de setembro de 2026, quando verificado em 10 de outubro de 2026. A versão anterior, v0.10.14, corrigiu uma vulnerabilidade de acesso à conta e recomendou a atualização imediata. Esse histórico torna o monitoramento de atualizações parte da configuração, e não uma tarefa opcional posterior.

O site do Conduit ainda classifica o projeto como beta e observa que alguns recursos estão ausentes. Antes de escolhê-lo, verifique se o conjunto de recursos atual atende às suas necessidades, especialmente se você depende de bridges, administração avançada ou ampla compatibilidade com clientes. Um Raspberry Pi pode ser um host prático para uma pequena implantação, mas o tráfego, o uso de mídia e a atividade de federação afetam o desempenho. Comece com um grupo de usuários modesto e monitore o uso de memória, temperatura e armazenamento, em vez de confiar em uma quantidade de usuários prometida.

O que você deve decidir antes de instalar?

  • Escolha o nome do servidor Matrix. Neste exemplo, é matrix.example.org. Este domínio aparece nos IDs do Matrix dos usuários, como @alex:matrix.example.org. Escolha um domínio que você controle e planeje manter; alterá-lo posteriormente não é uma simples edição de nome de host.
  • Planeje o acesso público. Crie um registro DNS para o domínio apontando para o seu endereço IP público. Configure o encaminhamento de roteador e um proxy reverso com um certificado HTTPS válido. As diretrizes de implantação do Conduit exigem HTTPS e indicam que o tráfego de federação deve ser acessível nas portas 443 e/ou 8448, dependendo da sua configuração de descoberta e proxy.
  • Use o sistema operacional Raspberry Pi de 64 bits. Verifique a arquitetura com ` docker uname -mps`. Deverá retornar `<nome_da_arquitetura>` aarch64. O guia atual do Docker para Raspberry Pi observa que as futuras versões principais do Docker Engine não fornecerão mais pacotes para o sistema operacional Raspberry Pi de 32 bits; em ARM de 64 bits, ele direciona os usuários para arm64as instruções de instalação do Debian.
  • Mantenha o banco de dados persistente. Armazene os dados do Conduit em um diretório persistente ou volume Docker e inclua-o em um plano de backup testado. Não armazene a única cópia na camada gravável de um contêiner ou em um cartão removível que possa ser formatado.

Como iniciar o Conduit com o Docker?

Instale o Docker Engine e o plugin Compose seguindo as instruções para a versão do seu sistema operacional Raspberry Pi. Em seguida, confirme se o Docker está em execução. A documentação do Conduit lista a imagem estável do Docker Hub registry.gitlab.com/famedly/conduit/matrix-conduit:lateste as imagens OCI ARM64. Baixe a imagem estável e verifique se o Docker selecionou uma imagem ARM64.

docker image pull registry.gitlab.com/famedly/conduit/matrix-conduit:latest
docker image inspect registry.gitlab.com/famedly/conduit/matrix-conduit:latest \
  --format '{{.Architecture}}'

Continue somente se a arquitetura relatada corresponder ao seu sistema operacional de 64 bits. Crie um diretório de trabalho e um arquivo Compose:

mkdir -p ~/matrix-conduit/data
cd ~/matrix-conduit
nano compose.yaml

Use esta configuração como ponto de partida. Ela pressupõe que o proxy reverso esteja em execução no host Raspberry Pi e encaminhe as solicitações do Matrix para a porta 6167. Substitua o nome do servidor de exemplo. O parâmetro vazio CONDUIT_CONFIGindica ao contêiner que utilize variáveis ​​de ambiente, conforme exigido pelas instruções atuais do Conduit Docker para esta configuração.

services:
  conduit:
    image: registry.gitlab.com/famedly/conduit/matrix-conduit:latest
    container_name: conduit
    restart: unless-stopped
    ports:
      - "127.0.0.1:6167:6167"
    volumes:
      - ./data:/var/lib/matrix-conduit
    environment:
      CONDUIT_CONFIG: ""
      CONDUIT_SERVER_NAME: "matrix.example.org"
      CONDUIT_ADDRESS: "0.0.0.0"
      CONDUIT_PORT: "6167"
      CONDUIT_DATABASE_BACKEND: "rocksdb"
      CONDUIT_ALLOW_REGISTRATION: "true"
      CONDUIT_REGISTRATION_TOKEN: "${CONDUIT_REGISTRATION_TOKEN}"
      CONDUIT_ALLOW_FEDERATION: "true"
      CONDUIT_TRUSTED_SERVERS: '["matrix.org"]'

Crie um arquivo de token de registro privado e inicie o serviço:

umask 077
printf 'CONDUIT_REGISTRATION_TOKEN=%s\n' "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose logs --tail=100 conduit

O token é necessário para registrar sua primeira conta; o Conduit torna o primeiro usuário criado o administrador do servidor. Mantenha o .envarquivo privado e não o publique em um repositório público. O exemplo vincula o Conduit à interface de loopback do Raspberry Pi, portanto, ele só é acessível por meio de um proxy reverso executado no mesmo host. Se o seu proxy estiver em outro contêiner ou em outra máquina, use uma rede Docker privada ou uma interface privada protegida em vez de expor a porta 6167 publicamente.

Como tornar o servidor acessível e seguro?

Configure seu proxy reverso para servir o domínio via HTTPS e encaminhar as solicitações do cliente Matrix e da federação — incluindo /_matrix/as de autenticação e /.well-known/matrix/de requisição — para o Conduit. A configuração pública mais simples depende do seu proxy e se a federação usa a porta 8448 ou a descoberta delegada na porta 443. Siga o exemplo correspondente na documentação de implantação do Docker do Conduit; não copie um trecho de código de proxy sem adaptar seus nomes de host, tratamento de certificados e caminhos de rede.

Se você usar o mesmo domínio para o server_nameservidor e para a URL do servidor doméstico, certifique-se de que os clientes consigam acessar o endpoint HTTPS anunciado. Se o Conduit estiver hospedado em um subdomínio separado do domínio do ID da Matrix, configure ambos /.well-known/matrix/clientconforme /.well-known/matrix/serverdescrito no guia de delegação. Abrir uma porta por si só não configura a descoberta ou o TLS.

Registre sua conta de administrador imediatamente com um cliente Matrix que suporte tokens de registro. Em seguida, desative o registro aberto, a menos que você queira intencionalmente que outros criem contas. No Compose, altere CONDUIT_ALLOW_REGISTRATIONpara "false", remova o token de registro do ambiente de serviço e recrie o contêiner com docker compose up -d. Seu diretório de dados montado por bind permanece intacto. Verifique quem pode acessar o socket do Docker e os arquivos de configuração do Raspberry Pi, pois essas pessoas podem revelar ou alterar segredos do servidor.

Como posso confirmar se a configuração funciona?

Verifique a API do cliente Matrix local através do nome de host HTTPS público:

curl -fsS https://matrix.example.org/_matrix/client/versions

Uma resposta JSON confirma que a API do cliente está acessível; ela não comprova que a federação está funcionando. Execute o Matrix Federation Tester oficial para o nome do seu servidor e corrija quaisquer .well-knownerros de DNS, TLS, encaminhamento de portas ou outros que ele reportar. Por fim, faça login com sua nova conta, confirme se ela possui acesso de administrador e teste uma mensagem em uma sala com um usuário em outro servidor doméstico, caso a federação faça parte do seu objetivo.

Os detalhes técnicos acima foram verificados nas páginas oficiais do Conduit sobre Docker, configuração, delegação e histórico de alterações em 10 de outubro de 2026. Consulte o guia de implantação do Conduit no Docker , o guia de implantação para binários ARM64 e genéricos , a referência de configuração , o guia de delegação , o histórico de alterações do Conduit e as notas de instalação do Docker no Raspberry Pi OS para obter detalhes que podem variar de acordo com a versão.

Deixar um comentário

Restaure o Matrix Synapse com segurança usando um dump do PostgreSQL.

Faça backup do Synapse com pg_dump, proteja sua chave de assinatura e mídia e restaure-o em um banco de dados PostgreSQL limpo, sem reutilizar chaves de uso único obsoletas.

Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

Configure o Mjölnir com uma conta Matrix dedicada, sala de gerenciamento criptografada, Docker Compose, lista de políticas e verificações de permissão.

Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

Ignore o proxy descontinuado e configure a Sincronização Deslizante integrada do Synapse. Verifique a descoberta de clientes e, em seguida, meça o carregamento da lista de salas e o comportamento de reconexão em um telefone compatível.

Hospedagem de elementos web no Nginx com um servidor doméstico personalizado

Implante o Element Web como um site estático, aponte-o para o seu servidor Matrix, adicione HTTPS e configure o Nginx para servir atualizações sem arquivos obsoletos.

Execute um servidor doméstico Matrix leve no Raspberry Pi 4

Configure o Conduit em um Raspberry Pi 4 de 64 bits com dados persistentes, federação HTTPS, registro protegido e verificações para um servidor doméstico em funcionamento.

Configure um alias personalizado para a sala Matrix em seu próprio domínio.

Atribua um endereço fácil de compartilhar a uma sala do Matrix em seu domínio usando o Element ou a API do Matrix, com verificações de permissões, nomenclatura Synapse e federação.

Configure o Coturn para chamadas de voz e vídeo confiáveis ​​no Remake Matrix.

Configure o coturn e o Synapse com credenciais TURN correspondentes, abra as portas de retransmissão necessárias e verifique se os clientes Matrix conseguem obter candidatos de retransmissão.

Implante o Matrix Synapse com Docker Compose e PostgreSQL.

Implante o Matrix Synapse com Docker Compose e PostgreSQL.

Configure um servidor doméstico Synapse persistente com Docker Compose, PostgreSQL, uma configuração privada e verificações antes de expô-lo via HTTPS.

Personalize o tema e a identidade visual do Element Web.

Defina um nome de marca, cores personalizadas e recursos de login para sua implementação do Element Web, entendendo quais partes permanecerão com a marca Element.

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.