Установка Localtonet в Linux
На этой странице 9 разделов
- Перед началом
- Установка с помощью скрипта
- Запустите установочный скрипт
- Проверьте установку
- Установка вручную
- Скачайте и распакуйте
- По желанию: переместите в PATH
- Запустите клиент
- Запустите его с вашим токеном
- Проверьте сессию
- Запуск как служба systemd
- Установите службу
- Проверьте, что она работает
- Команды службы
- Юнит и его журналы
- Обновление
- Замените клиент
- Перезапустите службу
- Удаление
- Устранение неполадок
- Связанные страницы
В Linux клиент Localtonet — это одна консольная программа. Установите её с помощью установочного скрипта или из ZIP-архива, запустите с вашим AuthToken и установите как службу systemd, если она должна запускаться после каждой перезагрузки.
Перед началом #
- Аккаунт Localtonet. Если его нет, создайте его бесплатно.
- Ваш AuthToken. Нажмите Копировать в карточке AuthToken на странице Панель управления или скопируйте токен на странице Мои токены.
curlилиwget, а такжеunzip.- Для службы systemd: доступ root и дистрибутив, использующий systemd.
Другие способы запустить Localtonet в Linux. В Debian, Ubuntu, Fedora и RHEL можно установить пакет DEB или RPM, который приносит собственные службы. Отдельные руководства есть для Docker, маршрутизаторов OpenWrt и Termux на Android.
Установка с помощью скрипта #
-
Запустите установочный скрипт #
Терминалcurl -fsSL https://localtonet.com/install.sh | shСкрипт определяет ваш процессор (x64, ARM64 или ARM) и то, использует ли система glibc или musl, скачивает подходящую сборку и устанавливает её в
/usr/local/bin/localtonet. Он также создаёт ссылку/usr/bin/localtonet, чтобыsudo localtonetработала в дистрибутивах, гдеsudoне ищет программы в/usr/local/bin.Скрипт использует
sudo, когда у вашего пользователя нет прав на запись в папку установки, поэтому он может запросить пароль. Еслиunzipотсутствует, скрипт пытается установить его менеджером пакетов вашего дистрибутива. -
Проверьте установку #
В конце скрипт выводит установленную версию. Её можно вывести снова в любой момент:
Терминалlocaltonet --version
Установка вручную #
Если вы предпочитаете прямую загрузку, возьмите архив для вашей системы. В каждом ZIP один файл — localtonet.
| Процессор | glibc (Debian, Ubuntu, Fedora, RHEL и большинство других) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32-разрядный) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m выводит тип процессора: x86_64 — это x64, aarch64 — ARM64, а armv7l — ARM.
-
Скачайте и распакуйте #
В примере используется сборка x64 с glibc. Замените имя файла на архив для вашей системы.
Терминалwget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
По желанию: переместите в PATH #
Без этого шага клиент запускается по пути
~/localtonet/localtonet. После него можно вводитьlocaltonetв любой папке.Терминалsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Запустите клиент #
-
Запустите его с вашим токеном #
Терминалlocaltonet --authtoken <YOUR_TOKEN>Клиент сохраняет токен локально для вашего пользователя. В следующий раз его можно запускать просто командой
localtonet. Если запустить его без сохранённого токена, он спроситPlease Enter AuthToken or PIN. -
Проверьте сессию #
В терминале отображается
Session Status: Connectedнад таблицей с одной строкой на каждый работающий туннель:IP/Url,Protocol,Client IP,Client Port,PingиStatus. Пока вы не запустите туннель в панели управления, таблица пуста, см. Быстрый старт.Нажмите Ctrl + C, чтобы остановить клиент. Нажмите F12, чтобы удалить сохранённый токен и выйти.
Если вывод идёт не в терминал, например перенаправлен в файл, клиент вместо таблицы пишет по одной простой строке на каждое изменение.
Для VPN нужен root. Если устройство входит в сеть Менеджер VPN, а клиент работает без root, в строке VPN таблицы отображается Admin rights required. В таком случае запускайте клиент через sudo или как службу.
Запуск как служба systemd #
Служба запускает Localtonet после каждой перезагрузки, продолжает работать после выхода из системы и не требует открытого терминала. Для команд службы нужен root.
-
Установите службу #
Терминалsudo localtonet --install-service --authtoken <YOUR_TOKEN>Команда создаёт юнит systemd для этого токена, включает его и сразу запускает. В ответ она выводит имя юнита:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>— это первые 9 символов вашего токена. У каждого токена свой юнит, поэтому остальным командам для работы со службой нужен тот же--authtoken, чтобы его найти. -
Проверьте, что она работает #
Терминалsudo localtonet --status-service --authtoken <YOUR_TOKEN>Работающая служба отвечает
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. В панели управления токен на странице Мои токены отображается как Онлайн.
Команды службы #
Выполняйте каждую команду через sudo и добавляйте --authtoken <YOUR_TOKEN>.
| Команда | Что делает |
|---|---|
--install-service | Записывает файл юнита, включает юнит и запускает его. |
--start-service | Запускает юнит, например после того, как вы его остановили. |
--stop-service | Останавливает юнит. Он остаётся включённым и снова запускается после перезагрузки. |
--status-service | Выводит состояние, например Running, Stopped или Error, если юнит завершился сбоем. |
--remove-service | Останавливает и отключает юнит и удаляет файл юнита. |
Служба устанавливается с теми параметрами, которые вы передаёте вместе с --install-service. Параметры перечислены в Справочнике по командной строке.
Юнит и его журналы #
Файл юнита — /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. systemd перезапускает клиент через пять секунд после сбоя. Поскольку это обычный юнит systemd, им можно управлять и через systemctl, а его вывод читать через journalctl:
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -fЮнит запускает файл localtonet по тому пути, который был у него при установке службы. Есть одно исключение: если этот путь находится внутри /root/, команда установки копирует файл в /usr/local/lib/Localtonet_<TOKEN_PREFIX>/, и служба запускает копию.
Обновление #
-
Замените клиент #
Запустите установочный скрипт снова. Его можно безопасно запускать повторно: он перезаписывает установленный клиент текущей версией. После установки вручную скачайте актуальный архив и замените файл
localtonet.Терминалcurl -fsSL https://localtonet.com/install.sh | sh -
Перезапустите службу #
Работающая служба продолжает использовать старую версию, пока не будет перезапущена.
Терминалsudo systemctl restart Localtonet_<TOKEN_PREFIX>Если служба запускает копию внутри
/usr/local/lib/, вместо этого удалите службу и установите её заново с новым клиентом.
На странице Мои токены в столбце Клиент показана версия, о которой устройство сообщило в последний раз, и значок Требуется обновление, когда доступна более новая.
Удаление #
- Если вы устанавливали службу, удалите её:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Чтобы удалить сохранённый токен, запустите клиент и нажмите F12.
- Удалите клиент:
sudo rm /usr/local/bin/localtonet /usr/bin/localtonetпосле установки скриптом или папку, в которую вы распаковали архив.
Устранение неполадок #
Установочный скрипт: Unsupported architecture
У скрипта есть сборки для x64 (x86_64), ARM64 (aarch64) и 32-разрядного ARM (armv7l). Другие типы процессоров сборки для Linux не поддерживают.
Установочный скрипт: Neither curl nor wget found
Установите curl или wget менеджером пакетов и запустите скрипт снова.
Установочный скрипт: Failed to install 'unzip'
Скрипту не удалось самостоятельно установить unzip. Установите его менеджером пакетов и запустите скрипт снова.
Installed but not found in PATH
Откройте новую оболочку или запустите клиент по полному пути, /usr/local/bin/localtonet.
sudo: localtonet: command not found
После установки вручную клиента нет в пути поиска sudo. Используйте полный путь, например sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, или сначала переместите файл в /usr/local/bin.
Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.
Команда была запущена без root. Повторите её через sudo. То же относится к --start-service, --stop-service и --remove-service.
Install failed: Systemd unit already exists for 'Localtonet_…'
Служба для этого токена уже установлена. Проверьте её командой --status-service. Чтобы установить её заново, сначала выполните --remove-service.
Команды службы не работают в системе без systemd
Режим службы использует systemd. В системах без него запускайте клиент другим способом, например в контейнере Docker. Для этого у консольного клиента есть режим без интерфейса: --headless работает без запросов и читает токен из файла, заданного через --authtoken-file. См. Справочник по командной строке.
Wrong Token!
Клиент ожидает 33-символьный AuthToken со страницы Мои токены или неистёкший 6-значный PIN-код. Скопируйте токен ещё раз и введите его в строке запроса.
This token is used in another localtonet application!
На этом компьютере уже работает другой клиент Localtonet с тем же токеном. Закройте его или запустите этот клиент с другим токеном. На один токен — один работающий клиент.