WindowsにLocaltonetをインストールする
このページの内容 9セクション
Windowsでは、Microsoft StoreのLocaltonetアプリ、同じアプリのポータブル版、またはコンソールクライアントを使えます。コンソールクライアントは、起動のたびに開始されるWindowsサービスとして自分自身をインストールすることもできます。
始める前に #
- Localtonetアカウント。お持ちでない場合は、無料で作成してください。
- AuthToken。ダッシュボードのAuthTokenカードでコピーを選択するか、マイトークンからトークンをコピーします。
- Windowsサービスとして使う場合:管理者として実行しているコマンド プロンプトまたはPowerShellのウィンドウ。
ビルドを選ぶ #
| ビルド | ダウンロード | 備考 |
|---|---|---|
| Microsoft Storeアプリ | Microsoft StoreのLocaltonet | ログイン画面のあるアプリウィンドウ。Windows 10 バージョン1809(ビルド17763)以降が必要です。 |
| デスクトップアプリ(ポータブルZIP) | x64、x86、ARM64 | Storeを使わない同じアプリです。ZIPを展開し、展開したフォルダーからアプリを起動します。 |
| コンソールクライアント | 64ビット、32ビット、ARM64 | localtonet.exe1つだけを含むZIP。サービス用コマンドが使えるのはこのビルドです。 |
ダウンロードページのバイナリには、Microsoft Storeアプリと3種類のコンソールビルドがあります。
アプリを使う #
-
アプリをインストールして開く #
Microsoft StoreからLocaltonetをインストールするか、ポータブルZIPを展開してアプリを起動します。アプリはSign in to Localtonet画面で開きます。
-
トークンでログインする #
Authtoken or PIN欄にAuthTokenを貼り付け、Connectを選択します。画面を開いたときにトークンがクリップボードにあれば、アプリが自動で入力します。トークンの代わりに、マイトークンにトークンごとに表示される6桁のPINを入力することもできます。PINの有効期間は1分です。
アプリが
Pin or authtoken is not valid.と表示した場合は、トークンをもう一度コピーし、33文字すべてが含まれているか確認してください。 -
トンネルを開始する #
ログインすると、アプリにはこのデバイスで動作しているトンネルが一覧表示されます。一覧にNo active tunnelsと表示されている間は、ダッシュボードでトンネルを作成して開始してください。クイックスタートを参照してください。Sign Outはアプリからトークンを削除し、Quit Localtonetはアプリを終了します。
コンソールクライアントを使う #
-
ダウンロードして展開する #
お使いのCPU用のZIPをダウンロードし、場所が変わらないフォルダー(例:
C:\Localtonet)に展開します。後でインストールするサービスは、このフォルダーのlocaltonet.exeを起動します。 -
トークンを指定して起動する #
そのフォルダーでコマンド プロンプトまたはPowerShellを開き、次を実行します。
コマンド プロンプトlocaltonet --authtoken <YOUR_TOKEN>PowerShellは、パスを書かないとカレントフォルダーのプログラムを実行しないため、PowerShellでのコマンドは次のとおりです。
PowerShell.\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を押すと、保存されたトークンを削除して終了します。
Windowsサービスとして実行する #
サービスにすると、起動のたびにLocaltonetが開始され、ログアウト後も動作し続け、ターミナルを開いておく必要がありません。コンソールクライアントを使い、管理者として実行しているコマンド プロンプトまたはPowerShellで、次のコマンドを実行します。
-
サービスをインストールする #
コマンド プロンプト (管理者)localtonet --install-service --authtoken <YOUR_TOKEN>このコマンドは、このトークン用のWindowsサービスを登録し、スタートアップの種類を自動に設定して、すぐに開始します。サービス名が返されます。
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>はトークンの先頭9文字です。サービスはトークンごとに作成されるため、ほかのサービスコマンドでも、同じ--authtokenを指定して見つける必要があります。 -
動作を確認する #
コマンド プロンプト (管理者)localtonet --status-service --authtoken <YOUR_TOKEN>サービスが動作していると、
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Runningと返されます。サービスはservices.mscにも同じ名前で表示され、説明はLocaltonet Serviceです。ダッシュボードのマイトークンでは、トークンがオンラインと表示されます。
サービスコマンド #
各コマンドに--authtoken <YOUR_TOKEN>を追加します。
| コマンド | 動作 | 管理者権限 |
|---|---|---|
--install-service | スタートアップを自動に設定してサービスを作成し、開始します。障害が起きると、Windowsは1分後にサービスを再起動します。 | 必要 |
--start-service | インストール済みのサービスを開始します。たとえば、停止した後に使います。 | 必要 |
--stop-service | サービスを停止します。次回の起動時には再び開始されます。 | 必要 |
--status-service | 状態を表示します。Running、Stopped、サービスの開始中はInstalling、Paused、このトークン用のサービスが存在しない場合はNotFound、Error、Unknownです。 | 不要 |
--remove-service | サービスを停止して削除します。 | 必要 |
サービスは、--install-serviceと一緒に渡したオプションでインストールされます。--netや--ipなどのクライアントオプションは、そのコマンドに追加してください。オプションはCLIリファレンスに一覧があります。
サービスは、インストール時にあったフォルダーのlocaltonet.exeを、トークンを含む起動コマンドで実行します。サービスがインストールされている間は、このファイルを移動したり削除したりしないでください。
アップデート #
- Microsoft Storeアプリ:アプリはMicrosoft Storeが更新します。
- コンソールクライアントとポータブルアプリ:ダウンロードページから最新のZIPをダウンロードし、古いファイルを置き換えます。Windowsでは、
localtonet.exeは実行中に置き換えられないため、先にクライアントを閉じてください。サービスとして動作している場合は、--stop-serviceを実行し、ファイルを置き換えてから--start-serviceを実行します。
localtonet --versionでインストール済みのバージョンが表示されます。マイトークンのクライアント列には、デバイスが最後に報告したバージョンが表示され、新しいバージョンがある場合は要アップデートバッジが付きます。
アンインストール #
- サービスをインストールした場合は、管理者として
localtonet --remove-service --authtoken <YOUR_TOKEN>を実行して削除します。 - 保存されたトークンを削除するには、コンソールクライアントを起動してF12を押します。
localtonet.exeがあるフォルダーを削除するか、Windowsの設定からStoreアプリをアンインストールします。
トラブルシューティング #
'localtonet' は、内部コマンドまたは外部コマンド…として認識されていません
ターミナルがlocaltonet.exeのあるフォルダーにないか、PowerShellを使っています。先にそのフォルダーに移動してください。PowerShellでは、クライアントを.\localtonetとして起動します。
Install failed: 'Windows service installation' requires elevated (admin/root) privileges.
ターミナルが管理者として実行されていません。コマンド プロンプトまたはPowerShellを管理者として実行で開き、コマンドをやり直してください。--start-service、--stop-service、--remove-serviceでも同じ種類のメッセージが表示されます。
Install failed: Service 'Localtonet_…' already exists.
このトークン用のサービスはすでにインストールされています。--status-serviceで確認してください。別のオプションや別のフォルダーなどで再インストールする場合は、先に--remove-serviceを実行します。
Start failed: Service could not be started
このメッセージには、Windowsのscツールの応答が含まれます。エラー1056は、サービスがすでに動作していることを意味します。--install-serviceの直後に--start-serviceを実行した場合は、インストールコマンドがすでにサービスを開始しているため、これは想定どおりです。エラー1060は、このトークン用のサービスが存在しないことを意味します。
サービスをインストールしたのにStatusがNotFoundになる
サービス名はトークンから作られます。サービスをインストールしたときと異なるトークンを渡すと、クライアントは別のサービスを探します。同じトークンを使うか、services.mscでLocaltonet_で始まるサービスを探してください。
Service installation cannot persist proxy passwords.
--install-serviceを--proxy-userや、パスワードを含むプロキシURLと組み合わせています。サービスはプロキシのパスワードを含めてインストールすることはできません。--proxy envを使い、認証情報をサービスの環境で指定してください。CLIリファレンスを参照してください。
Wrong Token!
クライアントは、マイトークンの33文字のAuthTokenか、有効期限が切れていない6桁のPINを想定しています。トークンをもう一度コピーし、プロンプトに入力してください。
This token is used in another localtonet application!
このパソコンの別のLocaltonetウィンドウが、すでに同じトークンで動作しています。そのウィンドウを閉じるか、こちらを別のトークンで起動してください。トークン1つにつき、クライアントは1つだけ実行してください。
ダッシュボードでトークンがオフラインのままになる
オフラインとは、デバイスが切断されている状態です。クライアントのウィンドウが開いたままであるか、サービスの状態がRunningであること、そして確認しているトークンでクライアントを起動したことを確認してください。