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

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

このページのヘルプ
このページの内容 8セクション
  1. 始める前に
  2. インストール
  3. インストールスクリプトを実行する
  4. インストールを確認する
  5. 代わりにダウンロードしたパッケージをインストールする
  6. クライアントを起動する
  7. トークンを指定して起動する
  8. 出力を読む
  9. トンネルを開始する
  10. 制限
  11. アップグレード
  12. 削除
  13. トラブルシューティング
  14. 関連ページ

TermuxはAndroid向けのターミナルアプリです。Termuxパッケージは、Linuxと同じlocaltonetコマンドであるLocaltonetコンソールクライアントを、ARM64のAndroidデバイス上でLocaltonetアプリなしで動かします。

始める前に #

  • ARM64 CPUを搭載し、TermuxがインストールされたAndroidデバイス。パッケージはARM64専用です。
  • Termuxでのインターネット接続。パッケージにはTermuxの.NET 10ランタイム(dotnet-runtime-10.0)が必要で、TermuxのパッケージマネージャーがLocaltonetと一緒に自動的にインストールします。ASP.NET Coreは不要です。
  • AuthToken。ダッシュボードのAuthTokenカードでコピーを選択するか、マイトークンからトークンをコピーします。トークンはデバイスごとに別のものを使ってください。

TermuxとAndroidアプリのどちらを使う?Androidアプリは、QRコードまたはPINでログインし、バックグラウンドでも自動的に動作し続けます。スマートフォンでコマンドラインクライアントを使いたい場合は、Termuxを選んでください。

インストール #

  1. インストールスクリプトを実行する #

    Linux用のインストールスクリプトはTermuxを認識します。Termux用のパッケージをダウンロードし、pkgでインストールします。ランタイムも一緒にインストールされます。

    Termux
    curl -fsSL https://localtonet.com/install.sh | sh

    curlがまだインストールされていない場合は、先にpkg install curlでインストールしてください。

  2. インストールを確認する #

    スクリプトの最後に、インストールされたバージョンが表示されます。いつでももう一度表示できます。

    Termux
    localtonet --version

代わりにダウンロードしたパッケージをインストールする #

パッケージはこのページの末尾に一覧があります。DEBファイルと、同じDEBを含むZIPアーカイブです。そのどちらかをTermuxでダウンロードし、ZIPを選んだ場合は展開して、DEBをTermuxのパッケージマネージャーでインストールします。<PACKAGE_FILE>はDEBファイルの名前に置き換えてください。

Termux
pkg install ./<PACKAGE_FILE>.deb

不足している依存関係も一緒にダウンロードされるよう、これにはpkgを使ってください。下の一覧にあるZIPパッケージをインストールには、実際のファイル名を使ったコマンドが表示されます。

クライアントを起動する #

  1. トークンを指定して起動する #

    Termux
    localtonet --authtoken <YOUR_TOKEN>

    クライアントはトークンをローカルに保存します。次回からはlocaltonetだけで起動できます。保存されたトークンがない状態で起動すると、Please Enter AuthToken or PINと尋ねられます。このプロンプトでは、マイトークンにトークンごとに表示される6桁のPINを入力することもできます。PINの有効期間は1分です。

  2. 出力を読む #

    Termuxでは、クライアントはデスクトップ版のようなライブ表示の表を描画しません。変更があるたびに1行のプレーンテキストを書き出します。

    行意味
    Connection: Connectedセッションの状態です。ほかの値はConnectingとDisconnectedです。
    AuthTokenName: …クライアントがログインしたトークンの名前。
    OPEN …, ADDED …このデバイスで動作しているトンネルの、公開アドレス、プロトコル、ローカルの接続先。
    STATUS …トンネルの状態が変わりました。
    CLOSED …トンネルが停止または削除されました。
    Authentication failed: AuthToken was rejected.トークンが受け付けられませんでした。マイトークンからもう一度コピーしてください。
  3. トンネルを開始する #

    マイトークンで、トークンがオンラインと表示されます。そのトークン用のトンネルをダッシュボードで作成して開始してください。クイックスタートを参照してください。127.0.0.1へのトンネルは、スマートフォン自体で動作するサービス(たとえばTermux内のサービス)に到達します。

Ctrl + Cを押すとクライアントが停止します。別のトークンでログインするには、新しい--authtokenを指定してクライアントをもう一度起動します。

制限 #

項目Termuxでは
CPUARM64のみ。
サービスモードサポートされていません。--install-serviceにはsystemdとroot権限が必要ですが、Termuxはサポート対象外です。クライアントは、Termuxのセッションが開いている間だけ動作します。ターミナルを開いたままにせずにスマートフォンを接続し続けるには、代わりにAndroidアプリを使ってください。
バックグラウンド画面がオフの間、AndroidがTermuxを停止することがあります。Termuxにはこのための専用のウェイクロックtermux-wake-lockがあります。
ログインコマンドラインでトークンまたはPINを使います。QRコードはAndroidアプリ用です。

アップグレード #

インストールスクリプトをもう一度実行するか、最新のDEBをダウンロードして、以前と同じようにpkg installでインストールします。同じバージョンをもう一度インストールするには、pkg reinstall ./<PACKAGE_FILE>.debを使います。

マイトークンのクライアント列には、デバイスが最後に報告したバージョンが表示され、新しいバージョンがある場合は要アップデートバッジが付きます。

削除 #

パッケージの名前はtermux-localtonetです。

Termux
pkg uninstall termux-localtonet

トラブルシューティング #

Termux .NET runtime bulunamadı. Çalıştırın: pkg install dotnet-runtime-10.0

これはランチャーのメッセージで、トルコ語で表示されます。意味は、Termuxの.NETランタイムが見つからないということです。pkg install dotnet-runtime-10.0でインストールし、localtonetをもう一度起動してください。依存関係をダウンロードしないdpkg -iでDEBをインストールした場合に表示されることがあります。

localtonet.dll bulunamadı. Localtonet paketini yeniden kurun.

ランチャーがクライアントのファイルを見つけられませんでした。Localtonetパッケージをもう一度インストールしてください。

パッケージマネージャーでパッケージをインストールできない

このパッケージはARM64用で、Termuxリポジトリのバージョン10.0.15以降のdotnet-runtime-10.0が必要です。pkg upgradeでTermuxを最新にしてから、パッケージをもう一度インストールしてください。ARM64ではないデバイスでは、Androidアプリを使ってください。

Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.

サービスモードはTermuxではサポートされていません。Termuxのセッションでクライアントを起動するか、Androidアプリを使ってください。

Wrong Token!

クライアントは、マイトークンの33文字のAuthTokenか、有効期限が切れていない6桁のPINを想定しています。トークンをもう一度コピーし、プロンプトに入力してください。

Termuxのパッケージは以下に一覧があります。

Android向けTermux

ARM64のAndroidデバイスで、Termux上でコンソールクライアントを実行します。必要な.NETランタイムはパッケージマネージャーが自動でインストールします。ASP.NET Coreは不要です。

ZIPパッケージをインストール
curl -fLO https://localtonet.com/download/localtonet-termux.zip
unzip -o localtonet-termux.zip
pkg install ./localtonet.deb
localtonet --authtoken <YOUR_TOKEN>

直接ダウンロードしたDEBはpkg install ./localtonet-termux.debでインストールできます。不足している依存関係のインストールにはインターネット接続が必要です。

サポート