Accéder à un serveur MySQL via Localtonet
Sur cette page 9 sections
- Fonctionnement
- Avant de commencer
- Créer le tunnel
- Ouvrir la page TCP - UDP
- Remplir le formulaire
- Démarrer le tunnel et copier l'adresse
- Se connecter depuis l'extérieur
- Paramètres MySQL importants derrière un tunnel
- L'adresse de liaison peut rester locale
- L'hôte du compte est le client Localtonet, pas le visiteur
- Conserver la même adresse
- Le sécuriser
- Problèmes courants
- 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> -pfonctionne 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 #
-
Ouvrir la page TCP - UDP #
Ouvrez Mes tunnels › TCP - UDP et développez Créer un tunnel TCP - UDP.
-
Remplir le formulaire #
Champ Ce qu'il faut saisir Protocole TCP Jeton d'appareil Le jeton qu'utilise le client Localtonet sur l'appareil. Région du serveur Choisissez une région proche de votre appareil pour une latence plus faible. Adresse IP locale 127.0.0.1lorsque 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 local 3306, ou la valeurportde votre configuration MySQL.Type d'URL Sous-domaine aléatoire. Sous-domaine personnalisé vous permet de choisir le nom et nécessite du solde. Sélectionnez Créer le tunnel.
-
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.
mysql -h <TUNNEL_HOST> -P <TUNNEL_PORT> -u <DB_USER> -p <DB_NAME>Les applications prennent généralement une 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 :
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 SSLet 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.