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

Banco de Dados

Como configurar replicação assíncrona no PostgreSQL 15: Guia passo a passo

atualizado em 23/08/2026

A replicação assíncrona no PostgreSQL permite que dados sejam copiados de um servidor primário para um ou mais servidores secundários, proporcionando alta disponibilidade e escalabilidade.

Pré-requisitos

  • PostgreSQL 15 instalado em ambas as máquinas (primária e secundária).
  • Acesso ao terminal com permissões de superusuário.
  • Rede configurada entre os servidores.

Passo a Passo

1. Configurando o Servidor Primário

No servidor primário, você deve editar o arquivo de configuração postgresql.conf e habilitar a replicação.

sudo nano /etc/postgresql/15/main/postgresql.conf
  • Localize e modifique as seguintes linhas:
  • wal_level = replica
  • max_wal_senders = 5
  • wal_keep_segments = 64
  • listen_addresses = '*' (ou o IP específico)

2. Configurando o Acesso de Replicação

Adicione um usuário para replicação e configure o acesso no arquivo pg_hba.conf.

sudo -u postgres createuser --replication --pwprompt replicator
sudo nano /etc/postgresql/15/main/pg_hba.conf
  • Adicione a seguinte linha:
  • host replication replicator /32 md5

3. Reiniciando o Servidor Primário

sudo systemctl restart postgresql

4. Configurando o Servidor Secundário

No servidor secundário, você deve criar uma cópia do banco de dados do servidor primário.

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

5. Configurando o arquivo de recuperação

Crie um arquivo chamado recovery.conf no diretório de dados do PostgreSQL no servidor secundário.

sudo nano /var/lib/postgresql/15/main/recovery.conf
  • Adicione as seguintes linhas:
  • standby_mode = 'on'
  • primary_conninfo = 'host= port=5432 user=replicator password='

6. Iniciando o Servidor Secundário

sudo systemctl start postgresql

Conclusão

Após seguir esses passos, a replicação assíncrona estará configurada. Monitore os logs e o status da replicação usando:

SELECT * FROM pg_stat_replication;

Dica: Sempre faça backups regulares e teste a recuperação para garantir a integridade dos dados.

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.