macOSにLocaltonetをインストールする
このページの内容 9セクション
macOSでは、LocaltonetクライアントはIntel MacとApple Silicon Mac向けのコンソールプログラムです。HomebrewまたはZIPアーカイブからインストールし、AuthTokenを指定して起動します。起動のたびに自動で動かしたい場合は、launchdサービスとしてインストールします。
始める前に #
- Localtonetアカウント。お持ちでない場合は無料で作成してください。
- AuthToken。ダッシュボードのAuthTokenカードでコピーを選択するか、マイトークンからトークンをコピーします。
- Homebrewでインストールする場合:Homebrew。
- launchdサービスを使う場合:
sudoを使用できるアカウント。
Homebrewでインストールする #
-
Localtonet tapを追加してインストールする #
tapを追加すると、Homebrewにサードパーティのリポジトリが追加され、そこからformulaをインストール・更新できるようになります。
ターミナルbrew tap localtonet/tap brew install localtonet -
インストールを確認する #
ターミナルlocaltonet --versionこのコマンドは、クライアントのバージョンを表示します。
手動でインストールする #
直接ダウンロードする場合は、お使いのMac用のアーカイブを入手してください。ZIPには、localtonetという1つのファイルが含まれています。
| 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の下に、実行中のトンネルごとに1行ずつ表が表示されます。列は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。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でパスを確認できます。例:
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つです。