Никита АлимпиевNikAlimp

Переменные окружения

Environment Variables

Переменные окружения (environment variables) — это настройки приложения, которые хранятся вне кода и подставляются при запуске: адреса, пароли, ключи API, режим работы. Благодаря им один и тот же код работает по-разному на тестовом и боевом сервере.

Каждая переменная — пара «имя и значение»: например, адрес базы данных или ключ платёжной системы. Приложение читает их при старте. Так секреты не попадают в репозиторий, а смена настройки не требует правки кода. Переменные удобно хранить в файле .env, который не добавляют в Git, и задавать в панели хостинга или системы выкладки.

Этот подход — часть правил, известных как «двенадцатифакторное приложение», и стал стандартом для современных сайтов и сервисов.

Пример

Магазину нужны разные данные для платёжной системы: тестовые ключи для проверки и боевые для живых платежей. В коде написано «взять ключ из переменной PAYMENT_KEY». В тестовом окружении в ней лежит тестовый ключ, в боевом — настоящий.

Что хранят в переменных

  • Пароли и адреса баз данных.
  • Ключи API сторонних сервисов: платежи, почта, карты.
  • Секреты для подписи сессий и токенов.
  • Адрес сайта и режим работы (разработка или боевой).
  • Включение и отключение функций.

Как работать с ними безопасно

  1. Добавьте файл .env в список игнорируемых файлов Git.
  2. Положите в репозиторий пример .env.example без настоящих значений.
  3. Задавайте боевые значения прямо на сервере или в панели хостинга.
  4. Давайте доступ к секретам только тем, кому он нужен.
  5. Если ключ попал в репозиторий, немедленно перевыпустите его.

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

  • Пароли и ключи прописывают прямо в код.
  • В открытую часть сайта, видимую браузеру, попадают секретные ключи.
  • Не документируют, какие переменные нужны, и новый разработчик не может запустить проект.
  • Забывают задать переменные после переезда на другой сервер.

Кому и когда это нужно

Переменные окружения нужны любому проекту с кодом, который работает с паролями, ключами или разными серверами. Для заказчика это вопрос безопасности: спросите подрядчика, где хранятся ключи платёжной системы и доступы к базе, и кто их видит. Если ответ «в коде» или «в чате», это повод немедленно навести порядок и перевыпустить ключи.

Частый вопрос

Почему нельзя хранить пароли в коде? Код попадает в репозиторий, к подрядчикам и в резервные копии, а значит, пароль может утечь. Кроме того, его придётся менять во всех местах при смене. Переменные окружения решают обе проблемы: секреты лежат отдельно и под контролем.

Веб-сервис

Личный кабинет, админка или MVP под ключ

Next.js и Supabase, спецификация до старта и фиксированная цена. MVP — от 4 недель, клиентская часть — от 300 000 ₽.

Или написать в Telegram

Удобнее голосом? Запишитесь на 30 минут в Zoom — разберём задачу и решим, с чего начать.