Перейти к содержимому
Localtonet Localtonet Панель управления

Доступ к серверу MongoDB через Localtonet

Помощь по этой странице
На этой странице 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 и клиент Localtonet, подключённый с вашим AuthToken. См. Быстрый старт.
  • MongoDB, работающий на устройстве с включённым контролем доступа. См. ниже раздел Настройки MongoDB.
  • Пользователь MongoDB для удалённой работы с надёжным паролем и только теми ролями, которые ему нужны.

Создание туннеля #

  1. Откройте страницу TCP - UDP #

    Откройте Мои туннели › TCP - UDP и разверните Создать TCP/UDP-туннель.

  2. Заполните форму #

    ПолеЧто ввести
    ПротоколTCP
    Токен устройстваТокен, который использует клиент Localtonet на устройстве.
    Регион сервераВыберите регион, близкий к вашему устройству, чтобы уменьшить задержку.
    Локальный IP-адрес127.0.0.1, если MongoDB работает на том же устройстве, что и клиент. Для сервера на другом компьютере в сети укажите адрес этого компьютера.
    Локальный порт27017 или значение net.port в mongod.conf.
    Тип 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 и перезапустите 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 нужен баланс. См. Контроль доступа.
  • Отдельный пользователь с ролями только для одной нужной ему базы данных, например readWrite, вместо администратора.
  • TLS в MongoDB. По умолчанию туннели не шифруются от начала до конца. Настройте net.tls на сервере и добавьте tls=true в строку подключения, чтобы учётные данные и данные шифровались на всём пути.
  • Лимиты. Срок действия, Лимит трафика и Лимиты скорости в Настройки туннеля ограничивают, как долго и сколько можно использовать туннель. См. Лимиты и срок действия.
  • Журнал запросов › Показать выводит список подключений к туннелю с IP-адресом посетителя. Сам MongoDB записывает в журнал источником каждого подключения клиент Localtonet.

Частые проблемы #

MongoServerSelectionError или MongoNetworkError: connection timed out

Проверьте, что туннель запущен, а в его столбце Подключение указано ВКЛ, что вы используете текущий порт из Порт сервера и что MongoDB отвечает на устройстве по Локальный IP-адрес и Локальный порт туннеля. Если сервер — набор реплик, добавьте directConnection=true. Если вы используете ограничение по IP, проверьте, что ваш текущий адрес есть в списке.

MongoServerError: Authentication failed

Туннель работает, и MongoDB ответил. Проверьте пароль и authSource: это должна быть база данных, в которой создан пользователь. Специальные символы в имени пользователя или пароле в строке подключения нужно кодировать с помощью процентного кодирования.

Я могу читать данные без входа

Контроль доступа выключен. Остановите туннель, включите security.authorization, перезапустите MongoDB, затем снова запустите туннель.

Приложение потеряло подключение после перезапуска

Порт не зарезервирован, поэтому он изменился при перезапуске туннеля или клиента. Включите Порт зарезервирован? или обновите порт в строке подключения.

Туннель сам остановился через полчаса

На Бесплатном тарифе TCP-туннель останавливается через 30 минут. Выберите Запустить, чтобы начать новый сеанс, или пополните баланс, чтобы снять ограничение сеанса.

«Чтобы пользоваться этой функцией, пополните баланс.»

Порт зарезервирован?, Порт сервера, Ограничение по IP и Свой поддомен требуют баланса. Пополните его в разделе Баланс.

Поддержка