O acesso remoto ao PostgreSQL permite conectar aplicações e ferramentas de gerenciamento ao banco de dados da sua VPS a partir de outro computador ou servidor. Abaixo, mostramos como configurar essa conexão e liberar o acesso para um IP específico.
Este artigo utiliza o Ubuntu 24.04 como base, que também devem funcionar normalmente com o sistema Debian. Ao final, você encontrará os comandos para realizar o mesmo procedimento no AlmaLinux 10 e no CentOS Stream 9.
Para prosseguir com os passos deste artigo você precisará se conectar ao terminal SSH da sua VPS. Nossa equipe realizou a conexão à partir da ferramenta Bitvise, caso ainda não possua uma ferramenta de conexão SSH ou não sabe como se conectar a sua VPS, clique aqui.
Como liberar o acesso remoto ao PostgreSQL
Antes de começar, atualize a lista de pacotes e os pacotes instalados:
Copy
sudo apt update && sudo apt upgrade -y- Identifique os arquivos de configuração e a porta utilizada (Execute um comando por vez):
Arquivo de configuração:sudo -u postgres psql -c "SHOW config_file;"
Arquivo de autorização:sudo -u postgres psql -c "SHOW hba_file;"
Descobrir a porta atual:sudo -u postgres psql -c "SHOW port;"
Nos próximos passos, utilizaremos os caminhos padrão do PostgreSQL 16 no Ubuntu 24.04 e a porta5432. Se os resultados forem diferentes, substitua esses valores. Caso já tenha alterado a porta, utilize a porta atual. - Faça uma cópia dos arquivos:
Primeiro arquivo:sudo cp -a /etc/postgresql/16/main/postgresql.conf /etc/postgresql/16/main/postgresql.conf.bak
Segundo arquivo:sudo cp -a /etc/postgresql/16/main/pg_hba.conf /etc/postgresql/16/main/pg_hba.conf.bak - Para permitir as conexões remotas, abra o arquivo de configuração com o comando:
sudo nano /etc/postgresql/16/main/postgresql.conf
Localizelisten_addresses(você pode usar Ctrl + W para buscar). Ao localizar, remova o#do início da linha, se houver, e deixe assim:listen_addresses = '*'
Salve com Ctrl + O, pressione Enter e saia com Ctrl + X. - Para autorizar o IP que poderá se conectar, abra o arquivo de autorização com o comando:
sudo nano /etc/postgresql/16/main/pg_hba.conf
Adicione a linha abaixo no final do arquivo:host meu_banco meu_usuario 1.2.3.4/32 scram-sha-256
Substituameu_bancoemeu_usuariopelos dados de acesso existentes. Troque1.2.3.4pelo IP público da sua rede ou IP do servidor que fará a conexão, mantendo/32para autorizar somente esse IPv4.
Salve e feche o arquivo (Ctrl + O, Enter e depois Ctrl + X para sair). - Confira se o firewall UFW está ativo:
sudo systemctl ufw status
Se ele não estiver ativo, use os comandossudo systemctl enable ufw(para habilitar) e sudo systemctl start ufw (para iniciar) - Se estiver ativo, libere o IP e a porta utilizados:
sudo ufw allow from 1.2.3.4 to any port 5432 proto tcp
Se utilizar outro firewall, faça a liberação nele. O mesmo vale para um firewall externo à VPS, caso exista. - Reinicie o PostgreSQL para aplicar as alterações:
sudo systemctl restart postgresql
Se quiser verificar o estado dos bancos, execute o comando:pg_lsclusters
O cluster configurado deverá aparecer com o statusonline. - E pronto, agora é só realizar a conexão na sua ferramenta de gerenciamento, informando o IP do servidor com o PostgreSQL, a porta, o banco, o usuário e a senha.
Comandos para AlmaLinux 10 e CentOS Stream 9
Utilize um comando por vez e confira o resultado antes de continuar. Nos editores, faça os mesmos ajustes apresentados no passo a passo acima.
Os comandos abaixo servem para os dois sistemas. Ajuste os caminhos conforme as consultas iniciais e substitua o IP e a porta pelos seus dados.
Copy
# Atualize os pacotes instalados no sistema
sudo dnf upgrade -y
# Instale o editor de texto (se ainda não estiver)
sudo dnf install nano -y
# Comando para ver o caminho do arquivo principal de configuração
sudo -u postgres psql -c "SHOW config_file;"
# Comando para ver o caminho do arquivo de controle de acesso
sudo -u postgres psql -c "SHOW hba_file;"}
# Comando para ver a porta utilizada pelo PostgreSQL
sudo -u postgres psql -c "SHOW port;"
# Cria cópias dos arquivos. Ajuste os caminhos se necessário
sudo cp -a /var/lib/pgsql/data/postgresql.conf /var/lib/pgsql/data/postgresql.conf.bak
sudo cp -a /var/lib/pgsql/data/pg_hba.conf /var/lib/pgsql/data/pg_hba.conf.bak
# Abre a configuração: ajuste listen_addresses = '*', salve e saia
sudo nano /var/lib/pgsql/data/postgresql.conf
# Abra o arquivo de controle de acesso e adcione a rebra abaixo no final do arquivo.
sudo nano /var/lib/pgsql/data/pg_hba.conf
# host meu_banco meu_usuario 1.2.3.4/32 scram-sha-256
# Verifica se o firewalld está em execução
sudo firewall-cmd --state
# Mostra as zonas ativas: use a zona da interface que recebe a conexão
sudo firewall-cmd --get-active-zones
# Se o firewalld estiver ativo, libere o acesso
# Substitua public pela zona correta e ajuste IP e porta
sudo firewall-cmd --permanent --zone=public --add-rich-rule='rule family="ipv4" source address="1.2.3.4/32" port port="5432" protocol="tcp" accept'
# Recarregue o firewall para aplicar
sudo firewall-cmd --reload
# Verifique o nome do serviço do PostgreSQL
sudo systemctl list-units --type=service --all 'postgresql*'
# Agora reinicie o PostgreSQL (substitua o nome se for diferente):
sudo systemctl restart postgresql
# Verifique o estado do serviço (ajuste o nome se necessário):
sudo systemctl status postgresql --no-pagerEm instalações pelo repositório oficial do PostgreSQL, o serviço pode se chamar postgresql-16, por exemplo. Nesse caso, utilize esse nome nos comandos de reinicialização e verificação.