MongoDB Atlas: облачная база для первого проекта

Когда Atlas удобнее локальной MongoDB

Локальная база хороша для обучения. Но иногда хочется быстрее подключить проект к облаку: показать демо, развернуть backend, дать доступ с другого компьютера, не возиться со службой MongoDB на своей машине

MongoDB Atlas закрывает эту задачу. Это облачная платформа MongoDB: создаешь кластер, получаешь строку подключения и используешь базу из приложения

Но у Atlas есть несколько шагов, которые новичок часто пропускает. Если просто создать кластер и скопировать URI, подключение может не заработать

Что получится в конце

Ты поймешь:

• что такое cluster в Atlas;
• зачем нужен database user;
• почему нужно настраивать Network Access;
• где брать connection string;
• как подключиться через Compass или Node.js;
• что нельзя публиковать в открытом виде.

Шаг 1. Создать проект и кластер

В Atlas сначала создается организация/проект, потом кластер. Названия могут отличаться в интерфейсе, но смысл такой:

• проект — контейнер для настроек;
• кластер — сама облачная MongoDB.

Для обучения выбирай минимальный стартовый вариант, если он доступен в твоем регионе и на текущих условиях Atlas. Тарифы и бесплатные лимиты могут меняться, поэтому конкретные цифры лучше проверять на официальной странице

Назови кластер понятно, например:

learning-cluster

Шаг 2. Создать database user

Это важный момент. Пользователь базы — не то же самое, что твой аккаунт Atlas

Создай отдельного database user, например:

app_user

Сгенерируй надежный пароль и сохрани его в менеджере паролей. Не вставляй пароль прямо в публичный код

Для учебного проекта можно дать пользователю доступ к нужной базе. Для реального проекта права стоит ограничивать аккуратнее

Шаг 3. Настроить Network Access

Atlas не пускает подключения откуда угодно, пока ты не разрешишь IP

Для локального обучения можно добавить текущий IP. В интерфейсе обычно есть кнопка вроде “Add current IP address”

Иногда для теста ставят доступ:

0.0.0.0/0

Это разрешает подключения отовсюду. Для учебного черновика такое иногда используют, но для реального проекта это плохая привычка. Лучше ограничивать доступ конкретными IP или сетями

Шаг 4. Получить connection string

В Atlas выбери подключение к кластеру. Для приложения тебе понадобится строка вида:

mongodb+srv://app_user:<password>@cluster.example.mongodb.net/?retryWrites=true&w=majority

Вместо <password> нужно подставить пароль database user

Если пароль содержит спецсимволы, их иногда нужно URL-encode. Это частая причина странных ошибок подключения

Шаг 5. Проверить подключение через Compass

Перед тем как подключать код, я бы проверил connection string через Compass

Почему:

• быстрее понять, работает ли доступ;
• проще увидеть ошибку авторизации;
• можно сразу создать базу и коллекцию.

Если Compass подключился, значит кластер, пользователь, пароль и Network Access в целом настроены правильно

Шаг 6. Подключить Node.js

В коде не храни URI прямо в файле:

const uri = process.env.MONGODB_URI;

А в .env:

MONGODB_URI=mongodb+srv://...

Файл .env не публикуют в GitHub. Его добавляют в .gitignore

Что создать первым

Для учебного CRM-примера создай:

• database: crm_demo;
• collection: leads;
• document: первая заявка.

Документ:

{
  "name": "Анна",
  "email": "anna@example.com",
  "source": "atlas-test",
  "status": "new"
}

Типичные ошибки Atlas

Неверный пароль

Проверь, что используешь пароль database user, а не пароль от аккаунта Atlas

IP не разрешен

Если Network Access не настроен, подключение будет падать даже с правильным логином

Пароль со спецсимволами

Если в пароле есть @, :, /, # и похожие символы, connection string может сломаться без кодирования

URI попал в GitHub

Если случайно опубликовал строку подключения с паролем, считай пароль скомпрометированным. Меняй его

Когда Atlas не нужен

Atlas не обязателен, если:

• ты только учишь базовые запросы;
• проект полностью локальный;
• интернет нестабильный;
• тебе проще поднять MongoDB в Docker;
• есть требования хранить данные только внутри своей инфраструктуры.

Для первого понимания MongoDB локальная база или Docker часто проще. Для демо и деплоя Atlas удобнее

Ответы на эти вопросы могут быть для вас полезными

MongoDB Atlas — это хостинг MongoDB?

Да, по смыслу это облачная платформа для MongoDB. Она управляет кластером, доступом, бэкапами и инфраструктурой

Можно ли использовать Atlas бесплатно?

Для обучения могут быть стартовые бесплатные варианты, но условия нужно проверять на официальном сайте Atlas. Они могут меняться

Почему Compass подключается, а Node.js нет?

Часто дело в переменной окружения, спецсимволах пароля или том, что приложение запущено не с тем .env

Нужно ли открывать доступ 0.0.0.0/0?

Для реального проекта лучше не надо. Для теста это иногда используют, но безопаснее ограничивать IP

Следующий шаг

Сохрани connection string в .env, подключи Node.js и сделай маршрут, который записывает заявку в коллекцию leads. Именно там Atlas станет частью реального проекта

Что почитать дальше по MongoDB

Если вы собираете тему по шагам, рядом лучше открыть:

• Node.js + MongoDB: мини-проект с заявками — использовать connection string в реальном Express-проекте.
• MongoDB Compass: подключение и первая коллекция без командной строки — проверить облачную базу в Compass.
• MongoDB в Docker Compose: локальная база без установки в систему — сравнить облачный сценарий с локальным контейнером.
• MongoDB простыми словами: создаем первую коллекцию — вернуться к модели документов и коллекций.