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

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

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

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

## 必要なもの

- 対応するOpenWrtまたはiStoreOSルーター
- `opkg`を使用するOpenWrt 24.x、または`apk`を使用するOpenWrt 25.x
- 設定済みのルーターrootパスワード
- LuCIとSSHの管理者アクセス
- 有効なVilaVPNアカウント
- 最新の[VilaNet OpenWrtリリース](https://github.com/vilavpn/vilanet-openwrt/releases/tag/v1.0.33)

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

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

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

次の情報も記録します。

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

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

```sh
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`を選びます。

## インストール方法を選ぶ

| ルーター | ファイル | インストール方法 |
|---|---|---|
| iStoreOS | `vilanet-istore-install_1.0.33.run` | **iStore > 手動インストール** |
| OpenWrt 24.x | `vilanet-core_1.0.33_<arch>.ipk`と`luci-app-vilanet_1.0.33_all.ipk` | `opkg install` |
| OpenWrt 25.x | `vilanet-core_1.0.33_<arch>.apk`と`luci-app-vilanet_1.0.33_noarch.apk` | `apk add` |

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

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

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

| ファイル | v1.0.33の期待されるSHA-256 |
|---|---|
| `vilanet-core_1.0.33_aarch64_cortex-a53.apk` | `b66dba97bc2c8d3c18eca3556e087651fc9d8ec6d84ebed2ac1d4ab65b03a982` |
| `vilanet-core_1.0.33_aarch64_generic.apk` | `5479c84c8b1373150dd4afd5a337e7e4cfbbcf7109b8c2861e40f979784677b8` |
| `vilanet-core_1.0.33_arm_arm926ej-s.apk` | `5c8c211f9aa9708bab10cdfc80d3171d6f6d6453d0f836927b199f938c5e4569` |
| `vilanet-core_1.0.33_arm_cortex-a7_neon-vfpv4.apk` | `de7425cc9c23cb5f981f78344b75822a11c7624a7033a044bf8eb701415a4d7e` |
| `vilanet-core_1.0.33_mipsel_24kc.apk` | `643ff91ca501ef7605146bf3c9e2490a5177ecfdfc5bc9613e48ac4a8b22867d` |
| `vilanet-core_1.0.33_x86_64.apk` | `f22fa045b777677a647da808110eb00af8ad661bafeb07b48aae13e7ff6187c4` |
| `luci-app-vilanet_1.0.33_noarch.apk` | `201782ccebba81d170ed7193ca75aee8e46fe9d542fa4992dc7222960dc04502` |

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をダウンロードします。次のようにルーターへコピーします。

```sh
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経由で両方のパッケージをインストールします。

```sh
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をダウンロードします。次のようにルーターへコピーします。

```sh
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経由で両方のパッケージをインストールします。

```sh
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. **概要**に戻り、**接続**を選びます。

![実在するOpenWrt LuCIインターフェースのVilaNetログインフォーム。例示用のメールアドレスを使用](/assets/openwrt/openwrt-vilanet-login-en-24.10.2.png)

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

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

## 動作を確認する

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

```sh
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が起動後に停止する場合

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

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

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

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

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

## 次のステップ

ルーティングモードの変更、パッケージのアップグレード、VilaNetの削除を行う前に、[復旧とロールバック](/ja/routers/recovery-and-rollback/)を確認してください。