This topic describes how to connect a local client to an ApsaraDB for MongoDB instance over the Internet.

Prerequisites

A public endpoint for the ApsaraDB for MongoDB instance is obtained. For more information, see the following topics:

Precautions

Read this topic only when you want to connect a local client to an ApsaraDB for MongoDB instance. If you want to connect to an ApsaraDB for MongoDB instance by using an ECS instance, you can obtain both the public and private IP addresses from the ECS instance details page in the ECS console.

If you connect to an ApsaraDB for MongoDB instance over the Internet, security risks may arise. We recommend that you connect to an ApsaraDB for MongoDB instance by using an ECS instance.

Method 1 Query an IP address library

You can query an IP address library for the public IP address of your local client and connect to an ApsaraDB for MongoDB instance.

  1. Query the public IP address of your local client.
  2. Add the public IP address to a whitelist of the ApsaraDB for MongoDB instance. For more information, see Configure a whitelist for an ApsaraDB for MongoDB instance.
  3. Log on to the ApsaraDB for MongoDB instance by using the mongo shell from your local client. For more information, see Connect to a replica set instance by using the mongo shell.
    Note You can also log on to the ApsaraDB for MongoDB instance by using other client tools.

You may have added the public IP address of your local client to the whitelist but still fail to connect to the ApsaraDB for MongoDB instance. However, after you add 0.0.0.0/0 to the whitelist, you can connect to the instance. In this case, we recommend that you query the connection information for the public IP address. For more information, see Method 2 Query the connection information.

Method 2 Query the connection information

You can query the connection information for the public IP address of your local client and connect to an ApsaraDB for MongoDB instance.

  1. Add the 0.0.0.0/0 entry to a whitelist of the ApsaraDB for MongoDB instance. For more information, see Configure a whitelist for an ApsaraDB for MongoDB instance.
    Note If you add the 0.0.0.0/0 entry to the whitelist, all clients are granted access to the ApsaraDB for MongoDB instance. This may raise security risks. Exercise caution when you add the 0.0.0.0/0 entry to a whitelist. Remove the 0.0.0.0/0 entry once you no longer need it.
  2. Log on to the ApsaraDB for MongoDB instance by using the mongo shell from your local client. For more information, see Connect to a replica set instance by using the mongo shell.
  3. Run the following command to query information about the client where you log on:
    db.currentOp({"appName" : "MongoDB Shell","active" : true})

    The following figure shows an example.

    Query the client IP address
    Note If you log on to the ApsaraDB for MongoDB instance using other methods, you can run the following command to query information about all clients:
    db.runCommand({currentOp: 1, "active" : true})
  4. Add the IP address obtained in the preceding step to the whitelist of the ApsaraDB for MongoDB instance, and remove the 0.0.0.0/0 entry that you added in Step 1 from the whitelist.

References

If the public IP address of your local client changes dynamically, you can use either of the following methods to connect to an ApsaraDB for MongoDB instance: