wils@web ~ $ cat ~/ajuda/como-configurar-a-replicacao-master-slave-no-postgresql-15-guia-passo-a-passo.md

Banco de Dados

Como configurar a replicação master-slave no PostgreSQL 15: Guia passo a passo

atualizado em 22/08/2026

A replicação master-slave no PostgreSQL 15 permite que você crie cópias de segurança e melhore a disponibilidade do seu banco de dados. Neste guia, vamos configurar essa replicação passo a passo.

Pré-requisitos

  • Dois servidores com PostgreSQL 15 instalado.
  • Acesso administrativo aos servidores.
  • Rede entre os servidores configurada.

Passo 1: Configuração do Servidor Master

No servidor master, edite o arquivo /etc/postgresql/15/main/postgresql.conf para habilitar a replicação:

listen_addresses = '*'
wal_level = replica
max_wal_senders = 3
wal_keep_segments = 64

Em seguida, edite o arquivo /etc/postgresql/15/main/pg_hba.conf para permitir conexões do servidor slave:

host    replication     all             /32          md5

Reinicie o PostgreSQL:

sudo systemctl restart postgresql

Passo 2: Criação de um Usuário para Replicação

No servidor master, crie um usuário para a replicação:

psql -U postgres -c "CREATE ROLE replicator WITH REPLICATION PASSWORD 'senha_replicador' LOGIN;"

Passo 3: Backup do Servidor Master

Realize um backup do banco de dados no servidor master:

pg_basebackup -h localhost -U replicator -D /var/lib/postgresql/15/main -P --wal-method=stream

Passo 4: Configuração do Servidor Slave

No servidor slave, edite o arquivo /etc/postgresql/15/main/postgresql.conf:

hot_standby = on

Crie um arquivo recovery.conf no diretório de dados do PostgreSQL:

standby_mode = 'on'
primary_conninfo = 'host= port=5432 user=replicator password=senha_replicador'
trigger_file = '/tmp/postgresql.trigger.5432'

Reinicie o PostgreSQL no servidor slave:

sudo systemctl restart postgresql

Passo 5: Verificação da Replicação

Para verificar se a replicação está funcionando, execute o seguinte comando no servidor master:

SELECT * FROM pg_stat_replication;

Conclusão

A replicação master-slave no PostgreSQL 15 é uma excelente maneira de garantir alta disponibilidade. Lembre-se de monitorar regularmente a replicação e ajustar as configurações conforme necessário.

Dica: Considere implementar um sistema de monitoramento para acompanhar a saúde dos seus servidores PostgreSQL.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.