Документация / cli

Готовая папка → HTTPS-ссылка на 48 часов

Установка aifra из npm, загрузка готового dist, обновление и удаление временного HTTPS-превью. Без сборки на сервере.

Статус: CLI опубликован в npm под MIT. Публичные загрузки открыты.

01

1. Установите клиент

Нужен Node.js 24. Откройте терминал в папке своего проекта и установите фиксированную beta-версию. Это установка инструмента на вашем компьютере; сборку сайта сервис не выполняет.

Подготовьте dist с index.html в корне. Уберите секреты, исходники backend и формы сбора данных. Preview доступен всем, у кого есть ссылка.

npm install --save-dev --save-exact --ignore-scripts --no-audit --no-fund aifra@0.2.0-beta.1

02

2. Прочитайте условия и загрузите dist

До запуска прочитайте условия по ссылкам ниже. --accept-terms означает ваше явное согласие при создании или обновлении. Для другой папки замените ./dist.

Одна ссылка действует 48 часов. Лимиты: 3 активных preview на внешний IP, 50 MiB на архив и распакованные файлы, 150 MiB активных файлов на IP. --json выводит ID, ссылку и срок удаления без секретного ключа.

node node_modules/aifra/aifra.cjs deploy ./dist --api-origin https://api.aifra.ru --accept-terms --json

03

3. Обновляйте ту же ссылку

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

Флаг --new создаёт отдельную ссылку и занимает ещё одно место из трёх. Старая ссылка продолжит жить до удаления или истечения срока.

node node_modules/aifra/aifra.cjs deploy ./dist --api-origin https://api.aifra.ru --accept-terms --json

04

Удалить preview досрочно

Команда использует ключ из .ai-deploy-state.json в текущем проекте. После удаления место освобождается. Это действие удаляет опубликованные файлы, поэтому агент должен получить ваше разрешение.

node node_modules/aifra/aifra.cjs deploy --delete --api-origin https://api.aifra.ru --json

05

Где хранится ключ управления

CLI сохраняет .ai-deploy-state.json локально. Не коммитьте и не загружайте этот файл, не вставляйте его в чат или логи. На Windows храните проект в своём профиле с ограниченным доступом.

Состояние CLI и MCP раздельное: выбирайте один способ управления конкретной ссылкой. Удаление npm-пакета не удаляет preview; сервер удалит его по сроку.

В версии 0.2.0-beta.1 внутренняя справка содержит старую фразу о неопубликованном пакете. Пакет опубликован; используйте команды этой страницы.

06

Что проверено

17 сентября 2026 года пакет был установлен из публичного npm. Через его MCP-клиент выполнены создание, обновление, проверка статуса и удаление тестового HTTPS-превью. Обновление сохранило исходный срок; viewer и файлы получили noindex.

Это проверка одного контролируемого сценария, а не обещание доступности из любой сети. Для постоянного сайта, backend, SSR, функций и базы данных нужен другой сервис.