Aller au contenu
Localtonet Localtonet Tableau de bord

Accéder à un serveur PostgreSQL via Localtonet

Aide pour cette page
Sur cette page 9 sections
  1. Fonctionnement
  2. Avant de commencer
  3. Créer le tunnel
  4. Ouvrir la page TCP - UDP
  5. Remplir le formulaire
  6. Démarrer le tunnel et copier l'adresse
  7. Se connecter depuis l'extérieur
  8. Paramètres PostgreSQL importants derrière un tunnel
  9. listen_addresses peut rester local
  10. pg_hba.conf décide selon l'adresse du client, et c'est le client Localtonet
  11. Conserver la même adresse
  12. Le sécuriser
  13. Problèmes courants
  14. Pages associées

Connectez-vous à un serveur PostgreSQL de votre machine depuis un autre réseau avec psql, pgAdmin, DBeaver ou votre application : un tunnel TCP donne au port 5432 un nom d'hôte et un port publics.

Fonctionnement #

Le client Localtonet s'exécute sur la machine qui héberge PostgreSQL, ou sur un autre appareil du même réseau. Un tunnel TCP pointe vers le port de PostgreSQL, 5432. Localtonet donne au tunnel une adresse publique composée d'un nom d'hôte et d'un port. Un client PostgreSQL qui se connecte à cette adresse atteint votre serveur. Les détails des tunnels TCP se trouvent sur la page TCP.

Vérifiez pg_hba.conf avant de démarrer le tunnel. Les connexions passant par le tunnel atteignent PostgreSQL depuis le client Localtonet, qui est une adresse locale. Si pg_hba.conf contient une règle trust pour 127.0.0.1, toute personne qui atteint le tunnel est admise sans mot de passe. Consultez les paramètres ci-dessous.

Avant de commencer #

  • Un compte Localtonet et le client Localtonet connecté avec votre AuthToken. Consultez le Démarrage rapide.
  • PostgreSQL en cours d'exécution sur l'appareil. Vérifiez que psql -h 127.0.0.1 -p 5432 -U <DB_USER> -d <DB_NAME> fonctionne sur l'appareil lui-même et demande un mot de passe.
  • Un rôle PostgreSQL pour l'accès à distance, avec un mot de passe robuste et seulement les privilèges nécessaires. N'utilisez pas le superutilisateur postgres.

Créer le tunnel #

  1. Ouvrir la page TCP - UDP #

    Ouvrez Mes tunnels › TCP - UDP et développez Créer un tunnel TCP - UDP.

  2. Remplir le formulaire #

    ChampCe qu'il faut saisir
    ProtocoleTCP
    Jeton d'appareilLe jeton qu'utilise le client Localtonet sur l'appareil.
    Région du serveurChoisissez une région proche de votre appareil pour une latence plus faible.
    Adresse IP locale127.0.0.1 lorsque PostgreSQL s'exécute sur le même appareil que le client. Pour un serveur situé sur une autre machine du réseau, saisissez l'adresse de cette machine.
    Port local5432, ou la valeur port de postgresql.conf.
    Type d'URLSous-domaine aléatoire. Sous-domaine personnalisé vous permet de choisir le nom et nécessite du solde.

    Sélectionnez Créer le tunnel.

  3. Démarrer le tunnel et copier l'adresse #

    Le tunnel apparaît sous Vos tunnels. Sélectionnez Démarrer. La colonne URL affiche l'adresse publique sous la forme host:port, et la colonne Port du serveur affiche le port seul.

Se connecter depuis l'extérieur #

Avec psql, l'hôte se place après -h et le port après un -p en minuscule. psql demande le mot de passe.

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

Les applications prennent généralement une URI de connexion. sslmode=require fait refuser au client une session non chiffrée :

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

Dans pgAdmin ou DBeaver, saisissez le nom d'hôte du tunnel dans le champ hôte et le port du tunnel dans le champ port.

Paramètres PostgreSQL importants derrière un tunnel #

listen_addresses peut rester local #

Le client Localtonet se connecte à PostgreSQL depuis votre propre appareil. PostgreSQL n'a pas besoin d'écouter sur une interface publique : la valeur par défaut listen_addresses = 'localhost' suffit lorsque le client s'exécute sur la même machine. Laissez-la ainsi, pour que le tunnel soit le seul chemin depuis l'extérieur.

pg_hba.conf décide selon l'adresse du client, et c'est le client Localtonet #

PostgreSQL choisit la méthode d'authentification dans pg_hba.conf selon l'adresse d'où provient une connexion. Via le tunnel, cette adresse est celle du client Localtonet : 127.0.0.1 lorsque le client s'exécute sur la machine PostgreSQL. La règle correspondante doit exiger un mot de passe :

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

Remplacez toute règle trust pour 127.0.0.1/32 ou ::1/128 et rechargez PostgreSQL. Si le client s'exécute sur un autre appareil, utilisez l'adresse de cet appareil dans la règle, et définissez listen_addresses pour que PostgreSQL écoute aussi sur sa propre adresse réseau.

Pour la même raison, les règles d'adresse de pg_hba.conf ne peuvent pas distinguer les visiteurs. Limitez plutôt les visiteurs sur le tunnel, avec Restriction IP.

Conserver la même adresse #

Le nom d'hôte reste attaché au tunnel. Le port est attribué par le serveur au démarrage du tunnel. Avec Réservé ? activé dans les Paramètres du tunnel, le port reste identique lorsque le tunnel ou le client Localtonet redémarre, ce dont a besoin une URI de connexion dans une application. Désactivé, le port change à chaque redémarrage. Les tunnels que vous créez lorsque votre compte a du solde démarrent avec Réservé ? activé. L'activer nécessite du solde et un tunnel démarré.

Avec du solde, vous pouvez aussi choisir le port sous Port du serveur › Modifier, par exemple 5432 si aucun autre tunnel de ce serveur ne l'utilise. Consultez Ports.

Offre gratuite. Un tunnel TCP s'arrête au bout de 30 minutes avec l'offre gratuite et peut être redémarré. Le port peut être différent à chaque démarrage. Consultez Offres et solde.

Le sécuriser #

  • Restriction IP. Dans les Paramètres du tunnel, sélectionnez Restriction IP › Gérer, choisissez Autoriser uniquement ceux-ci et ajoutez les adresses des applications et des personnes qui se connectent. Utiliser mon IP renseigne votre adresse actuelle. Les modifications s'appliquent immédiatement. La restriction IP nécessite du solde. Consultez Contrôle d'accès.
  • Authentification par mot de passe pour les adresses locales, comme décrit ci-dessus, et un rôle dédié sans droits de superutilisateur.
  • TLS dans PostgreSQL. Les tunnels ne sont pas chiffrés de bout en bout par défaut : laissez donc PostgreSQL chiffrer la session. Définissez ssl = on avec un certificat sur le serveur et connectez-vous avec sslmode=require.
  • Limites. Date d'expiration, Limite de bande passante et Limites de vitesse dans les Paramètres du tunnel plafonnent la durée et le volume d'utilisation du tunnel. Consultez Limites et expiration.
  • Journal des requêtes › Afficher liste les connexions établies vers le tunnel avec l'adresse IP du visiteur.

Problèmes courants #

psql : connection refused, ou la connexion expire

Vérifiez que le tunnel est démarré et que sa colonne Connexion indique ON, que vous utilisez le port actuel de Port du serveur, et que PostgreSQL répond sur l'appareil à l'Adresse IP locale et au Port local du tunnel. Si vous utilisez la restriction IP, vérifiez que votre adresse actuelle figure dans la liste.

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

Le tunnel fonctionne et PostgreSQL a répondu. Aucune règle de pg_hba.conf ne correspond à l'adresse du client Localtonet avec votre utilisateur et votre base de données. Ajoutez la règle indiquée ci-dessus et rechargez PostgreSQL.

FATAL: password authentication failed for user "…"

Le tunnel fonctionne. Vérifiez le mot de passe du rôle, et que le rôle en a bien un : un rôle créé sans mot de passe ne peut pas se connecter avec scram-sha-256.

J'ai été admis sans mot de passe

Une règle trust correspond à l'adresse du client Localtonet. Arrêtez le tunnel, remplacez la règle par scram-sha-256, rechargez PostgreSQL, puis redémarrez le tunnel.

L'application a perdu sa connexion après un redémarrage

Le port n'est pas réservé : il a donc changé lorsque le tunnel ou le client a redémarré. Activez Réservé ?, ou mettez à jour le port dans l'application.

Le tunnel s'est arrêté tout seul au bout d'une demi-heure

Avec l'offre gratuite, un tunnel TCP s'arrête au bout de 30 minutes. Sélectionnez Démarrer pour commencer une autre session, ou ajoutez du solde pour supprimer la limite de session.

« Vous devez acheter du solde pour utiliser cette fonctionnalité. »

Réservé ?, Port du serveur, Restriction IP et Sous-domaine personnalisé nécessitent du solde. Ajoutez-en sous Solde.

Support