Acesse um servidor PostgreSQL pelo Localtonet
Nesta página 9 seções
- Como funciona
- Antes de começar
- Crie o túnel
- Abra a página TCP - UDP
- Preencha o formulário
- Inicie o túnel e copie o endereço
- Conecte-se de fora
- Configurações do PostgreSQL que importam por trás de um túnel
- listen_addresses pode continuar local
- O pg_hba.conf decide pelo endereço do cliente, e esse cliente é o Localtonet
- Mantenha o mesmo endereço
- Proteja o acesso
- Problemas comuns
- Páginas relacionadas
Conecte-se a um servidor PostgreSQL na sua máquina, a partir de outra rede, com psql, pgAdmin, DBeaver ou a sua aplicação: um túnel TCP dá à porta 5432 um nome de host e uma porta públicos.
Como funciona #
O cliente Localtonet roda na máquina que hospeda o PostgreSQL ou em outro dispositivo da mesma rede. Um túnel TCP aponta para a porta do PostgreSQL, 5432. O Localtonet dá ao túnel um endereço público formado por um nome de host e uma porta. Um cliente PostgreSQL que se conecta a esse endereço alcança o seu servidor. Os detalhes dos túneis TCP estão na página TCP.
Verifique o pg_hba.conf antes de iniciar o túnel. As conexões pelo túnel chegam ao PostgreSQL a partir do cliente Localtonet, que é um endereço local. Se o pg_hba.conf tiver uma regra trust para 127.0.0.1, qualquer pessoa que alcance o túnel entra sem senha. Veja as configurações abaixo.
Antes de começar #
- Uma conta Localtonet e o cliente Localtonet conectado com o seu AuthToken. Veja o Início rápido.
- O PostgreSQL em execução no dispositivo. Confira se
psql -h 127.0.0.1 -p 5432 -U <DB_USER> -d <DB_NAME>funciona no próprio dispositivo e pede uma senha. - Uma role do PostgreSQL para uso remoto, com uma senha forte e somente os privilégios de que precisa. Não use o superusuário
postgres.
Crie o túnel #
-
Abra a página TCP - UDP #
Abra Meus túneis › TCP - UDP e expanda Criar túnel TCP - UDP.
-
Preencha o formulário #
Campo O que informar Protocolo TCP Token do dispositivo O token que o cliente Localtonet no dispositivo usa. Região do servidor Escolha uma região próxima do seu dispositivo para ter menor latência. Endereço IP local 127.0.0.1quando o PostgreSQL roda no mesmo dispositivo que o cliente. Para um servidor em outra máquina da rede, informe o endereço dessa máquina.Porta local 5432ou o valor deportempostgresql.conf.Tipo de URL Subdomínio aleatório. Subdomínio personalizado permite escolher o nome e exige Saldo. Selecione Criar túnel.
-
Inicie o túnel e copie o endereço #
O túnel aparece em Seus túneis. Selecione Iniciar. A coluna URL mostra o endereço público no formato
host:port, e a coluna Porta do servidor mostra só a porta.
Conecte-se de fora #
Com o psql, o host vai depois de -h e a porta depois de -p em minúsculas. O psql pede a senha.
psql -h <TUNNEL_HOST> -p <TUNNEL_PORT> -U <DB_USER> -d <DB_NAME>As aplicações geralmente aceitam uma URI de conexão. sslmode=require faz o cliente recusar uma sessão não criptografada:
postgresql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?sslmode=requireNo pgAdmin ou no DBeaver, informe o nome de host do túnel no campo de host e a porta do túnel no campo de porta.
Configurações do PostgreSQL que importam por trás de um túnel #
listen_addresses pode continuar local #
O cliente Localtonet se conecta ao PostgreSQL a partir do seu próprio dispositivo. O PostgreSQL não precisa escutar em uma interface pública: o padrão listen_addresses = 'localhost' basta quando o cliente roda na mesma máquina. Deixe assim, para que o túnel seja o único caminho vindo de fora.
O pg_hba.conf decide pelo endereço do cliente, e esse cliente é o Localtonet #
O PostgreSQL escolhe o método de autenticação no pg_hba.conf pelo endereço de onde a conexão vem. Pelo túnel, esse endereço é o do cliente Localtonet: 127.0.0.1 quando o cliente roda na máquina do PostgreSQL. A regra correspondente deve exigir uma senha:
# TYPE DATABASE USER ADDRESS METHOD
host <DB_NAME> <DB_USER> 127.0.0.1/32 scram-sha-256Substitua qualquer regra trust para 127.0.0.1/32 ou ::1/128 e recarregue o PostgreSQL. Se o cliente roda em outro dispositivo, use na regra o endereço desse dispositivo e defina listen_addresses para que o PostgreSQL também escute no próprio endereço de rede.
Pelo mesmo motivo, as regras de endereço no pg_hba.conf não conseguem distinguir os visitantes. Limite os visitantes no túnel, com Restrição de IP.
Mantenha o mesmo endereço #
O nome do host permanece com o túnel. A porta é atribuída pelo servidor quando o túnel é iniciado. Com Porta reservada? ativada nas Configurações do túnel, a porta continua a mesma quando o túnel ou o cliente Localtonet é reiniciado, que é o que uma URI de conexão em uma aplicação precisa. Com a opção desativada, a porta muda a cada reinício. Os túneis que você cria enquanto sua conta tem Saldo já começam com Porta reservada? ativada. Para ativá-la, é preciso ter Saldo e um túnel iniciado.
Com Saldo, você também pode escolher a porta em Porta do servidor › Alterar, por exemplo 5432, se nenhum outro túnel nesse servidor a usar. Veja Portas.
Plano Grátis. Um túnel TCP para após 30 minutos no plano Grátis e pode ser iniciado de novo. A porta pode ser diferente a cada início. Veja Planos e Saldo.
Proteja o acesso #
- Restrição de IP. Nas Configurações do túnel, selecione Restrição de IP › Gerenciar, escolha Permitir só estes e adicione os endereços das aplicações e das pessoas que se conectam. Usar meu IP preenche o seu endereço atual. As alterações valem na hora. A Restrição de IP exige Saldo. Veja Controle de acesso.
- Autenticação por senha para endereços locais, como descrito acima, e uma role dedicada sem direitos de superusuário.
- TLS no PostgreSQL. Os túneis não são criptografados de ponta a ponta por padrão, então deixe o PostgreSQL criptografar a sessão: defina
ssl = oncom um certificado no servidor e conecte-se comsslmode=require. - Limites. Data de expiração, Limite de banda e Limites de velocidade nas Configurações do túnel definem por quanto tempo e em que volume o túnel pode ser usado. Veja Limites e expiração.
- Log de requisições › Mostrar lista as conexões feitas ao túnel com o endereço IP do visitante.
Problemas comuns #
psql: connection refused, ou a conexão expira
Verifique se o túnel foi iniciado e se a coluna Conexão dele mostra LIG, se você usa a porta atual de Porta do servidor e se o PostgreSQL responde no dispositivo, no Endereço IP local e na Porta local do túnel. Se você usa Restrição de IP, confira se o seu endereço atual está na lista.
FATAL: no pg_hba.conf entry for host "127.0.0.1"
O túnel funciona e o PostgreSQL respondeu. Nenhuma regra do pg_hba.conf corresponde ao endereço do cliente Localtonet junto com o seu usuário e banco de dados. Adicione a regra mostrada acima e recarregue o PostgreSQL.
FATAL: password authentication failed for user "…"
O túnel funciona. Confira a senha da role e se ela tem uma: uma role criada sem senha não consegue entrar com scram-sha-256.
Entrei sem senha
Uma regra trust corresponde ao endereço do cliente Localtonet. Pare o túnel, altere a regra para scram-sha-256, recarregue o PostgreSQL e inicie o túnel de novo.
O aplicativo perdeu a conexão após uma reinicialização
A porta não está reservada, então ela mudou quando o túnel ou o cliente foi reiniciado. Ative Porta reservada? ou atualize a porta na aplicação.
O túnel parou sozinho depois de meia hora
No plano Grátis, um túnel TCP para após 30 minutos. Selecione Iniciar para começar outra sessão ou adicione Saldo para remover o limite de sessão.
"Você precisa comprar saldo para usar este recurso."
Porta reservada?, Porta do servidor, Restrição de IP e Subdomínio personalizado exigem Saldo. Adicione-o em Saldo.