Запуск туннеля через SSH-клиент
Бесплатный тариф HTTP- и TCP-туннели
На этой странице 11 разделов
- Когда это нужно
- Перед началом
- Шаги
- Создайте HTTP- или TCP-туннель
- Откройте SSH-команду
- Выберите, нужно ли переподключение
- Выполните команду
- Не закрывайте окно
- Из мастера настройки туннеля
- Разбор команды
- Автоматическое переподключение
- Как долго действует команда
- Ограничения
- Что вы видите в панели управления
- Устранение неполадок
- Сообщения в панели управления
- Сообщения в терминале
- Связанные страницы
Опубликуйте локальный сервис, не устанавливая 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 ни один клиент не входит с ним в систему. Если клиент подключён с токеном этого туннеля, панель управления откажется выдавать команду.
Шаги #
-
Создайте HTTP- или TCP-туннель #
Откройте Мои туннели › HTTP или Мои туннели › TCP - UDP (протокол TCP) и создайте туннель как обычно. Локальный IP-адрес и Локальный порт определяют, куда SSH-клиент будет отправлять трафик: это
127.0.0.1и порт вашего сервиса, если вы запускаете команду на том же компьютере, что и сервис. Оставьте туннель остановленным. -
Откройте SSH-команду #
В списке туннелей выберите Настройки для нужного туннеля, затем Показать SSH-команду. Откроется диалог SSH-команда с командой для этого туннеля. Уведомление сообщает, сколько секунд у вас есть, чтобы её выполнить; неиспользованная команда истекает, и новую вы запрашиваете так же.
-
Выберите, нужно ли переподключение #
Оставьте Автопереподключение выключенным, чтобы получить обычную команду
ssh. Включите его, чтобы обернуть команду в цикл, который запускает её снова при обрыве соединения, и выберите в разделе Где вы будете её запускать, для какой оболочки написан цикл: PowerShell, Командная строка или macOS или Linux. -
Выполните команду #
Скопируйте текст под заголовком Команда. Откройте терминал на компьютере, на котором работает ваш сервис, вставьте команду и нажмите 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>. -
Не закрывайте окно #
Туннель запускается сам, когда команда подключается; нажимать Запустить не нужно. Он работает, пока выполняется команда. Закрытие окна разрывает соединение, и публичный адрес перестаёт отвечать. Чтобы завершить команду самостоятельно, введите
exitи нажмите Enter или нажмите Ctrl + C.Завершение команды не останавливает туннель в панели управления. Туннель остаётся запущенным, а его соединение отображается как отключённое, чтобы та же команда могла подключиться снова. Когда туннель вам больше не нужен, выберите для него Остановить в панели управления. Новую SSH-команду панель выдаёт только для остановленного туннеля.
Из мастера настройки туннеля #
Та же команда есть в Мастере настройки туннеля на Панели управления. На последнем шаге, где вы выбираете платформу, выберите SSH, а затем Получить SSH-команду. Вариант SSH появляется только для HTTP- и TCP-туннелей. Пока ваша команда не подключилась, мастер показывает Ожидание SSH, а после подключения — Подключён по SSH. Автопереподключение добавляет такой же цикл переподключения, а Получить новую команду заменяет истёкшую команду.
Разбор команды #
Команда всегда имеет такой вид. Панель управления подставляет значения для вашего туннеля:
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 denied | Localtonet не принял команду. Она не была выполнена вовремя, туннель был остановлен или достиг лимита после выдачи команды, другая сессия с этой же командой уже подключена, либо текст был изменён при копировании. Получите новую команду в панели управления и вставьте её без изменений. |
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-адрес и Локальный порт туннеля указаны верно. После их изменения запросите новую команду, потому что старая всё ещё содержит прежние значения. |