LocaltonetでMySQLサーバーに接続する
このページの内容 9セクション
お使いのマシン上のMySQLまたはMariaDBサーバーに、別のネットワークから接続できます。TCPトンネルによって、ポート3306にパブリックなホスト名とポートが割り当てられ、どのMySQLクライアントからでも利用できます。
仕組み #
Localtonetクライアントは、MySQLをホストしているマシン、または同じネットワーク内の別のデバイスで実行します。TCPトンネルはMySQLのポート 3306 を指します。Localtonetは、トンネルにホスト名とポートで構成されるパブリックアドレスを割り当てます。そのアドレスに接続したMySQLクライアントが、お使いのサーバーに到達します。TCPトンネルの詳細はTCPページを参照してください。
アクセス制御なしでデータベースを公開しないでください。開始したトンネルは、アドレスを知っている人なら誰でも到達できます。実際のデータをトンネルの先に置く前に、保護するをお読みください。
始める前に #
- Localtonetアカウントと、AuthTokenで接続したLocaltonetクライアント。クイックスタートを参照してください。
- デバイス上でMySQLが動作していること。デバイス自体で
mysql -h 127.0.0.1 -P 3306 -u <DB_USER> -pが動作することを確認してください。 - リモート利用向けのMySQLアカウント。強力なパスワードを設定し、必要な権限だけを付与します。
rootは使わないでください。
トンネルを作成する #
-
TCP - UDPページを開く #
マイトンネル › TCP - UDPを開き、TCP - UDPトンネルを作成を展開します。
-
フォームに入力する #
項目 入力する内容 プロトコル TCP デバイストークン デバイス上のLocaltonetクライアントが使うトークン。 サーバーリージョン レイテンシを下げるため、デバイスに近いリージョンを選びます。 ローカルIPアドレス MySQLがクライアントと同じデバイスで動作している場合は 127.0.0.1。ネットワーク内の別のマシンにあるMySQLサーバーの場合は、そのマシンのアドレスを入力します。ローカルポート 3306、またはMySQL設定のportの値。URLの種類 ランダムサブドメイン。カスタムサブドメインでは名前を選べますが、残高が必要です。 トンネルを作成を選択します。
-
トンネルを開始してアドレスをコピーする #
トンネルはあなたのトンネルの下に表示されます。開始を選択します。URL列にはパブリックアドレスが
host:portの形式で表示され、サーバーポート列にはポートだけが表示されます。
外部から接続する #
mysql コマンドラインクライアントでは、ホストを -h の後ろに、ポートを大文字の -P の後ろに指定します。小文字の -p はパスワードの入力を求めます。
mysql -h <TUNNEL_HOST> -P <TUNNEL_PORT> -u <DB_USER> -p <DB_NAME>アプリケーションでは、通常、接続URLを使います。
mysql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>MySQL WorkbenchやDBeaverなどのグラフィカルクライアントでは、ホストにトンネルのホスト名、ポートにトンネルのポートを入力します。トンネルのサーバーポートを3306に設定していない限り、ポートを3306のままにしないでください。
トンネルの先で重要なMySQLの設定 #
バインドアドレスはローカルのままで構いません #
Localtonetクライアントは、お使いのデバイスからMySQLに接続します。MySQLがパブリックなインターフェースで待ち受ける必要はありません。クライアントが同じマシンで動作している場合は bind-address = 127.0.0.1 で十分です。この設定のままにして、外部からの唯一の経路がトンネルになるようにしてください。
アカウントのホストは、訪問者ではなくLocaltonetクライアントです #
MySQLのアカウントは、ユーザー名と、接続元のホストの組み合わせです。トンネル経由では、すべての接続がLocaltonetクライアントから来ます。クライアントがMySQLと同じマシンで動作している場合、そのホストは localhost です。
CREATE USER '<DB_USER>'@'localhost' IDENTIFIED BY '<DB_PASSWORD>';
GRANT SELECT, INSERT, UPDATE, DELETE ON <DB_NAME>.* TO '<DB_USER>'@'localhost';サーバーが skip_name_resolve をオンにして動作している場合は、'localhost' の代わりに '127.0.0.1' を使ってください。クライアントが別のデバイスで動作している場合は、そのデバイスのネットワーク内のアドレスを使います。
このため、MySQLのホストルールでは訪問者を区別できません。トンネルに到達するすべての人が同じホストとして届くからです。訪問者の制限は、代わりにトンネルのIP制限で行ってください。
同じアドレスを維持する #
ホスト名はトンネルに紐づいたままですが、ポートはトンネルの開始時にサーバーから割り当てられます。トンネルの設定で予約ポートをオンにすると、トンネルやLocaltonetクライアントを再起動してもポートは同じままになります。アプリケーションの接続文字列にはこれが必要です。オフの場合、再起動するとポートが変わります。アカウントに残高がある間に作成したトンネルは、予約ポートがオンの状態で開始されます。オンにするには、残高と開始済みのトンネルが必要です。
残高があれば、サーバーポート › 変更でポートを選ぶこともできます(そのサーバー上の他のトンネルが使っていなければ、たとえば3306)。ポートを参照してください。
無料プラン。無料プランでは、TCPトンネルは30分後に停止し、再び開始できます。開始するたびにポートが変わることがあります。プランと残高を参照してください。
セキュリティを確保する #
- IP制限。トンネルの設定でIP制限 › 管理を選択し、これらのみ許可を選んで、接続するアプリケーションや人のアドレスを追加します。単一のアドレス、
10.0.0.0/16のような範囲、または複数を一度に指定できます。変更はすぐに反映されます。IP制限には残高が必要です。アクセス制御を参照してください。 - 専用アカウント:上の例のように、強力なパスワードと、最小限の権限を設定します。パスワードのないアカウントは削除してください。
- MySQLのTLS。トンネルは、既定ではエンドツーエンドで暗号化されません。そのため、MySQLでセッションを暗号化してください。アカウントを
REQUIRE SSLで作成し、--ssl-mode=REQUIREDで接続します(MariaDBクライアントでは--sslを使います)。 - 制限。トンネルの設定にある有効期限、帯域幅制限、速度制限で、トンネルを使える期間と量を制限できます。制限と有効期限を参照してください。
- リクエストログ › 表示には、トンネルへの接続が、訪問者のIPアドレスとともに一覧表示されます。
よくある問題 #
ERROR 2003: Can't connect to MySQL server
クライアントが接続を開けませんでした。トンネルが開始されていて接続列がオンになっていること、サーバーポートの現在のポートを使っていること、そしてMySQLがデバイス上のトンネルのローカルIPアドレスとローカルポートで応答することを確認してください。IP制限を使っている場合は、現在のアドレスがリストに含まれているかを確認してください。
ERROR 1045: Access denied for user '…'@'localhost'
トンネルは動作しており、MySQLが応答しています。メッセージ内のホストは、上で説明したとおりLocaltonetクライアントです。パスワードを確認し、そのユーザーとホストの組み合わせに完全に一致するアカウントが存在することを確認してください。
ERROR 1130: Host '…' is not allowed to connect to this MySQL server
MySQLから見えるホストに一致するアカウントがありません。メッセージに表示されているホストに対するアカウントを作成してください。
再起動後にアプリケーションの接続が切れた
ポートが予約されていないため、トンネルまたはクライアントの再起動時に変わりました。予約ポートをオンにするか、アプリケーション側のポートを更新してください。
30分後にトンネルが自動的に停止した
無料プランでは、TCPトンネルは30分後に停止します。開始を選択して新しいセッションを始めるか、残高を追加してセッション制限をなくしてください。
「この機能を利用するには残高の購入が必要です。」
予約ポート、サーバーポート、IP制限、カスタムサブドメインには残高が必要です。残高から追加してください。