К содержимому

Laravel Reverb: настройка на Ubuntu 24.04

Reverb это WebSocket-сервер Laravel для событий в реальном времени. Настройка занимает несколько шагов: пакет, ключи в .env, запуск сервера и проксирование через nginx. В конце проверка соединения и разбор ошибок.

Руководство Laravel 3 мин чтения

01Проверьте окружение

Зайдите на сервер под пользователем, который деплоит проект, и проверьте версии PHP и Laravel. Для Laravel 13 нужен PHP 8.3 и выше, PHP 8.3 из Ubuntu 24.04 подходит. Если Laravel ещё не установлен, проект создаёт composer create-project laravel/laravel example.com.

bash
php -v
php artisan --version

02Установите пакет Reverb

Пакет ставят через Composer в каталог проекта. Команда подключает сервер и публикует его конфиг. Запускайте её от владельца файлов проекта, без sudo, иначе composer оставит в vendor файлы root.

bash
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 должны совпадать у сервера и у клиентской части.

ini
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 команду запускают как службу, а не в интерактивной сессии.

bash
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.

nginx
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 без остановки службы. Если проверка падает, в выводе будет файл и строка с ошибкой.

bash
sudo nginx -t
sudo systemctl reload nginx

07Проверьте, что Reverb работает

Убедитесь, что процесс слушает порт: ss -tlnp покажет строку с 127.0.0.1:8080 и именем процесса php. Затем проверьте рукопожатие через nginx: ответ 101 Switching Protocols значит, что проксирование настроено верно. Код 404 или 502 говорит о проблеме в location или о незапущенном сервере.

bash
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: руководство по установке и настройке: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.