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

Встановлення Localtonet на macOS

Допомога зі сторінкою
На цій сторінці 9 розділів
  1. Перш ніж почати
  2. Встановлення через Homebrew
  3. Додайте tap Localtonet і встановіть
  4. Перевірте встановлення
  5. Встановлення вручну
  6. Завантажте й розпакуйте
  7. Необов'язково: перемістіть його в PATH
  8. Запустіть клієнт
  9. Запустіть його зі своїм токеном
  10. Перевірте сесію
  11. Запуск як служби launchd
  12. Встановіть службу
  13. Переконайтеся, що вона працює
  14. Що створює встановлення
  15. Команди служби
  16. Оновлення
  17. Видалення
  18. Усунення несправностей
  19. Пов’язані сторінки

У macOS клієнт Localtonet — це консольна програма для Mac на Intel і Apple Silicon. Встановіть його через Homebrew або з ZIP-архіву, запустіть зі своїм AuthToken і встановіть як службу launchd, якщо він має запускатися при кожному завантаженні.

Перш ніж почати #

Встановлення через Homebrew #

  1. Додайте tap Localtonet і встановіть #

    Tap додає до Homebrew стороннє сховище, щоб ви могли встановлювати з нього формули та оновлювати їх.

    Термінал
    brew tap localtonet/tap
    brew install localtonet
  2. Перевірте встановлення #

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

    Команда виводить версію клієнта.

Встановлення вручну #

Якщо ви віддаєте перевагу прямому завантаженню, візьміть архів для вашого Mac. ZIP містить один файл, localtonet.

MacАрхів
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. Завантажте й розпакуйте #

    Apple Silicon
    curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
    unzip localtonet-osx-arm64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
    Intel
    curl -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
  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, щоб видалити збережений токен і вийти.

Запуск як служби launchd #

Служба запускає Localtonet при кожному завантаженні, підтримує його роботу після виходу з системи та не потребує відкритого терміналу. Команди служби потребують root, тому виконуйте їх через sudo.

  1. Встановіть службу #

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

    Команда реєструє системне завдання launchd для цього токена та одразу його запускає. Вона відповідає назвою завдання:

    [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. У панелі керування токен показує Онлайн у розділі Мої токени.

Що створює встановлення #

ЕлементРозташування
Визначення завдання 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. Ці команди описано в розділі Запуск як служби.

Видалення #

  1. Якщо ви встановлювали службу, видаліть її: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Щоб видалити збережений токен, запустіть клієнт і натисніть F12.
  3. Видаліть клієнт. Для 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 виводить його, наприклад:

Bash
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 уже працює з тим самим токеном. Закрийте його або запустіть цей з іншим токеном. Використовуйте один запущений клієнт на токен.

Підтримка