Встановлення Localtonet на macOS
На цій сторінці 9 розділів
- Перш ніж почати
- Встановлення через Homebrew
- Додайте tap Localtonet і встановіть
- Перевірте встановлення
- Встановлення вручну
- Завантажте й розпакуйте
- Необов'язково: перемістіть його в PATH
- Запустіть клієнт
- Запустіть його зі своїм токеном
- Перевірте сесію
- Запуск як служби launchd
- Встановіть службу
- Переконайтеся, що вона працює
- Що створює встановлення
- Команди служби
- Оновлення
- Видалення
- Усунення несправностей
- Пов’язані сторінки
У macOS клієнт Localtonet — це консольна програма для Mac на Intel і Apple Silicon. Встановіть його через Homebrew або з ZIP-архіву, запустіть зі своїм AuthToken і встановіть як службу launchd, якщо він має запускатися при кожному завантаженні.
Перш ніж почати #
- Обліковий запис Localtonet. Створіть його безкоштовно, якщо його ще немає.
- Ваш AuthToken. Натисніть Копіювати на картці AuthToken у розділі Панель керування або скопіюйте токен із розділу Мої токени.
- Для встановлення через Homebrew: Homebrew.
- Для служби launchd: обліковий запис, який може використовувати
sudo.
Встановлення через Homebrew #
-
Додайте tap Localtonet і встановіть #
Tap додає до Homebrew стороннє сховище, щоб ви могли встановлювати з нього формули та оновлювати їх.
Терміналbrew tap localtonet/tap brew install localtonet -
Перевірте встановлення #
Терміналlocaltonet --versionКоманда виводить версію клієнта.
Встановлення вручну #
Якщо ви віддаєте перевагу прямому завантаженню, візьміть архів для вашого Mac. ZIP містить один файл, localtonet.
| Mac | Архів |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
Завантажте й розпакуйте #
Apple Siliconcurl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip unzip localtonet-osx-arm64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonetIntelcurl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip unzip localtonet-osx-64.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, щоб видалити збережений токен і вийти.
Запуск як служби launchd #
Служба запускає Localtonet при кожному завантаженні, підтримує його роботу після виходу з системи та не потребує відкритого терміналу. Команди служби потребують root, тому виконуйте їх через sudo.
-
Встановіть службу #
Терміналsudo localtonet --install-service --authtoken <YOUR_TOKEN>Команда реєструє системне завдання launchd для цього токена та одразу його запускає. Вона відповідає назвою завдання:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>— це перші 9 символів вашого токена. Кожен токен має власне завдання, тому інші команди служби потребують того самого--authtoken, щоб його знайти. -
Переконайтеся, що вона працює #
Терміналsudo localtonet --status-service --authtoken <YOUR_TOKEN>Працююче завдання відповідає
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. У панелі керування токен показує Онлайн у розділі Мої токени.
Що створює встановлення #
| Елемент | Розташування |
|---|---|
| Визначення завдання launchd | /Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist |
| Стандартний вивід клієнта | /var/log/Localtonet_<TOKEN_PREFIX>.out.log |
| Вивід помилок клієнта | /var/log/Localtonet_<TOKEN_PREFIX>.err.log |
Завдання запускається під час завантаження Mac, а launchd запускає клієнт знову, коли він завершується з помилкою. Завдання запускає файл localtonet за тим шляхом, який він мав під час встановлення служби, з токеном у складі аргументів.
Команди служби #
Виконуйте кожну команду через sudo і додавайте --authtoken <YOUR_TOKEN>.
| Команда | Що робить |
|---|---|
--install-service | Записує визначення завдання, завантажує його та запускає клієнт. |
--start-service | Запускає завдання. Якщо воно вже працює, launchd перезапускає його. |
--stop-service | Зупиняє клієнт. Завдання залишається встановленим і знову запускається під час наступного завантаження. |
--status-service | Виводить стан, наприклад Running, Stopped, NotFound або Error. |
--remove-service | Зупиняє завдання, вивантажує його та видаляє визначення завдання. |
Службу встановлено з параметрами, які ви передаєте разом із --install-service. Параметри перелічено в Довіднику CLI.
Оновлення #
- Homebrew:
brew upgrade localtonet - Встановлення вручну: завантажте актуальний архів і замініть файл
localtonet.
Якщо Localtonet працює як служба, після оновлення через Homebrew встановіть службу знову: видаліть її, а потім встановіть із тим самим токеном. Встановлення також запускає її.
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Завдання зберігає шлях до файлу, з якого його встановлено. Якщо після ручного оновлення клієнт залишається на тому самому місці, достатньо зупинити службу командою --stop-service, замінити файл і запустити службу командою --start-service. Ці команди описано в розділі Запуск як служби.
Видалення #
- Якщо ви встановлювали службу, видаліть її:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Щоб видалити збережений токен, запустіть клієнт і натисніть F12.
- Видаліть клієнт. Для Homebrew:
brew uninstall localtonet, аbrew untap localtonet/tapвидаляє tap. Після встановлення вручну видаліть файлlocaltonet.
Усунення несправностей #
Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.
Команду виконано без root. Повторіть її через sudo.
sudo: localtonet: command not found
sudo не знаходить клієнт у власному шляху пошуку. Натомість вкажіть повний шлях. command -v localtonet виводить його, наприклад:
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>Після встановлення вручну без кроку з PATH шлях такий: ~/localtonet/localtonet.
Install failed: Plist already exists for 'Localtonet_…'
Служба для цього токена вже встановлена. Перевірте її за допомогою --status-service. Щоб встановити її знову, спершу виконайте --remove-service.
Службу встановлено, але токен залишається Офлайн
Прочитайте журнал помилок завдання, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, і переконайтеся, що файл localtonet досі існує за тим шляхом, який він мав під час встановлення служби.
Wrong Token!
Клієнт очікує 33-символьний AuthToken із розділу Мої токени або 6-значний PIN, строк дії якого не минув. Скопіюйте токен знову й введіть його у відповідь на запит.
This token is used in another localtonet application!
Інший клієнт Localtonet на цьому Mac уже працює з тим самим токеном. Закрийте його або запустіть цей з іншим токеном. Використовуйте один запущений клієнт на токен.