Laravel на localhost через HTTPS: artisan serve, SSH и вебхуки
Открываем локальный Laravel через HTTPS без дополнительного Composer-пакета: artisan serve, SSH-туннель, тестовый POST-маршрут и диагностика 419.

Чтобы показать Laravel-приложение или получить тестовый webhook, достаточно запустить php artisan serve и стандартный SSH-клиент. Дополнительный пакет для Artisan не нужен. Покажем проверяемый POST-маршрут, доступный сначала локально, затем по HTTPS.
Инструкция рассчитана на существующий Laravel-проект с настроенными PHP, Composer и зависимостями. Версию своего приложения проверьте через php artisan --version. Здесь используется API маршрутов Laravel 12; для другого проекта сверяйте структуру middleware с документацией своей версии. Dev-сервер подходит для временной разработки на тестовых данных.
1. Добавьте тестовый маршрут
В routes/web.php добавьте:
use Illuminate\Foundation\Http\Middleware\ValidateCsrfToken;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
Route::post('/tunnel-check', function (Request $request) {
$data = $request->validate(['message' => ['required', 'string', 'max:100']]);
return response()->json(['received' => $data['message']]);
})->withoutMiddleware([ValidateCsrfToken::class]);
Если Request или Route уже импортированы, не добавляйте повторный use. Для одного диагностического маршрута исключена CSRF-проверка: внешний отправитель не имеет браузерной CSRF-сессии. Остальные web-маршруты сохраняют защиту. У этого endpoint нет побочных действий; не принимайте здесь платежи и не меняйте заказы.
Проверьте регистрацию и запустите сервер:
php artisan route:list --path=tunnel-check
php artisan serve --host=127.0.0.1 --port=8000
Во втором терминале:
curl -i http://127.0.0.1:8000/tunnel-check \
-H 'Content-Type: application/json' -H 'Accept: application/json' \
--data '{"message":"hello tunnel"}'
Ожидаются HTTP 200 и {"received":"hello tunnel"}. Без message ожидается 422. Пока эти проверки не проходят, туннель запускать рано. Исключение middleware для отдельного маршрута описано в документации Laravel.
2. Создайте HTTPS-туннель
Для Free добавьте свой публичный SSH-ключ в раздел SSH-ключей. Не загружайте приватный ключ. Затем в отдельном терминале:
ssh -p 2222 -o ExitOnForwardFailure=yes \
-R 80:127.0.0.1:8000 tunnelhunt.ru
Скопируйте выданный адрес https://YOUR-SUBDOMAIN.tunnelhunt.ru. SSH и Artisan должны продолжать работать. Повторите POST из первого шага, заменив локальный URL на https://YOUR-SUBDOMAIN.tunnelhunt.ru/tunnel-check. Ожидаются тот же JSON и HTTP 200. Проверьте с другого устройства или сети.
Туннель не требует белого IP или входящего порта роутера. Подробная диагностика SSH и 502 есть в инструкции localhost. Для Docker/Sail адрес справа в -R должен быть доступен именно машине, где запущен SSH; 127.0.0.1 контейнера и хоста — разные адреса.
3. Подключите настоящий webhook
Замените диагностический маршрут обработчиком конкретного провайдера. Сначала проверьте подпись или отдельный секрет, проверьте входные данные и повторную доставку. Исключение CSRF само по себе не удостоверяет отправителя.
Для Telegram используйте HTTPS и метод Bot API setWebhook, а не команду BotFather. BotFather создаёт бота и выдаёт bot token. Пример регистрации из Bash/zsh для своего тестового обработчика /telegram/webhook:
curl --fail-with-body -X POST "https://api.telegram.org/bot${BOT_TOKEN}/setWebhook" \
--data-urlencode "url=${PUBLIC_URL}/telegram/webhook" \
--data-urlencode "secret_token=${WEBHOOK_SECRET}"
До вызова задайте BOT_TOKEN, HTTPS-origin PUBLIC_URL и отдельный WEBHOOK_SECRET; реализуйте проверку X-Telegram-Bot-Api-Secret-Token в этом маршруте. Не регистрируйте webhook на учебном /tunnel-check: он не понимает Telegram Update. Полный цикл проверки — в руководстве Telegram-бота, протокол — в Telegram Bot API.
Если страница открывается, а приложение работает неправильно
| Симптом | Что проверить |
|---|---|
| 419 на диагностическом POST | Маршрут и withoutMiddleware именно у него; не отключайте CSRF всему сайту |
| 422 | JSON, обязательный message, заголовок Accept |
| 404 | Путь и HTTP-метод в route:list; API-маршрут может иметь префикс /api |
| 502 | Artisan запущен, порт 8000 доступен машине SSH, соединение не закрыто |
| Редирект на localhost или HTTP | APP_URL, настройки доверенных прокси и фактические forwarded-заголовки |
| Страница без JS/CSS | Vite dev URL ссылается на localhost; для простой демонстрации выполните npm run build, для HMR настройте отдельный Vite-туннель |
| Вход пропадает после смены домена | Cookie относятся к прежнему хосту; проверьте домен cookie и начните новую сессию |
Для абсолютных ссылок в тестовом окружении укажите текущий HTTPS-origin в APP_URL и примените конфигурацию способом, принятым в проекте. Это не настраивает доверие к прокси автоматически. Настройку HTTPS и прокси сверяйте с документацией Laravel; не доверяйте произвольным входящим заголовкам. Детали разработки frontend — в гайде Vite/HMR.
Повторная отладка и завершение
Найдите свой запрос в Logs кабинета, исправьте обработчик и используйте Replay. Повтор должен быть безопасен для бизнес-логики: одна доставка не означает новую оплату или новый заказ.
Случайный домен может меняться при новом SSH-сеансе. Для повторных тестов зарезервируйте поддомен Pro и подключайтесь привязанным ключом; имя сохранится, но локальное приложение и SSH должны работать. После проверки удалите диагностический маршрут и остановите процессы через Ctrl+C.
Откройте тестовый Laravel по HTTPS
Проверьте /tunnel-check локально, добавьте SSH-ключ и запустите туннель к порту Artisan. Повторите POST через выданный адрес до подключения настоящего провайдера.
Первый запуск: добавьте публичный SSH-ключ, запустите локальное приложение и команду SSH из статьи, затем откройте выданный HTTPS-адрес. Если ответа нет, пройдите проверку localhost и туннеля.
Free: 1 ГБ трафика в месяц, 1 туннель, сессия до 4 часов. Pro: 199 ₽/месяц, 50 ГБ, до 5 туннелей и резервирование поддомена. Компьютер, приложение и SSH-соединение должны работать; постоянный адрес сохраняет имя, а не доступность выключенного сервера.
Готовы запустить свой первый туннель?
Начните использовать TunnelHunt бесплатно уже сегодня и откройте доступ к локальному серверу всего одной командой.
Зарегистрироваться бесплатно →По теме

Telegram-бот локально: webhook, secret_token и отладка на localhost
5 июня 2025 г.
Запустите Telegram-бота на localhost: выберите polling или webhook, настройте HTTPS и secret_token, проверьте getWebhookInfo и исправьте ошибки доставки.

Как запустить localhost и открыть сайт в интернете через SSH
11 сентября 2026 г.
Запуск сайта на localhost:3000, проверка в браузере и с телефона, публичный HTTPS через SSH. Пример на Python, настройка Docker и Vite, диагностика ошибок.

Как повторить вебхук: отладка HTTP-запросов через Replay
20 июня 2026 г.
Получите тестовый вебхук, найдите ошибку и повторите запрос после исправления. Рабочий пример на Python, диагностика подписей и ограничения Replay.

Vite на localhost:5173 не открывается: проверка с ПК, телефона и по HTTPS
5 октября 2026 г.
Как запустить Vite на 127.0.0.1:5173, открыть React или Vue с телефона и исправить 403, 502 или HMR при работе через HTTPS-туннель.