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

Установка Localtonet в Linux

Помощь по этой странице
На этой странице 9 разделов
  1. Перед началом
  2. Установка с помощью скрипта
  3. Запустите установочный скрипт
  4. Проверьте установку
  5. Установка вручную
  6. Скачайте и распакуйте
  7. По желанию: переместите в PATH
  8. Запустите клиент
  9. Запустите его с вашим токеном
  10. Проверьте сессию
  11. Запуск как служба systemd
  12. Установите службу
  13. Проверьте, что она работает
  14. Команды службы
  15. Юнит и его журналы
  16. Обновление
  17. Замените клиент
  18. Перезапустите службу
  19. Удаление
  20. Устранение неполадок
  21. Связанные страницы

В Linux клиент Localtonet — это одна консольная программа. Установите её с помощью установочного скрипта или из ZIP-архива, запустите с вашим AuthToken и установите как службу systemd, если она должна запускаться после каждой перезагрузки.

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

Другие способы запустить Localtonet в Linux. В Debian, Ubuntu, Fedora и RHEL можно установить пакет DEB или RPM, который приносит собственные службы. Отдельные руководства есть для Docker, маршрутизаторов OpenWrt и Termux на Android.

Установка с помощью скрипта #

  1. Запустите установочный скрипт #

    Терминал
    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 отсутствует, скрипт пытается установить его менеджером пакетов вашего дистрибутива.

  2. Проверьте установку #

    В конце скрипт выводит установленную версию. Её можно вывести снова в любой момент:

    Терминал
    localtonet --version

Установка вручную #

Если вы предпочитаете прямую загрузку, возьмите архив для вашей системы. В каждом ZIP один файл — localtonet.

Процессорglibc (Debian, Ubuntu, Fedora, RHEL и большинство других)musl (Alpine)
x64localtonet-linux-x64.ziplocaltonet-linux-musl-x64.zip
ARM64localtonet-linux-arm64.ziplocaltonet-linux-musl-arm64.zip
ARM (32-разрядный)localtonet-linux-arm.ziplocaltonet-linux-musl-arm.zip

uname -m выводит тип процессора: x86_64 — это x64, aarch64 — ARM64, а armv7l — ARM.

  1. Скачайте и распакуйте #

    В примере используется сборка x64 с glibc. Замените имя файла на архив для вашей системы.

    Терминал
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. По желанию: переместите в PATH #

    Без этого шага клиент запускается по пути ~/localtonet/localtonet. После него можно вводить localtonet в любой папке.

    Терминал
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Запустите клиент #

  1. Запустите его с вашим токеном #

    Терминал
    localtonet --authtoken <YOUR_TOKEN>

    Клиент сохраняет токен локально для вашего пользователя. В следующий раз его можно запускать просто командой localtonet. Если запустить его без сохранённого токена, он спросит Please Enter AuthToken or PIN.

  2. Проверьте сессию #

    В терминале отображается 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.

  1. Установите службу #

    Терминал
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    Команда создаёт юнит systemd для этого токена, включает его и сразу запускает. В ответ она выводит имя юнита:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> — это первые 9 символов вашего токена. У каждого токена свой юнит, поэтому остальным командам для работы со службой нужен тот же --authtoken, чтобы его найти.

  2. Проверьте, что она работает #

    Терминал
    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>/, и служба запускает копию.

Обновление #

  1. Замените клиент #

    Запустите установочный скрипт снова. Его можно безопасно запускать повторно: он перезаписывает установленный клиент текущей версией. После установки вручную скачайте актуальный архив и замените файл localtonet.

    Терминал
    curl -fsSL https://localtonet.com/install.sh | sh
  2. Перезапустите службу #

    Работающая служба продолжает использовать старую версию, пока не будет перезапущена.

    Терминал
    sudo systemctl restart Localtonet_<TOKEN_PREFIX>

    Если служба запускает копию внутри /usr/local/lib/, вместо этого удалите службу и установите её заново с новым клиентом.

На странице Мои токены в столбце Клиент показана версия, о которой устройство сообщило в последний раз, и значок Требуется обновление, когда доступна более новая.

Удаление #

  1. Если вы устанавливали службу, удалите её: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Чтобы удалить сохранённый токен, запустите клиент и нажмите F12.
  3. Удалите клиент: 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 с тем же токеном. Закройте его или запустите этот клиент с другим токеном. На один токен — один работающий клиент.

Поддержка