Перейти к содержимому
Localtonet Localtonet Панель управления

Доступ к виртуальному хосту через Localtonet

Помощь по этой странице
На этой странице 10 разделов
  1. Почему виртуальному хосту нужен правильный заголовок Host
  2. Перед началом
  3. Создание туннеля
  4. Откройте страницу HTTP
  5. Заполните форму
  6. Запустите туннель
  7. Вариант 1: задать заголовок Host в туннеле
  8. Вариант 2: добавить имя туннеля в виртуальный хост
  9. Apache
  10. Nginx
  11. Вариант 3: использовать собственный домен
  12. Несколько виртуальных хостов
  13. Защитите доступ
  14. Частые проблемы
  15. Связанные страницы

Опубликуйте в интернете один сайт локального сервера Apache или Nginx, включая конфигурации XAMPP, WampServer и MAMP с несколькими сайтами: создайте HTTP-туннель и убедитесь, что веб-сервер получает известное ему имя хоста.

Почему виртуальному хосту нужен правильный заголовок Host #

При виртуальных хостах на основе имён один веб-сервер обслуживает несколько сайтов на одном порту. Он выбирает сайт по заголовку Host каждого запроса: запрос для mysite.test получает тот сайт, в конфигурации которого указано mysite.test.

HTTP-туннель передаёт заголовок Host посетителя вашему веб-серверу без изменений. Поэтому посетитель, открывший адрес туннеля, отправляет имя хоста туннеля, например имя, оканчивающееся на .localto.net, а не mysite.test. Ваш веб-сервер не знает этого имени и отвечает своим сайтом по умолчанию — обычно первым в конфигурации или стартовой страницей XAMPP или WampServer.

Есть три способа это исправить. Выберите один:

ВариантЧто вы меняетеЛучше всего подходит для
Задать заголовок Host в туннелеЗаголовок запроса в настройках туннеля. Ничего не меняется на веб-сервере.Быстрого просмотра статического или простого сайта.
Добавить имя туннеля в виртуальный хостОдна строка в конфигурации веб-сервера.Приложений, которые строят ссылки и перенаправления из имени хоста.
Использовать собственный доменТуннель использует ваш домен, и виртуальный хост назван по нему.Сайта, у которого должен быть постоянный адрес.

Перед началом #

  • Аккаунт Localtonet и клиент Localtonet, подключённый с вашим AuthToken на компьютере, где работает веб-сервер. См. Быстрый старт.
  • Виртуальный хост, который работает в браузере на этом компьютере, например http://mysite.test.
  • Порт, который прослушивает веб-сервер. XAMPP и WampServer используют 80. MAMP использует 8888, если вы это не меняли.

Создание туннеля #

  1. Откройте страницу HTTP #

    Откройте Мои туннели › HTTP и разверните Создать HTTP-туннель.

  2. Заполните форму #

    ПолеЧто ввести
    Тип URLСлучайный поддомен для вариантов 1 и 2. Для варианта 3 выберите Свой домен.
    Токен устройстваТокен, который использует клиент Localtonet на компьютере.
    Регион сервераВыберите регион, близкий к вашему устройству, чтобы уменьшить задержку.
    Локальный IP-адрес127.0.0.1. Введите адрес, а не имя виртуального хоста: имя передаётся в заголовке Host.
    Локальный портПорт веб-сервера, например 80.

    Выберите Создать туннель.

  3. Запустите туннель #

    Туннель появится в разделе Ваши туннели. Выберите Запустить и запомните публичный адрес в столбце URL. Если открыть его сейчас, вы увидите сайт веб-сервера по умолчанию. Это исправляет следующий шаг.

Форма туннеля подробно описана на странице HTTP / HTTPS.

Вариант 1: задать заголовок Host в туннеле #

Туннель может заменять заголовок Host до того, как запрос дойдёт до вашего веб-сервера. Эта настройка — заголовок запроса с именем Host:

  1. Выберите Настройки в строке туннеля.
  2. Рядом с Заголовки выберите Управлять. Откроется окно HTTP-заголовки на вкладке Заголовки запроса.
  3. Выберите Хост в разделе Варианты или выберите Добавить заголовок запроса и введите Host в качестве имени.
  4. В качестве значения введите имя вашего виртуального хоста, например mysite.test. Подсказка подставляет localhost; замените его. Вводите только имя хоста, без http:// и без пути.
  5. Выберите Сохранить.

Панель управления описывает заголовок запроса Хост так: ваша служба получает это имя хоста вместо адреса туннеля, что полезно, когда локальный веб-сервер выбирает сайт по имени хоста. Без заголовка запроса Host ваша служба получает имя хоста, которое использовал посетитель.

Снова откройте адрес туннеля. Теперь веб-сервер получает Host: mysite.test и отвечает этим сайтом. Чтобы вернуть всё назад, удалите заголовок и сохраните.

Приложение тоже видит локальное имя. Программы, которые строят ссылки и перенаправления из заголовка Host или из настроенного адреса сайта, теперь отправляют посетителей на mysite.test, который существует только на вашем компьютере. Если страницы загружаются без стилей или вход перенаправляет на локальное имя, используйте вариант 2 или 3.

В API есть такая же настройка, как переопределение заголовка Host у HTTP-туннеля. См. API. Другие заголовки запроса и ответа рассматриваются на странице Заголовки и перезаписи.

Вариант 2: добавить имя туннеля в виртуальный хост #

Сообщите веб-серверу, что имя хоста туннеля относится к вашему сайту. Скопируйте имя хоста из URL туннеля без https:// и добавьте его как псевдоним. Оставьте Заголовки туннеля пустыми.

Apache #

В XAMPP виртуальные хосты находятся в apache\conf\extra\httpd-vhosts.conf. Добавьте строку ServerAlias:

httpd-vhosts.conf
<VirtualHost *:80>
    ServerName mysite.test
    ServerAlias <TUNNEL_HOST>
    DocumentRoot "C:/xampp/htdocs/mysite"
</VirtualHost>

Перезапустите Apache.

Nginx #

Добавьте имя хоста туннеля в server_name:

mysite.conf
server {
    listen 80;
    server_name mysite.test <TUNNEL_HOST>;
    root /var/www/mysite;
    index index.html index.php;
}

Проверьте конфигурацию и перезагрузите Nginx:

Терминал
sudo nginx -t && sudo nginx -s reload

HTTP-туннель сохраняет свой поддомен, пока вы не удалите туннель, поэтому псевдоним остаётся действительным после перезапусков.

Вариант 3: использовать собственный домен #

Когда туннель работает на вашем домене, посетители отправляют этот домен в заголовке Host, а виртуальный хост вы называете по нему. Переопределять заголовок и добавлять псевдоним не нужно, а ссылки, которые строит приложение, будут правильными.

  1. Добавьте домен в свой аккаунт и создайте HTTP-туннель, указав для Тип URL значение Свой домен. Шаги описаны на странице Собственные домены. Для собственных доменов нужен Баланс.
  2. Укажите в ServerName (Apache) или server_name (Nginx) виртуального хоста этот домен, как в примерах выше.

Свой поддомен работает так же, только с выбранным вами именем вместо случайного. Для него тоже нужен Баланс.

Несколько виртуальных хостов #

У одного HTTP-туннеля один публичный адрес, и он ведёт на один сайт. Для каждого дополнительного виртуального хоста создайте ещё один HTTP-туннель с теми же Локальный IP-адрес и Локальный порт и примените к нему один из вариантов. Бесплатный тариф допускает всего один туннель. См. Тарифы и баланс.

Защитите доступ #

Сайт для разработки часто не готов к показу посторонним. HTTP-туннель может попросить посетителей идентифицировать себя до того, как запрос дойдёт до вашего веб-сервера:

  • Basic Auth? в разделе Настройки туннеля запрашивает у посетителей имя пользователя и пароль.
  • Ограничение по IP › Управлять разрешает подключение только с перечисленных вами адресов. Нужен Баланс.
  • SSO-провайдеры требуют от посетителей сначала войти через поставщика удостоверений. Нужен Баланс.

Все три описаны на странице Контроль доступа. Для демонстрации Срок действия останавливает туннель в заданную вами дату. См. Лимиты и срок действия.

Частые проблемы #

Я вижу стартовую страницу XAMPP или WampServer либо не тот сайт

Веб-сервер не узнал имя хоста и показал сайт по умолчанию. Примените один из трёх вариантов. В варианте 1 проверьте, что заголовок называется Host, а его значение совпадает с ServerName или server_name сайта. В варианте 2 проверьте псевдоним на опечатки и перезапустите веб-сервер.

Страница загружается без стилей, или ссылки ведут на mysite.test

Приложение строит свои адреса из локального имени. Используйте вариант 2 или 3, чтобы приложение видело публичное имя. Приложениям с сохранённым адресом сайта нужно изменить и этот адрес: для WordPress обновите URL сайта на адрес туннеля или используйте собственный домен.

Сайт перенаправляет на http://, и браузер показывает предупреждение или возникает цикл

Посетители используют HTTPS по адресу туннеля, а туннель общается с вашим веб-сервером по обычному HTTP. Приложение, которое само принудительно включает HTTPS, может не заметить, что посетитель уже на HTTPS. В разделе Заголовки заголовок запроса X-Forwarded-Proto из Варианты со значением https сообщает такому приложению, что посетители используют HTTPS.

Посетители сначала видят страницу предупреждения Localtonet

На аккаунтах без Баланса Localtonet показывает эту страницу один раз каждому посетителю HTTP-туннеля. Запросы с заголовком localtonet-skip-warning с любым значением её пропускают, как и туннели на аккаунтах с Балансом.

Мой веб-сервер слушает только HTTPS

Укажите в Локальный порт туннеля порт HTTPS, обычно 443, и включите Локальный HTTPS (SslStream)? в разделе Настройки туннеля. Этот переключатель предназначен для локальных служб, которые сами используют HTTPS или TLS.

«Чтобы пользоваться этой функцией, пополните баланс.»

Свой поддомен, Свой домен, Ограничение по IP и SSO-провайдеры требуют Баланса. Пополните его в разделе Баланс.

Поддержка