VilaNetをインストールしたルーターを復旧またはロールバックするには？

ルーターをリセットまたは再書き込みする前に停止してください。まず通常のインターネットアクセスを復元し、少量の診断記録を保存して、問題がVilaNetサービス、パッケージ、ルーターのファームウェアのどこにあるかを特定します。

{% hint style="warning" %} 最初のトラブルシューティングとしてファームウェアを再書き込みしないでください。失敗したり互換性のないファームウェア操作を行ったりすると、ルーターにアクセスできなくなる可能性があります。ファームウェアの復旧方法はモデルごとに異なり、このガイドの対象外です。 {% endhint %}

最初にインターネットアクセスを復元する

ルーター配下のデバイスからインターネットにアクセスできない場合は、SSH経由でVilaNetを停止します。

/etc/init.d/vilanet stop
/etc/init.d/vilanet status

ルーターに接続したデバイスから、通常のHTTPSウェブサイトをテストします。インターネットアクセスが戻った場合は、情報を収集している間、VilaNetを停止したままにします。

ネットワーク経由でルーターにアクセスできない場合は、該当するモデル向けのルーターメーカーのローカル復旧手順に従ってください。一般的なファームウェアイメージを使用しないでください。

現在の状態を記録する

何かを再インストールする前に、次のコマンドを実行します。

cat /etc/openwrt_release
command -v opkg || command -v apk
vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet

出力をローカルに保存します。サポートへ送る前に内容を確認し、メールアドレス、サブスクリプションデータ、サーバー識別子、IPアドレス、トークンを削除してください。パスワードは絶対に送らないでください。

次の情報も記録します。

• ルーターのメーカーと正確なモデル
• LuCIとSSHから引き続きルーターにアクセスできるか
• 障害が発生する直前に行った操作
• VilaNetを停止すると通常のインターネットアクセスが復元したか
• インストールしたVilaNetパッケージのファイル名

VilaNet設定をバックアップする

システム > バックアップ / ファームウェアの書き込みから通常のOpenWrt設定バックアップを作成し、ルーター以外の場所に保存します。

バックアップは機密情報として扱ってください。アカウント情報やネットワーク設定が含まれている可能性があります。完全なアーカイブをサポートチケットに添付しないでください。

最も影響の少ない復旧方法を選ぶ

表示されないLuCIメニューを修復する

/etc/init.d/rpcd restart

ブラウザーを強制再読み込みし、ネットワーク > VilaNetを開き直します。まだ表示されない場合は、インストール済みパッケージを確認します。

opkg list-installed 2>/dev/null | grep vilanet
apk list --installed 2>/dev/null | grep vilanet

現在のリリースを修復する

同じバージョンの修復は、初回インストールとは異なる操作です。アーキテクチャを正確に一致させ、OpenWrtにVilaNetをインストールするに掲載された現在のv1.0.33リリースアセットのみを使用します。

opkgを使用するOpenWrt 24では、適合する2つのIPKファイルを/tmpへコピーしてから、次を実行します。

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

apkを使用するOpenWrt 25では、同じバージョンの修復に新規インストール用のapk addコマンドを再利用しないでください。apk-tools v3ではapk fix --reinstallを使用し、ローカルファイルからの正確な復旧手順でもリリースの完全性確認を維持する必要があります。この一連のコマンドが公開され、実機ルーターで確認されるまでは、VilaNetを停止したままにし、上記の編集済み情報を添えてサポートへ問い合わせてください。

iStoreOSでは、同じ現在の.runインストーラーをアップロードすれば同じバージョンのインストールが修復されるとは限りません。v1.0.33のインストーラーは通常のパッケージインストール手順を使用するため、同じバージョンのファイルは処理されない可能性があります。修復対応のインストール方法が公開され、iStoreOSで確認されるまで、VilaNetを停止したままにし、上記の編集済み情報を添えてサポートへ問い合わせてください。

再インストールしただけでは、復旧した証拠になりません。インストール後に、次の3つの条件をすべて確認します。

1. /etc/init.d/vilanet statusでサービスが実行中と表示される。
2. vilanet status --jsonで期待する接続状態が表示される。
3. ルーター配下のデバイスから通常のHTTPSウェブサイトを読み込める。

ダウングレードについて

古いパッケージでは、異なる設定スキーマや認証情報形式が使用されている場合があります。古いアセットが利用できるという理由だけで、お客様のルーターをダウングレードしないでください。VilaVPNサポートが、正確なバージョンの組み合わせ、ルーターのアーキテクチャ、ロールバック手順を確認した場合に限り、古いバージョンを使用してください。

必要な場合にのみVilaNetを削除する

パッケージを削除するとルーターが変更され、別途処理が必要な機密設定を残したままウェブインターフェースが削除される可能性があります。完全なアンインストールが目的の場合は、バージョン別の削除手順をサポートへ問い合わせてください。一時的な復旧手段としては、サービスの停止のほうが安全です。

サポートへ送る情報

次の情報を送ります。

• 正確なルーターのモデルとOpenWrtのバージョン
• VilaNetのバージョン
• パッケージマネージャーとアーキテクチャ
• 編集済みの状態情報とVilaNetのログ行
• サービスの停止でインターネットアクセスが復元したか
• 最後に正常だった状態と最初に失敗した状態の簡潔な説明

ルーターのバックアップ、アカウントのパスワード、未編集のサブスクリプションデータ、未確認の診断アーカイブは送らないでください。