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

Доступ до сервера PostgreSQL через Localtonet

Допомога зі сторінкою
На цій сторінці 9 розділів
  1. Як це працює
  2. Перш ніж почати
  3. Створення тунелю
  4. Відкрийте сторінку TCP - UDP
  5. Заповніть форму
  6. Запустіть тунель і скопіюйте адресу
  7. Підключення ззовні
  8. Налаштування PostgreSQL, важливі для роботи за тунелем
  9. listen_addresses може залишатися локальним
  10. pg_hba.conf вирішує за адресою клієнта, а це клієнт Localtonet
  11. Зберігайте ту саму адресу
  12. Захистіть доступ
  13. Типові проблеми
  14. Пов’язані сторінки

Підключайтеся до сервера 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.

Створення тунелю #

  1. Відкрийте сторінку TCP - UDP #

    Відкрийте Мої тунелі › TCP/UDP і розгорніть Створити TCP/UDP-тунель.

  2. Заповніть форму #

    ПолеЩо вводити
    ПротоколTCP
    Токен пристроюТокен, який використовує клієнт Localtonet на пристрої.
    Регіон сервераВиберіть регіон, близький до вашого пристрою, щоб зменшити затримку.
    Локальна IP-адреса127.0.0.1, якщо PostgreSQL працює на тому самому пристрої, що й клієнт. Для сервера на іншій машині в мережі вкажіть адресу тієї машини.
    Локальний порт5432 або значення port у postgresql.conf.
    Тип URLВипадковий піддомен. Власний піддомен дає змогу вибрати назву, але потребує балансу.

    Натисніть Створити тунель.

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

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

Підключення ззовні #

У psql хост указується після -h, а порт — після -p малою літерою. psql запитує пароль.

Термінал
psql -h <TUNNEL_HOST> -p <TUNNEL_PORT> -U <DB_USER> -d <DB_NAME>

Застосунки зазвичай приймають URI підключення. sslmode=require змушує клієнт відхиляти незашифровану сесію:

URI підключення
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. Відповідне правило має вимагати пароль:

pg_hba.conf
# 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-обмеження і Власний піддомен потребують балансу. Поповнити його можна в розділі Баланс.

Підтримка