Перейти до вмісту
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. Параметри перелічено в довіднику CLI.

Юніт і його журнали #

Файл юніта — /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. Див. довідник CLI.

Wrong Token!

Клієнт очікує 33-символьний AuthToken зі сторінки Мої токени або 6-значний PIN, строк дії якого не минув. Скопіюйте токен ще раз і введіть його у відповідь на запит.

This token is used in another localtonet application!

Інший клієнт Localtonet на цій машині вже працює з тим самим токеном. Закрийте його або запустіть цей з іншим токеном. Використовуйте один запущений клієнт на токен.

Підтримка