PassFront
  1. PassFront
  2. База знаний
  3. CI и качество

Как работают переменные окружения во фронтенде и почему в них нельзя хранить секреты?

CI и качество

Переменные окружения фронтенда подставляются в код на этапе сборки, поэтому они попадают в итоговые файлы и видны любому пользователю.

// .env: VITE_API_URL=https://api.example.com
const apiUrl = import.meta.env.VITE_API_URL; // значение вшивается в бандл при сборке

// SECRET_KEY из .env в клиентский код не попадёт, а VITE_SECRET_KEY попадёт и будет виден всем

Как это работает

В Vite доступны переменные с префиксом VITE_: import.meta.env.VITE_API_URL. Сборщик заменяет их значениями прямо в бандле. Другие переменные в клиентский код не попадают.

Что можно хранить

Публичные настройки: адрес API, идентификатор счётчика аналитики, публичные ключи сервисов, которые рассчитаны на открытое использование.

Чего нельзя

Секретные ключи, пароли, токены доступа к базе. Всё, что вы положили в клиентский бандл, можно найти в DevTools. Секреты хранят на сервере, а браузер обращается к вашему API.

Особенность

Значения фиксируются при сборке. Чтобы поменять адрес API, нужно собрать приложение заново (или загружать конфиг при старте отдельным файлом).

Коротко для собеседования

Переменные вшиваются в бандл при сборке и видны всем. Секреты держим на сервере, во фронтенд кладём только публичные настройки.

Подробнее: Vite — Env Variables and Modes

Другие вопросы раздела