コンテンツへスキップ
Localtonet Localtonet ダッシュボード

LocaltonetでPostgreSQLサーバーに接続する

このページのヘルプ
このページの内容 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を確認してください。トンネル経由の接続は、ローカルアドレスである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スーパーユーザーは使わないでください。

トンネルを作成する #

  1. TCP - UDPページを開く #

    マイトンネル › TCP - UDPを開き、TCP - UDPトンネルを作成を展開します。

  2. フォームに入力する #

    項目入力する内容
    プロトコルTCP
    デバイストークンデバイス上のLocaltonetクライアントが使うトークン。
    サーバーリージョンレイテンシを下げるため、デバイスに近いリージョンを選びます。
    ローカルIPアドレスPostgreSQLがクライアントと同じデバイスで動作している場合は127.0.0.1。ネットワーク内の別のマシンにあるサーバーの場合は、そのマシンのアドレスを入力します。
    ローカルポート5432、またはpostgresql.confのportの値。
    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クライアントで、クライアントがPostgreSQLのマシンで動作しているなら127.0.0.1です。一致するルールではパスワードを要求する必要があります。

pg_hba.conf
# TYPE  DATABASE   USER        ADDRESS         METHOD
host    <DB_NAME>  <DB_USER>   127.0.0.1/32    scram-sha-256

127.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制限、カスタムサブドメインには残高が必要です。残高から追加してください。

サポート