Доступ к серверу PostgreSQL через Localtonet
На этой странице 9 разделов
- Как это работает
- Перед началом
- Создание туннеля
- Откройте страницу TCP - UDP
- Заполните форму
- Запустите туннель и скопируйте адрес
- Подключение снаружи
- Настройки PostgreSQL, важные при работе через туннель
- listen_addresses может оставаться локальным
- pg_hba.conf решает по адресу клиента, а им является клиент Localtonet
- Сохраните тот же адрес
- Защита
- Частые проблемы
- Связанные страницы
Подключайтесь к серверу PostgreSQL на вашей машине из другой сети с помощью psql, pgAdmin, DBeaver или вашего приложения: TCP-туннель даёт порту 5432 публичное имя хоста и порт.
Как это работает #
Клиент Localtonet работает на машине, где размещён PostgreSQL, или на другом устройстве в той же сети. TCP-туннель указывает на порт PostgreSQL, 5432. Localtonet даёт туннелю публичный адрес, состоящий из имени хоста и порта. Клиент PostgreSQL, подключающийся к этому адресу, попадает на ваш сервер. Подробности о TCP-туннелях есть на странице TCP.
Проверьте pg_hba.conf, прежде чем запускать туннель. Соединения через туннель попадают в PostgreSQL от клиента Localtonet, то есть с локального адреса. Если в pg_hba.conf есть правило trust для 127.0.0.1, любой, кто доберётся до туннеля, будет впущен без пароля. См. настройки ниже.
Перед началом #
- Аккаунт Localtonet и клиент Localtonet, подключённый с помощью AuthToken. См. Быстрый старт.
- PostgreSQL запущен на устройстве. Убедитесь, что на самом устройстве команда
psql -h 127.0.0.1 -p 5432 -U <DB_USER> -d <DB_NAME>работает и запрашивает пароль. - Роль PostgreSQL для удалённого доступа, с надёжным паролем и только необходимыми привилегиями. Не используйте суперпользователя
postgres.
Создание туннеля #
-
Откройте страницу TCP - UDP #
Откройте Мои туннели › TCP - UDP и разверните Создать TCP/UDP-туннель.
-
Заполните форму #
Поле Что ввести Протокол TCP Токен устройства Токен, который использует клиент Localtonet на устройстве. Регион сервера Выберите регион, близкий к вашему устройству, чтобы уменьшить задержку. Локальный IP-адрес 127.0.0.1, если PostgreSQL работает на том же устройстве, что и клиент. Для сервера на другой машине в сети укажите адрес этой машины.Локальный порт 5432или значениеportвpostgresql.conf.Тип URL Случайный поддомен. Свой поддомен позволяет выбрать имя, для него нужен баланс. Нажмите Создать туннель.
-
Запустите туннель и скопируйте адрес #
Туннель появится в разделе Ваши туннели. Нажмите Запустить. В столбце URL показан публичный адрес в виде
host:port, а в столбце Порт сервера — отдельно порт.
Подключение снаружи #
В psql хост указывается после -h, а порт — после -p в нижнем регистре. psql запросит пароль.
psql -h <TUNNEL_HOST> -p <TUNNEL_PORT> -U <DB_USER> -d <DB_NAME>Приложения обычно принимают URI подключения. Параметр sslmode=require заставляет клиент отказаться от незашифрованного сеанса:
postgresql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?sslmode=requireВ pgAdmin или DBeaver введите имя хоста туннеля в поле хоста, а порт туннеля — в поле порта.
Настройки PostgreSQL, важные при работе через туннель #
listen_addresses может оставаться локальным #
Клиент Localtonet подключается к PostgreSQL с вашего же устройства. PostgreSQL не обязан слушать публичный интерфейс: значения по умолчанию listen_addresses = 'localhost' достаточно, когда клиент работает на той же машине. Оставьте так, чтобы туннель был единственным путём снаружи.
pg_hba.conf решает по адресу клиента, а им является клиент Localtonet #
PostgreSQL выбирает метод аутентификации в pg_hba.conf по адресу, с которого пришло соединение. При работе через туннель это адрес клиента Localtonet: 127.0.0.1, когда клиент работает на машине с PostgreSQL. Подходящее правило должно требовать пароль:
# TYPE DATABASE USER ADDRESS METHOD
host <DB_NAME> <DB_USER> 127.0.0.1/32 scram-sha-256Замените любое правило trust для 127.0.0.1/32 или ::1/128 и перезагрузите конфигурацию PostgreSQL. Если клиент работает на другом устройстве, укажите в правиле адрес этого устройства и настройте listen_addresses так, чтобы PostgreSQL слушал и на собственном сетевом адресе.
По той же причине адресные правила в pg_hba.conf не позволяют отличить посетителей друг от друга. Ограничивайте посетителей на самом туннеле — через Ограничение по IP.
Сохраните тот же адрес #
Имя хоста остаётся за туннелем. Порт назначает сервер при запуске туннеля. Если в Настройки туннеля включён параметр Порт зарезервирован?, порт остаётся прежним при перезапуске туннеля или клиента Localtonet, а именно это нужно URI подключения в приложении. Если он выключен, при перезапуске порт меняется. Туннели, которые вы создаёте, пока на аккаунте есть баланс, запускаются с включённым Порт зарезервирован?. Чтобы включить его, нужны баланс и запущенный туннель.
При наличии баланса порт можно выбрать и самому в Порт сервера › Сменить, например 5432, если его не использует другой туннель на этом сервере. См. Порты.
Бесплатный тариф. На бесплатном тарифе TCP-туннель останавливается через 30 минут, и его можно запустить снова. После каждого запуска порт может быть другим. См. Тарифы и баланс.
Защита #
- Ограничение по IP. В Настройки туннеля выберите Ограничение по IP › Управлять, выберите Разрешить только эти и добавьте адреса приложений и людей, которые подключаются. Кнопка Мой IP подставляет ваш текущий адрес. Изменения применяются сразу. Для ограничения по IP нужен баланс. См. Контроль доступа.
- Аутентификация по паролю для локальных адресов, как описано выше, и отдельная роль без прав суперпользователя.
- TLS в PostgreSQL. По умолчанию туннели не шифруются от края до края, поэтому пусть сеанс шифрует PostgreSQL: включите
ssl = onс сертификатом на сервере и подключайтесь сsslmode=require. - Лимиты. Срок действия, Лимит трафика и Лимиты скорости в Настройки туннеля ограничивают, как долго и в каком объёме можно использовать туннель. См. Лимиты и сроки действия.
- Журнал запросов › Показать перечисляет подключения к туннелю с IP-адресом посетителя.
Частые проблемы #
psql: connection refused или время подключения истекает
Убедитесь, что туннель запущен и в столбце Подключение стоит ВКЛ, что вы используете актуальный порт из Порт сервера и что PostgreSQL отвечает на устройстве по Локальный IP-адрес и Локальный порт туннеля. Если вы используете ограничение по IP, проверьте, что ваш текущий адрес есть в списке.
FATAL: no pg_hba.conf entry for host "127.0.0.1"
Туннель работает, и PostgreSQL ответил. В pg_hba.conf нет правила, подходящего к адресу клиента Localtonet вместе с вашим пользователем и базой данных. Добавьте правило, показанное выше, и перезагрузите конфигурацию PostgreSQL.
FATAL: password authentication failed for user "…"
Туннель работает. Проверьте пароль роли и то, что он у роли есть: роль, созданная без пароля, не может войти через scram-sha-256.
Меня впустили без пароля
Правило trust подходит к адресу клиента Localtonet. Остановите туннель, замените в правиле метод на scram-sha-256, перезагрузите конфигурацию PostgreSQL и снова запустите туннель.
Приложение потеряло соединение после перезапуска
Порт не зарезервирован, поэтому он изменился при перезапуске туннеля или клиента. Включите Порт зарезервирован? или обновите порт в приложении.
Туннель сам остановился через полчаса
На бесплатном тарифе TCP-туннель останавливается через 30 минут. Нажмите Запустить, чтобы начать новую сессию, или пополните баланс, чтобы снять ограничение на длительность сессии.
«Чтобы пользоваться этой функцией, пополните баланс.»
Порт зарезервирован?, Порт сервера, Ограничение по IP и Свой поддомен требуют баланса. Пополните его в разделе Баланс.