Modificando as Configurações do Banco de Dados PostgreSQL no ServBay

O ServBay oferece aos desenvolvedores macOS um ambiente local de desenvolvimento web poderoso, integrando o banco de dados PostgreSQL. Este artigo detalha como modificar as configurações do PostgreSQL no ServBay, incluindo o método recomendado pela interface gráfica (UI) e a edição manual dos arquivos de configuração, indicada apenas para fins temporários.

Dependendo da versão do PostgreSQL instalada no ServBay, os principais arquivos de configuração geralmente ficam em /Applications/ServBay/etc/postgresql/<versão>. Por exemplo, os arquivos do PostgreSQL 16 encontram-se em /Applications/ServBay/etc/postgresql/16.

Aviso Importante

O ServBay gerencia a maioria das configurações por meio de sua interface gráfica (UI) e gera automaticamente os arquivos de configuração correspondentes. É altamente recomendado que você utilize a UI do ServBay para alterar as configurações. Editar os arquivos manualmente pode resultar na sobrescrita de suas alterações quando o ServBay gerenciar ou atualizar as configurações posteriormente. Edições manuais devem ser feitas apenas para testes temporários ou por usuários avançados que compreendem as configurações de baixo nível, não sendo recomendadas para ambientes de produção ou uso prolongado.

Modificando as Configurações pela Interface do ServBay (Recomendado)

O ServBay oferece uma interface gráfica intuitiva, sendo essa a maneira mais fácil e recomendada para modificar as configurações do PostgreSQL. Alterações pela UI normalmente são aplicadas de forma automática e imediata, sem necessidade de reiniciar o serviço manualmente (a menos que o ServBay indique o contrário).

Passo a Passo

1. Abra o aplicativo ServBay.
2. No menu lateral esquerdo do ServBay, selecione Banco de Dados.
3. Na lista de bancos, encontre PostgreSQL e clique na versão desejada que você quer configurar.
4. Ao acessar a interface de configuração do PostgreSQL, você verá informações detalhadas sobre a versão selecionada e suas opções de configuração.

Configurações Disponíveis

Nesta interface, você pode visualizar o nome de usuário e senha padrão do PostgreSQL definidos pelo ServBay (normalmente exibidos nesta página). Além disso, é possível modificar diretamente alguns parâmetros comuns:

• Endereços de escuta (listen_addresses): Define as interfaces de rede que o PostgreSQL escutará. O padrão costuma ser *, indicando todas as interfaces disponíveis.
• Porta (port): Porta de escuta do serviço PostgreSQL. O padrão é 5432 (diferente do 3306 usado pelo MySQL/MariaDB).
• Número máximo de conexões (max_connections): Limita o número de conexões simultâneas de clientes ao banco de dados.
• Memória de trabalho (work_mem): Define a quantidade de memória disponível por processo de consulta para operações de ordenação e tabelas hash.

Além desses, você pode adicionar ou modificar outros parâmetros do postgresql.conf na área Parâmetros Adicionais. Preencha cada parâmetro em uma linha, no formato nome_do_parâmetro = valor.

Aplicando as Alterações

Após modificar as configurações, clique em Salvar ao final da página. O ServBay aplicará suas mudanças automaticamente. Para a maioria dos parâmetros, as alterações têm efeito imediato. Em casos raros, pode ser necessário reiniciar o serviço PostgreSQL, e o ServBay exibirá um aviso nesses casos.

Modificando Manualmente os Arquivos de Configuração (Não Recomendado para Uso Prolongado)

Como mencionado antes, alterações manuais não são recomendadas para gerenciamento rotineiro, pois as configurações feitas pela UI podem sobrescrever arquivos editados diretamente. Conhecer a localização e estrutura desses arquivos, porém, é útil para entender as configurações internas do PostgreSQL.

WARNING

A edição manual dos arquivos deve ser reservada para depuração temporária ou investigações avançadas. O ServBay recomenda fortemente o uso da interface gráfica para qualquer ajuste, garantindo a consistência e persistência das configurações. Os caminhos e conteúdos dos arquivos podem ser redefinidos a qualquer momento devido ao gerenciamento interno do ServBay.

Localização dos Arquivos de Configuração

Os principais arquivos de configuração do PostgreSQL no ServBay são postgresql.conf e pg_hba.conf. Os caminhos podem variar conforme a versão, geralmente sendo:

• postgresql.conf: /Applications/ServBay/etc/postgresql/<versão>/postgresql.conf
• pg_hba.conf: /Applications/ServBay/etc/postgresql/<versão>/pg_hba.conf

Observe que documentos antigos podem referenciar /db/postgresql/16/pg_hba.conf, mas a UI do ServBay gerencia principalmente os arquivos sob /Applications/ServBay/etc. Na edição manual, verifique sempre o caminho exato usado pela sua instalação. Para manter padrão com a interface, sempre prefira /Applications/ServBay/etc/postgresql/<versão>.

Exemplos de Configuração Comuns

Veja abaixo exemplos comuns de configurações no postgresql.conf e pg_hba.conf. Edite esses arquivos com um editor de texto (VS Code, Sublime Text, Nano, etc.) e permissões administrativas.

postgresql.conf

postgresql.conf é o principal arquivo de configuração do servidor PostgreSQL, controlando o funcionamento do serviço.

# Endereços de escuta: interfaces de rede que o servidor irá monitorar. '*' significa todas.
listen_addresses = '*'

# Porta: porta de rede na qual o PostgreSQL irá escutar. Padrão: 5432.
port = 5432

# Máximo de conexões: número máximo de clientes simultâneos ao banco.
max_connections = 100

# Buffers compartilhados: memória compartilhada usada pelo PostgreSQL para cache dos dados.
shared_buffers = 128MB

# Diretório de logs: local onde os arquivos de log serão armazenados.
log_directory = 'log'

# Formato do nome dos arquivos de log.
log_filename = 'postgresql-%Y-%m-%d.log'

# Habilitar log de consultas lentas: registra consultas que excedem determinado tempo em ms.
# Defina como inteiro positivo, por exemplo, 2000 registra consultas acima de 2 segundos.
# Definindo como -1 desativa o log de consultas lentas.
log_min_duration_statement = 2000

pg_hba.conf

O arquivo pg_hba.conf (Host-Based Authentication) define os métodos de autenticação e permissões de conexão ao PostgreSQL.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# Permite conexões locais via socket Unix, usando método trust (sem senha).
# "local" é somente para conexões via socket Unix
local   all             all                                     trust

# Permite todas as conexões IPv4 remotas via TCP/IP, usando autenticação md5.
# Conexões locais IPv4:
host    all             all             0.0.0.0/0               md5

# Permite conexões IPv4 de uma faixa específica (ex: 192.168.1.0/24), usando md5.
# Conexões IPv4 de uma subrede:
# host    all             all             192.168.1.0/24          md5

Ao editar o pg_hba.conf, compreenda o significado de cada coluna (TYPE, DATABASE, USER, ADDRESS, METHOD). Configurações incorretas podem impedir o acesso ao banco ou criar riscos de segurança.

Aplicando as Alterações Manuais

Após editar os arquivos de configuração, é preciso reiniciar o serviço PostgreSQL para aplicar as mudanças.

Reiniciando pela Interface do ServBay

1. Abra o painel de gerenciamento do ServBay.
2. Selecione Banco de Dados na barra lateral.
3. Localize PostgreSQL e clique na versão apropriada.
4. Na página dedicada ou na seção "Pacotes"/“Serviços”, encontre o PostgreSQL da versão especificada e clique em Reiniciar.

Reiniciando pelo comando servbayctl

Também é possível reiniciar o PostgreSQL pelo utilitário de linha de comando servbayctl:

servbayctl restart postgresql <versao>

Substitua <versao> pelo número real da versão, por exemplo, 16.

Resumo

O ServBay simplifica a modificação das configurações do PostgreSQL através de uma interface gráfica conveniente, sendo essa a abordagem mais recomendada para evitar que alterações sejam sobrescritas acidentalmente. Você pode ajustar endereço de escuta, porta, número de conexões e consultar credenciais padrão diretamente pela UI do ServBay. Em situações que exigem edição manual (como para testes), os arquivos principais postgresql.conf e pg_hba.conf ficam em /Applications/ServBay/etc/postgresql/<versão>. Independentemente do método escolhido, normalmente é necessário reiniciar o serviço PostgreSQL para que as mudanças sejam aplicadas — isso pode ser feito tanto pela interface quanto pelo comando servbayctl.

Compreender essas opções e procedimentos permite customizar o ambiente do PostgreSQL no ServBay para atender de forma mais eficaz às necessidades de desenvolvimento.