Установка клиента Localtonet
На этой странице 5 разделов
- Поддерживаемые платформы
- Выбор вида установки
- Что общего у всех установок
- Клиент входит с помощью AuthToken
- Вы запускаете клиент с этим токеном
- Вы создаёте и запускаете туннели в панели управления
- Клиент должен оставаться запущенным
- Поддерживайте клиент в актуальном состоянии
- Руководства по установке
Клиент Localtonet работает на устройстве, где размещён ваш сервис, и поддерживает открытым туннель к Localtonet. На этой странице перечислены поддерживаемые платформы, помощь в выборе подходящего вида установки и ссылки на руководство по каждой из них.
Поддерживаемые платформы #
Все загрузки находятся на странице Загрузки.
| Платформа | Что можно установить | Архитектуры |
|---|---|---|
| Windows | Приложение из Microsoft Store, переносимое настольное приложение, консольный клиент | 64-разрядная (x64), 32-разрядная (x86), ARM64 |
| macOS | Консольный клиент, через Homebrew или в виде ZIP-архива | Intel (x64), Apple Silicon (ARM64) |
| Linux | Консольный клиент, через установочный скрипт или в виде ZIP-архива | x64, ARM и ARM64, каждая для glibc и для musl |
| Пакеты для Linux | Пакеты DEB и RPM со службами systemd | x64, ARM64 |
| Android | Приложение для Android из Google Play или в виде APK-файла | Минимальная версия Android для приложения — 5.0 |
| Termux | Консольный клиент в виде пакета Termux | ARM64 |
| Docker | Официальный образ localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | Пакеты для маршрутизаторов на OpenWrt 24.10 и 25.12+ (экспериментальные) | x64, ARM64 |
| NAS и Home Assistant | Шаблоны настройки Docker Compose и Home Assistant | AMD64, ARM64 |
| SSH без установки | Ничего. Вы используете уже имеющийся SSH-клиент. | Любое устройство с SSH-клиентом |
Выбор вида установки #
| Вариант | Что это | Когда выбирать |
|---|---|---|
| Консольный клиент | Программа localtonet для Windows, macOS и Linux. Вы запускаете её в терминале со своим AuthToken. Она показывает ваши туннели в таблице в реальном времени и может установить себя как службу. | Вы работаете в терминале либо устройство — сервер без графической среды. |
| Настольное приложение | Приложение Localtonet для Windows с окном входа, из Microsoft Store или в виде переносимого ZIP-архива. | В Windows вам удобнее окно приложения, чем терминал. |
| Мобильное приложение | Приложение Localtonet для Android. Вы входите по QR-коду, PIN-коду или токену. | Устройство — телефон или планшет на Android, например для мобильного прокси. |
| Пакет | Пакеты DEB и RPM для Linux, пакет Termux для Android и экспериментальные пакеты для OpenWrt. Пакеты для Linux и OpenWrt включают службу, которая читает токен из файла. | Вы хотите, чтобы клиент устанавливался и удалялся менеджером пакетов системы, а служба запускалась при загрузке. |
| Контейнер | Официальный образ Docker и основанные на нём шаблоны настройки для устройств NAS и Home Assistant. | Ваши сервисы уже работают в контейнерах, либо устройство — NAS. |
| SSH без установки | Панель управления формирует команду ssh, которая открывает туннель. Скачивать ничего не нужно. Это доступно для туннелей HTTP и TCP. | Вы не можете или не хотите ничего устанавливать на устройство. |
Что общего у всех установок #
-
Клиент входит с помощью AuthToken #
AuthToken подключает одно устройство к вашему аккаунту. Скопируйте его кнопкой Копировать на карточке AuthToken Панели управления или создайте именованный токен для каждого устройства в разделе Мои токены. О токенах рассказано на странице AuthToken-токены.
Храните токен в тайне. Любой, у кого есть токен, может использовать его для входа в приложение.
-
Вы запускаете клиент с этим токеном #
Замените
<YOUR_TOKEN>своим токеном.Windows
Откройте приложение Localtonet и вставьте свой AuthToken либо запустите консольный клиент в «Командной строке» из папки, где лежит
localtonet.exe:Командная строкаlocaltonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker pull localtonet/localtonet docker run localtonet/localtonet --authtoken <YOUR_TOKEN>Android
Откройте приложение Localtonet, затем отсканируйте QR-код токена, введите его PIN-код или вставьте токен и нажмите Connect. QR-код и PIN-код находятся в разделе Мои токены.
Консольный клиент сохраняет токен локально, поэтому в следующий раз его можно запускать просто командой
localtonet. Если запустить его без сохранённого токена, он спроситPlease Enter AuthToken or PIN. -
Вы создаёте и запускаете туннели в панели управления #
Клиенту не нужно заранее знать о ваших туннелях. Вы создаёте туннель в разделе Мои туннели, выбираете токен устройства, и его обслуживает клиент, вошедший с этим токеном. Быстрый старт проведёт вас через первый туннель.
-
Клиент должен оставаться запущенным #
Туннель начинает работать, когда клиент запущен с вашим AuthToken и туннель запущен. В разделе Мои токены каждое устройство отображается как Онлайн или Офлайн. Офлайн означает, что устройство отключено, даже если его туннели по-прежнему настроены.
Чтобы клиент продолжал работать после закрытия терминала, выхода из системы или перезагрузки устройства, установите его как службу:
Платформа Как Windows localtonet --install-service --authtoken <YOUR_TOKEN>в терминале, запущенном от имени администратораmacOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>Пакеты DEB, RPM и OpenWrt Пакет содержит службу. Вы включаете её после того, как зададите токен. Android Приложение продолжает работать в фоне и снова открывается после перезагрузки телефона. Подробности — в разделе Запуск в виде службы и на странице каждой платформы.
Поддерживайте клиент в актуальном состоянии #
Столбец Клиент в разделе Мои токены показывает последнюю версию, о которой сообщило каждое устройство. Значок Обновите ведёт на страницу загрузок, когда доступна более новая версия. Консольный клиент также показывает New Version available под таблицей туннелей, а localtonet --version выводит установленную версию.