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

DEBまたはRPMパッケージからLocaltonetをインストールする

このページのヘルプ
このページの内容 9セクション
  1. 始める前に
  2. パッケージがインストールするもの
  3. 手順
  4. パッケージをダウンロードしてインストールする
  5. AuthTokenを設定する
  6. 設定を確認する
  7. サービスを有効にする
  8. トンネルを開始する
  9. トンネルサービスとVPNサービス
  10. サービスの動作
  11. ログを読む
  12. アップグレード
  13. 削除
  14. トラブルシューティング
  15. 関連ページ

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/localtonetlocaltonet コマンド。
/usr/lib/localtonet/クライアント本体。
/usr/lib/systemd/system/localtonet.serviceトンネルサービス。
/usr/lib/systemd/system/localtonet-vpn.serviceVPNとトンネルのサービス。
/etc/localtonet/auth-tokenトークンファイル。rootだけが読み取れます。プレースホルダー DUMMY_AUTH_TOKEN が入った状態でインストールされます。

パッケージ名は localtonet です。OpenSSL 3、iproute2(RPMでは iproute)、iptables、kmod などの依存パッケージは、パッケージマネージャーがインストールします。パッケージをインストールしても、サービスは有効化も開始もされません。先にトークンを設定してから、必要なサービスを有効にします。

手順 #

  1. パッケージをダウンロードしてインストールする #

    このページの末尾にある一覧から、お使いのディストリビューションとCPUに合ったパッケージを選び、ダウンロードしたファイルを apt(DEB)または dnf(RPM)でインストールします。各パッケージの下にあるセットアップ手順に、そのファイル用の正確なコマンドが表示されます。

  2. AuthTokenを設定する #

    rootでテキストエディターを使って /etc/localtonet/auth-token を編集し、DUMMY_AUTH_TOKEN をご自身のトークン(1行)に置き換えます。その後、rootだけがこのファイルを読み取れるようにします。

    ターミナル
    sudo chmod 600 /etc/localtonet/auth-token
  3. 設定を確認する #

    ターミナル
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    この確認では、接続せずにトークンファイルを読み取ります。ファイルにスペースのない33文字のトークンが入っていると、Localtonet headless configuration OK. と応答します。そのトークンがお使いのアカウントで有効かどうかをLocaltonetのサーバーに問い合わせることはありません。

  4. サービスを有効にする #

    トンネル用には、トンネルサービスを有効にしてログを確認します。

    ターミナル
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    このデバイスがVPNネットワークにも参加する場合は、代わりにVPNサービスを有効にします。トンネルサービスとVPNサービスを参照してください。

  5. トンネルを開始する #

    マイトークンで、トークンがオンラインと表示されます。ダッシュボードでそのトークン用のトンネルを作成して開始します。クイックスタートを参照してください。

トンネルサービスとVPNサービス #

どちらのサービスも同じクライアントを実行し、どちらもトンネルを提供します。違いは、動作する権限です。どちらか一方だけを有効にしてください。2つのサービスは競合し、一方を開始するともう一方が停止します。

localtonet.servicelocaltonet-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 localtonet
VPNサービス
sudo systemctl restart localtonet-vpn.service

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

削除 #

Debian、Ubuntu
sudo apt remove localtonet
Fedora、RHEL
sudo 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.deb

    2. 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-config

    3. サービスを開始します。設定の確認に成功したら:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    VPNを使う場合は、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.deb

    2. 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-config

    3. サービスを開始します。設定の確認に成功したら:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    VPNを使う場合は、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.rpm

    2. 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-config

    3. サービスを開始します。設定の確認に成功したら:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    VPNを使う場合は、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.rpm

    2. 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-config

    3. サービスを開始します。設定の確認に成功したら:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    VPNを使う場合は、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を再起動してください。

サポート