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

Localtonet経由でMongoDBサーバーに接続する

このページのヘルプ
このページの内容 9セクション
  1. 仕組み
  2. 始める前に
  3. トンネルを作成する
  4. TCP - UDPページを開く
  5. フォームに入力する
  6. トンネルを開始してアドレスをコピーする
  7. 外部から接続する
  8. トンネル経由で使うときに重要なMongoDBの設定
  9. アクセス制御を有効にする
  10. bindIpはローカルのままで構わない
  11. レプリカセットではダイレクト接続が必要
  12. 同じアドレスを維持する
  13. セキュリティを確保する
  14. よくある問題
  15. 関連ページ

別のネットワークから、お使いのマシン上のMongoDBサーバーに、mongosh、MongoDB Compass、ドライバーで接続できます。TCPトンネルによって、ポート27017に公開のホスト名とポートが割り当てられます。

仕組み #

Localtonetクライアントは、MongoDBをホストしているマシン、または同じネットワーク内の別のデバイスで実行します。TCPトンネルはMongoDBのポート27017を指します。Localtonetは、トンネルにホスト名とポートからなる公開アドレスを割り当てます。そのアドレスに接続したMongoDBクライアントは、お使いのサーバーに到達します。TCPトンネルの詳細はTCPのページをご覧ください。

先に認証を有効にしてください。自己管理のMongoDBサーバーは、アクセス制御を有効にするまで、ユーザー名もパスワードもなしですべての接続を受け付けます。開始したトンネルは、アドレスを知っている人なら誰でも到達できるため、そのようなサーバーへのトンネルは、第三者にデータへの完全なアクセスを与えてしまいます。

始める前に #

  • Localtonetアカウントと、AuthTokenで接続されたLocaltonetクライアント。クイックスタートをご覧ください。
  • アクセス制御を有効にした状態で、デバイス上で動作しているMongoDB。下のMongoDBの設定をご覧ください。
  • リモート用のMongoDBユーザー。強力なパスワードを設定し、必要なロールだけを付けます。

トンネルを作成する #

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

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

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

    フィールド入力する内容
    プロトコルTCP
    デバイストークンデバイス上のLocaltonetクライアントが使うトークン。
    サーバーリージョンレイテンシを下げるため、デバイスに近いリージョンを選びます。
    ローカルIPアドレスMongoDBがクライアントと同じデバイスで動作している場合は127.0.0.1。ネットワーク内の別のマシン上のサーバーの場合は、そのマシンのアドレスを入力します。
    ローカルポート27017、またはmongod.confのnet.portの値。
    URLの種類ランダムサブドメイン。カスタムサブドメインでは名前を自分で選べますが、残高が必要です。

    トンネルを作成を選びます。

  3. トンネルを開始してアドレスをコピーする #

    トンネルはあなたのトンネルに表示されます。開始を選びます。URL列には公開アドレスがhost:portの形式で表示され、サーバーポート列にはポートだけが表示されます。

外部から接続する #

MongoDBクライアントは接続文字列を使います。トンネルのホストとポートを指定したmongodb://形式を使ってください。authSourceには、ユーザーを作成したデータベース(通常はadmin)を指定します。

接続文字列
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin

mongoshでは、パスワードをコマンドに含めないでください。シェルの履歴に残らずに済みます。mongoshがパスワードを尋ねます。

ターミナル
mongosh "mongodb://<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>" --username <DB_USER> --authenticationDatabase admin

MongoDB Compassでは、新しい接続のURIフィールドに接続文字列を貼り付けます。

トンネルのアドレスには、mongodb+srv://形式を使わないでください。この形式はDNSレコードを検索しますが、トンネルのホスト名にはそのレコードがありません。

トンネル経由で使うときに重要なMongoDBの設定 #

アクセス制御を有効にする #

先に管理者を作成してから、mongod.confでauthorizationをオンにして、MongoDBを再起動します。

mongod.conf
security:
  authorization: enabled

再起動後は、認証情報なしの接続では、データの読み取りも変更もできなくなります。手順の全体は、MongoDBのマニュアルの「Enable Access Control」に記載されています。

bindIpはローカルのままで構わない #

Localtonetクライアントは、お使いのデバイスからMongoDBに接続します。MongoDBが公開インターフェースで待ち受ける必要はありません。クライアントが同じマシンで動作している場合は、既定のnet.bindIp: 127.0.0.1で十分です。外部からの唯一の経路がトンネルになるよう、このままにしてください。

レプリカセットではダイレクト接続が必要 #

ドライバーがレプリカセットに接続すると、サーバーはメンバーのホスト名を返し、ドライバーはそれらの名前に接続しようとします。これらはネットワーク内部のアドレスであるため、外部からでは接続が止まったり、失敗したりします。トンネルのアドレスに留まるよう、接続文字列にdirectConnection=trueを追加します。

接続文字列
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin&directConnection=true

同じアドレスを維持する #

ホスト名はトンネルに紐づきます。ポートは、トンネルの開始時にサーバーによって割り当てられます。トンネルの設定で予約ポートをオンにすると、トンネルやLocaltonetクライアントを再起動してもポートは変わりません。アプリケーションの接続文字列にはこれが必要です。オフの場合、再起動するとポートが変わります。アカウントに残高がある状態で作成したトンネルは、予約ポートがオンで始まります。オンにするには、残高と開始済みのトンネルが必要です。

残高があれば、サーバーポート › 変更でポートを選ぶこともできます。たとえば、同じサーバー上のほかのトンネルが使っていなければ27017にできます。ポートをご覧ください。

無料プラン。無料プランでは、TCPトンネルは30分後に停止し、再度開始できます。開始のたびにポートが変わることがあります。プランと残高をご覧ください。

セキュリティを確保する #

  • MongoDBのアクセス制御。前述のとおりです。これは省略できない唯一の手順です。
  • IP制限。トンネルの設定でIP制限 › 管理を選び、これらのみ許可を選んで、接続するアプリケーションや人のアドレスを追加します。自分のIPを使用を使うと、現在のアドレスが入力されます。変更はすぐに反映されます。IP制限には残高が必要です。アクセス制御をご覧ください。
  • 専用のユーザー。管理者ではなく、必要な1つのデータベースに対するロール(たとえばreadWrite)だけを付けます。
  • MongoDBのTLS。トンネルは、既定ではエンドツーエンドで暗号化されません。サーバーでnet.tlsを設定し、接続文字列にtls=trueを追加して、認証情報とデータが経路全体で暗号化されるようにします。
  • 制限。トンネルの設定にある有効期限、帯域幅制限、速度制限で、トンネルを使える期間と量を制限できます。制限と有効期限をご覧ください。
  • リクエストログ › 表示には、トンネルへの接続が、訪問者のIPアドレスとともに一覧表示されます。MongoDB自体のログでは、すべての接続の接続元がLocaltonetクライアントになります。

よくある問題 #

MongoServerSelectionErrorまたはMongoNetworkError:connection timed out

トンネルが開始されていて接続列がオンと表示されていること、サーバーポートの現在のポートを使っていること、トンネルのローカルIPアドレスとローカルポートのデバイス上でMongoDBが応答していることを確認してください。サーバーがレプリカセットの場合は、directConnection=trueを追加します。IP制限を使っている場合は、現在のアドレスが一覧に含まれているか確認してください。

MongoServerError:Authentication failed

トンネルは動作していて、MongoDBが応答しています。パスワードとauthSourceを確認してください。これは、ユーザーを作成したデータベースである必要があります。ユーザー名やパスワードに特殊文字が含まれる場合は、接続文字列ではパーセントエンコードする必要があります。

サインインしなくてもデータを読み取れる

アクセス制御がオフになっています。トンネルを停止し、security.authorizationを有効にして、MongoDBを再起動してから、もう一度トンネルを開始してください。

再起動後にアプリケーションの接続が切れた

ポートが予約されていないため、トンネルまたはクライアントの再起動時に変わりました。予約ポートをオンにするか、接続文字列のポートを更新してください。

トンネルが30分後に自動的に停止した

無料プランでは、TCPトンネルは30分後に停止します。開始を選んで新しいセッションを始めるか、残高を追加してセッション制限をなくしてください。

「この機能を利用するには残高の購入が必要です。」

予約ポート、サーバーポート、IP制限、カスタムサブドメインには残高が必要です。残高で追加してください。

サポート