Rocky Linux / Instalar PostgreSQL e configurar o acesso remoto
No Rocky Linux, você pode instalar o PostgreSQL usando o pacote postgresql-server do repositório padrão. Após a instalação, é necessário inicializar o cluster de banco de dados e habilitar o serviço, e para acesso remoto, você deve configurar listen_addresses, pg_hba.conf, o firewall e TLS (Transport Layer Security) em conjunto.
Este procedimento usa os pacotes do repositório padrão do Rocky e exige uma conta autorizada a usar sudo. Comece em uma máquina de laboratório ou em uma instalação nova. Para um servidor existente, identifique o cluster, faça backups recuperáveis e planeje a manutenção antes de alterar pacotes ou reiniciar. TLS protege o tráfego; uma VPN é uma rede privada virtual.
A versão principal do PostgreSQL e o nome do serviço fornecido podem variar dependendo da versão do Rocky Linux e dos repositórios ativos. Verifique os pacotes disponíveis e a versão exigida pela sua aplicação antes da instalação.
Verificar as versões disponíveis
cat /etc/rocky-release
dnf info postgresql-server
dnf module list postgresql
A página oficial de pacotes para Rocky Linux e a família Red Hat distingue os pacotes da distribuição dos pacotes PGDG (PostgreSQL Global Development Group). Confira a versão oferecida por seu Rocky e os requisitos da aplicação; este guia não escolhe automaticamente um módulo nem instala um repositório PGDG.
dnf module pode não estar disponível dependendo da versão do Rocky Linux e do DNF. Se uma versão principal específica do PostgreSQL for necessária, primeiro decida se vai usar o ciclo de vida do repositório padrão do Rocky ou o repositório PGDG fornecido pelo projeto PostgreSQL, e não misture pacotes de servidor de diferentes repositórios.
Instalar e inicializar PostgreSQL
Instalar servidor e cliente
sudo dnf install postgresql-server postgresql
Verifique a versão e os pacotes instalados.
psql --version
rpm -q postgresql-server postgresql
psql --version informa a versão do cliente, não comprova a versão do servidor em execução. Depois de conectar, SELECT version(); identifica o servidor. Confira também a origem dos pacotes para evitar combinar ferramentas e dados de versões incompatíveis.
Inicializar o cluster de bancos de dados
Um cluster, neste contexto, é o conjunto de bancos administrados por uma instância PostgreSQL; não significa automaticamente vários servidores em alta disponibilidade. Confira o diretório destinado aos dados e as opções de postgresql-setup --help antes de inicializar.
sudo postgresql-setup --initdb
Inicialize uma única vez em um diretório vazio. initdb cria os catálogos e bancos iniciais; as ferramentas normalmente recusam um diretório não vazio. Não apague dados para contornar essa recusa nem execute a inicialização como correção de um serviço com falha. Identifique o cluster existente e sua recuperação primeiro.
sudo postgresql-setup --help
Iniciar o serviço e habilitar na inicialização
sudo systemctl enable --now postgresql
systemctl status postgresql
enable --now habilita o serviço na inicialização e o inicia imediatamente. O estado esperado é active (running); saia do paginador com q. Se falhar, consulte sudo journalctl -u postgresql -b, usando o nome real da unidade, e investigue o erro antes de prosseguir.
Pacotes específicos de versão no repositório PGDG podem ter nomes de serviço e comandos de inicialização diferentes, como postgresql-16. Verifique as instruções oficiais para o pacote instalado e o resultado de systemctl list-unit-files 'postgresql*'.
Acesso local e segurança básica
Conectar como a conta postgres do Linux
sudo -iu postgres psql
Esse comando é executado no shell Linux e abre o cliente interativo psql. Os comandos SQL e os comandos iniciados por barra invertida das próximas subseções são digitados dentro dele. Em uma instalação padrão, a conexão costuma abrir o banco postgres; uma falha deve ser investigada nas regras locais, sem trocar a autenticação por trust apenas para passar pelo erro.
A autenticação local inicial pode usar o método peer, que vincula a conta do sistema operacional ao papel do banco de dados. A senha do papel postgres do PostgreSQL e a senha da conta Linux postgres são diferentes.
Definir senhas com segurança
O comando \password de psql solicita a senha sem colocá-la em texto simples na instrução SQL ou no histórico do shell. Ele altera a senha do papel PostgreSQL, não a senha da conta Linux. Definir a senha de postgres não é necessário para continuar usando autenticação local por peer; quando houver essa necessidade administrativa, use:
\password postgres
Não use papéis administrativos em aplicações; crie papéis e bancos de dados específicos para cada finalidade.
Para o exemplo remoto com scram-sha-256, confira SHOW password_encryption; no psql. Antes de definir a nova senha, use SET password_encryption = 'scram-sha-256'; nessa sessão, se necessário, e confirme que o driver da aplicação suporta SCRAM (Salted Challenge Response Authentication Mechanism). Mudar apenas o método de autenticação não converte uma senha antiga armazenada em MD5; ela precisa ser redefinida, conforme a documentação de autenticação por senha.
Execute as próximas três linhas, uma por vez, no psql. appuser e appdb são nomes de exemplo; escolha outros se já existirem. A linha com \password é um comando do cliente psql, enquanto as demais são SQL.
CREATE ROLE appuser LOGIN;
\password appuser
CREATE DATABASE appdb OWNER appuser;
As instruções SQL bem-sucedidas retornam CREATE ROLE e CREATE DATABASE. Esse papel não recebe superusuário, mas será proprietário do banco: para produção, avalie separar o proprietário das migrações do papel usado pela aplicação, concedendo a este apenas os privilégios necessários.
Localizar os arquivos de configuração
SHOW config_file;
SHOW hba_file;
SHOW data_directory;
Os comandos SHOW retornam os caminhos efetivos. Anote-os, saia do psql com \q e faça cópias dos arquivos antes de editar. Não suponha um caminho fixo de dados. Mantenha uma sessão administrativa local ou acesso por console durante os testes de autenticação.
Permitir conexões remotas
Restringir os endereços de escuta
É recomendável limitar listen_addresses em postgresql.conf para um IP privado específico do servidor.
listen_addresses = '192.0.2.20'
O endereço configurado deve existir em uma interface do servidor. Não confunda esse endereço de escuta com o endereço de origem do cliente usado nas regras abaixo. TCP (Transmission Control Protocol) é o protocolo usado aqui, normalmente na porta 5432; confira a porta real se ela foi alterada.
192.0.2.20 é um exemplo para documentação. Substitua-o pelo endereço real do servidor. * significa todas as interfaces, o que é conveniente, mas pode expô-lo a redes desnecessárias. O padrão para o PostgreSQL é o acesso pelo loopback local. Para mais detalhes, consulte a documentação oficial das configurações de conexão do PostgreSQL.
Restringir clientes em pg_hba.conf
Por exemplo, se você quiser que apenas um servidor de aplicação específico se conecte ao appdb como appuser, você pode revisar os seguintes registros.
Prepare TLS no servidor antes de depender de hostssl. Essa regra só corresponde a conexões criptografadas quando o suporte SSL está ativo; ela não gera certificados nem ativa TLS sozinha. Siga a configuração TLS do servidor na documentação PostgreSQL 16, selecionando a versão realmente instalada:
- Obtenha um certificado de servidor e sua chave privada por uma autoridade certificadora (CA) confiável para seus clientes. O certificado precisa identificar o nome ou IP usado na conexão e incluir a cadeia intermediária necessária.
- Instale o certificado e a chave nos locais definidos por
ssl_cert_fileessl_key_file; por padrão, sãoserver.crteserver.keyno diretório de dados. Uma configuração comum no Linux é chave pertencente à conta do servidor, com permissão0600. Garanta leitura pelo PostgreSQL, preserve os contextos SELinux adequados e nunca publique a chave privada. - No arquivo de configuração efetivo, ajuste
ssl = one os caminhos dos arquivos quando diferirem dos padrões. Aplique as configurações e verifique os logs; endereço de escuta exige reinício, como explicado adiante. Não remova uma sessão de recuperação antes de testar o novo acesso. - No cliente, instale o certificado raiz da CA em
~/.postgresql/root.crtou indique seu caminho emsslrootcert. Esse arquivo de confiança é diferente do certificado e da chave privada do servidor.
hostssl appdb appuser 192.0.2.10/32 scram-sha-256
192.0.2.10/32 é um único endereço IPv4 de documentação. Substitua-o pela origem que o servidor realmente observa, considerando NAT e VPN; não é necessariamente o endereço local do cliente. hostssl exige TLS, e scram-sha-256 autentica a senha do papel. Eles não concedem automaticamente todos os privilégios SQL.
pg_hba.conf é a configuração de autenticação por origem (host-based authentication). A primeira regra que corresponda ao tipo de conexão, banco, papel e endereço é usada; se a autenticação falhar, o servidor não tenta regras seguintes. Uma regra ampla anterior pode superar a específica. Uma regra ampla posterior também pode permitir outras origens ou conexões sem TLS: revise o arquivo completo, inclusive IPv6 e arquivos incluídos. Veja a documentação oficial de pg_hba.conf.
Limitar origens também no firewall
Verifique sudo firewall-cmd --state e sudo firewall-cmd --get-active-zones. Substitua public pela zona que recebe o tráfego e adapte a porta real. Esta rich rule adiciona uma permissão para uma origem; não remove outras permissões gerais já existentes. Confira serviços, portas, políticas, outras regras e IPv6 antes de afirmar que o acesso ficou restrito.
sudo firewall-cmd --zone=public --add-rich-rule='rule family="ipv4" source address="192.0.2.10/32" port port="5432" protocol="tcp" accept'
Faça a gravação somente depois de concluir os testes da próxima seção com uma nova conexão da aplicação e acesso administrativo preservado. Segundo o manual de firewall-cmd, --runtime-to-permanent copia toda a configuração em execução e sobrescreve a permanente, não apenas a última regra. Revise também as alterações temporárias de outras zonas.
sudo firewall-cmd --runtime-to-permanent
Não exponha portas de banco de dados diretamente para toda a internet. Use redes privadas, VPNs, grupos de segurança e firewalls em conjunto.
Aplicar e verificar as configurações
Recarregar as regras de autenticação
Configurações que podem ser recarregadas, como pg_hba.conf, podem ser lidas novamente da seguinte forma.
Antes de recarregar, execute a consulta de pg_hba_file_rules apresentada logo abaixo e verifique os erros dos arquivos de configuração. Valores não nulos em error precisam ser corrigidos. No psql administrativo, SELECT sourcefile, sourceline, name, error FROM pg_file_settings WHERE error IS NOT NULL; ajuda a localizar problemas no arquivo, como explica a documentação de pg_file_settings. O retorno verdadeiro de pg_reload_conf() indica o envio do sinal de recarga; não comprova que toda configuração foi aceita. Consulte também os logs e a vista pg_file_settings, conforme as funções administrativas oficiais.
sudo -iu postgres psql -c 'SELECT pg_reload_conf();'
A consulta a seguir permite revisar as linhas do arquivo de autenticação antes e depois da recarga. Um campo error vazio não prova que o cliente ou os privilégios SQL estejam corretos; confirme uma nova conexão.
sudo -iu postgres psql -c 'SELECT line_number, type, database, user_name, address, auth_method, error FROM pg_hba_file_rules;'
Aplicar alterações que exigem reinício
Configurações aplicadas na inicialização do servidor, como listen_addresses, exigem reinício. Após a recarga, consulte SELECT name FROM pg_settings WHERE pending_restart; no psql administrativo; essa vista de parâmetros ativos indica alterações que ainda aguardam reinício.
sudo systemctl restart postgresql
sudo systemctl status postgresql
Reiniciar interrompe conexões existentes; programe a manutenção. Se o serviço não voltar, consulte o status e o diário da unidade, compare apenas as alterações desta manutenção com os backups e corrija ou reverta as opções incorretas. Não reinicialize o diretório de dados para resolver um erro de certificado ou sintaxe. Para desfazer a abertura de rede, restaure os arquivos anteriores e remova a rich rule exata com --remove-rich-rule, confirmando novamente o acesso necessário. Se já tiver salvo as regras, revise também a configuração permanente para que a reversão continue válida após reiniciar; não salve alterações temporárias alheias sem revisão.
Testar a escuta e uma nova conexão
A primeira linha abaixo é executada no servidor; ela apenas filtra a listagem de sockets e não prova autenticação ou conectividade externa. Execute a segunda no cliente autorizado, onde psql, a CA e o driver compatível já foram preparados. Substitua o IP de documentação pelo destino real.
ss -lntp | grep 5432
psql 'host=192.0.2.20 dbname=appdb user=appuser sslmode=verify-full'
Com sslmode=verify-full, o cliente verifica a cadeia de confiança e a identidade do destino, conforme a documentação TLS de libpq. Se host for um IP, o certificado precisa corresponder a esse IP; não basta conter um nome DNS diferente. Um certificado com o IP no campo de nome alternativo (SAN) apropriado é a escolha usual; se usar um nome DNS certificado, informe esse nome no parâmetro host. Não reduza a verificação apenas para ignorar uma falha de identidade.
Após conectar, \conninfo no psql mostra o destino e informações de criptografia. Execute SELECT current_database(), current_user; e confirme appdb e appuser, adaptando os nomes. Teste também uma origem não autorizada e uma tentativa sem TLS em um ambiente controlado: o exemplo de uma única regra não prova que outras permissões tenham sido removidas.
Preparar a operação
- Backups lógicos e físicos regulares e testes reais de recuperação
- Plano para aplicar atualizações menores suportadas
- Papéis com privilégios mínimos e rotação de senhas por aplicação
- Verificação de certificado TLS e uso de rede privada ou VPN
- Monitoramento do uso de disco, contagem de conexões, latência, checkpoints e registros de erros
- Revisão de compatibilidade e preparação de procedimentos separados antes da atualização de versão principal
As atualizações de versão principal do PostgreSQL são diferentes de simples atualizações de pacotes. Planeje o caminho de atualização oficial de acordo com a versão, como pg_upgrade, replicação lógica ou dump e restore.
Perguntas frequentes
Não é possível encontrar o comando postgresql-setup
Verifique o repositório instalado e os nomes dos pacotes. As ferramentas de inicialização e os nomes dos serviços podem diferir entre os pacotes padrão do Rocky e os pacotes específicos da versão PGDG.
Conexões externas continuam sendo recusadas
Verifique listen_addresses, a primeira regra correspondente em pg_hba.conf, a porta de escuta do serviço, firewalld e os grupos de segurança da nuvem, nesta ordem.
É aceitável permitir 0.0.0.0/0 no pg_hba.conf?
0.0.0.0/0 corresponde a qualquer endereço IPv4, inclusive redes privadas, quando os demais campos da regra coincidirem. Prefira a origem real da aplicação ou uma sub-rede autorizada, com TLS e privilégios mínimos. IPv6 tem regras próprias.
Após alterar os arquivos de configuração, devo usar reload ou restart?
Depende do item. pg_hba.conf pode ser recarregado, mas listen_addresses requer um reinício. Verifique pg_settings.pending_restart e o contexto na documentação oficial.
Resumo
No Rocky Linux, prepare PostgreSQL instalando os pacotes escolhidos, inicializando o novo cluster uma única vez e ativando o serviço. Para conexões remotas, combine endereços de escuta específicos, regras de autenticação restritas, revisão das permissões do firewall e TLS com identidade verificada.
Como os caminhos de configuração e os nomes dos serviços podem variar dependendo da fonte de instalação e da versão, é seguro trabalhar com base nos caminhos relatados diretamente pelo PostgreSQL e na documentação do pacote instalado.




