Sem KYC · e-mail opcional · pague em Monero, Bitcoin ou USDT
Idioma: Português
Implantar um VPS

Guia · Hospedagem própria · verificado em 2026-11-10

Como hospedo um servidor Matrix em uma VPS?

Matrix é um protocolo de chat aberto, e o Synapse é o seu servidor de referência. Este guia instala o Synapse a partir dos pacotes Debian do projeto e coloca um proxy reverso à frente dele.

Última atualização: · 7 min de leitura

Resposta rápida

Como hospedo um servidor Matrix em uma VPS?

Para hospedar um servidor Matrix em uma VPS, instale o Synapse a partir do repositório apt da Matrix.org, dê a ele um banco PostgreSQL e coloque um proxy reverso HTTPS na porta 443 à frente da sua porta 8008. O plano Gloam da Gloamport, 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic a $8.25 por mês no período de 12 meses, é dimensionado para isso.

O que envolve a instalação do Synapse?

ParteConfiguraçãoPor quê
Nome do servidorO domínio nos IDs de usuário, por exemplo example.com; não pode ser alterado depoisIdentidade de federação
Pacotematrix-synapse-py3 a partir de packages.matrix.orgO pacote próprio do Debian não está disponível para Debian 13 e versões anteriores
Substituições de configuração/etc/matrix-synapse/conf.d/Atualizações de pacote não perguntam se devem substituir sua configuração
Listener de cliente e de federaçãoHTTP em localhost:8008 atrás de um proxyO proxy encerra o HTTPS
Banco de dadosPostgreSQL (psycopg2)A documentação diz que o SQLite é aceitável apenas para testes
Portas443 para clientes; 8448 para federação, a menos que seja delegada ao 443As duas precisam estar acessíveis pela internet
PlanoGloam: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB trafficLista de planos da Gloamport

Preços verificados em

O que você precisa antes de instalar um servidor Matrix?

Você precisa de um nome de domínio que controle e de uma VPS com endereço IPv4 público. O domínio importa mais que o servidor: a documentação do Synapse diz que o nome do servidor é a parte do domínio de todo ID de usuário e que ele não pode ser alterado depois. Escolha-o antes de instalar.

Toda VPS da Gloamport vem com um IPv4 e um IPv6 /64 em qualquer plano, então os registros DNS podem apontar diretamente para ela. Um domínio não é vendido aqui; compre-o onde preferir e crie um registro A para o nome de host que você vai usar. Apenas Linux: imagens Debian, Ubuntu, AlmaLinux e Rocky Linux. Sem Windows. Reserve cerca de uma hora para o DNS e o certificado, além da própria instalação.

Como instalar o Synapse no Debian 13 ou no Ubuntu 24.04

Os comandos seguem a documentação oficial do Synapse. Execute-os como root ou com sudo.

  1. Aponte o DNS para a VPS

    Crie um registro A para matrix.example.com com o endereço da VPS (e um registro AAAA se você usar IPv6). Aguarde até que ele resolva antes de pedir um certificado.

  2. Adicione o repositório apt da Matrix.org

    Baixe a chave de assinatura, adicione a linha do repositório e execute apt update, como no primeiro bloco de código. A documentação informa a impressão digital da chave AAF9AE843A7584B5A3E4CD2BCF45A512DE2DA058; compare-a com o gpg antes de confiar na chave.

  3. Instale o matrix-synapse-py3

    Execute apt install matrix-synapse-py3 e defina o nome do servidor quando solicitado. Altere as configurações apenas por meio de arquivos em /etc/matrix-synapse/conf.d/.

  4. Crie o banco de dados PostgreSQL

    Instale o PostgreSQL e a biblioteca libpq5, depois crie o usuário e o banco com os comandos do segundo bloco de código e aponte o Synapse para ele com o bloco de banco de dados mostrado ali.

  5. Coloque um proxy reverso à frente

    Instale um servidor web, obtenha um certificado para o nome de host e encaminhe /_matrix e /_synapse/client para localhost:8008, como no terceiro bloco de código. Defina x_forwarded: true no listener da porta 8008.

  6. Crie seu usuário e teste

    Defina um registration_shared_secret, reinicie o Synapse, execute register_new_matrix_user e depois entre por um cliente Matrix com o endereço do seu homeserver.

1. Repositório e pacote da Matrix.org
sudo apt install -y lsb-release wget apt-transport-https
sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" |
    sudo tee /etc/apt/sources.list.d/matrix-org.list
sudo apt update
sudo apt install matrix-synapse-py3
2. PostgreSQL: usuário, banco e o bloco de banco do Synapse
sudo apt install postgresql libpq5
sudo -u postgres createuser --pwprompt synapse_user
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse

# /etc/matrix-synapse/conf.d/database.yaml
database:
  name: psycopg2
  args:
    user: synapse_user
    password: CHANGE_ME
    dbname: synapse
    host: localhost
    cp_min: 5
    cp_max: 10
3. Proxy reverso e listener (bloco location do nginx da documentação do Synapse)
# nginx: inside a server block that listens on 443 ssl for matrix.example.com
location ~ ^(/_matrix|/_synapse/client) {
    proxy_pass http://localhost:8008;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 50M;
}

# Synapse listener on port 8008, in homeserver.yaml or a conf.d file
listeners:
  - port: 8008
    type: http
    x_forwarded: true
    bind_addresses: ['127.0.0.1']
    resources:
      - names: [client, federation]
4. Primeiro usuário
# conf.d/registration.yaml  (a random value, kept secret)
registration_shared_secret: "RANDOM_VALUE"

sudo systemctl restart matrix-synapse
register_new_matrix_user -c /etc/matrix-synapse/homeserver.yaml

Quanto servidor um homeserver Matrix precisa?

Um homeserver privado para algumas pessoas cabe em um plano intermediário, e é a federação com salas públicas grandes que faz a carga crescer. Não fizemos testes de desempenho do Synapse e não informamos números de usuários. A Gloamport indica o Gloam como o plano para Um servidor Matrix, Vaultwarden e SearXNG juntos: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic, $8.25 por mês no período de 12 meses e $16.50 no plano de um único mês.

Para um chat de equipe com muitas salas, o Night (4 vCPU, 8 GB RAM, 160 GB NVMe, 8 TB traffic, $13.50 por mês no período de 12 meses) é indicado para Um relay movimentado, um servidor de chat de equipe ou vários serviços.

A federação precisa da porta 8448?

Não, a federação pode funcionar pela porta 443 se você delegar. A página de proxy reverso do Synapse informa que, com delegação pela resposta .well-known/matrix/server, a porta 8448 não precisa ser aberta e a federação usa a 443. Sem delegação, a porta padrão de federação é a 8448; então abra-a no firewall e adicione um segundo bloco de servidor que escute ali.

Os clientes podem encontrar seu servidor por meio de um arquivo /.well-known/matrix/client servido em https://nome-do-seu-servidor/.well-known/matrix/client, que indica o homeserver em m.homeserver com seu base_url. Clientes de navegador também precisam de um cabeçalho CORS, e o public_baseurl do Synapse deve conter a mesma URL. Use o nome do servidor no domínio puro apenas se você puder servir esse arquivo ali.

Como manter um servidor Matrix próprio seguro?

Faça cópia de segurança da chave de assinatura, do banco de dados e do armazenamento de mídia, e mantenha o host atualizado. A documentação alerta que as chaves de assinatura devem ser guardadas, porque outros servidores dependem delas. Mensagens em salas sem criptografia ponta a ponta ficam legíveis no banco de dados da sua VPS, então vale considerar a criptografia do disco; Consigo criptografar o disco de uma VPS com LUKS? explica o que a criptografia de disco protege e o que não protege.

Nenhum plano inclui backups: mantenha sua própria cópia de tudo o que você não pode perder. Segundo o levantamento da Gloamport sobre 10 de novembro de 2026, 28 dos 49 provedores não pedem documento de identidade no cadastro; assim, a VPS pode ser comprada sem entregar documentos, mas a segurança do servidor continua sendo sua: SSH somente por chave, como em Como reforço o SSH em uma VPS nova?.

Resumo
  • O Synapse é instalado a partir de packages.matrix.org como matrix-synapse-py3.
  • O nome do servidor é permanente; escolha o domínio primeiro.
  • Use PostgreSQL; a documentação considera o SQLite aceitável apenas para testes.
  • Faça proxy de /_matrix e /_synapse/client para localhost:8008 atrás de HTTPS.
  • A delegação permite que a federação use a porta 443 em vez da 8448.
  • O Gloam, $8.25 por mês no período de 12 meses, é o plano adequado.
  • Faça cópia de segurança das chaves de assinatura, do banco e da mídia; nenhum plano inclui backups.

Hospedagem de um servidor Matrix: perguntas frequentes

Preciso de um nome de domínio para a Matrix?

Sim. O nome do servidor faz parte de todo ID de usuário e é definido na instalação. Ele não pode ser alterado depois, então registre ou escolha o domínio antes de instalar.

Por que não usar o SQLite?

A documentação do Synapse diz que o SQLite é aceitável apenas para testes e não deve ser usado em produção. Quase todas as instalações devem usar PostgreSQL.

Onde coloco minhas próprias configurações?

Em arquivos em /etc/matrix-synapse/conf.d/. A documentação recomenda isso para que uma atualização de pacote não pergunte se deve substituir seu arquivo de configuração.

Como crio a primeira conta?

Execute register_new_matrix_user -c com a configuração do homeserver depois que o Synapse estiver rodando. Ele usa o registration_shared_secret, que qualquer pessoa que o conheça pode usar para criar contas, inclusive de administradores.

Posso rodar a Matrix junto com outros serviços?

Sim, em um plano Gloam ou maior. Vaultwarden e SearXNG são pequenos perto dele; veja o guia sobre hospedagem própria do Vaultwarden.

Fontes (3)
  1. Documentação do Synapse: instruções de instalação — Element / Matrix.org Foundation (checked 2026-11-10)
  2. Documentação do Synapse: uso de proxy reverso com o Synapse — Element / Matrix.org Foundation (checked 2026-11-10)
  3. Documentação do Synapse: uso do Postgres — Element / Matrix.org Foundation (checked 2026-11-10)

A partir de $3.74/mês · sem KYC

Implantar um VPS