Встановлення 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. Параметри перелічено в довіднику 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>/, і служба запускає копію.
Оновлення #
-
Замініть клієнт #
Запустіть інсталяційний скрипт ще раз. Його безпечно запускати повторно, він перезаписує встановлений клієнт поточною версією. Після ручного встановлення завантажте актуальний архів і замініть файл
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. Див. довідник CLI.
Wrong Token!
Клієнт очікує 33-символьний AuthToken зі сторінки Мої токени або 6-значний PIN, строк дії якого не минув. Скопіюйте токен ще раз і введіть його у відповідь на запит.
This token is used in another localtonet application!
Інший клієнт Localtonet на цій машині вже працює з тим самим токеном. Закрийте його або запустіть цей з іншим токеном. Використовуйте один запущений клієнт на токен.