Laravel Reverb: настройка на Ubuntu 24.04
Reverb это WebSocket-сервер Laravel для событий в реальном времени. Настройка занимает несколько шагов: пакет, ключи в .env, запуск сервера и проксирование через nginx. В конце проверка соединения и разбор ошибок.
01Проверьте окружение
Зайдите на сервер под пользователем, который деплоит проект, и проверьте версии PHP и Laravel. Для Laravel 13 нужен PHP 8.3 и выше, PHP 8.3 из Ubuntu 24.04 подходит. Если Laravel ещё не установлен, проект создаёт composer create-project laravel/laravel example.com.
php -v
php artisan --version
02Установите пакет Reverb
Пакет ставят через Composer в каталог проекта. Команда подключает сервер и публикует его конфиг. Запускайте её от владельца файлов проекта, без sudo, иначе composer оставит в vendor файлы root.
cd /var/www/example.com
composer require laravel/reverb
03Задайте ключи в.env
Reverb берёт параметры подключения из .env. Проверьте, что APP_KEY не пустой: без него Laravel падает с No application encryption key has been specified., а ключ создаёт php artisan key:generate. Идентификатор приложения, ключ и секрет Reverb должны совпадать у сервера и у клиентской части.
APP_NAME=Laravel
APP_ENV=production
APP_KEY=base64:ЗАМЕНИТЕ_НА_СВОЙ_КЛЮЧ
APP_DEBUG=false
APP_URL=https://example.com
REVERB_APP_ID=example-app
REVERB_APP_KEY=example-key
REVERB_APP_SECRET=example-secret
REVERB_HOST=example.com
REVERB_PORT=443
REVERB_SCHEME=https
REVERB_SERVER_HOST=127.0.0.1
REVERB_SERVER_PORT=8080
04Запустите сервер Reverb
Сервер запускается artisan-командой и слушает порт из REVERB_SERVER_PORT. На сервере с nginx его держат на 127.0.0.1, чтобы порт не был открыт наружу. Для постоянной работы под systemd или supervisor команду запускают как службу, а не в интерактивной сессии.
php artisan reverb:start --host=127.0.0.1 --port=8080
05Проксируйте WebSocket через nginx
Клиент подключается к Reverb по пути /app на порту 443, а nginx передаёт запрос на 127.0.0.1:8080. В location нужны заголовки Upgrade и Connection, иначе рукопожатие WebSocket не пройдёт. Блок вставляют в server с server_name example.com.
location /app {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 60s;
}
06Примените конфиг nginx
Проверьте синтаксис перед перезагрузкой: sudo nginx -t печатает syntax is ok и test is successful. Затем перезагрузите nginx без остановки службы. Если проверка падает, в выводе будет файл и строка с ошибкой.
sudo nginx -t
sudo systemctl reload nginx
07Проверьте, что Reverb работает
Убедитесь, что процесс слушает порт: ss -tlnp покажет строку с 127.0.0.1:8080 и именем процесса php. Затем проверьте рукопожатие через nginx: ответ 101 Switching Protocols значит, что проксирование настроено верно. Код 404 или 502 говорит о проблеме в location или о незапущенном сервере.
ss -tlnp | grep 8080
curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Sec-WebSocket-Version: 13" -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" https://example.com/app
Частые ошибки
-
В браузере видна ошибка
No application encryption key has been specified.В
.envпустойAPP_KEY. Выполнитеphp artisan key:generate, а при закэшированном конфиге затемphp artisan config:cache. -
Сайт открывается, но WebSocket не подключается, в консоли браузера ошибка соединения с
/app.Проверьте, что в nginx есть location
/appсproxy_pass http://127.0.0.1:8080и заголовкамиUpgradeиConnection. После правки выполнитеsudo nginx -tиsudo systemctl reload nginx. -
composer installилиphp artisan optimizeпадают сPermission deniedвbootstrap/cache.Каталоги
storageиbootstrap/cacheдолжны принадлежать пользователю проекта с группойwww-data:sudo chown -R $USER:www-data storage bootstrap/cacheиsudo chmod -R ug+rwX storage bootstrap/cache. Команды запускайте безsudo. -
После правки
.envновые значения не применяются.Конфиг закэширован. Выполните
php artisan optimizeилиphp artisan config:clear, затем перезапустите Reverb.
Deploykin
Как это делается в Deploykin
В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Нужен ли отдельный порт для Reverb?
Да, сервер слушает свой порт, по умолчанию 8080. На сервере с nginx его оставляют на 127.0.0.1 и проксируют через location /app на порту 443.
Чем Reverb отличается от Pusher?
Reverb работает на вашем сервере и не требует внешнего сервиса. Протокол совместим с Pusher, поэтому клиентская часть Laravel Echo настраивается так же.
Почему после деплоя перестали приходить события?
Проверьте, что процесс Reverb запущен и слушает порт: ss -tlnp | grep 8080. После изменений в .env перезапустите сервер и выполните php artisan optimize.
Можно ли запускать Reverb от www-data?
Нет, файлы проекта принадлежат пользователю, который деплоит. www-data пишет только в storage и bootstrap/cache через группу, остальные файлы читает.
Ещё по теме
- Руководство · Laravel PHP Laravel: пошаговая настройка проекта на Ubuntu 24.04 Создайте проект Laravel на PHP 8.3 в Ubuntu 24.04: Composer,.env, MySQL, миграции, nginx, кэш и проверка запуска. Команды и типичные ошибки.
- Руководство · Laravel Filament в Laravel: установка и настройка панели Установка Filament 5 в Laravel на Ubuntu 24.04: панель /admin, пользователь, ресурс Customer, доступ на сервере и проверка входа без ошибки 403.
- Руководство · Laravel Laravel Livewire: установка и первый компонент на Ubuntu 24.04 Установка Livewire 4 в Laravel на Ubuntu 24.04: создание компонента, вывод на страницу, настройка nginx для livewire.min.js и проверка работы в браузере.
- Руководство · Laravel Laravel API: пошаговая настройка на Ubuntu 24.04 Как поднять API в Laravel на Ubuntu 24.04: установка Sanctum, маршруты в routes/api.php, проверка через curl, ответы 401 и 404, кэш и деплой.
- Руководство · Laravel Laravel Eloquent: настройка и проверка на Ubuntu 24.04 Пошаговая настройка Eloquent в Laravel на Ubuntu 24.04: подключение MySQL, миграции, модели, связи, проверка через tinker и маршрут.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
Laravel: руководство по установке и настройке: все материалы темы