Как работают переменные окружения во фронтенде и почему в них нельзя хранить секреты?
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