O PostgreSQL utiliza a porta 5432 como padrão para receber conexões. Você pode alterar essa porta nas configurações do serviço, mas também precisará atualizar os dados de conexão dos sites e aplicativos que utilizam o banco. Neste artigo, mostramos como realizar essa alteração na sua VPS.
Se você deseja instalar o PostgreSQL mas ainda não sabe como fazer isso, nossa equipe preparou um artigo bem completo te mostrando passo a passo como fazer isso. Se quiser da uma olhada, é só acessá-lo clicando aqui.
Este artigo utiliza o Ubuntu 24.04 como base. Ao final, você também encontrará os comandos para realizar o 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 alterar a porta do PostgreSQL no Ubuntu 24.04
Antes de começar, atualize a lista de pacotes:
Copy
sudo apt update && sudo apt upgrade -yA atualização dos pacotes pode reiniciar serviços. A alteração da porta também exige reiniciar o PostgreSQL, interrompendo temporariamente as conexões com os bancos. Programe o procedimento para um momento de menor uso.
- Para conferir onde está o arquivo de configuração do PostgreSQL, execute:
sudo -u postgres psql -p 5432 -c "SHOW config_file;"
O resultado deve ser algo semelhante a:/etc/postgresql/16/main/postgresql.conf
O 16 em negrito é a versão do PostgreSQL instalado. Se o resultado mostrar outro caminho, utilize-o nos próximos comandos. - Neste artigo, utilizaremos a porta 55432. Antes de continuar, verifique se a porta que você deseja está disponível:
sudo ss -ltnp 'sport = :55432'
Se aparecer apenas o cabeçalho (como na imagem acima), nenhum serviço está vinculado nessa porta TCP naquele momento. Se houver um serviço listado, escolha uma outra porta. - Para salvar uma cópia do arquivo de configuração antes de alterá-lo, execute:
sudo cp -a /etc/postgresql/16/main/postgresql.conf /etc/postgresql/16/main/postgresql.conf.bak
Importante: Utilize o caminho obtido no passo 1. - Abra o arquivo de configuração com o comando:
sudo nano /etc/postgresql/16/main/postgresql.conf
Caso o editor não esteja instalado, executesudo apt install nanopara instalar, e depois tente novamente. - Desça um pouco no arquivo até encontrar a linha que define a porta. A linha deve estar port = 5432. Altere a porta “5432” para o valor que você deseja, em nosso exemplo, vamos usar a 55432.
Se houver um#no início dessa linha, remova-o. Para salvar, pressione Ctrl + O, aperte a tecla Enter e depois saia pressionando Ctrl + X. - Para aplicar a alteração, reinicie o PostgreSQL:
sudo systemctl restart postgresql@16-main - Confirme se o PostgreSQL está utilizando a nova porta:
sudo ss -ltnp | grep postgres
O resultado deverá mostrar 55432. - Nas configurações dos sites, aplicativos e ferramentas que utilizam esse banco, substitua a porta atual pela nova porta. Depois, teste o funcionamento de cada aplicação.
Comandos para outros sistemas
Os exemplos abaixo consideram o PostgreSQL instalado pelo repositório da distribuição, com o serviço chamado
postgresql. Se a instalação utilizar outro caminho ou um serviço como postgresql-16, ajuste os comandos antes de executá-los.Execute um comando por vez e aguarde sua conclusão antes de continuar. Leia também os comentários, pois alguns comandos dependem do resultado anterior.
AlmaLinux 10:
Copy
# Atualiza os pacotes do sistema.
sudo dnf upgrade -y
# Instala o editor e a ferramenta de configuração do SELinux.
sudo dnf install -y nano policycoreutils-python-utils
# Mostra o caminho do arquivo de configuração.
sudo -u postgres psql -p 5432 -c "SHOW config_file;"
# Verifica se a porta 55432 está em uso. Se houver um serviço listado, escolha outra porta.
sudo ss -ltnp 'sport = :55432'
# Cria uma cópia da configuração. Se o caminho for diferente, ajuste no comando
sudo cp -a /var/lib/pgsql/data/postgresql.conf /var/lib/pgsql/data/postgresql.conf.bak
# Abre o arquivo de configuração.
sudo nano /var/lib/pgsql/data/postgresql.conf
# No editor, localize a configuração port e altere para a nova porta:
port = 55432
# Para salvar, pressione Ctrl + O, aperte a tecla Enter e depois saia pressionando Ctrl + X
# Verifica o estado do SELinux.
getenforce
# Se o resultado for Enforcing ou Permissive, consulte as portas autorizadas para o PostgreSQL.
sudo semanage port -l | grep postgresql_port_t
# Execute o comando abaixo somente se o SELinux estiver habilitado e a porta 55432 não
# estiver na lista anterior. Se a porta já pertencer a outro tipo, escolha outra porta e
# ajuste também o arquivo de configuração.
sudo semanage port -a -t postgresql_port_t -p tcp 55432
# Reinicia o PostgreSQL para aplicar a alteração.
sudo systemctl restart postgresql
# Confirma a porta utilizada. O resultado esperado é a nova porta configurada.
sudo ss -ltnp | grep postgresCentOS Stream 9:
Copy
# Atualiza os pacotes do sistema.
sudo dnf upgrade -y
# Instala o editor e a ferramenta de configuração do SELinux.
sudo dnf install -y nano policycoreutils-python-utils
# Mostra o caminho do arquivo de configuração.
sudo -u postgres psql -p 5432 -c "SHOW config_file;"
# Verifica se a porta 55432 está em uso. Se houver um serviço listado, escolha outra porta.
sudo ss -ltnp 'sport = :55432'
# Cria uma cópia da configuração. Se o caminho for diferente, ajuste no comando
sudo cp -a /var/lib/pgsql/data/postgresql.conf /var/lib/pgsql/data/postgresql.conf.bak
# Abre o arquivo de configuração.
sudo nano /var/lib/pgsql/data/postgresql.conf
# No editor, localize a configuração port e altere para a nova porta:
port = 55432
# Para salvar, pressione Ctrl + O, aperte a tecla Enter e depois saia pressionando Ctrl + X
# Verifica o estado do SELinux.
getenforce
# Se o resultado for Enforcing ou Permissive, consulte as portas autorizadas para o PostgreSQL.
sudo semanage port -l | grep postgresql_port_t
# Execute o comando abaixo somente se o SELinux estiver habilitado e a porta 55432 não
# estiver na lista anterior. Se a porta já pertencer a outro tipo, escolha outra porta e
# ajuste também o arquivo de configuração.
sudo semanage port -a -t postgresql_port_t -p tcp 55432
# Reinicia o PostgreSQL para aplicar a alteração.
sudo systemctl restart postgresql
# Confirma a porta utilizada. O resultado esperado é nova porta configurada.
sudo ss -ltnp | grep postgresApós confirmar a nova porta, lembre-se de atualizar as configurações dos sites e aplicativos que utilizam o PostgreSQL. Com isso, eles poderão continuar se conectando ao banco pela porta escolhida.