DEBまたはRPMパッケージからLocaltonetをインストールする
このページの内容 9セクション
DEBおよびRPMパッケージは、Localtonetクライアントと、2つのsystemdサービス(トンネル用と、トンネルとVPN用)を一緒にインストールします。サービスはAuthTokenをファイルから読み込み、ターミナルなしで動作するため、クライアントは起動のたびに自動的に始まります。
始める前に #
- 64ビットのLinuxシステム。パッケージはx64とARM64向けに提供されています。
- systemd 247以降とOpenSSL 3(Debian 12、Ubuntu 22.04以降、RHEL 9など)。
- root権限(
sudo)。 - AuthToken。ダッシュボードのAuthTokenカードでコピーを選択するか、マイトークンからトークンをコピーします。
他のディストリビューション、32ビットARM、またはシステムパッケージを使いたくない場合は、Linuxで説明しているインストールスクリプトかアーカイブを使ってください。
パッケージがインストールするもの #
| パス | 内容 |
|---|---|
/usr/bin/localtonet | localtonet コマンド。 |
/usr/lib/localtonet/ | クライアント本体。 |
/usr/lib/systemd/system/localtonet.service | トンネルサービス。 |
/usr/lib/systemd/system/localtonet-vpn.service | VPNとトンネルのサービス。 |
/etc/localtonet/auth-token | トークンファイル。rootだけが読み取れます。プレースホルダー DUMMY_AUTH_TOKEN が入った状態でインストールされます。 |
パッケージ名は localtonet です。OpenSSL 3、iproute2(RPMでは iproute)、iptables、kmod などの依存パッケージは、パッケージマネージャーがインストールします。パッケージをインストールしても、サービスは有効化も開始もされません。先にトークンを設定してから、必要なサービスを有効にします。
手順 #
-
パッケージをダウンロードしてインストールする #
このページの末尾にある一覧から、お使いのディストリビューションとCPUに合ったパッケージを選び、ダウンロードしたファイルを
apt(DEB)またはdnf(RPM)でインストールします。各パッケージの下にあるセットアップ手順に、そのファイル用の正確なコマンドが表示されます。 -
AuthTokenを設定する #
rootでテキストエディターを使って
/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENをご自身のトークン(1行)に置き換えます。その後、rootだけがこのファイルを読み取れるようにします。ターミナルsudo chmod 600 /etc/localtonet/auth-token -
設定を確認する #
ターミナルsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configこの確認では、接続せずにトークンファイルを読み取ります。ファイルにスペースのない33文字のトークンが入っていると、
Localtonet headless configuration OK.と応答します。そのトークンがお使いのアカウントで有効かどうかをLocaltonetのサーバーに問い合わせることはありません。 -
サービスを有効にする #
トンネル用には、トンネルサービスを有効にしてログを確認します。
ターミナルsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceこのデバイスがVPNネットワークにも参加する場合は、代わりにVPNサービスを有効にします。トンネルサービスとVPNサービスを参照してください。
-
トンネルを開始する #
マイトークンで、トークンがオンラインと表示されます。ダッシュボードでそのトークン用のトンネルを作成して開始します。クイックスタートを参照してください。
トンネルサービスとVPNサービス #
どちらのサービスも同じクライアントを実行し、どちらもトンネルを提供します。違いは、動作する権限です。どちらか一方だけを有効にしてください。2つのサービスは競合し、一方を開始するともう一方が停止します。
localtonet.service | localtonet-vpn.service | |
|---|---|---|
| 用途 | トンネル | VPNとトンネル |
| 実行ユーザー | systemdがサービス用に作成する、権限のないユーザー | root。ただしネットワーク権限 CAP_NET_ADMIN と CAP_NET_RAW に限定 |
| TUNモジュール | 使用しません | クライアントの起動前に modprobe tun で読み込まれます |
| 作業ディレクトリ | /var/lib/localtonet | /var/lib/localtonet-vpn |
デバイスをトンネルサービスからVPNサービスに切り替えるには:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service元に戻すには、同じ方法で localtonet-vpn.service を無効にし、localtonet.service を有効にします。VPNネットワーク自体はダッシュボードで設定します。VPNマネージャーを参照してください。
サービスの動作 #
| 動作 | 詳細 |
|---|---|
| ヘッドレスモード | どちらのサービスも localtonet --headless を起動します。このモードでは、クライアントは何も尋ねず、トークンを自身の設定に保存しません。 |
| トークン | systemdが /etc/localtonet/auth-token をサービスに渡します。ファイルがない間は、サービスは起動しません。 |
| 起動時に開始 | 有効にしたサービスは、ネットワークが利用可能になった後で開始します。 |
| 再起動 | systemdは、障害の10秒後にクライアントを再起動します。トークンファイルが無効でクライアントが停止した場合は再起動しません。ファイルを修正して、ご自身でサービスを再起動してください。 |
ログを読む #
ヘッドレスモードでは、クライアントは変更のたびに1行ずつ、プレーンなテキストをジャーナルに書き込みます。
sudo journalctl -u localtonet.service -f| 行 | 意味 |
|---|---|
Connection: Connected | セッションの状態。ほかの値は Connecting と Disconnected です。 |
AuthTokenName: … | クライアントがログインに使ったトークンの名前。 |
OPEN …, ADDED … | このデバイスで動作しているトンネル。パブリックアドレス、プロトコル、ローカルの接続先が含まれます。 |
STATUS … | トンネルのステータスが変わりました。 |
CLOSED … | トンネルが停止または削除されました。 |
Authentication failed: AuthToken was rejected. | ファイルのトークンが受け付けられません。マイトークンからもう一度コピーしてください。 |
これらの行にトークンが含まれる場合、クライアントはその部分を [redacted] に置き換えて書き込みます。
アップグレード #
新しいパッケージをダウンロードし、最初のときと同じ方法でインストールしてから、使っているサービスを再起動します。トークンファイルは保持されます。
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceマイトークンのクライアント列には、デバイスが最後に報告したバージョンが表示され、新しいバージョンがある場合は要アップデートのバッジが表示されます。
削除 #
sudo apt remove localtonetsudo dnf remove localtonetパッケージを削除すると、両方のサービスが停止して無効になります。トークンファイルは設定ファイルであり、パッケージマネージャーはそうしたファイルを慎重に扱います。削除後に、/etc/localtonet/auth-token またはそのコピーが残っていないか確認し、マシンにトークンを残したくない場合は削除してください。
トラブルシューティング #
Invalid Localtonet headless configuration. Check the token file or environment settings.
トークンファイルが使用できません。/etc/localtonet/auth-token が存在すること、プレースホルダー DUMMY_AUTH_TOKEN が残っていないこと、そしてファイルにスペースのない33文字のトークンだけが1行で入っていることを確認してください。ファイルを読み取れるのはrootだけなので、確認は sudo で実行してください。
サービスは有効なのに動作しない
systemctl status localtonet.service を実行してください。/etc/localtonet/auth-token がない間はサービスは起動せず、トークンファイルが無効で停止した場合も再起動されません。ファイルを修正し、設定の確認を実行してから、sudo systemctl restart localtonet.service を実行してください。
ログに「Authentication failed: AuthToken was rejected.」と表示される
ファイルの形式は正しいものの、トークンが受け付けられていません。マイトークンからトークンをもう一度コピーし、トークンファイルに保存して、サービスを再起動してください。
VPNサービスを開始したら、トンネルサービスが停止した
これは仕様です。2つのサービスは競合するため、一方が開始するとsystemdがもう一方を停止します。VPNサービスもトンネルを提供します。
お使いのディストリビューションにパッケージをインストールできない
パッケージにはsystemd 247以降とOpenSSL 3が必要です。それより古いリリースでは、パッケージマネージャーがこれらの依存関係を満たせません。代わりに、Linuxページのインストールスクリプトかアーカイブを使ってください。
関連ページ #
パッケージは以下に一覧表示されています。ファイル名入りのコマンドを確認するには、パッケージの下にあるセットアップ手順を選択します。
Linuxパッケージ
x64およびARM64向けのインストール可能なDEB・RPMパッケージ。systemd 247以降とOpenSSL 3が必要です(Debian 12、Ubuntu 22.04以降、RHEL 9など)。
-
Debian / Ubuntu · x64
セットアップ手順
1. ダウンロードしたパッケージをインストールします。
localtonet-linux-x64.debがあるディレクトリでターミナルを開きます。sudo apt install ./localtonet-linux-x64.deb2. AuthTokenを設定します。rootで
/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENを1行でトークンに置き換えます。その後、ファイルを保護して設定を確認します:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. サービスを開始します。設定の確認に成功したら:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPNを使う場合は、VPNサービスに切り替えます:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceアップグレードするには、新しいパッケージをインストールして
sudo systemctl restart localtonetを実行します。設定は保持されます。VPNを使用している場合は、代わりに
localtonet-vpn.serviceを再起動してください。 -
Debian / Ubuntu · ARM64
セットアップ手順
1. ダウンロードしたパッケージをインストールします。
localtonet-linux-arm64.debがあるディレクトリでターミナルを開きます。sudo apt install ./localtonet-linux-arm64.deb2. AuthTokenを設定します。rootで
/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENを1行でトークンに置き換えます。その後、ファイルを保護して設定を確認します:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. サービスを開始します。設定の確認に成功したら:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPNを使う場合は、VPNサービスに切り替えます:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceアップグレードするには、新しいパッケージをインストールして
sudo systemctl restart localtonetを実行します。設定は保持されます。VPNを使用している場合は、代わりに
localtonet-vpn.serviceを再起動してください。 -
Fedora / RHEL · x64
セットアップ手順
1. ダウンロードしたパッケージをインストールします。
localtonet-linux-x64.rpmがあるディレクトリでターミナルを開きます。sudo dnf install ./localtonet-linux-x64.rpm2. AuthTokenを設定します。rootで
/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENを1行でトークンに置き換えます。その後、ファイルを保護して設定を確認します:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. サービスを開始します。設定の確認に成功したら:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPNを使う場合は、VPNサービスに切り替えます:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceアップグレードするには、新しいパッケージをインストールして
sudo systemctl restart localtonetを実行します。設定は保持されます。VPNを使用している場合は、代わりに
localtonet-vpn.serviceを再起動してください。 -
Fedora / RHEL · ARM64
セットアップ手順
1. ダウンロードしたパッケージをインストールします。
localtonet-linux-arm64.rpmがあるディレクトリでターミナルを開きます。sudo dnf install ./localtonet-linux-arm64.rpm2. AuthTokenを設定します。rootで
/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENを1行でトークンに置き換えます。その後、ファイルを保護して設定を確認します:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. サービスを開始します。設定の確認に成功したら:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceVPNを使う場合は、VPNサービスに切り替えます:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.serviceアップグレードするには、新しいパッケージをインストールして
sudo systemctl restart localtonetを実行します。設定は保持されます。VPNを使用している場合は、代わりに
localtonet-vpn.serviceを再起動してください。