どこかのサーバーにデータベースがあり、それをノート PC から使いたいとします——クエリを実行する、GUI をつなぐ、マイグレーションツールを接続させる、といったことです。それは 5432(Postgres)や 3306(MySQL)で待ち受けていますが、いまのところノート PC からは届きません。データベースが、外部からの経路を持たないプライベートネットワーク上にあるからです。そこで最速の橋を探すと、インターネットは、すぐに使えて、しかもプライベートネットワークが守っていたものをひっそりと手放させる近道を差し出します。
間違い:データベースのポートを世界に開く
その近道は、データベースを到達可能にすることです。127.0.0.1 ではなく 0.0.0.0 にバインドし、セキュリティグループにポート 5432 の穴を開ける。これでどこからでも接続できます。一発で動いてしまう——それこそが危険な理由です。
公開インターネット上のデータベースポートは、常設の標的です。Postgres と MySQL はよく知られたポートで話し、インターネット全体が絶えずそれらを求めてスキャンされています。5432 のリスナーは、立ち上がってから数分でログイン試行を集め始めます。いまやインターネットとあなたのデータの間にあるのは、データベース自身のパスワード、1 つのプロトコルの癖、あるいは 1 つの CVE だけです。マネージドデータベースは、これをうっかりやらせません。RDS、Cloud SQL などが既定でパブリック IP のないプライベートサブネットになっているのは、まさに、データベースこそインターネットに面させたくない最たるものだからです。それでも開けてしまう——「いまだけ」の 0.0.0.0/0 ルール——のは、数分の節約のために設計全体を手放すことです。正しい対処も同じくらいわずかなコストで、しかも何も犠牲にしません。
データベースへの SSH トンネルが実際にしていること
あなたはほぼ確実に、そのネットワークへの入り口をすでに持っています。データベースが見えるサーバーへの SSH ログインです——アプリサーバー、踏み台、同じサブネット上のどれかのマシンです。SSH のポート転送を使えば、新しいものを何もさらさずに、その到達性を借りられます。
ssh -L 5432:db.internal:5432 deploy@bastion.example.com
左から右へ読みます。自分のノート PC 上でポート 5432 を開き、そこに届いたものを 踏み台から解決した db.internal:5432 へ転送する、という意味です。あとはクライアントを localhost に向けます。
psql -h 127.0.0.1 -p 5432 -U app appdb
psql は自分のマシンに接続します。SSH が、あなたがすでに持っていた接続の上で、バイトを暗号化して運びます。踏み台は、プライベートネットワークの内側から db.internal への素の接続を開きます——そこでは許されているからです。データベースから見れば何も変わっていません。相変わらず自分のネットワークからの接続しか受け付けません。そして、インターネットのどこにも新しいポートは開かれていません。露出なしに到達性を手に入れたわけです。
誰もがつまずく唯一の細部はこれです。db.internal は、あなたのノート PC ではなく、踏み台、つまり向こう側で解決されます。プライベートネットワークしか知らない名前でも、あなたのノート PC がルーティングできない生のアドレスでも構いません。
# the database only the bastion can see, by private IP
ssh -L 5432:10.0.0.9:5432 deploy@bastion.example.com
これがトリックのすべてで、ローカル・リモート・ダイナミックまで含めて SSH ポート転送の解説で詳しく扱っています。ここで必要なのはローカル(-L)のケースだけです。
トンネルが始まるのは踏み台
トンネルを通すマシンは、たいてい、プライベートネットワークでシェルを得るためにあなたがすでに踏み越えているのと同じゲートウェイです。内部サーバーに ProxyJump で到達しているなら、データベーストンネルに必要な部品はもう手元にあります。この 2 つは補い合う関係です。ProxyJump は、あなたのシェルをゲートウェイの奥のホストに届け、-L は、向こう側からサービスのポートをあなたの localhost へ持ち帰ります。ゲートウェイを2 つ越えなければならないなら、連ねます。
ssh -J bastion.example.com -L 5432:db.internal:5432 deploy@app.internal
それでもトンネルがうまくいかない理由
仕組みそのものはきれいです。ほころびが出るのは、トンネルを手作業で回す日々の運用です。
- コマンドはシェル履歴の中で腐っていきます。 翌週には、どのローカルポートが、どの踏み台で、どの環境の、どのデータベースに対応していたのかを組み立て直すはめになります。ステージングも本番もどちらも
5432を使いたがり、ノート PC では一度に 1 つしか得られません。 - ローカルポートは、あなたのマシン上のあらゆるプロセスに開かれています。
-L 5432は127.0.0.1:5432で待ち受けます。トンネルが上がっている間、ノート PC 上のどのプログラムも、SSH 認証なしでそれを通して本番データベースに到達できます。(そして-L 0.0.0.0:5432:...は、それを LAN 全体にひっそりとさらします。) - トンネルはセッションの途中で死に、クエリを道連れにします。 ノート PC のスリープ、Wi-Fi の切り替え、アイドルタイムアウト——どれかで転送は何も言わずに落ちます。たいていは
-N、-f、ServerAliveInterval 30で解決しますが、最初はそのどれも思い出せません。 - データベース 1 つにつき
ssh -L1 つ。 プライマリ、リードレプリカ、MySQL のマシン、Redis——これで 4 つのローカルポート上に 4 つのトンネルコマンドができ、切断のたびにそれぞれ再実行し、どれもひと目では生きているかどうかを教えてくれません。
保存した ssh_config のブロック——LocalForward、ProxyJump、キープアライブ——で、この大半はならされます。ですが、起動するのは相変わらず手作業で、相変わらず見張り、相変わらず自分で正しいループバックポートにクライアントを向けることになります。
Termalin の Data クライアントのやり方
Termalin はクロスプラットフォームの SSH クライアントで、最近 Data クライアント を備えました——デスクトップアプリと、termal.in/account のウェブキャビネットの中のデータベースクライアントです。データベースの追加は、サーバーを追加するのと同じ要領です。エンジンを選び、ホスト、ポート、資格情報、必要なら既定のデータベースを指定します。幅広いエンジンに対応します——PostgreSQL、MySQL、SQL Server、ClickHouse、MongoDB、Redis、Elasticsearch、Neo4j など。この記事が扱うのは、そのデータベースがファイアウォールの内側にあるときに何が起きるかです——ポートを開くことも、ssh -L を手で実行することもありません。
- すでにルーティングできるネットワーク上のデータベースには、直接到達します。 Termalin は、あなたが指定したホストとポートにダイヤルします。
- ファイアウォールの内側のデータベースには、トンネル経由で到達します。 デスクトップでは、保存済みの SSH ホスト——あなたの踏み台ホストを、その設定ごとまるごと——を接続にひも付けます。Termalin がそのセッション上でローカル転送を開き、できあがった
127.0.0.1:<port>にドライバーを向けてくれるので、localhost でしか待ち受けないデータベースや、VPN の奥にあるデータベースが、まるでローカルにあるかのように通ってきます。ウェブキャビネットでは、同じ仕事を Connector が受け持ちます。Termalin が Connector の SSH セッションを開き、そこを通してループバックポートを転送し、その上でクエリを実行します。どちらの場合も、暗号化された SSH セッションが、データベースの見えるマシンまでトラフィックを運び、データベース自身がインターネットに面することは決してありません。
こうして、プライベートサブネットが与えてくれていたもの——自分のネットワークの内側からしか到達できないデータベース——を保ったまま、ノート PC 上で実際に使えるクエリエディターを手にできます。トンネルは接続とともに立ち上がり、接続を閉じると、開いていたループバックポートもろとも落ちます。覚えておくべきコマンドも、面倒を見るべき転送も、セキュリティグループに残された 0.0.0.0/0 ルールもありません。
トンネルは到達性であって、認可ではない
はっきり言っておく価値があります。トンネルがしないことが 1 つあるからです。接続をデータベースまで届けることは、そこに着いたあとで何をしてよいかを決めることとは別です。トンネルは配線であり、配線は中立です——向こう端にいるのが誰であれ、あなたが渡したデータベースユーザーとして接続します。接続は最小権限のロールに向け、もし向こう端にエージェントが来るなら、それは別の判断として扱ってください——それは AI エージェントに読み取り専用のデータベースアクセスを与える(英語)という、この記事とは別のテーマです。
Termalin の位置づけ
どの開発者も ssh -L はそらで知っておくべきです——データベースを世界に開かずに到達する、誠実な方法であり、その心的モデル(自分の側でポートを開き、向こう側が見えるものへ転送する)がすべてです。摩擦は概念にあったのではなく、帳簿付けにありました。履歴の中のコマンド、やりくりするポート、落ちるトンネル、データベース 1 つにつき 1 つの転送、です。
Termalin は、トンネルとデータベース接続を 1 つの保存済みのものとして保ちます。踏み台ホストか Connector をひも付ければ、プライベートサブネット上のデータベースに到達するのはワンクリックです——転送は接続とともに開き、ドライバーはループバックポートに向けられ、データベースは本来あるべき場所に——ファイアウォールの内側、自分のネットワークだけに耳を傾けて——とどまります。
Termalin は無料でクロスプラットフォームの SSH/データベースクライアントで、トンネル、踏み台ホスト、Data クライアントを内蔵しています。ダウンロードするか、鍵と資格情報を安全に扱う方法をご覧ください。