Ir para o conteúdo
Localtonet Localtonet Painel

Acesse um servidor PostgreSQL pelo Localtonet

Ajuda com esta página
Nesta página 9 seções
  1. Como funciona
  2. Antes de começar
  3. Crie o túnel
  4. Abra a página TCP - UDP
  5. Preencha o formulário
  6. Inicie o túnel e copie o endereço
  7. Conecte-se de fora
  8. Configurações do PostgreSQL que importam por trás de um túnel
  9. listen_addresses pode continuar local
  10. O pg_hba.conf decide pelo endereço do cliente, e esse cliente é o Localtonet
  11. Mantenha o mesmo endereço
  12. Proteja o acesso
  13. Problemas comuns
  14. 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 #

  1. Abra a página TCP - UDP #

    Abra Meus túneis › TCP - UDP e expanda Criar túnel TCP - UDP.

  2. Preencha o formulário #

    CampoO que informar
    ProtocoloTCP
    Token do dispositivoO token que o cliente Localtonet no dispositivo usa.
    Região do servidorEscolha uma região próxima do seu dispositivo para ter menor latência.
    Endereço IP local127.0.0.1 quando 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 local5432 ou o valor de port em postgresql.conf.
    Tipo de URLSubdomínio aleatório. Subdomínio personalizado permite escolher o nome e exige Saldo.

    Selecione Criar túnel.

  3. 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.

Terminal
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:

URI de conexão
postgresql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?sslmode=require

No 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:

pg_hba.conf
# TYPE  DATABASE   USER        ADDRESS         METHOD
host    <DB_NAME>  <DB_USER>   127.0.0.1/32    scram-sha-256

Substitua 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 = on com um certificado no servidor e conecte-se com sslmode=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.

Suporte