Laravel Jetstream ставится одной командой и сразу отдаёт готовый кабинет: вход, регистрацию, подтверждение почты, двухфакторную аутентификацию, управление сессиями, API-токены и, если включить, команды с ролями. Это не пакет с отдельной админкой, а заготовка приложения на Tailwind CSS, поверх которой вы строите свой продукт. Ниже я разбираю, что именно попадает в проект, как это подключается и в каких случаях мне проще взять Breeze.
Что входит в Laravel Jetstream из коробки
Под капотом Jetstream опирается на Laravel Fortify: это бэкенд аутентификации без интерфейса. Jetstream добавляет к нему готовые экраны и несколько модулей, которые включаются в конфиге.
Аутентификация и безопасность
В набор входят вход и регистрация, сброс пароля, подтверждение email, подтверждение пароля перед чувствительными действиями, двухфакторная аутентификация с QR-кодом и резервными кодами. Отдельный экран показывает активные сессии в браузерах и позволяет завершить чужие. Для клиентских кабинетов это заметная экономия: 2FA и список сессий руками пишутся долго, а тестируются ещё дольше.
Профиль и аккаунт
Пользователь может поменять имя и email, сменить пароль, загрузить фото профиля (функция включается отдельно) и удалить аккаунт. Логика лежит в классах-действиях в папке app/Actions, поэтому правила валидации и поведение можно менять без правки пакета.
API-токены на Sanctum
Если включить функцию API, в кабинете появится экран, где пользователь создаёт токены и выбирает для каждого набор разрешений. Под ним работает Laravel Sanctum. На практике это удобно, когда к системе подключаются внешние сценарии: n8n, Telegram-бот на aiogram или скрипт на стороне клиента ходят в ваш API со своим токеном и ограниченными правами.
Команды
Команды (teams) включаются флагом при установке. Пользователь создаёт команду, приглашает участников по email и назначает роли с разными правами. У каждого пользователя есть личная команда и переключатель между ними. Если у вас B2B-сервис, где в одном аккаунте работают несколько сотрудников клиента, этот модуль закрывает недели работы. Если пользователи изолированы друг от друга, команды только добавят таблицы и экраны, которые вы не используете.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Стартовый набор Laravel: Livewire или Inertia
Jetstream выпускается в двух вариантах интерфейса, и выбирать нужно до установки, потому что поменять стек потом почти равно переустановке.
- Livewire. Интерфейс на Blade-шаблонах с компонентами на PHP. JavaScript почти не нужен, вся логика остаётся в PHP. Подходит, если команда пишет в основном на PHP и не хочет держать отдельный фронтенд.
- Inertia с Vue. Страницы на Vue, а маршруты и контроллеры остаются в Laravel. Роутер на клиенте не нужен. Подходит, если в проекте уже есть компоненты на Vue или планируется богатый интерфейс.
Я беру Livewire для кабинетов и внутренних панелей с формами и таблицами, а Inertia для проектов, где интерфейс тяжелее и его будут развивать отдельно. В обоих случаях получается один репозиторий и один деплой, без отдельного API только ради собственного фронтенда.
Как установить Jetstream и включить нужные функции
Установка идёт на чистый проект Laravel. Ставить Jetstream в приложение, где уже есть своя аутентификация, не стоит: он перезапишет маршруты, модель пользователя и миграции.
composer require laravel/jetstream
php artisan jetstream:install livewire --teams
npm install
npm run build
php artisan migrate
Для Inertia вместо livewire указывается inertia. Флаг --teams добавляет команды, --api добавляет поддержку API-токенов, --verification включает подтверждение email. Полный список флагов есть в документации, и перед установкой я его сверяю, потому что набор опций дополняется.
Дальше все переключатели живут в config/jetstream.php. Например, так включаются удаление аккаунта и фото профиля:
use Laravel\Jetstream\Features;
'features' => [
Features::profilePhotos(),
Features::api(),
Features::accountDeletion(),
],
Двухфакторная аутентификация настраивается в config/fortify.php, а разрешения для API-токенов задаются в JetstreamServiceProvider:
Jetstream::permissions(['create', 'read', 'update', 'delete']);
Jetstream::defaultApiTokenPermissions(['read']);
После этого в контроллере или маршруте проверяется право токена через tokenCan('read') у пользователя. Сами разрешения Sanctum не навязывает: это просто строки, смысл им придаёте вы.
Хостинг и сборка
Laravel работает на обычном хостинге с подходящей версией PHP, MySQL и доступом к composer, если корневой каталог сайта указывает на папку public. Фронтенд-ресурсы Jetstream собирает Vite, поэтому npm run build я запускаю локально и загружаю готовую папку public/build. Отдельный сервер с Node.js для этого не нужен. Если на тарифе нет SSH, миграции придётся выполнять другим способом, и это стоит проверить до начала работы, а не в день запуска.
Jetstream и Breeze: сравнение
Breeze тоже ставится одной командой, но устроен иначе: он копирует контроллеры, маршруты и представления прямо в приложение, и вся логика сразу видна в вашем коде. Jetstream часть логики держит в пакетах и в классах-действиях, поэтому старт быстрее, а глубокое вмешательство сложнее.
| Возможность | Breeze | Jetstream |
|---|---|---|
| Вход, регистрация, сброс пароля | Есть | Есть |
| Подтверждение email | Есть | Есть, включается флагом |
| Двухфакторная аутентификация | Нет, пишется отдельно | Есть |
| Управление сессиями браузера | Нет | Есть |
| API-токены | Нет | Есть, на Sanctum |
| Команды и роли | Нет | Есть, включается флагом |
| Фото профиля и удаление аккаунта | Удаление есть, фото нет | Есть оба, включаются в конфиге |
| Стеки интерфейса | Blade, Livewire, React, Vue, API | Livewire и Inertia с Vue |
| Где лежит код | Целиком в вашем приложении | Частично в пакетах |
По этой таблице видно главное: Breeze это минимум, который вы достраиваете сами, а Jetstream это максимум готового, который вы урезаете конфигом.
Когда я беру Jetstream
- Нужен клиентский кабинет с 2FA и списком сессий, и писать это отдельно нет смысла.
- В системе есть организации или команды с разными ролями участников.
- К приложению будут подключаться внешние сервисы по API с токенами и ограниченными правами.
- Интерфейс на Tailwind устраивает, а сроки жёсткие.
Когда я беру Breeze
- Нужна простая авторизация для небольшой админки или внутреннего инструмента.
- Интерфейс будет на React или чистом Blade, а Jetstream такого выбора не даёт.
- Заказчик хочет читать и менять весь код аутентификации без обращения к пакетам.
- Приложение отдаёт только API, а фронтенд живёт отдельно.
Если сомневаетесь, посмотрите, что из списка модулей Jetstream вы реально включите. Когда получается одна-две функции, Breeze проще и прозрачнее.
Ограничения Jetstream и что проверить до старта
Первое ограничение связано с судьбой самих наборов. В документации Laravel для новых проектов теперь предлагаются собственные стартовые наборы, а Breeze и Jetstream описаны как решения, которые больше не получают новых возможностей. Для существующих проектов они работают, но статус лучше проверить в документации на день, когда вы начинаете. Для нового проекта я сначала смотрю, хватает ли официального набора, и только потом решаю, нужен ли Jetstream ради 2FA, команд или токенов.
Второе ограничение это кастомизация. Дизайн на Tailwind меняется легко, а вот поведение регистрации, схема команд или нестандартные роли упираются в действия и политики Jetstream. Я закладываю на это время: перенос сущности «команда» на «организацию» с другой логикой приглашений обычно занимает больше, чем сама установка.
Третье ограничение это состав готового. В Jetstream нет биллинга, нет админ-панели для управления пользователями и нет мультитенантности с отдельными базами. Команды разделяют данные логикой приложения, а не изоляцией базы, и это надо учитывать в требованиях к безопасности.
Если задача выходит за рамки готового кабинета, например нужен API для мобильного приложения, интеграции с CRM и сложные роли, я оцениваю её как самостоятельную разработку. Такие проекты я веду как разработку бэкенда на Laravel, и цена начинается от 100 000 ₽. Jetstream в этом случае может стать стартовой точкой, но не обязательно.
Возможности Laravel и Jetstream меняются, поэтому перед запуском проекта я сверяюсь с актуальной документацией.
Частые вопросы
Можно ли добавить Jetstream в существующий проект?
Технически можно, но безопасно это только для проекта без своей аутентификации. Jetstream создаёт свои миграции, маршруты и модель пользователя, поэтому при готовой системе входа получаются конфликты. Если проект уже живой, обычно проще перенести нужные функции вручную, например добавить Sanctum и собственный экран токенов.
Чем Jetstream отличается от Fortify?
Fortify это бэкенд аутентификации без интерфейса: маршруты и логика входа, регистрации, сброса пароля и 2FA. Jetstream использует его и добавляет экраны, профиль, команды и API-токены. Если вам нужен собственный дизайн с нуля, можно взять только Fortify.
Livewire или Inertia: что выбрать в Jetstream?
Livewire подходит, когда основная логика на PHP и интерфейс состоит из форм, таблиц и кабинетов. Inertia с Vue лучше, если во фронтенде много интерактива или в команде уже есть разработчик на Vue. Переключиться потом почти невозможно без переделки интерфейса, поэтому решение принимают до установки.
Нужен ли отдельный сервер для Jetstream?
Нет, отдельный сервер не обязателен. Приложение работает на хостинге с подходящей версией PHP и MySQL, а фронтенд собирается локально и загружается готовым. Стоит заранее проверить версию PHP на тарифе и наличие SSH или другого способа выполнять миграции.