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

Эта страница описывает текущие правила деплоя на VibeHosting по состоянию кода: какие архивы поддерживаются, как работает автосборка, какие лимиты действуют и как автоматизировать публикацию через API.

Для AI и автоматизаций: машиночитаемая версия этой документации доступна по адресу hostingvibe.ru/llms.txt.

Что поддерживается

VibeHosting публикует статический результат: HTML, CSS, JavaScript, изображения, шрифты, видео и другие ассеты. Серверный код на PHP, Python, Node.js и похожих технологиях не исполняется.

На вход можно передать либо уже собранный статический сайт, либо исходники фронтенд-проекта, если в архиве есть package.json со скриптом build. После сборки на хостинг всё равно попадает только статический output.

Способы деплоя

Архивный деплой

Поддерживаются форматы .zip, .tar.gz, .tgz. В корне архива должен быть index.html или package.json со сборкой.

Автосборка исходников

Если в архиве найден package.json со скриптом build, VibeHosting выполняет npm install или npm ci, затем npm run build и ищет результат в dist/, build/, out/, .output/public/.

GitHub deploy

Через личный кабинет можно деплоить публичный GitHub-репозиторий. В нём уже должен существовать готовый index.html в корне или в выбранной подпапке. Автосборка для GitHub-flow сейчас не запускается.

Ограничения по тарифам

Параметр	Free	Pro
Количество проектов	1	3
Макс. размер одного сайта	100 МБ	500 МБ
Общее хранилище	100 МБ	500 МБ
Макс. файлов в деплое	5 000
Кастомный домен	Нет	Да
Rollback на предыдущую версию	Нет	Да

Запрещённые типы файлов

Если архив содержит файл с любым из этих расширений, весь деплой будет отклонён:

.php.exe.sh.py.cgi.htaccess.bat.cmd.pl.jsp.asp.aspx.rb

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

Игнорируемые файлы

Эти файлы автоматически пропускаются при извлечении и не влияют на деплой:

.env.git.gitignore.npmrc.dockerignore.DS_StoreThumbs.db.gitkeep.gitattributes

Правильная структура архива

# Вариант 1: готовый статический сайт

my-site.zip

├── index.html

├── assets/

├── styles.css

└── script.js

# Вариант 2: файлы лежат в одной подпапке

my-site.tgz

└── dist/

├── index.html

└── assets/...

# Вариант 3: исходники с автосборкой

my-app.zip

├── package.json

├── package-lock.json

├── src/

└── public/

Что платформа добавляет автоматически

После успешного деплоя VibeHosting может автоматически встроить служебные скрипты платформы в HTML-файлы. Их не нужно включать в архив вручную.

vibe-forms.jsvibe-patches.jsvibe-analytics.js

Если у проекта настроен счётчик Яндекс.Метрики, он тоже добавляется автоматически во все HTML-страницы.

API и автоматизация

Веб-клиент использует защищённую httpOnly-cookie vibe_token. Для CLI и внешних интеграций backend также возвращает JWT в ответе на /api/auth/register и /api/auth/login, и этот токен можно передавать как Authorization: Bearer ....

Время жизни текущей auth-сессии — 7 дней. Для автоматизаций удобно хранить Bearer JWT, а для браузера ничего дополнительно сохранять не нужно.

# Логин (получаем JWT и cookie) curl -s -X POST https://hostingvibe.ru/api/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"USER_EMAIL","password":"USER_PASSWORD"}' # Создание проекта curl -s -X POST https://hostingvibe.ru/api/projects \ -H "Content-Type: application/json" \ -H "Authorization: Bearer TOKEN" \ -d '{"title":"My site","slug":"my-site"}' # Архивный деплой curl -s -X POST https://hostingvibe.ru/api/projects/PROJECT_ID/deploy \ -H "Authorization: Bearer TOKEN" \ -F "file=@site.zip"

Частые ошибки

«Запрещённый тип файла: .py»

В архиве найден исполняемый или серверный файл. Удалите его из архива и загружайте только фронтенд-часть.

«Архив должен содержать index.html в корне или package.json для сборки»

Вы загрузили исходники без статического output и без build-скрипта. Нужен либо готовый index.html, либо проект, который можно собрать через npm run build.

«Сборка прошла, но не найден index.html»

Проверьте, что build кладёт сайт в dist/, build/, out/ или .output/public/.

«Слишком много файлов»

Скорее всего, в архив попали node_modules, кеши сборки или лишние ассеты.

«Размер превышает лимит»

Сожмите медиафайлы, уберите лишние исходники или перейдите на PRO, если проект объективно больше 100 МБ.

Инструкция для нейросети

Если вы просите нейросеть подготовить проект под VibeHosting, можно дать ей такой короткий prompt:

Сделай сайт для VibeHosting (hostingvibe.ru). Правила: - результат должен быть статическим - можно прислать готовый архив .zip / .tar.gz / .tgz - либо исходники с package.json и командой build - в итоговом output нужен index.html - build output должен лежать в dist/, build/, out/ или .output/public/ - запрещены: .php .exe .sh .py .cgi .htaccess .bat .cmd .pl .jsp .asp .aspx .rb - не включать node_modules, .git, .env - лимит: 100 МБ на Free и 500 МБ на Pro - максимум 5 000 файлов