Перейти к содержимому
Localtonet Localtonet Панель управления

Доступ к серверу MySQL через Localtonet

Помощь по этой странице
На этой странице 9 разделов
  1. Как это работает
  2. Перед началом
  3. Создание туннеля
  4. Откройте страницу TCP - UDP
  5. Заполните форму
  6. Запустите туннель и скопируйте адрес
  7. Подключение снаружи
  8. Настройки MySQL, важные при работе за туннелем
  9. Адрес привязки может оставаться локальным
  10. Хост учётной записи — это клиент Localtonet, а не посетитель
  11. Сохраните тот же адрес
  12. Защита
  13. Частые проблемы
  14. Связанные страницы

Подключайтесь к серверу MySQL или MariaDB на вашей машине из другой сети: TCP-туннель даёт порту 3306 публичное имя хоста и порт, которыми может пользоваться любой клиент MySQL.

Как это работает #

Клиент Localtonet работает на машине, где размещён MySQL, или на другом устройстве в той же сети. TCP-туннель указывает на порт MySQL, 3306. Localtonet даёт туннелю публичный адрес из имени хоста и порта. Клиент MySQL, подключающийся к этому адресу, попадает на ваш сервер. Подробности о TCP-туннелях есть на странице TCP.

Не открывайте базу данных без контроля доступа. Запущенный туннель доступен любому, кто знает его адрес. Прочитайте раздел Защита, прежде чем размещать за туннелем реальные данные.

Перед началом #

  • Аккаунт Localtonet и клиент Localtonet, подключённый с вашим AuthToken. См. Быстрый старт.
  • MySQL, запущенный на устройстве. Убедитесь, что на самом устройстве работает команда mysql -h 127.0.0.1 -P 3306 -u <DB_USER> -p.
  • Учётная запись MySQL для удалённого доступа с надёжным паролем и только необходимыми привилегиями. Не используйте root.

Создание туннеля #

  1. Откройте страницу TCP - UDP #

    Откройте Мои туннели › TCP - UDP и разверните Создать TCP/UDP-туннель.

  2. Заполните форму #

    ПолеЧто ввести
    ПротоколTCP
    Токен устройстваТокен, который использует клиент Localtonet на устройстве.
    Регион сервераВыберите регион, близкий к вашему устройству, чтобы уменьшить задержку.
    Локальный IP-адрес127.0.0.1, если MySQL работает на том же устройстве, что и клиент. Для сервера MySQL на другой машине в сети введите адрес этой машины.
    Локальный порт3306 или значение port из конфигурации MySQL.
    Тип URLСлучайный поддомен. Свой поддомен позволяет выбрать имя и требует баланса.

    Нажмите Создать туннель.

  3. Запустите туннель и скопируйте адрес #

    Туннель появится в разделе Ваши туннели. Нажмите Запустить. В столбце URL публичный адрес показан как host:port, а в столбце Порт сервера — отдельно порт.

Подключение снаружи #

В консольном клиенте mysql хост указывается после -h, а порт — после -P в верхнем регистре. Строчная -p запрашивает пароль.

Терминал
mysql -h <TUNNEL_HOST> -P <TUNNEL_PORT> -u <DB_USER> -p <DB_NAME>

Приложения обычно принимают URL подключения:

URL подключения
mysql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>

В графическом клиенте, например MySQL Workbench или DBeaver, введите имя хоста туннеля как хост, а порт туннеля как порт. Не оставляйте порт 3306, если вы не задали для туннеля Порт сервера 3306.

Настройки MySQL, важные при работе за туннелем #

Адрес привязки может оставаться локальным #

Клиент Localtonet подключается к MySQL с вашего собственного устройства. MySQL не обязан слушать публичный интерфейс: когда клиент работает на той же машине, достаточно bind-address = 127.0.0.1. Оставьте так, чтобы единственным путём снаружи был туннель.

Хост учётной записи — это клиент Localtonet, а не посетитель #

Учётные записи MySQL состоят из имени пользователя и хоста, с которого приходит подключение. Через туннель все подключения приходят от клиента Localtonet. Когда клиент работает на машине с MySQL, этим хостом является localhost:

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

Если сервер запущен с включённым skip_name_resolve, используйте '127.0.0.1' вместо 'localhost'. Если клиент работает на другом устройстве, используйте адрес этого устройства в сети.

Это также означает, что правила хостов в MySQL не позволяют различать посетителей: все, кто достигает туннеля, приходят как один и тот же хост. Ограничивайте посетителей на уровне туннеля с помощью Ограничения по IP.

Сохраните тот же адрес #

Имя хоста остаётся за туннелем. Порт назначается сервером при запуске туннеля. Если в Настройках туннеля включён параметр Порт зарезервирован?, порт остаётся тем же при перезапуске туннеля или клиента Localtonet, и именно это нужно строке подключения в приложении. Если параметр выключен, при перезапуске порт меняется. Туннели, которые вы создаёте, пока на аккаунте есть баланс, запускаются с включённым Порт зарезервирован?. Для включения нужны баланс и запущенный туннель.

С балансом вы можете также выбрать порт в разделе Порт сервера › Сменить, например 3306, если его не использует другой туннель на этом сервере. См. Порты.

Бесплатный тариф. TCP-туннель на бесплатном тарифе останавливается через 30 минут и может быть запущен снова. После каждого запуска порт может быть другим. См. Тарифы и баланс.

Защита #

  • Ограничение по IP. В Настройках туннеля выберите Ограничение по IP › Управлять, отметьте Разрешить только эти и добавьте адреса приложений и людей, которые подключаются. Допускается один адрес, диапазон вроде 10.0.0.0/16 или сразу несколько. Изменения применяются сразу. Для ограничения по IP нужен баланс. См. Контроль доступа.
  • Отдельная учётная запись с надёжным паролем и минимальным набором привилегий, как в примере выше. Удалите учётные записи без пароля.
  • TLS в MySQL. Туннели по умолчанию не шифруются от конца до конца, поэтому пусть MySQL шифрует сеанс: создайте учётную запись с REQUIRE SSL и подключайтесь с --ssl-mode=REQUIRED (клиент MariaDB использует --ssl).
  • Лимиты. Срок действия, Лимит трафика и Лимиты скорости в Настройках туннеля ограничивают, как долго и в каком объёме можно пользоваться туннелем. См. Лимиты и срок действия.
  • Журнал запросов › Показать перечисляет подключения к туннелю с IP-адресом посетителя.

Частые проблемы #

ERROR 2003: Can't connect to MySQL server

Клиент не смог открыть соединение. Убедитесь, что туннель запущен и в столбце Подключение стоит ВКЛ, что вы используете актуальный порт из Порт сервера и что MySQL отвечает на устройстве по Локальному IP-адресу и Локальному порту туннеля. Если вы используете ограничение по IP, проверьте, что ваш текущий адрес есть в списке.

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

Туннель работает, и MySQL ответил. Хост в сообщении — это клиент Localtonet, как объяснено выше. Проверьте пароль и убедитесь, что существует учётная запись именно для этого пользователя и хоста.

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

Ни одна учётная запись не соответствует хосту, который видит MySQL. Создайте учётную запись для хоста, указанного в сообщении.

Приложение потеряло соединение после перезапуска

Порт не зарезервирован, поэтому он изменился при перезапуске туннеля или клиента. Включите Порт зарезервирован? или обновите порт в приложении.

Туннель сам остановился через полчаса

На бесплатном тарифе TCP-туннель останавливается через 30 минут. Нажмите Запустить, чтобы начать новый сеанс, или пополните баланс, чтобы снять ограничение сеанса.

«Чтобы пользоваться этой функцией, пополните баланс.»

Порт зарезервирован?, Порт сервера, Ограничение по IP и Свой поддомен требуют баланса. Пополните его в разделе Баланс.

Поддержка