OpenWrtにVilaNetをインストールするには？

ルーターに合った2つのパッケージをインストールしてから、LuCIでネットワーク > VilaNetを開き、ログインして接続します。最初にルーターをバックアップし、何かをダウンロードする前にパッケージマネージャーとCPUアーキテクチャを確認してください。

詳しい図解資料が必要ですか？ パッケージ別の手順、アーキテクチャの選び方、スクリーンショット、高度なトラブルシューティングについては、詳細なVilaNet OpenWrtガイドを参照してください。このページは、多言語の安全な入門ガイドとして維持します。

{% hint style="warning" %} ルーターを変更すると、ネットワーク上のすべてのデバイスが通信できなくなる可能性があります。始める前にルーター設定のコピーを保管し、ローカルネットワーク経由でLuCIまたはSSHにアクセスできることを確認してください。 {% endhint %}

必要なもの

• 対応するOpenWrtまたはiStoreOSルーター
• opkgを使用するOpenWrt 24.x、またはapkを使用するOpenWrt 25.x
• 設定済みのルーターrootパスワード
• LuCIとSSHの管理者アクセス
• 有効なVilaVPNアカウント
• 最新のVilaNet OpenWrtリリース

このガイドで確認済みの現在の公開リリースはv1.0.33です。

ルーターをバックアップする

LuCIでシステム > バックアップ / ファームウェアの書き込みを開き、設定バックアップを作成します。アーカイブはルーター以外の場所に保存してください。

次の情報も記録します。

• ルーターのモデル
• OpenWrtのバージョン
• CPUアーキテクチャ
• ルーターがopkgとapkのどちらを使用しているか

SSHセッションで次のコマンドを実行すると、必要な情報を確認できます。

cat /etc/openwrt_release
command -v opkg || command -v apk
opkg print-architecture 2>/dev/null || apk --print-arch

opkg print-architectureは複数行を返すことがあります。優先度の数値が最も高い固有のアーキテクチャを使用し、コアパッケージではallとnoarchを除外します。たとえば、aarch64_cortex-a53の優先度がallより高い場合は、aarch64_cortex-a53を選びます。

インストール方法を選ぶ

<arch>はルーターが報告したアーキテクチャに置き換えます。ルーターの商品名だけで推測しないでください。

OpenWrt 25のダウンロードを検証する

OpenWrt 25のパッケージは、ルーターに設定されたリポジトリのパッケージではなくローカルのリリースファイルであるため、--allow-untrustedを付けてインストールします。コピーまたはインストールする前にSHA-256値を検証してください。

macOSではshasum -a 256 <filename>を実行します。Linuxまたはルーターではsha256sum <filename>を実行します。いずれかの値が異なる場合は、ファイルをインストールしないでください。

iStoreOSにインストールする

1. 現在のリリースからvilanet-istore-install_1.0.33.runをダウンロードします。
2. iStoreOSのウェブインターフェースを開きます。
3. iStore > 手動インストールへ移動します。
4. .runインストーラーをアップロードします。
5. ページを離れる前にインストール結果を確認します。
6. ネットワーク > VilaNetを開きます。

OpenWrt 24.xにインストールする

アーキテクチャに合ったコアIPKと、アーキテクチャに依存しないLuCI IPKをダウンロードします。次のようにルーターへコピーします。

scp -O vilanet-core_1.0.33_<arch>.ipk root@<router>:/tmp/
scp -O luci-app-vilanet_1.0.33_all.ipk root@<router>:/tmp/

SSH経由で両方のパッケージをインストールします。

opkg install /tmp/vilanet-core_1.0.33_<arch>.ipk \
  /tmp/luci-app-vilanet_1.0.33_all.ipk
/etc/init.d/vilanet enable
vilanet version

OpenWrt 25.xにインストールする

アーキテクチャに合ったコアAPKと、noarchのLuCI APKをダウンロードします。次のようにルーターへコピーします。

scp -O vilanet-core_1.0.33_<arch>.apk root@<router>:/tmp/
scp -O luci-app-vilanet_1.0.33_noarch.apk root@<router>:/tmp/

SSH経由で両方のパッケージをインストールします。

apk add --allow-untrusted --force-non-repository \
  /tmp/vilanet-core_1.0.33_<arch>.apk \
  /tmp/luci-app-vilanet_1.0.33_noarch.apk
/etc/init.d/vilanet enable
vilanet version

ログインして接続する

1. インストール後にLuCIを更新します。
2. ネットワーク > VilaNetを開きます。
3. 概要でVilaVPNアカウントのメールアドレスとパスワードを入力します。
4. ログインを選びます。
5. サーバーノードを開いて場所を選ぶか、利用できる場合は自動選択のままにします。
6. 概要に戻り、接続を選びます。

この実際のLuCI画面では、予約済みの例示用アドレスyou@example.comを使用し、パスワード欄は空にしています。スマートフォンでもログイン操作が見やすいよう、横長のルーター画面を切り抜いています。インターフェース要素を再現したものではありません。

公開には、実機ルーターのスクリーンショットとLAN通信の確認が引き続き必要です。接続済みという表示だけでは、トンネルが機能している証拠になりません。

動作を確認する

まずルーターを確認します。

vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet

次に、ルーターに接続したデバイスを使用します。

1. 通常のHTTPSウェブサイトを開きます。
2. ネットワーク > VilaNet > 概要に戻ります。
3. サービスが実行中のままで、接続が接続済みのままであることを確認します。

接続済みという表示だけでは不十分です。ルーターの状態とLANデバイスからの通信が、どちらも機能する必要があります。

VilaNetメニューが表示されない場合

1. LuCIページを強制再読み込みします。
2. SSH経由で/etc/init.d/rpcd restartを実行します。
3. LuCIを開き直し、ネットワーク > VilaNetを確認します。
4. コアパッケージとLuCIパッケージが両方インストールされていることを確認します。

VilaNetが起動後に停止する場合

再インストールする前に、次の情報を保存します。

vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet

サポートへ問い合わせる際は、ルーターのモデル、OpenWrtのバージョン、パッケージマネージャー、編集済みの出力を添えてください。パスワードや未編集のサブスクリプションデータは送らないでください。

サポート対象外の旧インストーラー

以前のvilanet-test-*.tar.gzを手動でコピーする方法は廃止されました。公式リリースにある現在のIPK、APK、またはiStoreOSインストーラーを使用してください。

次のステップ

ルーティングモードの変更、パッケージのアップグレード、VilaNetの削除を行う前に、復旧とロールバックを確認してください。