Документация по деплою на RelaxDev

Переменные — одной вставкой

Выгрузите переменные проекта из Vercel в файл:

npx vercel link
npx vercel env pull .env.vercel --environment=production

Вставьте содержимое файла целиком во вкладку «Переменные» — при создании проекта или в готовом — или загрузите сам файл. Кавычки снимаются, служебные VERCEL_* и TURBO_* пропускаются, совпадающие ключи обновляются. Подсказка «Переезжаете с Vercel?» есть прямо в блоке переменных. Значения с пометкой Sensitive Vercel не выгружает — их нужно вписать вручную.

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

Создайте базу во вкладке «База данных». Если в проекте уже был DATABASE_URL (например, от Neon), он сохраняется как OLD_DATABASE_URL, а на его место встаёт новая база. В блоке «Импорт из другой базы данных» старая строка подставится сама — остаётся нажать «Запустить импорт». Строку можно брать как есть, вместе с пулером: искать DIRECT_URL или адрес без пулера не нужно.

После импорта проверьте данные и удалите из переменных старые строки подключения.

Приёмник вебхуков

Telegram, платёжные системы и другие сервисы из-за границы не всегда стабильно достукиваются до серверов в России. Приёмник даёт постоянный адрес https://hook.relaxweb.ru/r/… на зарубежном сервере: он принимает вебхук и пересылает его в ваш проект по указанному пути, заголовки — без изменений. Пересылать можно только в свой проект.

• Telegram — одной кнопкой. Если в переменных есть токен бота, «Подключить к Telegram» ставит вебхук через приёмник. Видно, куда сейчас смотрит вебхук, сколько обновлений ждёт доставки и последнюю ошибку. Секрет из TELEGRAM_WEBHOOK_SECRET приходит в заголовке X-Telegram-Bot-Api-Secret-Token.
• У каждого приёмника виден счётчик запросов и ответ проекта на последний из них.
• Адрес утёк — «Сменить адрес»: старый перестанет работать.

Исходящий прокси

Если внешний API не открывается с наших серверов — таймауты, обрыв загрузки файлов, — запросы к нему можно пустить через зарубежный прокси платформы. Адрес — по кнопке «Получить адрес прокси». Прокси принимает соединения только с серверов платформы и работает для HTTPS.

• Точечно (рекомендуем). Добавьте адрес в переменные под своим именем, например OUTBOUND_PROXY_URL, и используйте его только в нужном запросе. База, Redis и остальной трафик идут напрямую.
• На весь проект — RELAXDEV_PROXY_URL. Платформа выставит контейнеру HTTP_PROXY, HTTPS_PROXY и NO_PROXY (см. раздел о переменных выше).

import { fetch, ProxyAgent } from 'undici';

const proxy = new ProxyAgent(process.env['OUTBOUND_PROXY_URL']);
const res = await fetch('https://api.example.com/...', { dispatcher: proxy });

fetch и ProxyAgent берите из одного пакета undici: агент из пакета вместе со встроенным fetch Node может не работать из-за разницы версий. В Python — параметр proxy у клиента httpx.

Что написать агенту

Подготовь проект к деплою на RelaxDev по инструкции
https://relaxdev.ru/.well-known/skills/relaxdev-deploy/SKILL.md
и перечисли, что мне нужно настроить в панели.

Если сборка упала — вставьте агенту лог из панели и ту же ссылку: в инструкции есть таблица симптомов и причин.

Чтобы агент знал о RelaxDev всегда

• Claude Code — сохраните файл инструкции в проект как .claude/skills/relaxdev-deploy/SKILL.md: агент подключит его сам, когда речь зайдёт о деплое.
• Cursor — сохраните его как правило проекта .cursor/rules/relaxdev.mdc или добавьте ссылку на инструкцию в AGENTS.md.
• Любой агент с доступом в интернет — ссылка в запросе, как в примере выше.

Что происходит после push

• В ветку проекта — сборка и выкат новой версии. В истории деплоев видно автора push и коммит.
• В другую ветку — превью-окружение на отдельном адресе, если превью включены в настройках проекта. Ветку удалили — превью удаляется вместе с ней; если провайдер не прислал событие удаления, превью удалится само через 72 часа.
• Автодеплой выключен — push сборку не запускает, новая версия выкатывается кнопкой «Редеплой».
• Раннеры заняты — сборка встаёт в очередь и стартует, как только освободится место.

Записи у регистратора

Других A- и AAAA-записей у имени быть не должно. NS — только родные, у регистратора или в Cloudflare. Почтовые записи (MX, SPF, DKIM) не трогайте: к сайту они не относятся. Если у домена есть CAA, в ней должен быть разрешён letsencrypt.org.

Порядок подключения

1. Пропишите записи у регистратора или в Cloudflare.
2. Проверьте их на dnschecker.org: во всех регионах у A должен быть только 72.56.37.162. Для проекта на VM (своя VM «+ Admin» и другие VM-площадки) — 135.136.191.56: вкладка «Домены» такого проекта сама покажет нужный адрес.
3. Добавьте домен во вкладке «Домены». Панель сама проверит DNS через публичные резолверы: если записи ещё не на нас, она покажет, что не так, и без подтверждения домен не добавит.
4. Сертификат выпустится автоматически, обычно за минуту.