Руководства по фреймворкам
Разверните приложение на фреймворке на Lizard из исходного кода. Выберите свой фреймворк и режим рендеринга ниже, подготовьте его production-сборку, затем разверните с помощью Lizard CLI или подключите репозиторий GitHub. Серверные приложения запускают процесс; статические сайты отдают сгенерированные файлы через nginx.
Выберите фреймворк
Эти настройки описывают стандартную структуру проектов в руководствах по ссылкам ниже. Команды подразумевают npm для JavaScript-проектов. Пользовательские пути вывода, адаптеры и переопределения сборки могут изменить результат. Чтобы вместо этого собрать собственный образ, см. Развертывание Docker-контейнера из Dockerfile.
| Фреймворк | Сборка | Среда выполнения или вывод | Порт сервиса |
|---|---|---|---|
| Next.js | npm run build | next start через скрипт start | 3000 |
| Статический экспорт Next.js | npm run build | out/ через Dockerfile | 80 |
| React с Vite | npm run build | dist/ | 80 |
| Vue с Vite | npm run build | dist/ | 80 |
| Astro | npm run build | dist/ или автономный Node-адаптер | 80 статический; 3000 сервер |
| Nuxt | npm run build | node .output/server/index.mjs | 3000 |
| SvelteKit | npm run build | node build с adapter-node | 3000 |
| Node.js (Express) | Скрипт build, если он есть | Скрипт start | 3000 |
| FastAPI | Установка Python-зависимостей | uvicorn main:app --host 0.0.0.0 --port 8000 | 8000 |
| Django | Установка Python-зависимостей | Gunicorn с вашим WSGI-модулем | 8000 |
| Streamlit | Установка Python-зависимостей | streamlit run app.py из Procfile | 8501 |
| Go | go build в статический бинарник | /app/server | 8080 |
| Ruby on Rails | Dockerfile, который генерирует Rails | Thruster и Puma или только Puma | 8080 в Rails 8; 3000 в Rails 7.1 и 7.2 |
| Docusaurus | npm run build | build/ | 80 |
| VitePress | npm run docs:build | docs/.vitepress/dist/ в этом руководстве | 80 |
| Hugo | hugo --minify | public/ | 80 |
Подготовка проекта
Выполняйте команды из директории приложения. Закоммитьте исходные файлы, конфигурацию и lockfile пакетов. Исключите .env, локальные зависимости и локальные артефакты сборки из загрузки. Node-проекты могут выбрать мажорную версию Node в .nvmrc; по умолчанию используется 22. Это выбирает мажорную версию, а не конкретный патч-релиз. Файлы версий для Node.js, Python, Go и Ruby перечислены на странице версии рантайма.
Установите Lizard CLI и войдите один раз:
curl -fsSL https://lizard.build/install.sh | bash
lizard loginВ Windows выполните в PowerShell irm https://lizard.build/api/cli/install.ps1 | iex. Новый аккаунт начинает без тарифа: пока вы не запустите 7-дневный пробный период Pro (требуется карта), lizard add и lizard up возвращают ссылку на Checkout. lizard billing start открывает её.
В каждом руководстве используется новый проект и сервис с именем web или api. Создайте этот сервис с помощью lizard add --service web (или api) перед первым вызовом lizard up --service. up --service выбирает существующий сервис; он не создает отсутствующий именованный сервис. Для существующего проекта проверьте lizard status --json и lizard ps --json перед развертыванием. Порт должен совпадать с процессом внутри контейнера, который должен слушать на 0.0.0.0.
Lizard CLI 0.3.95 и новее исключают метаданные архивов macOS при загрузке. Настройка COPYFILE_DISABLE не нужна. Обновите старые версии CLI перед использованием этих руководств.
Выбор GitHub или локального источника
Команды в руководствах используют lizard up для загрузки текущей папки. Эта команда меняет существующий сервис на загрузку исходного кода. Чтобы сохранить git push to deploy, подключите GitHub и используйте настройки сборки из руководства в репозитории. Настройте порт сервиса из таблицы: nginx для сборки Vite, Astro, SvelteKit, Docusaurus или VitePress слушает на заданном вами порту, а если порт не задан — на 3000.
Согласованность настроек сборки
В этих руководствах используется определение через lizardpack, если не требуется Dockerfile. Существующие buildCommand или startCommand имеют приоритет над определением и Dockerfile репозитория; заданный dockerfilePath имеет приоритет над обоими. Проверьте порядок решений о сборке перед сменой метода сборки. Задайте скрипты в package.json, когда об этом сказано в руководстве; переопределение через CLI меняет способ сборки.
Проверка релиза
Читайте логи сборки, логи рантайма и активный URL. Проверьте внутренний маршрут, отсутствующий маршрут и любые API или form action. Процесс, открывший свой порт, может все равно отдавать сломанную страницу. Для сгенерированных сайтов используйте статические маршруты и 404, чтобы не возвращать главную страницу с HTTP 200 для любого неизвестного URL.
Поддержка рантайма не подразумевает общие кэши, постоянные локальные файлы или каждую версию фреймворка. См. ограничения, хранилище и восстановление и известные проблемы, когда ваше приложение полагается на эти функции.
См. проверенные версии и результаты в облаке для проверок развертывания от 9 сентября 2026 года и их ограничений.
Обновлено