Aller au contenu
Localtonet Localtonet Tableau de bord

Accéder à un serveur MySQL 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 MySQL importants derrière un tunnel
  9. L'adresse de liaison peut rester locale
  10. L'hôte du compte est le client Localtonet, pas le visiteur
  11. Conserver la même adresse
  12. Le sécuriser
  13. Problèmes courants
  14. Pages associées

Connectez-vous depuis un autre réseau à un serveur MySQL ou MariaDB de votre machine : un tunnel TCP donne au port 3306 un nom d'hôte et un port publics que n'importe quel client MySQL peut utiliser.

Fonctionnement #

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

N'exposez pas une base de données sans contrôle d'accès. Un tunnel démarré est accessible à toute personne qui connaît son adresse. Lisez Sécuriser l'accès avant de placer des données réelles derrière un tunnel.

Avant de commencer #

  • Un compte Localtonet et le client Localtonet connecté avec votre AuthToken. Voir Démarrage rapide.
  • MySQL en cours d'exécution sur l'appareil. Vérifiez que mysql -h 127.0.0.1 -P 3306 -u <DB_USER> -p fonctionne sur l'appareil lui-même.
  • Un compte MySQL destiné à l'usage à distance, avec un mot de passe robuste et uniquement les privilèges nécessaires. N'utilisez pas root.

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 MySQL s'exécute sur le même appareil que le client. Pour un serveur MySQL sur une autre machine du réseau, saisissez l'adresse de cette machine.
    Port local3306, ou la valeur port de votre configuration MySQL.
    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 le client en ligne de commande mysql, l'hôte se place après -h et le port après un -P en majuscule. Le -p en minuscule demande le mot de passe.

Terminal
mysql -h <TUNNEL_HOST> -P <TUNNEL_PORT> -u <DB_USER> -p <DB_NAME>

Les applications prennent généralement une URL de connexion :

URL de connexion
mysql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>

Dans un client graphique tel que MySQL Workbench ou DBeaver, saisissez le nom d'hôte du tunnel comme hôte et le port du tunnel comme port. Ne laissez pas le port à 3306, sauf si vous avez défini le Port du serveur du tunnel sur 3306.

Paramètres MySQL importants derrière un tunnel #

L'adresse de liaison peut rester locale #

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

L'hôte du compte est le client Localtonet, pas le visiteur #

Les comptes MySQL se composent d'un nom d'utilisateur et de l'hôte d'où provient la connexion. Via le tunnel, toutes les connexions proviennent du client Localtonet. Lorsque le client s'exécute sur la machine MySQL, cet hôte est localhost :

MySQL
CREATE USER '<DB_USER>'@'localhost' IDENTIFIED BY '<DB_PASSWORD>';
GRANT SELECT, INSERT, UPDATE, DELETE ON <DB_NAME>.* TO '<DB_USER>'@'localhost';

Si le serveur s'exécute avec skip_name_resolve activé, utilisez '127.0.0.1' au lieu de 'localhost'. Si le client s'exécute sur un autre appareil, utilisez l'adresse de cet appareil dans le réseau.

Cela signifie aussi que les règles d'hôte de MySQL ne peuvent pas distinguer les visiteurs : tous ceux qui atteignent le tunnel arrivent avec le même hôte. Limitez plutôt les visiteurs au niveau du tunnel, avec Restriction IP.

Conserver la même adresse #

Le nom d'hôte reste lié 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 une chaîne de connexion d'application a besoin. Désactivé, le port change à chaque redémarrage. Les tunnels que vous créez alors que votre compte dispose de 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 3306 si aucun autre tunnel de ce serveur ne l'utilise. Voir 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 après chaque démarrage. Voir 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. Une adresse unique, une plage telle que 10.0.0.0/16, ou plusieurs à la fois sont acceptées. Les modifications s'appliquent immédiatement. Restriction IP nécessite du solde. Voir Contrôle d'accès.
  • Un compte dédié avec un mot de passe robuste et le plus petit ensemble de privilèges possible, comme dans l'exemple ci-dessus. Supprimez les comptes sans mot de passe.
  • TLS dans MySQL. Les tunnels ne sont pas chiffrés de bout en bout par défaut : faites donc chiffrer la session par MySQL. Créez le compte avec REQUIRE SSL et connectez-vous avec --ssl-mode=REQUIRED (le client MariaDB utilise --ssl).
  • 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. Voir Limites et expiration.
  • Journal des requêtes › Afficher liste les connexions établies vers le tunnel avec l'adresse IP du visiteur.

Problèmes courants #

ERROR 2003: Can't connect to MySQL server

Le client n'a pas pu ouvrir de connexion. Vérifiez que le tunnel est démarré et que sa colonne Connexion affiche ON, que vous utilisez le port actuel de Port du serveur, et que MySQL répond sur l'appareil à l'Adresse IP locale et au Port local du tunnel. Si vous utilisez Restriction IP, vérifiez que votre adresse actuelle figure dans la liste.

ERROR 1045: Access denied for user '…'@'localhost'

Le tunnel fonctionne et MySQL a répondu. L'hôte indiqué dans le message est le client Localtonet, comme expliqué plus haut. Vérifiez le mot de passe, et vérifiez qu'un compte existe exactement pour cet utilisateur et cet hôte.

ERROR 1130: Host '…' is not allowed to connect to this MySQL server

Aucun compte ne correspond à l'hôte que voit MySQL. Créez le compte pour l'hôte indiqué dans le message.

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