在受支援的 OpenWrt 或 iStoreOS 上，安裝與路由器相符的兩個套件，然後在 LuCI 打開網路 > VilaNet，用 VilaVPN 帳號登入並連線。不要匯入訂閱連結。先備份，並先看清套件管理器和 CPU 架構，再下載。
路由器還不是受支援的 OpenWrt，或不確定該不該刷機時，先看該用 OpenWrt 版還是 Merlin 版。變更路由器會影響區域網路上的所有裝置。
1. 備份並讀出架構
- 在 LuCI 打開系統 > 備份 / 升級，建立設定備份，存到路由器以外的地方。
- 記下路由器型號、OpenWrt 版本、CPU 架構，以及用的是
opkg還是apk。 - 確認你能從區域網路打開 LuCI 或 SSH。需要已設定的 root 密碼、LuCI 和 SSH 的管理員權限，以及一個有效的 VilaVPN 帳號。
SSH 裡可以這樣查看：
cat /etc/openwrt_release
command -v opkg || command -v apk
opkg print-architecture 2>/dev/null || apk --print-archopkg print-architecture 可能有多行。核心套件用優先序數字最高的那一個特定架構，忽略 all 和 noarch。不要只憑路由器的商品名猜測。
2. 按系統選兩個套件
| 路由器 | 下載什麼 | 怎麼裝 |
|---|---|---|
| iStoreOS | 目前版本裡的 .run 安裝程式 | iStore > 手動安裝 |
使用 opkg 的 OpenWrt 24.x | 與架構相符的核心 IPK，以及標記為 all 的 LuCI IPK | opkg install |
使用 apk 的 OpenWrt 25.x | 與架構相符的核心 APK，以及標記為 noarch 的 LuCI APK | apk add |
核心套件目前提供的架構有：x86_64、aarch64_cortex-a53、aarch64_generic、arm_cortex-a7_neon-vfpv4、mipsel_24kc、arm_arm926ej-s。從官方發布頁下載目前的檔案，檔名以頁面上的為準，不要自訂版本號。GitHub 較慢時，用 openwrt.vilavpn.com 上的架構選擇和鏡像選擇產生下載命令。舊的 vilanet-test-*.tar.gz 手動複製方法已經停用。
OpenWrt 25 的套件是本機發布檔案，不是路由器軟體庫裡的套件，所以安裝時要加 --allow-untrusted。複製或安裝之前，先用發布頁上的 SHA-256 核對。macOS 用 shasum -a 256，Linux 或路由器上用 sha256sum。有任何一個值對不上，就不要安裝。這裡不列出校驗表，以發布頁上的目前數值為準。
3. 安裝
iStoreOS：打開 iStoreOS 網頁，進入iStore > 手動安裝，上傳 .run 檔案，離開頁面前看完安裝結果，然後打開網路 > VilaNet。
OpenWrt 24.x：把兩個 IPK 複製到路由器的 /tmp。全新系統要先更新套件清單，否則 opkg 找不到 VilaNet 依賴的核心模組。
opkg update
opkg install /tmp/<核心套件>.ipk /tmp/<LuCI套件>.ipk
/etc/init.d/vilanet enableOpenWrt 25.x：同樣先複製到 /tmp，再安裝。安裝程式會從 /tmp 刪掉 LuCI 套件。要再執行一次，需重新複製那個檔案。
apk add --allow-untrusted --force-non-repository \
/tmp/<核心套件>.apk /tmp/<LuCI套件>.apk
/etc/init.d/vilanet enable4. 登入並連線
- 安裝後重新整理 LuCI。
- 打開網路 > VilaNet。
- 在概覽輸入 VilaVPN 帳號的電子郵件地址和密碼。
- 選取登入。官方路由器軟體用帳號登入，不需要訂閱連結，也不需要啟用訂閱。
- 在同一頁的快速操作裡，第一次連線把伺服器留在自動 - 所有伺服器，或改選一台伺服器。伺服器分頁裡每台伺服器旁也有連接。
- 選取連接。
怎樣算安裝成功
先看路由器：
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet再用一部連著這台路由器的裝置打開一個普通 HTTPS 網站。回到網路 > VilaNet > 概覽，確認 VPN 服務 仍是 running，連接狀態 仍是 connected。只看到「已連線」不夠，路由器狀態和區域網路裝置的存取都要成功。
仍然不行？
沒有 VilaNet 選單時：強制重新整理 LuCI 頁面，用 SSH 執行 /etc/init.d/rpcd restart，再打開網路 > VilaNet，並確認核心套件和 LuCI 套件都已安裝。
啟動後又停止時，先保留上面幾條命令的輸出，不要立刻重裝。聯絡支援時提供路由器型號、OpenWrt 版本、套件管理器，以及遮蔽過的輸出。不要傳送密碼或原始訂閱資料。
顯示已連線但區域網路裝置上不了網，看OpenWrt 顯示已連線，但區域網路裝置上不了網。要改路由模式之前，先看三種路由模式和復原與回復。逐步圖解在 openwrt.vilavpn.com 和安裝文件。