LinuxにLocaltonetをインストールする
このページの内容 9セクション
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には、それぞれ別のガイドがあります。
スクリプトでインストールする #
-
インストールスクリプトを実行する #
ターミナル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がない場合は、ディストリビューションのパッケージマネージャーでインストールを試みます。 -
インストールを確認する #
スクリプトの最後に、インストールされたバージョンが表示されます。いつでももう一度表示できます。
ターミナルlocaltonet --version
手動でインストールする #
直接ダウンロードしたい場合は、お使いのシステム用のアーカイブを選びます。各ZIPにはlocaltonetファイルが1つ入っています。
| CPU | glibc(Debian、Ubuntu、Fedora、RHELなど、ほとんどのディストリビューション) | musl(Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM(32ビット) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -mでCPUの種類が表示されます。x86_64はx64、aarch64はARM64、armv7lはARMです。
-
ダウンロードして展開する #
この例ではx64のglibc版を使っています。ファイル名は、お使いのシステム用のアーカイブに置き換えてください。
ターミナルwget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.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を押すと、保存されたトークンを削除して終了します。
出力先がターミナルでない場合(たとえばファイルにリダイレクトした場合)、クライアントは表の代わりに、変更があるたびに1行のプレーンテキストを書き出します。
VPNにはroot権限が必要です。デバイスがVPNマネージャーのネットワークに含まれていて、クライアントがroot権限なしで動作している場合、表のVPN行にAdmin rights required.と表示されます。その場合は、クライアントをsudo付きで、またはサービスとして起動してください。
systemdサービスとして実行する #
サービスにすると、再起動のたびにLocaltonetが開始され、ログアウト後も動作し続け、ターミナルを開いておく必要がありません。サービス用コマンドにはroot権限が必要です。
-
サービスをインストールする #
ターミナルsudo localtonet --install-service --authtoken <YOUR_TOKEN>このコマンドは、このトークン用のsystemdユニットを書き出し、有効にして、すぐに開始します。ユニット名が返されます。
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>はトークンの先頭9文字です。ユニットはトークンごとに作成されるため、ほかのサービスコマンドでも、同じ--authtokenを指定して見つける必要があります。 -
動作を確認する #
ターミナル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>/にコピーし、サービスはそのコピーを実行します。
アップグレード #
-
クライアントを置き換える #
インストールスクリプトをもう一度実行します。何度実行しても安全で、インストール済みのクライアントを最新バージョンで上書きします。手動でインストールした場合は、最新のアーカイブをダウンロードして
localtonetファイルを置き換えます。ターミナルcurl -fsSL https://localtonet.com/install.sh | sh -
サービスを再起動する #
動作中のサービスは、再起動するまで古いバージョンを使い続けます。
ターミナルsudo systemctl restart Localtonet_<TOKEN_PREFIX>サービスが
/usr/local/lib/の下のコピーを実行している場合は、代わりにサービスを削除し、新しいクライアントで再インストールします。
マイトークンのクライアント列には、デバイスが最後に報告したバージョンが表示され、新しいバージョンがある場合は要アップデートバッジが付きます。
アンインストール #
- サービスをインストールした場合は、削除します。
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - 保存されたトークンを削除するには、クライアントを起動してF12を押します。
- クライアントを削除します。スクリプトでインストールした場合は
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つだけ実行してください。