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

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

このページのヘルプ
このページの内容 9セクション
  1. 始める前に
  2. スクリプトでインストールする
  3. インストールスクリプトを実行する
  4. インストールを確認する
  5. 手動でインストールする
  6. ダウンロードして展開する
  7. 任意:PATHの通った場所に移動する
  8. クライアントを起動する
  9. トークンを指定して起動する
  10. セッションを確認する
  11. systemdサービスとして実行する
  12. サービスをインストールする
  13. 動作を確認する
  14. サービスコマンド
  15. ユニットとそのログ
  16. アップグレード
  17. クライアントを置き換える
  18. サービスを再起動する
  19. アンインストール
  20. トラブルシューティング
  21. 関連ページ

Linuxでは、Localtonetクライアントは単一のコンソールプログラムです。インストールスクリプトまたはZIPアーカイブでインストールし、AuthTokenを指定して起動します。再起動のたびに開始したい場合は、systemdサービスとしてインストールします。

始める前に #

  • Localtonetアカウント。お持ちでない場合は、無料で作成してください。
  • AuthToken。ダッシュボードのAuthTokenカードでコピーを選択するか、マイトークンからトークンをコピーします。
  • curlまたはwget、およびunzip。
  • systemdサービスとして使う場合:root権限と、systemdを使うディストリビューション。

LinuxでLocaltonetを動かすその他の方法。Debian、Ubuntu、Fedora、RHELでは、独自のサービスを同梱したDEBまたはRPMパッケージをインストールできます。Docker、OpenWrtルーター、Android上のTermuxには、それぞれ別のガイドがあります。

スクリプトでインストールする #

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

    ターミナル
    curl -fsSL https://localtonet.com/install.sh | sh

    スクリプトはCPU(x64、ARM64、ARM)とシステムがglibcかmuslかを検出し、対応するビルドをダウンロードして/usr/local/bin/localtonetにインストールします。sudoが/usr/local/binを検索しないディストリビューションでもsudo localtonetが使えるように、リンク/usr/bin/localtonetも作成します。

    ユーザーがインストール先のフォルダーに書き込めない場合、スクリプトはsudoを使うため、パスワードを求められることがあります。unzipがない場合は、ディストリビューションのパッケージマネージャーでインストールを試みます。

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

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

    ターミナル
    localtonet --version

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

直接ダウンロードしたい場合は、お使いのシステム用のアーカイブを選びます。各ZIPにはlocaltonetファイルが1つ入っています。

CPUglibc(Debian、Ubuntu、Fedora、RHELなど、ほとんどのディストリビューション)musl(Alpine)
x64localtonet-linux-x64.ziplocaltonet-linux-musl-x64.zip
ARM64localtonet-linux-arm64.ziplocaltonet-linux-musl-arm64.zip
ARM(32ビット)localtonet-linux-arm.ziplocaltonet-linux-musl-arm.zip

uname -mでCPUの種類が表示されます。x86_64はx64、aarch64はARM64、armv7lはARMです。

  1. ダウンロードして展開する #

    この例ではx64のglibc版を使っています。ファイル名は、お使いのシステム用のアーカイブに置き換えてください。

    ターミナル
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.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を押すと、保存されたトークンを削除して終了します。

出力先がターミナルでない場合(たとえばファイルにリダイレクトした場合)、クライアントは表の代わりに、変更があるたびに1行のプレーンテキストを書き出します。

VPNにはroot権限が必要です。デバイスがVPNマネージャーのネットワークに含まれていて、クライアントがroot権限なしで動作している場合、表のVPN行にAdmin rights required.と表示されます。その場合は、クライアントをsudo付きで、またはサービスとして起動してください。

systemdサービスとして実行する #

サービスにすると、再起動のたびにLocaltonetが開始され、ログアウト後も動作し続け、ターミナルを開いておく必要がありません。サービス用コマンドにはroot権限が必要です。

  1. サービスをインストールする #

    ターミナル
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    このコマンドは、このトークン用のsystemdユニットを書き出し、有効にして、すぐに開始します。ユニット名が返されます。

    [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と返されます。ダッシュボードのマイトークンでは、トークンがオンラインと表示されます。

サービスコマンド #

各コマンドをsudo付きで実行し、--authtoken <YOUR_TOKEN>を追加します。

コマンド動作
--install-serviceユニットファイルを書き出し、ユニットを有効にして開始します。
--start-serviceユニットを開始します。たとえば、停止した後に使います。
--stop-serviceユニットを停止します。有効のままなので、再起動後には再び開始されます。
--status-service状態を表示します。たとえばRunning、Stopped、ユニットが失敗した場合はErrorです。
--remove-serviceユニットを停止して無効にし、ユニットファイルを削除します。

サービスは、--install-serviceと一緒に渡したオプションでインストールされます。オプションはCLIリファレンスに一覧があります。

ユニットとそのログ #

ユニットファイルは/etc/systemd/system/Localtonet_<TOKEN_PREFIX>.serviceです。systemdは、障害の5秒後にクライアントを再起動します。通常のsystemdユニットなので、systemctlで管理したり、journalctlで出力を読んだりすることもできます。

ターミナル
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

ユニットは、サービスをインストールしたときのパスにあるlocaltonetファイルを起動します。ただし例外があります。そのパスが/root/の下にある場合、インストールコマンドはファイルを/usr/local/lib/Localtonet_<TOKEN_PREFIX>/にコピーし、サービスはそのコピーを実行します。

アップグレード #

  1. クライアントを置き換える #

    インストールスクリプトをもう一度実行します。何度実行しても安全で、インストール済みのクライアントを最新バージョンで上書きします。手動でインストールした場合は、最新のアーカイブをダウンロードしてlocaltonetファイルを置き換えます。

    ターミナル
    curl -fsSL https://localtonet.com/install.sh | sh
  2. サービスを再起動する #

    動作中のサービスは、再起動するまで古いバージョンを使い続けます。

    ターミナル
    sudo systemctl restart Localtonet_<TOKEN_PREFIX>

    サービスが/usr/local/lib/の下のコピーを実行している場合は、代わりにサービスを削除し、新しいクライアントで再インストールします。

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

アンインストール #

  1. サービスをインストールした場合は、削除します。sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. 保存されたトークンを削除するには、クライアントを起動してF12を押します。
  3. クライアントを削除します。スクリプトでインストールした場合はsudo rm /usr/local/bin/localtonet /usr/bin/localtonet、手動の場合はアーカイブを展開したフォルダーを削除します。

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

インストールスクリプト:Unsupported architecture

スクリプトには、x64(x86_64)、ARM64(aarch64)、32ビットARM(armv7l)用のビルドがあります。それ以外のCPUの種類は、Linux版ではサポートされていません。

インストールスクリプト:Neither curl nor wget found

パッケージマネージャーでcurlまたはwgetをインストールし、スクリプトをもう一度実行してください。

インストールスクリプト:Failed to install 'unzip'

スクリプトがunzipを自動でインストールできませんでした。パッケージマネージャーでインストールし、スクリプトをもう一度実行してください。

Installed but not found in PATH

新しいシェルを開くか、フルパス/usr/local/bin/localtonetでクライアントを起動してください。

sudo: localtonet: command not found

手動でインストールした場合、クライアントはsudoの検索パスに含まれていません。たとえばsudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>のようにフルパスを使うか、先にファイルを/usr/local/binに移動してください。

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

コマンドがroot権限なしで実行されました。sudoを付けてやり直してください。--start-service、--stop-service、--remove-serviceも同様です。

Install failed: Systemd unit already exists for 'Localtonet_…'

このトークン用のサービスはすでにインストールされています。--status-serviceで確認してください。再インストールする場合は、先に--remove-serviceを実行します。

systemdのないシステムでサービスコマンドが失敗する

サービスモードはsystemdを使います。systemdのないシステムでは、たとえばDockerコンテナーなど、別の方法でクライアントを起動してください。コンソールクライアントにはそのためのヘッドレスモードがあります。--headlessはプロンプトなしで動作し、--authtoken-fileで指定したファイルからトークンを読み込みます。CLIリファレンスを参照してください。

Wrong Token!

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

This token is used in another localtonet application!

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

サポート