Руководство5 мин чтения
Переменные окружения и секреты в облаке: где хранить и как менять
Переменные окружения живут на странице приложения в консоли: токены и пароли хранятся там зашифрованными, а после сохранения приложение передеплоится само. Секретное значение в списке скрыто, показать его может только участник проекта с правом записи. Агент по MCP умеет задать переменную и прочитать список, но самого значения секрета ему не показывают.
$ claude› добавь BOT_TOKEN в shop-bot как секрет✓ setEnvVar: shop-bot, BOT_TOKEN, is_secret=true✓ getOperation: передеплой Committed✓ listEnvVars: BOT_TOKEN, значение скрыто# DATABASE_URL уже на месте: его записала сама платформаГде лежат переменные и что с ними происходит
Блок «Переменные окружения» стоит на странице приложения. В таблице три колонки: ключ, значение и область, а у каждой строки кнопки «Показать», «Изменить» и «Удалить». Обычные значения видны сразу, секретные помечены словом «секрет» и скрыты.
Значение шифруется при записи и расшифровывается только в момент отрисовки конфигурации приложения. Поэтому сохранение переменной ничего не меняет, пока приложение не передеплоено. Платформа делает это сама: после сохранения или удаления она ставит в очередь передеплой текущего образа, и контейнер стартует уже с новым окружением.
Что происходит после «Сохранить»
Передеплой идёт тем же образом, который уже запущен, так что кода это не меняет. Если у приложения ещё нет образа, например первая сборка ещё идёт, передеплоить нечего: переменные подхватит первый деплой.
Секрет, область и вставка .env
У переменной два выбора. Первый: секрет или обычное значение. В форме флаг «Секрет» включён с самого начала, и подсказка рядом говорит, что значение шифруется и маскируется в интерфейсе. Если сохранить переменную повторно и не указывать флаг, прежнее значение флага останется.
Второй выбор: область. «При запуске приложения» стоит по умолчанию, «только при сборке» и «и при сборке, и при запуске» нужны реже. Консоль подсказывает, что сборке обычные переменные нужны редко: пример из подсказки это NEXT_PUBLIC_* у Next.js.
Кнопка «Вставить .env» принимает содержимое файла .env или строку A=1, B=2. Комментарии и пустые строки отбрасываются, нераспознанные строки консоль перечисляет. Все переменные из вставки сохраняются как секреты в области запуска, так что открытое значение придётся после этого переключить вручную.
Имя длиной до 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