Доступ к серверу MySQL через Localtonet
На этой странице 9 разделов
- Как это работает
- Перед началом
- Создание туннеля
- Откройте страницу TCP - UDP
- Заполните форму
- Запустите туннель и скопируйте адрес
- Подключение снаружи
- Настройки MySQL, важные при работе за туннелем
- Адрес привязки может оставаться локальным
- Хост учётной записи — это клиент Localtonet, а не посетитель
- Сохраните тот же адрес
- Защита
- Частые проблемы
- Связанные страницы
Подключайтесь к серверу 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.
Создание туннеля #
-
Откройте страницу TCP - UDP #
Откройте Мои туннели › TCP - UDP и разверните Создать TCP/UDP-туннель.
-
Заполните форму #
Поле Что ввести Протокол TCP Токен устройства Токен, который использует клиент Localtonet на устройстве. Регион сервера Выберите регион, близкий к вашему устройству, чтобы уменьшить задержку. Локальный IP-адрес 127.0.0.1, если MySQL работает на том же устройстве, что и клиент. Для сервера MySQL на другой машине в сети введите адрес этой машины.Локальный порт 3306или значениеportиз конфигурации MySQL.Тип URL Случайный поддомен. Свой поддомен позволяет выбрать имя и требует баланса. Нажмите Создать туннель.
-
Запустите туннель и скопируйте адрес #
Туннель появится в разделе Ваши туннели. Нажмите Запустить. В столбце URL публичный адрес показан как
host:port, а в столбце Порт сервера — отдельно порт.
Подключение снаружи #
В консольном клиенте mysql хост указывается после -h, а порт — после -P в верхнем регистре. Строчная -p запрашивает пароль.
mysql -h <TUNNEL_HOST> -P <TUNNEL_PORT> -u <DB_USER> -p <DB_NAME>Приложения обычно принимают 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:
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 и Свой поддомен требуют баланса. Пополните его в разделе Баланс.