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

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

試験的 OpenWrt 24.10および25.12以降 x64とARM64

このページのヘルプ
このページの内容 12セクション
  1. 始める前に
  2. 対応するバージョンとアーキテクチャー
  3. サポート対象外のもの
  4. アーキテクチャーを確認する
  5. OpenWrt 24.10(opkg)
  6. ストレージとメモリ
  7. パッケージがインストールするもの
  8. トークンファイルと設定
  9. トークンファイル
  10. UCI設定
  11. サービス
  12. ログ
  13. アップグレードと削除
  14. OpenWrt 24.10(opkg)
  15. OpenWrtでのVPN
  16. トラブルシューティング
  17. 関連ページ

OpenWrtルーター上でLocaltonetクライアントを直接実行します。パッケージには、クライアント、トークンファイル、UCI設定、ルーターとともに起動するサービスが含まれます。

OpenWrtパッケージは試験的なものです。署名のないファイルで、署名済みのOpenWrtフィードのパッケージではなく、手動でインストールします。利用前に、ファームウェアとの互換性、トンネル、VPNをお使いのデバイスで確認してください。

始める前に #

  • 対応するOpenWrtバージョンとCPUアーキテクチャーのルーター(次のセクションをご覧ください)。
  • SSHでルーターにアクセスできるroot権限。
  • インストール中にルーターがインターネットに接続できること。パッケージマネージャーが、お使いのファームウェア自身のパッケージフィードから依存パッケージをダウンロードします。
  • 十分な空きストレージとメモリ(ストレージとメモリをご覧ください)。
  • マイトークンで作成した、他のデバイスで使用していないAuthToken。

対応するバージョンとアーキテクチャー #

OpenWrtはリリースの途中でパッケージマネージャーを変更したため、パッケージ形式は2種類あります。お使いのファームウェアに合うものを選んでください。

OpenWrtのバージョンパッケージ形式パッケージマネージャーアーキテクチャー
24.10IPKopkgx64、ARM64
25.12以降APK v3apkx64、ARM64

ここでのAPKはOpenWrtのパッケージを指します。これらの.apkファイルはAndroidアプリではなく、スマートフォンにはインストールできません。Androidについては、Androidをご覧ください。

サポート対象外のもの #

  • MIPS、MIPSEL、ARMv7のルーター。これらのアーキテクチャー向けのパッケージはありません。
  • パッケージフィードからのインストール。パッケージはローカルファイルであり、ルーターがopkg updateやapk updateで見つけたり更新したりすることはありません。
  • パッケージを別のアーキテクチャーに強制的にインストールすること。パッケージマネージャーのアーキテクチャーチェックは、絶対に上書きしないでください。

アーキテクチャーを確認する #

パッケージのアーキテクチャーは、ファームウェアと一致している必要があります。ルーターが受け付けるアーキテクチャーを確認します。

OpenWrt 24.10(opkg) #

Bash
opkg print-architecture

OpenWrt 25.12以降(apk)

Bash
apk --print-arch

x64ルーターはx86_64と報告します。ARM64ルーターはaarch64_で始まる名前を報告し、その名前はファームウェアのビルドによって異なります。各パッケージには、ビルド対象の正確なパッケージアーキテクチャー(例:x86_64やaarch64_generic)を記載した短い説明ファイルが付属します。ダウンロードページのOpenWrtでお使いのパッケージを選び、パッケージのセットアップ手順を開くと確認できます。そのアーキテクチャーとルーターが報告するものを比較してください。一致しない場合は、パッケージをインストールしないでください。

ストレージとメモリ #

パッケージにはクライアントとそのランタイムが含まれるため、一般的なOpenWrtパッケージよりもかなり大きくなります。インストール前にルーターを確認してください。

Bash
df -h
free
  • フラッシュ(オーバーレイ)。プログラムファイルは/usr/lib/localtonetにインストールされます。フラッシュチップの容量が小さいルーターでは、収めるためにextroot(外部ストレージをルートオーバーレイとして使用)が必要になる場合があります。
  • RAMと/tmp。クライアントは起動時に、ネイティブライブラリを/tmp/localtonet/bundleに展開します。OpenWrtでは/tmpはRAM上にあるため、この容量はルーターのメモリから使われます。

パッケージがインストールするもの #

パス内容
/usr/bin/localtonetlocaltonetコマンド。
/usr/lib/localtonetプログラムファイル。
/etc/localtonet/auth-tokenトークンファイル。置き換えるまでは、プレースホルダーDUMMY_AUTH_TOKENが入っています。rootのみ読み取り可能です。
/etc/config/localtonetサービスのUCI設定。
/etc/init.d/localtonetサービススクリプト(procd)。

パッケージは、libc、libgcc1、libstdcpp6、libopenssl3、zlib、ca-bundle、kmod-tun、ip-full、bash、iptables-nft、ip6tables-nftに依存します。不足しているものは、パッケージマネージャーがお使いのファームウェアのフィードからインストールします。セットアップ手順が最初にパッケージリストを更新するのはこのためです。kmod-tunはインストール済みファームウェアのカーネルと一致している必要があるため、必ずそのファームウェア自身のフィードから取得してください。

トークンファイルと設定 #

パッケージをインストールしても、何も接続されません。次の2つを行うまで、サービスはオフのままです。トークンファイルにトークンを書き込むことと、UCIでサービスを有効にすることです。お使いのパッケージ向けの正確なコマンドは、このページの末尾にあるセットアップ手順にあります。このセクションでは、その内容を説明します。

トークンファイル #

/etc/localtonet/auth-tokenには、AuthTokenだけを1行で記述します。プレースホルダーDUMMY_AUTH_TOKENを、たとえばviでトークンに置き換えてください。ファイルはrootのみ読み取り可能(モード600)にしてください。

続いてセットアップ手順では、クライアントを--headless --authtoken-file /etc/localtonet/auth-token --check-configで一度実行します。これにより、Localtonetに接続せずにファイルを検査できます。

出力意味
Localtonet headless configuration OK.ファイルに正しい形式のトークン(33文字、スペースなし)が含まれています。このチェックでは、トークンがお使いのアカウントで有効かどうかまではわかりません。
Invalid Localtonet headless configuration. Check the token file or environment settings.ファイルが存在しない、プレースホルダーのままである、またはトークンが33文字ではありません。

UCI設定 #

サービスは/etc/config/localtonetから設定を読み込みます。新規インストール直後の内容は次のとおりです。

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
オプション動作値
enabledサービスがクライアントを起動するかどうか。0の間は、サービスを開始しても何も起こりません。0(デフォルト)または1
token_fileクライアントがトークンを読み取るファイルのパス。デフォルトは/etc/localtonet/auth-token

現在の値はいつでも確認できます。

Bash
uci show localtonet

サービス #

クライアントは、localtonetという名前のprocdサービスとして動作します。パッケージをインストールすると、ブート時に起動するよう登録されますが、クライアントが起動するのはenabledが1で、トークンファイルが空でない場合のみです。enabledを1にしてコミットしたら、サービスを一度再起動してください。それ以降は、ルーターとともに起動します。

コマンド動作
/etc/init.d/localtonet restartクライアントを停止してから起動します。トークンファイルや設定を変更したときに実行してください。
/etc/init.d/localtonet stop次回の再起動またはリブートまで、クライアントを停止します。
/etc/init.d/localtonet disableブート時のサービス起動を無効にします。
/etc/init.d/localtonet enableブート時のサービス起動を再び有効にします。

パッケージをインストールしたままクライアントをオフにするには、次のようにします。

Bash
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restart

クライアントが予期せず停止した場合は、procdが再起動します。

クライアントが接続されたら、ダッシュボードでルーターのトークンを使ってトンネルを作成して開始します。トンネルのローカルIPアドレスには、ルーター自身のサービスなら127.0.0.1、ルーターの配下にあるデバイスなら、そのLANアドレス(例:192.168.1.20)を指定できます。

ログ #

クライアントは、OpenWrtのシステムログに書き込みます。該当する行を表示するか、リアルタイムで追跡します。

Bash
logread -e localtonet
logread -f -e localtonet
行意味
Localtonet - headless logクライアントが起動しました。
Connection: …Localtonetとの接続状態です。
AuthTokenName: …ルーターがサインインしたトークンの名前です。
OPEN …, ADDED …, STATUS …, CLOSED …このトークンのトンネルが見つかった、追加された、状態が変わった、または削除されました。
Authentication failed: AuthToken was rejected.トークンファイルのトークンがLocaltonetに受け入れられませんでした。
AuthToken file missingサービスは有効ですが、トークンファイルが存在しないか、空です。

アップグレードと削除 #

アップグレードするには、新しいパッケージを古いパッケージの上にインストールし、サービスを再起動します。トークンファイルとUCI設定は保持されます。これらのファイルは、OpenWrtがファームウェアのアップグレード時に保持するファイルのリストにも含まれていますが、新しいファームウェアを書き込んだ後は、パッケージ自体を再度インストールする必要があります。

クライアントを削除するには、次のようにします。

OpenWrt 24.10(opkg) #

Bash
opkg remove localtonet

OpenWrt 25.12以降(apk)

Bash
apk del localtonet

パッケージを削除すると、サービスが停止し、ブートシーケンスから外れます。

OpenWrtでのVPN #

パッケージは、ルーター上でVPN機能に必要なもの(kmod-tun、ip-full、bash、iptables-nft、ip6tables-nft)を取り込みます。ルーティングやファイアウォールの動作は、ファームウェアとご自身のファイアウォールルールによって異なるため、利用前にお使いのデバイスでVPNをテストしてください。この機能自体については、VPNマネージャーをご覧ください。

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

アーキテクチャーが原因でパッケージマネージャーがパッケージを拒否する

パッケージが、お使いのファームウェアとは別のアーキテクチャー向けにビルドされています。opkg print-architectureまたはapk --print-archの出力と、パッケージの説明ファイルに記載されたアーキテクチャー(ダウンロードページのパッケージのセットアップ手順)を比較してください。強制的にインストールしないでください。MIPS、MIPSEL、ARMv7のルーターはサポート対象外です。

apkがファイルを信頼できないものとしてインストールを拒否する

APKパッケージは署名のないローカルファイルです。インストールには、パッケージのセットアップ手順に示されているとおり、--allow-untrustedオプションが必要です。

依存パッケージが見つからずインストールに失敗する

先にパッケージリストを更新(opkg updateまたはapk update)し、ルーターがインターネットに接続できることを確認してください。依存パッケージは、お使いのファームウェア自身のフィードから取得されます。

サービスは有効なのに、ログに何も表示されない

uci show localtonetを確認してください。enabledがまだ0の場合は1に設定し、コミットしてサービスを再起動します。ログにAuthToken file missingと表示される場合は、token_fileで指定したファイルにトークンを書き込んでください。

クライアントが起動しない、またはルーターのメモリが不足する

df -hとfreeで、フラッシュの空き容量とメモリを確認してください。クライアントには、/usr/lib/localtonetと/tmpに空き容量が必要です。

OpenWrt

試験運用版。OpenWrt 24.10ではIPK、25.12以降ではAPK v3を選択してください。これらのAPKファイルはOpenWrtパッケージであり、Androidアプリではありません。

x64およびARM64のみ。パッケージのアーキテクチャはファームウェアと一致している必要があります。パッケージのセットアップ手順とopkg print-architectureまたはapk --print-archで確認してください。これらのパッケージはMIPS、MIPSEL、ARMv7には対応していません。インストール前に空きストレージとRAMを確認してください。

  • OpenWrt 24.10 · x64 · IPK
    セットアップ手順

    1. ダウンロードしたパッケージをインストールします。localtonet-openwrt-24.10-x64.ipkがあるディレクトリでターミナルを開きます。

    これらのコマンドはルーター上でrootとして実行してください。インストール前に、パッケージのアーキテクチャがファームウェアと一致していることを確認してください。

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-x64.ipk

    2. AuthTokenを設定します。rootで/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENを1行でトークンに置き換えます。その後、ファイルを保護して設定を確認します:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    アップグレードするには、新しいパッケージをインストールして/etc/init.d/localtonet restartを実行します。設定は保持されます。

  • OpenWrt 24.10 · ARM64 · IPK
    セットアップ手順

    1. ダウンロードしたパッケージをインストールします。localtonet-openwrt-24.10-arm64.ipkがあるディレクトリでターミナルを開きます。

    これらのコマンドはルーター上でrootとして実行してください。インストール前に、パッケージのアーキテクチャがファームウェアと一致していることを確認してください。

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-arm64.ipk

    2. AuthTokenを設定します。rootで/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENを1行でトークンに置き換えます。その後、ファイルを保護して設定を確認します:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    アップグレードするには、新しいパッケージをインストールして/etc/init.d/localtonet restartを実行します。設定は保持されます。

  • OpenWrt 25.12+ · x64 · APK v3
    セットアップ手順

    1. ダウンロードしたパッケージをインストールします。localtonet-openwrt-25.12-x64.apkがあるディレクトリでターミナルを開きます。

    これらのコマンドはルーター上でrootとして実行してください。インストール前に、パッケージのアーキテクチャがファームウェアと一致していることを確認してください。

    このローカルAPKパッケージは署名されていないため、インストールには--allow-untrustedが必要です。

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk

    2. AuthTokenを設定します。rootで/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENを1行でトークンに置き換えます。その後、ファイルを保護して設定を確認します:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    アップグレードするには、新しいパッケージをインストールして/etc/init.d/localtonet restartを実行します。設定は保持されます。

  • OpenWrt 25.12+ · ARM64 · APK v3
    セットアップ手順

    1. ダウンロードしたパッケージをインストールします。localtonet-openwrt-25.12-arm64.apkがあるディレクトリでターミナルを開きます。

    これらのコマンドはルーター上でrootとして実行してください。インストール前に、パッケージのアーキテクチャがファームウェアと一致していることを確認してください。

    このローカルAPKパッケージは署名されていないため、インストールには--allow-untrustedが必要です。

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk

    2. AuthTokenを設定します。rootで/etc/localtonet/auth-tokenを編集し、DUMMY_AUTH_TOKENを1行でトークンに置き換えます。その後、ファイルを保護して設定を確認します:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    アップグレードするには、新しいパッケージをインストールして/etc/init.d/localtonet restartを実行します。設定は保持されます。

インストール前に、お使いのパッケージのセットアップ手順をお読みください。パッケージは署名されていません。ファームウェアの互換性、トンネル、VPNは対象デバイスで検証が必要です。一致しないアーキテクチャを強制しないでください。

サポート