Independent testing Updated April 2026 387 self-hosting guides 5 VPS providers tested

guide

Como Auto-Hospedar Matrix (Synapse) em um VPS (Guia Completo)

Aprenda passo a passo como hospedar seu próprio Matrix Synapse em um VPS com este guia completo. Ideal para desenvolvedores e entusiastas de homelab.

Auto-hospedar o Matrix Synapse em um VPS pode parecer desafiador, mas com este guia detalhado, você terá sua própria configuração de comunicação Matrix em pouco tempo. Este guia cobre os passos essenciais para instalar e configurar o Synapse usando um VPS, com foco na facilidade de compreensão para desenvolvedores e entusiastas de homelab.

O Que Você Precisa

Antes de começar, certifique-se de ter:

Opções Recomendadas de VPS

Provedor de VPSPreço (por mês)FuncionalidadesLink
Contabo VPS5,99 EUR8 GB RAM, 200 GB SSDContabo
Hetzner Cloud4,15 EUR2 GB RAM, 20 GB SSDHetzner
DigitalOcean6 USD1 GB RAM, 25 GB SSDDigitalOcean
Vultr6 USD1 GB RAM, 25 GB SSDVultr
Linode5 USD1 GB RAM, 25 GB SSDLinode

Para uma comparação mais abrangente, confira a comparação completa de VPS.

Passo 1: Configurar Seu VPS

  1. Crie uma conta com o provedor de VPS escolhido.

  2. Provisionar uma nova instância de VPS. Para Matrix Synapse, é recomendado um servidor com pelo menos 2 GB de RAM.

  3. Acesse seu VPS via SSH:

    ssh root@seu-ip-do-vps
  4. Atualize seu sistema:

    sudo apt update && sudo apt upgrade -y

Passo 2: Instalar as Dependências Necessárias

Instale os pacotes necessários para rodar o Matrix Synapse:

sudo apt install python3-pip python3-dev libjpeg-dev libssl-dev libpq-dev postgresql postgresql-contrib -y

Passo 3: Instalar o Matrix Synapse

  1. Instale o Synapse usando pip:

    sudo pip3 install matrix-synapse
  2. Crie um arquivo de configuração:

    sudo synapse_homeserver_setup

    Siga os prompts para configurar seu homeserver, inserindo seu domínio, nome do servidor e outras informações relevantes.

  3. Crie um arquivo de serviço systemd: Crie um arquivo em /etc/systemd/system/matrix-synapse.service com o seguinte conteúdo:

    [Unit]
    Description=Servidor Matrix Synapse
    After=postgresql.service
    
    [Service]
    ExecStart=/usr/local/bin/synapse_homeserver
    User=seu_usuario
    Group=seu_grupo
    
    [Install]
    WantedBy=multi-user.target
  4. Inicie e ative o serviço:

    sudo systemctl start matrix-synapse
    sudo systemctl enable matrix-synapse

Passo 4: Configurar Seu Domínio e SSL

  1. Aponte seu domínio para seu VPS: Atualize as configurações DNS do seu domínio para apontar para o IP do VPS.

  2. Instale o Certbot para SSL:

    sudo apt install certbot python3-certbot-nginx -y
  3. Gere certificados SSL:

    sudo certbot certonly --standalone -d seu-dominio.com
  4. Configure o Nginx: Crie um arquivo em /etc/nginx/sites-available/matrix com o seguinte conteúdo e crie um link em /etc/nginx/sites-enabled/:

    server {
      listen 443 ssl;
      server_name seu-dominio.com;
    
      ssl_certificate /etc/letsencrypt/live/seu-dominio.com/fullchain.pem;
      ssl_certificate_key /etc/letsencrypt/live/seu-dominio.com/privkey.pem;
    
      location / {
        proxy_pass http://localhost:8008;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      }
    }
  5. Testar e reiniciar o Nginx:

    sudo nginx -t
    sudo systemctl restart nginx

Passo 5: Acessar Seu Servidor Matrix Synapse

Assim que seu servidor estiver rodando e o Nginx configurado, você pode acessar seu Matrix Synapse em https://seu-dominio.com.

FAQs

1. Quais são os requisitos de sistema para rodar o Matrix Synapse?
Para rodar o Matrix Synapse de forma eficiente, recomenda-se que seu VPS tenha pelo menos 2 GB de RAM, uma CPU confiável e uma solução de armazenamento adequada, como SSD. Assim, o servidor consegue lidar com múltiplas conexões e operações necessárias para uma experiência suave. Uma instalação básica pode rodar com configurações menores, mas o desempenho pode diminuir conforme o uso aumenta, principalmente com muitos usuários simultâneos.

2. Como faço backup dos dados do Matrix Synapse?
Fazer backup da sua instalação do Matrix Synapse envolve, principalmente, fazer backup do banco de dados PostgreSQL, além das configurações do homeserver. Você pode criar backups regulares do banco com comandos como pg_dump. Além disso, certifique-se de salvar as configurações em /etc/matrix-synapse/. Configurar tarefas de cron para backups automáticos também é recomendado.

3. Posso rodar Matrix em um container Docker em um VPS?
Sim, rodar o Matrix Synapse em um container Docker é uma opção popular para implantação. O Docker facilita a gestão e escalabilidade da aplicação. Você pode encontrar imagens oficiais e instruções detalhadas na documentação do Docker do Matrix Synapse. O processo envolve puxar a imagem, configurar variáveis de ambiente para o homeserver e executar containers com armazenamento persistente para continuidade dos dados.

Seguindo os passos deste guia, você poderá hospedar seu próprio Matrix Synapse com confiança no VPS de sua escolha, gerenciando suas necessidades de comunicação de forma eficaz. Aproveite seu novo servidor Matrix configurado!