Localtonetクライアントをインストールする
このページの内容 5セクション
Localtonet クライアントは、サービスをホストするデバイス上で動作し、Localtonet へのトンネルを開いたままにします。このページでは、対応プラットフォームを一覧にし、適切なインストール方法の選び方を説明し、各ガイドへのリンクを示します。
対応プラットフォーム #
ダウンロードはすべてダウンロードページにあります。
| プラットフォーム | インストールできるもの | アーキテクチャ |
|---|---|---|
| Windows | Microsoft Store アプリ、ポータブルデスクトップアプリ、コンソールクライアント | 64 ビット(x64)、32 ビット(x86)、ARM64 |
| macOS | コンソールクライアント(Homebrew または ZIP アーカイブ) | Intel(x64)、Apple Silicon(ARM64) |
| Linux | コンソールクライアント(インストールスクリプトまたは ZIP アーカイブ) | x64、ARM、ARM64。それぞれ glibc 用と musl 用 |
| Linuxパッケージ | systemd サービス付きの DEB および RPM パッケージ | x64、ARM64 |
| Android | Google Play または APK ファイルの Android アプリ | アプリが必要とする最低限の Android バージョンは 5.0 です |
| Termux | Termux パッケージのコンソールクライアント | ARM64 |
| Docker | 公式イメージ localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | OpenWrt 24.10 および 25.12+ 向けのルーターパッケージ(試験的) | x64、ARM64 |
| NASとHome Assistant | Docker Compose と Home Assistant のセットアップテンプレート | AMD64, ARM64 |
| インストール不要のSSH | 不要です。すでにお持ちの SSH クライアントを使います。 | SSH クライアントがある任意のデバイス |
インストール方法を選ぶ #
| 選択肢 | 内容 | こんなときに選びます |
|---|---|---|
| コンソールクライアント | Windows、macOS、Linux 向けの localtonet プログラムです。AuthToken を指定してターミナルで起動します。トンネルをリアルタイムの表で表示し、自身をサービスとしてインストールすることもできます。 | ターミナルで作業する場合や、デスクトップのないサーバーの場合。 |
| デスクトップアプリ | サインインウィンドウのある Windows 向けの Localtonet アプリです。Microsoft Store、またはポータブル ZIP で入手できます。 | Windows でターミナルよりアプリのウィンドウを使いたい場合。 |
| モバイルアプリ | Android 向けの Localtonet アプリです。QR コード、PIN、またはトークンでサインインします。 | デバイスが Android のスマートフォンやタブレットの場合。たとえば、モバイルプロキシに使うときです。 |
| パッケージ | Linux 向けの DEB および RPM パッケージ、Android 向けの Termux パッケージ、OpenWrt 向けの試験的なパッケージです。Linux と OpenWrt のパッケージには、ファイルからトークンを読み込むサービスが付属します。 | システムのパッケージマネージャーでクライアントをインストールおよび削除したい場合や、起動時に開始するサービスが欲しい場合。 |
| コンテナー | 公式の Docker イメージと、それを使う NAS デバイスおよび Home Assistant 向けのセットアップテンプレートです。 | サービスがすでにコンテナーで動いている場合や、デバイスが NAS の場合。 |
| インストール不要のSSH | ダッシュボードがトンネルを開く ssh コマンドを生成します。ダウンロードは不要です。HTTP と TCP のトンネルで利用できます。 | デバイスに何もインストールできない、またはしたくない場合。 |
どのインストールにも共通すること #
-
クライアントは AuthToken でサインインする #
AuthToken は、1 台のデバイスをアカウントに接続します。ダッシュボードの AuthToken カードにあるコピーでコピーするか、マイトークンでデバイスごとに名前付きのトークンを作成します。トークンについては、AuthTokenで説明しています。
トークンは他人に見せないでください。トークンがあれば、誰でもそれを使ってアプリにサインインできます。
-
そのトークンでクライアントを起動する #
<YOUR_TOKEN>をご自身のトークンに置き換えてください。Windows
Localtonet アプリを開いて AuthToken を貼り付けるか、
localtonet.exeがあるフォルダーでコマンド プロンプトを開き、コンソールクライアントを実行します。コマンド プロンプトlocaltonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker pull localtonet/localtonet docker run localtonet/localtonet --authtoken <YOUR_TOKEN>Android
Localtonet アプリを開き、トークンの QR コードをスキャンするか、PIN を入力するか、トークンを貼り付けて、Connect を選びます。QR コードと PIN はマイトークンにあります。
コンソールクライアントはトークンをローカルに保存するため、次回からは
localtonetだけで起動できます。保存済みのトークンがない状態で起動すると、Please Enter AuthToken or PINと尋ねます。 -
トンネルはダッシュボードで作成して開始する #
クライアントは、トンネルを事前に知っておく必要はありません。マイトンネルでトンネルを作成してデバイスのトークンを選ぶと、そのトークンでサインインしているクライアントがそのトンネルを提供します。最初のトンネルについては、クイックスタートで順を追って説明しています。
-
クライアントは動かし続ける必要がある #
クライアントが AuthToken で実行されていて、トンネルが開始されると、トンネルが公開されます。マイトークンでは、各デバイスがオンラインまたはオフラインと表示されます。オフラインは、トンネルの設定が残っていても、デバイスが切断されていることを意味します。
ターミナルを閉じたり、ログアウトしたり、デバイスを再起動したりしても、クライアントを動かし続けるには、サービスとしてインストールします。
プラットフォーム 方法 Windows 管理者として実行しているターミナルで localtonet --install-service --authtoken <YOUR_TOKEN>macOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>DEB、RPM、OpenWrt のパッケージ パッケージにサービスが含まれています。トークンを設定した後で有効にします。 Android アプリはバックグラウンドで動き続け、スマートフォンの再起動後に再び開きます。 詳細は、サービスとして実行と各プラットフォームのページをご覧ください。
クライアントを最新に保つ #
マイトークンのクライアント列には、各デバイスが最後に報告したバージョンが表示されます。新しいバージョンがある場合は、要アップデートバッジがダウンロードページにリンクします。コンソールクライアントも、トンネルの表の下に New Version available と表示し、localtonet --version でインストール済みのバージョンを確認できます。