LocaltonetでPostgreSQLサーバーに接続する
このページの内容 9セクション
お使いのマシン上のPostgreSQLサーバーに、別のネットワークからpsql、pgAdmin、DBeaver、またはアプリケーションで接続します。TCPトンネルが、5432番ポートに公開ホスト名とポートを与えます。
仕組み #
Localtonetクライアントは、PostgreSQLを動かしているマシン、または同じネットワーク内の別のデバイスで動作します。TCPトンネルは、PostgreSQLのポート5432を指します。Localtonetはトンネルに、ホスト名とポートから成る公開アドレスを割り当てます。そのアドレスに接続したPostgreSQLクライアントが、お使いのサーバーに到達します。TCPトンネルの詳細はTCPのページにあります。
トンネルを開始する前に、pg_hba.confを確認してください。トンネル経由の接続は、ローカルアドレスであるLocaltonetクライアントからPostgreSQLに届きます。pg_hba.confに127.0.0.1に対するtrustルールがあると、トンネルに到達した人は誰でもパスワードなしで入れてしまいます。下の設定を参照してください。
始める前に #
- Localtonetアカウントと、AuthTokenで接続されたLocaltonetクライアント。クイックスタートを参照してください。
- デバイスで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アドレス PostgreSQLがクライアントと同じデバイスで動作している場合は 127.0.0.1。ネットワーク内の別のマシンにあるサーバーの場合は、そのマシンのアドレスを入力します。ローカルポート 5432、またはpostgresql.confのportの値。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=requirepgAdminやDBeaverでは、ホストの欄にトンネルのホスト名、ポートの欄にトンネルのポートを入力します。
トンネルを使うときに重要なPostgreSQLの設定 #
listen_addressesはローカルのままで構いません #
Localtonetクライアントは、お使いのデバイスからPostgreSQLに接続します。PostgreSQLが公開インターフェースで待ち受ける必要はありません。クライアントが同じマシンで動作している場合は、デフォルトのlisten_addresses = 'localhost'で十分です。外部からの経路がトンネルだけになるよう、そのままにしてください。
pg_hba.confはクライアントのアドレスで判断しますが、それはLocaltonetクライアントです #
PostgreSQLは、接続元のアドレスに基づいてpg_hba.confから認証方式を選びます。トンネル経由の場合、そのアドレスはLocaltonetクライアントで、クライアントがPostgreSQLのマシンで動作しているなら127.0.0.1です。一致するルールではパスワードを要求する必要があります。
# TYPE DATABASE USER ADDRESS METHOD
host <DB_NAME> <DB_USER> 127.0.0.1/32 scram-sha-256127.0.0.1/32または::1/128に対するtrustルールをすべて置き換え、PostgreSQLをリロードしてください。クライアントが別のデバイスで動作している場合は、ルールにそのデバイスのアドレスを使い、PostgreSQLがそのデバイス自身のネットワークアドレスでも待ち受けるようlisten_addressesを設定します。
同じ理由で、pg_hba.confのアドレスルールでは訪問者を区別できません。代わりに、トンネル側でIP制限を使って訪問者を制限してください。
同じアドレスを維持する #
ホスト名はトンネルに紐づいて変わりません。ポートはトンネルの開始時にサーバーが割り当てます。トンネルの設定で予約ポートをオンにすると、トンネルやLocaltonetクライアントを再起動してもポートが変わりません。アプリケーションの接続URIにはこれが必要です。オフの場合は、再起動するとポートが変わります。アカウントに残高がある状態で作成したトンネルは、予約ポートがオンの状態で開始されます。オンにするには、残高と開始済みのトンネルが必要です。
残高があれば、サーバーポート › 変更でポートを選ぶこともできます。そのサーバーで他のトンネルが使っていなければ、たとえば5432にできます。ポートを参照してください。
無料プラン。無料プランでは、TCPトンネルは30分で停止しますが、もう一度開始できます。開始のたびにポートが変わる場合があります。プランと残高を参照してください。
セキュリティを確保する #
- IP制限。トンネルの設定でIP制限 › 管理を選び、これらのみ許可を選択して、接続するアプリケーションや人のアドレスを追加します。自分のIPを使用を押すと現在のアドレスが入力されます。変更はすぐに反映されます。IP制限には残高が必要です。アクセス制御を参照してください。
- 前述のとおり、ローカルアドレスに対するパスワード認証と、スーパーユーザー権限のない専用ロール。
- PostgreSQLのTLS。トンネルはデフォルトではエンドツーエンドで暗号化されないため、PostgreSQLにセッションを暗号化させてください。サーバーに証明書を用意して
ssl = onを設定し、sslmode=requireで接続します。 - 制限。トンネルの設定にある有効期限、帯域幅制限、速度制限で、トンネルを使える期間と量の上限を設定できます。制限と有効期限を参照してください。
- リクエストログ › 表示には、トンネルへの接続が訪問者のIPアドレスとともに一覧表示されます。
よくある問題 #
psql:connection refused、または接続がタイムアウトする
トンネルが開始されていて接続列がオンになっていること、サーバーポートの現在のポートを使っていること、そしてデバイス上のトンネルのローカルIPアドレスとローカルポートでPostgreSQLが応答することを確認してください。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をリロードし、トンネルをもう一度開始してください。
再起動後にアプリケーションの接続が切れた
ポートが予約されていないため、トンネルまたはクライアントの再起動時に変わりました。予約ポートをオンにするか、アプリケーションのポートを更新してください。
30分後にトンネルが勝手に停止した
無料プランでは、TCPトンネルは30分で停止します。開始を選択して新しいセッションを始めるか、残高を追加してセッションの制限をなくしてください。
「この機能を利用するには残高の購入が必要です。」
予約ポート、サーバーポート、IP制限、カスタムサブドメインには残高が必要です。残高から追加してください。