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

Запуск туннеля через SSH-клиент

Бесплатный тариф HTTP- и TCP-туннели

Помощь по этой странице
На этой странице 11 разделов
  1. Когда это нужно
  2. Перед началом
  3. Шаги
  4. Создайте HTTP- или TCP-туннель
  5. Откройте SSH-команду
  6. Выберите, нужно ли переподключение
  7. Выполните команду
  8. Не закрывайте окно
  9. Из мастера настройки туннеля
  10. Разбор команды
  11. Автоматическое переподключение
  12. Как долго действует команда
  13. Ограничения
  14. Что вы видите в панели управления
  15. Устранение неполадок
  16. Сообщения в панели управления
  17. Сообщения в терминале
  18. Связанные страницы

Опубликуйте локальный сервис, не устанавливая Localtonet. Панель управления выдаёт готовую команду ssh; пока эта команда выполняется, ваш HTTP- или TCP-туннель работает.

Когда это нужно #

Используйте SSH без установки на компьютере, где вы не можете или не хотите устанавливать клиент Localtonet: например, на сервере, к которому вы подключаетесь ненадолго, на ограниченном рабочем компьютере или для быстрой демонстрации. Вам нужен только клиент ssh, который входит в состав Windows, macOS и Linux.

SSH-команда заменяет клиент Localtonet для одного туннеля. Всё остальное остаётся в панели управления: адрес туннеля, его настройки, журналы и трафик.

Тип туннеляSSH-команда
HTTP / HTTPSДоступно
TCPДоступно
UDP, UDP / TCP смешанный, TLS, Файловый сервер, Прокси-сервер и другие типыНедоступно. Для них нужен клиент Localtonet.

Эта страница не о доступе к SSH-серверу. Чтобы опубликовать собственный SSH-сервер через туннель, см. Использование Localtonet с SSH. Чтобы открыть оболочку на одном из ваших устройств из панели управления, см. Терминал устройств.

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

  • Аккаунт Localtonet и уже запущенный сервис, например веб-приложение на порту 3000.
  • Клиент ssh на компьютере, который имеет доступ к сервису. Проверьте командой ssh -V.
  • В сети этого компьютера должны быть разрешены исходящие TCP-подключения к порту 223.
  • AuthToken, который не использует ни один запущенный клиент Localtonet. Туннель всегда принадлежит токену, но при работе через SSH ни один клиент не входит с ним в систему. Если клиент подключён с токеном этого туннеля, панель управления откажется выдавать команду.

Шаги #

  1. Создайте HTTP- или TCP-туннель #

    Откройте Мои туннели › HTTP или Мои туннели › TCP - UDP (протокол TCP) и создайте туннель как обычно. Локальный IP-адрес и Локальный порт определяют, куда SSH-клиент будет отправлять трафик: это 127.0.0.1 и порт вашего сервиса, если вы запускаете команду на том же компьютере, что и сервис. Оставьте туннель остановленным.

  2. Откройте SSH-команду #

    В списке туннелей выберите Настройки для нужного туннеля, затем Показать SSH-команду. Откроется диалог SSH-команда с командой для этого туннеля. Уведомление сообщает, сколько секунд у вас есть, чтобы её выполнить; неиспользованная команда истекает, и новую вы запрашиваете так же.

  3. Выберите, нужно ли переподключение #

    Оставьте Автопереподключение выключенным, чтобы получить обычную команду ssh. Включите его, чтобы обернуть команду в цикл, который запускает её снова при обрыве соединения, и выберите в разделе Где вы будете её запускать, для какой оболочки написан цикл: PowerShell, Командная строка или macOS или Linux.

  4. Выполните команду #

    Скопируйте текст под заголовком Команда. Откройте терминал на компьютере, на котором работает ваш сервис, вставьте команду и нажмите Enter. Пароль не запрашивается. Когда соединение установлено, терминал показывает конечные точки туннеля:

    Терминал
    +--------------------------------------------------------------+
    | Welcome to Localtonet!                                       |
    +--------------------------------------------------------------+
    | Localtonet Tunnel Endpoints                                  |
    +--------------------------------------------------------------+
    | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000               |
    | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000             |
    +--------------------------------------------------------------+
    | Server Time: ...                                             |
    +--------------------------------------------------------------+
    
    You can view your requests and configure your tunnel settings from the Localtonet Dashboard.

    Для TCP-туннеля выводится одна строка: TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>.

  5. Не закрывайте окно #

    Туннель запускается сам, когда команда подключается; нажимать Запустить не нужно. Он работает, пока выполняется команда. Закрытие окна разрывает соединение, и публичный адрес перестаёт отвечать. Чтобы завершить команду самостоятельно, введите exit и нажмите Enter или нажмите Ctrl + C.

    Завершение команды не останавливает туннель в панели управления. Туннель остаётся запущенным, а его соединение отображается как отключённое, чтобы та же команда могла подключиться снова. Когда туннель вам больше не нужен, выберите для него Остановить в панели управления. Новую SSH-команду панель выдаёт только для остановленного туннеля.

Из мастера настройки туннеля #

Та же команда есть в Мастере настройки туннеля на Панели управления. На последнем шаге, где вы выбираете платформу, выберите SSH, а затем Получить SSH-команду. Вариант SSH появляется только для HTTP- и TCP-туннелей. Пока ваша команда не подключилась, мастер показывает Ожидание SSH, а после подключения — Подключён по SSH. Автопереподключение добавляет такой же цикл переподключения, а Получить новую команду заменяет истёкшую команду.

Разбор команды #

Команда всегда имеет такой вид. Панель управления подставляет значения для вашего туннеля:

Bash
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>
ЧастьЧто делает
-p 223Подключается к порту 223, на котором Localtonet принимает такие SSH-подключения.
-l <COMMAND_KEY>Имя для входа. Это ключ, который панель управления создаёт для этого туннеля; он не является ни вашим AuthToken, ни паролем от аккаунта. Он сообщает Localtonet, какой туннель запускать, поэтому пароль не запрашивается.
<TUNNEL_ADDRESS>Адрес вашего туннеля. SSH-соединение устанавливается с сервером, на котором он размещён.
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>Удалённая переадресация: подключения, поступающие к туннелю на сервере, передаются через SSH-соединение на <LOCAL_IP>:<LOCAL_PORT>. Последние два значения — это Локальный IP-адрес и Локальный порт туннеля. Порт сервера назначает Localtonet, и менять его нельзя.
-o ExitOnForwardFailure=yesЗавершает ssh, если переадресацию не удалось настроить, вместо того чтобы оставаться подключённым без работающего туннеля.
-o ServerAliveInterval=15 -o ServerAliveCountMax=3Отправляет keep-alive каждые 15 секунд и разрывает соединение после трёх неотвеченных, так что потеря соединения обнаруживается примерно за 45 секунд.
-o ConnectTimeout=15Прекращает попытки через 15 секунд, если сервер недоступен.
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/nullПропускает вопрос о ключе хоста и не записывает сервер в ваш файл known_hosts.
-o LogLevel=ERRORСкрывает информационные сообщения ssh. Ошибки по-прежнему отображаются.

Поскольку <LOCAL_IP> разрешается на компьютере, где вы запускаете ssh, сервис не обязан находиться на этом компьютере. С локальным адресом, например 192.168.1.20, команда перенаправляет трафик на другое устройство в той же сети.

Не передавайте команду другим. Тот, кто выполнит её, пока она действительна, будет отвечать на трафик вашего туннеля.

Автоматическое переподключение #

Если включено Автопереподключение, панель управления оборачивает ту же команду ssh в небольшой скрипт для выбранной вами оболочки. Для Командной строки скрипт передаётся одной строкой powershell -NoProfile -EncodedCommand …. Во всех оболочках скрипт ведёт себя одинаково:

  • Когда ssh завершается, скрипт ждёт и запускает его снова. Ожидание начинается примерно с 10 секунд и удваивается после каждой неудачной попытки, вплоть до примерно 2 минут.
  • Соединение, которое длилось не менее 60 секунд, считается успешным и сбрасывает время ожидания.
  • После 8 подряд попыток, каждая из которых завершилась менее чем за 60 секунд, скрипт останавливается и выводит SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel.

Переподключение использует ту же команду. Это работает после сбоя сети, но не после того, как туннель был остановлен в панели управления или достиг лимита; в этом случае скрипт прекращает попытки, и вам нужна новая команда.

Как долго действует команда #

  • До первого использования: команду нужно выполнить за время, которое панель управления показывает при её выдаче. После этого предложение порта истекает.
  • Во время использования: одна SSH-сессия на туннель. Вторая копия команды отклоняется, пока подключена первая.
  • После завершения соединения: та же команда может подключиться снова, если туннель не был остановлен в панели управления и лимит не достигнут.
  • После остановки: если туннель был остановлен в панели управления или из-за лимита, срок действия команды закончился. Снова откройте Показать SSH-команду, чтобы получить новую.

Панель управления выдаёт команду только пока туннель остановлен. Новая команда может прийти с другим портом сервера; на Бесплатном тарифе каждая новая команда получает новый порт. Для TCP-туннеля этот порт входит в публичный адрес, поэтому после запроса новой команды проверьте адрес в выводе терминала или в списке туннелей. Журнал активности туннеля фиксирует это изменение как Server port changed to "…" for SSH.

Ограничения #

  • Лимит сеанса на Бесплатном тарифе. Туннель, запущенный через SSH, подчиняется тому же правилу, что и запущенный клиентом: на Бесплатном тарифе TCP-туннели останавливаются через 30 минут и их можно запустить снова, а у HTTP-туннелей ограничения по времени нет. Эти 30 минут отсчитываются с момента первого подключения команды; переподключение с той же командой отсчёт не сбрасывает. Когда TCP-сессия достигает лимита, сервер закрывает SSH-соединение сообщением Session time limit reached. Get a new SSH command from the panel. См. Тарифы и баланс.
  • Трафик. Трафик учитывается в вашем объёме, как и трафик любого другого туннеля. Если трафик исчерпан, команда не выдаётся, а запущенную сессию сервер закрывает сообщением Bandwidth limit reached. Get a new command after bandwidth is available.
  • Только обратная переадресация. SSH-точка входа принимает только одну переадресацию из команды. Она не даёт вам оболочки на сервере Localtonet и не поддерживает другие виды переадресации.
  • Один туннель на команду. Чтобы запустить несколько туннелей, запросите команду для каждого и выполняйте каждую в отдельном терминале.

Что вы видите в панели управления #

Пока команда подключена, туннель отображается как запущенный, а запросы появляются в его журналах как обычно. В Журнале активности туннеля при подключении команды записывается Tunnel started over SSH. См. Журналы и инспекция.

Устранение неполадок #

Сообщения в панели управления #

СообщениеЧто делать
Остановите туннель, прежде чем запрашивать SSH-команду.Туннель работает через клиент Localtonet. Остановите его, затем снова выберите Показать SSH-команду.
Остановите текущий SSH-туннель, прежде чем запрашивать новую команду.Туннель всё ещё запущен через SSH, или его SSH-сессия была активна совсем недавно. Завершите выполняющуюся команду ssh, выберите для туннеля Остановить и повторите попытку.
К этому туннелю подключён клиент с созданным вами AuthToken. Создайте новый AuthToken.Клиент Localtonet вошёл с токеном этого туннеля. Остановите этот клиент или создайте другой токен в разделе Мои токены и используйте его для этого туннеля.
Недостаточно оставшегося трафика, чтобы запустить туннель.Ваш трафик исчерпан. См. Тарифы и баланс.
Эта функция недоступна для этого типа протокола.Туннель не является HTTP- или TCP-туннелем.
Эта функция недоступна на этом сервере. Перенесите туннель на другой сервер.Сервер этого туннеля не поддерживает SSH-команды. Создайте туннель на другом сервере.
Выполняется операция с туннелем. Попробуйте ещё раз чуть позже.Подождите несколько секунд и повторите попытку.
Не удалось назначить новый порт сервера.Повторите попытку. Если ошибка повторяется, создайте туннель на другом сервере.
Не удалось сохранить порт SSH. Попробуйте ещё раз.Повторите попытку.

Сообщения в терминале #

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

Сообщение или симптомПричина и решение
ssh сразу завершается с ошибкой аутентификации, обычно Permission deniedLocaltonet не принял команду. Она не была выполнена вовремя, туннель был остановлен или достиг лимита после выдачи команды, другая сессия с этой же командой уже подключена, либо текст был изменён при копировании. Получите новую команду в панели управления и вставьте её без изменений.
Port mismatch. Get a new SSH command from the panel.Порт сервера после -R не совпадает с назначенным Localtonet. Используйте команду точно в том виде, в каком она была выдана.
Session time limit reached. Get a new SSH command from the panel.30-минутная сессия TCP-туннеля на Бесплатном тарифе закончилась. Запросите новую команду, чтобы начать заново.
Bandwidth limit reached. Get a new command after bandwidth is available.Ваш трафик исчерпан.
Session stopped. Get a new SSH command from the panel.Туннель был остановлен, например из панели управления.
Тайм-аут соединения или Connection refusedКомпьютер не может связаться с сервером через порт 223. Разрешите исходящие TCP-подключения к порту 223 в брандмауэре или попробуйте из другой сети.
Туннель работает, но посетители получают ошибкуssh подключён, но не может связаться с вашим сервисом. Проверьте, что сервис запущен, а Локальный IP-адрес и Локальный порт туннеля указаны верно. После их изменения запросите новую команду, потому что старая всё ещё содержит прежние значения.
Поддержка