Naar de inhoud
Localtonet Localtonet Dashboard

Een PostgreSQL-server bereiken via Localtonet

Hulp bij deze pagina
Op deze pagina 9 secties
  1. Hoe het werkt
  2. Voordat je begint
  3. De tunnel aanmaken
  4. Open de pagina TCP - UDP
  5. Vul het formulier in
  6. De tunnel starten en het adres kopiëren
  7. Van buitenaf verbinden
  8. PostgreSQL-instellingen die achter een tunnel belangrijk zijn
  9. listen_addresses kan lokaal blijven
  10. pg_hba.conf beslist op basis van het adres van de client, en dat is de Localtonet-client
  11. Hetzelfde adres houden
  12. Beveilig het
  13. Veelvoorkomende problemen
  14. Gerelateerde pagina's

Maak vanuit een ander netwerk verbinding met een PostgreSQL-server op je machine met psql, pgAdmin, DBeaver of je applicatie: een TCP-tunnel geeft poort 5432 een openbare hostnaam en poort.

Hoe het werkt #

De Localtonet-client draait op de machine waarop PostgreSQL staat, of op een ander apparaat in hetzelfde netwerk. Een TCP-tunnel wijst naar de PostgreSQL-poort, 5432. Localtonet geeft de tunnel een openbaar adres dat bestaat uit een hostnaam en een poort. Een PostgreSQL-client die met dat adres verbinding maakt, bereikt je server. De details van TCP-tunnels staan op de pagina TCP.

Controleer pg_hba.conf voordat je de tunnel start. Verbindingen via de tunnel bereiken PostgreSQL vanaf de Localtonet-client, en dat is een lokaal adres. Heeft pg_hba.conf een trust-regel voor 127.0.0.1, dan wordt iedereen die de tunnel bereikt zonder wachtwoord toegelaten. Zie de onderstaande instellingen.

Voordat je begint #

  • Een Localtonet-account en de Localtonet-client, verbonden met je AuthToken. Zie Snelstart.
  • PostgreSQL draait op het apparaat. Controleer of psql -h 127.0.0.1 -p 5432 -U <DB_USER> -d <DB_NAME> op het apparaat zelf werkt en om een wachtwoord vraagt.
  • Een PostgreSQL-rol voor gebruik op afstand, met een sterk wachtwoord en alleen de rechten die nodig zijn. Gebruik niet de superuser postgres.

De tunnel aanmaken #

  1. Open de pagina TCP - UDP #

    Open Mijn tunnels › TCP - UDP en klap TCP-/UDP-tunnel aanmaken open.

  2. Vul het formulier in #

    VeldWat je invult
    ProtocolTCP
    ApparaattokenHet token dat de Localtonet-client op het apparaat gebruikt.
    ServerregioKies een regio dicht bij je apparaat voor een lagere latentie.
    Lokaal IP-adres127.0.0.1 als PostgreSQL op hetzelfde apparaat draait als de client. Voer voor een server op een andere machine in het netwerk het adres van die machine in.
    Lokale poort5432, of de waarde van port in postgresql.conf.
    URL-typeWillekeurig subdomein. Met Eigen subdomein kies je zelf de naam; hiervoor heb je saldo nodig.

    Selecteer Tunnel aanmaken.

  3. De tunnel starten en het adres kopiëren #

    De tunnel verschijnt onder Je tunnels. Selecteer Starten. De kolom URL toont het openbare adres als host:port en de kolom Serverpoort toont de poort apart.

Van buitenaf verbinden #

Bij psql staat de host achter -h en de poort achter een kleine -p. psql vraagt om het wachtwoord.

Terminal
psql -h <TUNNEL_HOST> -p <TUNNEL_PORT> -U <DB_USER> -d <DB_NAME>

Applicaties gebruiken meestal een verbindings-URI. Met sslmode=require weigert de client een onversleutelde sessie:

Verbindings-URI
postgresql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?sslmode=require

Voer in pgAdmin of DBeaver de hostnaam van de tunnel in het hostveld in en de poort van de tunnel in het poortveld.

PostgreSQL-instellingen die achter een tunnel belangrijk zijn #

listen_addresses kan lokaal blijven #

De Localtonet-client maakt vanaf je eigen apparaat verbinding met PostgreSQL. PostgreSQL hoeft niet op een openbare interface te luisteren: de standaardwaarde listen_addresses = 'localhost' is genoeg als de client op dezelfde machine draait. Laat het zo, zodat de tunnel de enige route van buitenaf is.

pg_hba.conf beslist op basis van het adres van de client, en dat is de Localtonet-client #

PostgreSQL kiest de authenticatiemethode uit pg_hba.conf op basis van het adres waarvandaan een verbinding komt. Via de tunnel is dat adres de Localtonet-client: 127.0.0.1 als de client op de PostgreSQL-machine draait. De regel die van toepassing is, moet om een wachtwoord vragen:

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

Vervang elke trust-regel voor 127.0.0.1/32 of ::1/128 en laad PostgreSQL opnieuw. Draait de client op een ander apparaat, gebruik dan het adres van dat apparaat in de regel en stel listen_addresses zo in dat PostgreSQL ook op zijn eigen netwerkadres luistert.

Om dezelfde reden kunnen adresregels in pg_hba.conf bezoekers niet van elkaar onderscheiden. Beperk de bezoekers in plaats daarvan op de tunnel, met IP-beperking.

Hetzelfde adres houden #

De hostnaam blijft bij de tunnel. De poort wordt door de server toegewezen wanneer de tunnel start. Als Gereserveerd? is ingeschakeld in de Instellingen van de tunnel, blijft de poort gelijk wanneer de tunnel of de Localtonet-client opnieuw start, en dat is wat een verbindings-URI in een applicatie nodig heeft. Staat het uit, dan verandert de poort bij een herstart. Tunnels die je aanmaakt terwijl je account saldo heeft, starten met Gereserveerd? ingeschakeld. Om het in te schakelen heb je saldo en een gestarte tunnel nodig.

Met saldo kun je de poort ook kiezen onder Serverpoort › Wijzigen, bijvoorbeeld 5432 als geen andere tunnel op die server die gebruikt. Zie Poorten.

Gratis-abonnement. Een TCP-tunnel stopt na 30 minuten in het Gratis-abonnement en kan opnieuw worden gestart. De poort kan na elke start anders zijn. Zie Abonnementen en saldo.

Beveilig het #

  • IP-beperking. Selecteer in de Instellingen van de tunnel IP-beperking › Beheren, kies Alleen deze toestaan en voeg de adressen toe van de applicaties en mensen die verbinden. Mijn IP gebruiken vult je huidige adres in. Wijzigingen gelden direct. IP-beperking vereist saldo. Zie Toegangsbeheer.
  • Wachtwoordauthenticatie voor lokale adressen, zoals hierboven beschreven, en een speciale rol zonder superuser-rechten.
  • TLS in PostgreSQL. Tunnels zijn standaard niet end-to-end versleuteld, dus laat PostgreSQL de sessie versleutelen: stel ssl = on in met een certificaat op de server en maak verbinding met sslmode=require.
  • Limieten. Met Vervaldatum, Bandbreedtelimiet en Snelheidslimieten in de Instellingen van de tunnel beperk je hoe lang en hoeveel de tunnel kan worden gebruikt. Zie Limieten en vervaldatum.
  • Verzoeklogboek › Tonen toont de verbindingen met de tunnel met het IP-adres van de bezoeker.

Veelvoorkomende problemen #

psql: connection refused, of de verbinding verloopt (time-out)

Controleer of de tunnel is gestart en of de kolom Verbinding AAN toont, of je de huidige poort uit Serverpoort gebruikt en of PostgreSQL op het apparaat antwoordt op het Lokaal IP-adres en de Lokale poort van de tunnel. Gebruik je IP-beperking, controleer dan of je huidige adres in de lijst staat.

FATAL: no pg_hba.conf entry for host "127.0.0.1"

De tunnel werkt en PostgreSQL heeft geantwoord. Geen enkele regel in pg_hba.conf komt overeen met het adres van de Localtonet-client samen met je gebruiker en database. Voeg de hierboven getoonde regel toe en laad PostgreSQL opnieuw.

FATAL: password authentication failed for user "…"

De tunnel werkt. Controleer het wachtwoord van de rol, en of de rol er een heeft: een rol die zonder wachtwoord is aangemaakt, kan niet inloggen met scram-sha-256.

Ik werd zonder wachtwoord toegelaten

Een trust-regel komt overeen met het adres van de Localtonet-client. Stop de tunnel, wijzig de regel in scram-sha-256, laad PostgreSQL opnieuw en start de tunnel daarna opnieuw.

De applicatie verloor na een herstart de verbinding

De poort is niet gereserveerd, dus hij is veranderd toen de tunnel of de client opnieuw werd gestart. Schakel Gereserveerd? in, of werk de poort in de applicatie bij.

De tunnel stopte vanzelf na een half uur

In het Gratis-abonnement stopt een TCP-tunnel na 30 minuten. Selecteer Starten om een nieuwe sessie te beginnen, of voeg saldo toe om de sessielimiet op te heffen.

"Je moet saldo kopen om deze functie te gebruiken."

Gereserveerd?, Serverpoort, IP-beperking en Eigen subdomein vereisen saldo. Voeg het toe onder Saldo.

Support