Ищем разработчиков для созвона на 25 минут: 500 ₽ на баланс за разговор.

Выбрать время

Руководство5 мин чтения

Переменные окружения и секреты в облаке: где хранить и как менять

Переменные окружения живут на странице приложения в консоли: токены и пароли хранятся там зашифрованными, а после сохранения приложение передеплоится само. Секретное значение в списке скрыто, показать его может только участник проекта с правом записи. Агент по MCP умеет задать переменную и прочитать список, но самого значения секрета ему не показывают.

$ claude› добавь BOT_TOKEN в shop-bot как секрет✓ setEnvVar: shop-bot, BOT_TOKEN, is_secret=true✓ getOperation: передеплой Committed✓ listEnvVars: BOT_TOKEN, значение скрыто# DATABASE_URL уже на месте: его записала сама платформа

Где лежат переменные и что с ними происходит

Блок «Переменные окружения» стоит на странице приложения. В таблице три колонки: ключ, значение и область, а у каждой строки кнопки «Показать», «Изменить» и «Удалить». Обычные значения видны сразу, секретные помечены словом «секрет» и скрыты.

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

Что происходит после «Сохранить»

Консоль или агентPUT значения
Платформашифрует и хранит
Платформаочередь операций
Передеплойтекущий образ
Приложениеновое окружение

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

Секрет, область и вставка .env

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

Второй выбор: область. «При запуске приложения» стоит по умолчанию, «только при сборке» и «и при сборке, и при запуске» нужны реже. Консоль подсказывает, что сборке обычные переменные нужны редко: пример из подсказки это NEXT_PUBLIC_* у Next.js.

Кнопка «Вставить .env» принимает содержимое файла .env или строку A=1, B=2. Комментарии и пустые строки отбрасываются, нераспознанные строки консоль перечисляет. Все переменные из вставки сохраняются как секреты в области запуска, так что открытое значение придётся после этого переключить вручную.

4 КиБ
максимум на значение одной переменной
256
символов в имени
3
области: сборка, запуск, обе
Правила записи по коду на 17 ноября 2026: backend/internal/api/envvars.go

Имя длиной до 256 символов состоит из латинских букв, цифр и подчёркиваний и не начинается с цифры, а значение не превышает 4 КиБ. Эту проверку делает и браузер, и сервер, поэтому пакетная запись тоже не примет 1KEY или my-key.

Кто видит секрет и как это проверить

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

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

Агенту по MCP достаются три инструмента для переменных: listEnvVars, setEnvVar и deleteEnvVar. Инструмента показа значения в его наборе нет, поэтому агент проверит, что токен записан, но не прочитает его. Общую модель прав агента описывает руководство про управление облаком из Claude Code и Cursor.

База, строка подключения и типичная ошибка

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

Для ключей вроде DATABASE_URL, REDIS_URL или с суффиксом _URL консоль проверяет, что значение начинается со схемы вида postgresql://. Голый хост она сохранит, ведь вы вправе записать любую строку, но покажет предупреждение до следующего деплоя. Если после правки статус приложения не меняется, ответ ищите в логах, как описано в руководстве про логи и диагностику.

Перед записью можно спросить, что изменится: запрос с dry_run ставит в очередь пробную операцию, и план читается через getOperation, ничего при этом не записывая.

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

Нужно ли перезапускать приложение после смены переменной?

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

Можно ли потом прочитать секрет, если я потерял токен?

Да, если у вас есть право записи в проект: нажмите «Показать» у нужной строки. Через MCP это сделать нельзя, и в списке значение тоже скрыто. Показ попадает в журнал аудита.

Что выбрать для NEXT_PUBLIC_API_URL?

Консоль приводит NEXT_PUBLIC_* у Next.js как пример переменной, нужной при сборке, поэтому подойдёт область «и при сборке, и при запуске». Остальные переменные оставляйте в области запуска.

Почему сохранённая переменная не появилась в приложении?

Сохранение только записывает значение, а доставляет его передеплой. Откройте операцию через getOperation или посмотрите фазу приложения: пока передеплой не завершён, контейнер живёт со старым окружением. Если у приложения ещё нет образа, значение подхватит первый деплой. Крупные данные в переменные не кладите, для них есть хранилище объектов.

Создайте проект и повторите это на своём репозитории.

  • Руководство
  • 2026

Автор

Команда DADA Cloud