OpenWrtにLocaltonetをインストールする
試験的 OpenWrt 24.10および25.12以降 x64とARM64
このページの内容 12セクション
OpenWrtルーター上でLocaltonetクライアントを直接実行します。パッケージには、クライアント、トークンファイル、UCI設定、ルーターとともに起動するサービスが含まれます。
OpenWrtパッケージは試験的なものです。署名のないファイルで、署名済みのOpenWrtフィードのパッケージではなく、手動でインストールします。利用前に、ファームウェアとの互換性、トンネル、VPNをお使いのデバイスで確認してください。
始める前に #
- 対応するOpenWrtバージョンとCPUアーキテクチャーのルーター(次のセクションをご覧ください)。
- SSHでルーターにアクセスできるroot権限。
- インストール中にルーターがインターネットに接続できること。パッケージマネージャーが、お使いのファームウェア自身のパッケージフィードから依存パッケージをダウンロードします。
- 十分な空きストレージとメモリ(ストレージとメモリをご覧ください)。
- マイトークンで作成した、他のデバイスで使用していないAuthToken。
対応するバージョンとアーキテクチャー #
OpenWrtはリリースの途中でパッケージマネージャーを変更したため、パッケージ形式は2種類あります。お使いのファームウェアに合うものを選んでください。
| OpenWrtのバージョン | パッケージ形式 | パッケージマネージャー | アーキテクチャー |
|---|---|---|---|
| 24.10 | IPK | opkg | x64、ARM64 |
| 25.12以降 | APK v3 | apk | x64、ARM64 |
ここでのAPKはOpenWrtのパッケージを指します。これらの.apkファイルはAndroidアプリではなく、スマートフォンにはインストールできません。Androidについては、Androidをご覧ください。
サポート対象外のもの #
- MIPS、MIPSEL、ARMv7のルーター。これらのアーキテクチャー向けのパッケージはありません。
- パッケージフィードからのインストール。パッケージはローカルファイルであり、ルーターが
opkg updateやapk updateで見つけたり更新したりすることはありません。 - パッケージを別のアーキテクチャーに強制的にインストールすること。パッケージマネージャーのアーキテクチャーチェックは、絶対に上書きしないでください。
アーキテクチャーを確認する #
パッケージのアーキテクチャーは、ファームウェアと一致している必要があります。ルーターが受け付けるアーキテクチャーを確認します。
OpenWrt 24.10(opkg) #
opkg print-architectureOpenWrt 25.12以降(apk)
apk --print-archx64ルーターはx86_64と報告します。ARM64ルーターはaarch64_で始まる名前を報告し、その名前はファームウェアのビルドによって異なります。各パッケージには、ビルド対象の正確なパッケージアーキテクチャー(例:x86_64やaarch64_generic)を記載した短い説明ファイルが付属します。ダウンロードページのOpenWrtでお使いのパッケージを選び、パッケージのセットアップ手順を開くと確認できます。そのアーキテクチャーとルーターが報告するものを比較してください。一致しない場合は、パッケージをインストールしないでください。
ストレージとメモリ #
パッケージにはクライアントとそのランタイムが含まれるため、一般的なOpenWrtパッケージよりもかなり大きくなります。インストール前にルーターを確認してください。
df -h
free- フラッシュ(オーバーレイ)。プログラムファイルは
/usr/lib/localtonetにインストールされます。フラッシュチップの容量が小さいルーターでは、収めるためにextroot(外部ストレージをルートオーバーレイとして使用)が必要になる場合があります。 - RAMと
/tmp。クライアントは起動時に、ネイティブライブラリを/tmp/localtonet/bundleに展開します。OpenWrtでは/tmpはRAM上にあるため、この容量はルーターのメモリから使われます。
パッケージがインストールするもの #
| パス | 内容 |
|---|---|
/usr/bin/localtonet | localtonetコマンド。 |
/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から設定を読み込みます。新規インストール直後の内容は次のとおりです。
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| オプション | 動作 | 値 |
|---|---|---|
enabled | サービスがクライアントを起動するかどうか。0の間は、サービスを開始しても何も起こりません。 | 0(デフォルト)または1 |
token_file | クライアントがトークンを読み取るファイルのパス。 | デフォルトは/etc/localtonet/auth-token |
現在の値はいつでも確認できます。
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 | ブート時のサービス起動を再び有効にします。 |
パッケージをインストールしたままクライアントをオフにするには、次のようにします。
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のシステムログに書き込みます。該当する行を表示するか、リアルタイムで追跡します。
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) #
opkg remove localtonetOpenWrt 25.12以降(apk)
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.ipk2. 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-config3. サービスを開始します。設定の確認に成功したら:
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.ipk2. 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-config3. サービスを開始します。設定の確認に成功したら:
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.apk2. 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-config3. サービスを開始します。設定の確認に成功したら:
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.apk2. 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-config3. サービスを開始します。設定の確認に成功したら:
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は対象デバイスで検証が必要です。一致しないアーキテクチャを強制しないでください。