コンテンツへスキップ
Localtonet Localtonet ダッシュボード

macOSにLocaltonetをインストールする

このページのヘルプ
このページの内容 9セクション
  1. 始める前に
  2. Homebrewでインストールする
  3. Localtonet tapを追加してインストールする
  4. インストールを確認する
  5. 手動でインストールする
  6. ダウンロードして展開する
  7. 任意:PATHに移動する
  8. クライアントを起動する
  9. トークンを指定して起動する
  10. セッションを確認する
  11. launchdサービスとして実行する
  12. サービスをインストールする
  13. 動作を確認する
  14. インストールで作成されるもの
  15. サービスコマンド
  16. アップグレード
  17. アンインストール
  18. トラブルシューティング
  19. 関連ページ

macOSでは、LocaltonetクライアントはIntel MacとApple Silicon Mac向けのコンソールプログラムです。HomebrewまたはZIPアーカイブからインストールし、AuthTokenを指定して起動します。起動のたびに自動で動かしたい場合は、launchdサービスとしてインストールします。

始める前に #

  • Localtonetアカウント。お持ちでない場合は無料で作成してください。
  • AuthToken。ダッシュボードのAuthTokenカードでコピーを選択するか、マイトークンからトークンをコピーします。
  • Homebrewでインストールする場合:Homebrew。
  • launchdサービスを使う場合:sudoを使用できるアカウント。

Homebrewでインストールする #

  1. Localtonet tapを追加してインストールする #

    tapを追加すると、Homebrewにサードパーティのリポジトリが追加され、そこからformulaをインストール・更新できるようになります。

    ターミナル
    brew tap localtonet/tap
    brew install localtonet
  2. インストールを確認する #

    ターミナル
    localtonet --version

    このコマンドは、クライアントのバージョンを表示します。

手動でインストールする #

直接ダウンロードする場合は、お使いのMac用のアーカイブを入手してください。ZIPには、localtonetという1つのファイルが含まれています。

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の下に、実行中のトンネルごとに1行ずつ表が表示されます。列は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。tapも削除するにはbrew untap localtonet/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!

このMac上の別のLocaltonetクライアントが、すでに同じトークンで動作しています。そちらを閉じるか、こちらを別のトークンで起動してください。トークン1つにつき、動作させるクライアントは1つです。

サポート