Локал туннель предоставляет доступ к вашему локальному хосту всему миру для удобства тестирования и обмена! Не нужно возиться с DNS или развёртывать, чтобы другие могли протестировать ваши изменения.

Отлично подходит для работы с инструментами тестирования браузера, такими как browserling, или внешними службами обратного вызова API, такими как Twilio, которым требуется публичный URL для обратных вызовов.

Быстрый старт

npx localtunnel --port 8000

Установка

Глобально

npm install -g localtunnel

Как зависимость в вашем проекте

yarn add localtunnel

Использование CLI

Когда локальный туннель установлен глобально, просто используйте команду lt, чтобы запустить туннель.

lt --port 8000

Вот и всё! Он подключится к серверу туннеля, настроит туннель и сообщит вам, какой URL использовать для тестирования. Этот URL будет активен в течение всего сеанса; так что не стесняйтесь делиться им с другими для весёлого времяпрепровождения!

Вы можете перезапускать свой локальный сервер сколько угодно, lt достаточно умён, чтобы обнаружить это и переподключиться, когда он снова заработает.

Аргументы

Ниже приведены некоторые общие аргументы. См. lt --help для получения дополнительных аргументов.

• --subdomain запросите именованный поддомен на сервере localtunnel (по умолчанию используются случайные символы).
• --local-host проксируйте на имя хоста, отличное от localhost.

Также можно указать аргументы через переменные среды. Например:

PORT=3000 lt

API

Клиент localtunnel также можно использовать через API (для тестовой интеграции, автоматизации и т. д.).

localtunnel(порт [, параметры][, обратный вызов])

Создаёт новый локальный туннель к указанному локальному порту. Вернёт Promise, который разрешится, как только вам будет назначен публичный локальный URL туннеля. Параметры можно использовать для запроса определённого поддомена. Можно передать функцию обратного вызова, в этом случае она не вернёт Promise. Это существует для обратной совместимости со старым API обратного вызова Node. Также можно передать один объект параметров с портом в качестве свойства.

const localtunnel = require('localtunnel');

(async () => {
  const tunnel = await localtunnel({ port: 3000 });

  // назначенный публичный URL вашего туннеля
  // например, https://abcdefgjhij.localtunnel.me
  tunnel.url;

  tunnel.on('close', () => {
    // туннели закрыты
  });
})();

параметры

• port (число) [обязательно] номер порта локального компьютера, который будет открыт через localtunnel.
• subdomain (строка) запросите конкретный поддомен на прокси-сервере. Примечание Вы можете фактически не получить это имя в зависимости от доступности.
• host (строка) URL для вышестоящего прокси-сервера. По умолчанию используется https://localtunnel.me.
• local_host (строка) проксируйте этот хост вместо localhost. Это также приведёт к тому, что заголовок Host будет переписан на это значение в проксируемых запросах.
• local_https (логическое значение) включите туннелирование на локальный HTTPS-сервер.
• local_cert (строка) путь к файлу сертификата PEM для локального HTTPS-сервера.
• local_key (строка) путь к файлу ключа сертификата для локального HTTPS-сервера.
• local_ca (строка) путь к файлу центра сертификации для самозаверяющих сертификатов.
• allow_invalid_cert (логическое значение) отключите проверку сертификатов для вашего локального HTTPS-сервера (игнорируйте параметры cert/key/ca).

Подробнее о параметрах сертификата см. в tls.createSecureContext.

Туннель

Экземпляр туннеля, возвращаемый вашему обратному вызову, генерирует следующие события.

У экземпляра туннеля есть следующие методы.

Другие клиенты

Клиенты на других языках. go gotunnelme

go-localtunnel

server

Подробности о сервере, который обеспечивает работу localtunnel, см. на странице localtunnel/server.

License

MIT