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