如何在 OpenWrt 上安裝 VilaNet?
安裝與路由器相符的兩個套件,然後在 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.44。
備份路由器
在 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。
選擇安裝方式
| 路由器 | 檔案 | 安裝方式 |
|---|---|---|
| iStoreOS | vilanet-istore-install_1.0.44.run |
iStore > 手動安裝 |
| OpenWrt 24.x | vilanet-core_1.0.44_<arch>.ipk 及 luci-app-vilanet_1.0.44_all.ipk |
opkg install |
| OpenWrt 25.x | vilanet-core_1.0.44_<arch>.apk 及 luci-app-vilanet_1.0.44_noarch.apk |
apk add |
請將 <arch> 替換為路由器回報的架構。不要只依據路由器的行銷名稱猜測。
驗證 OpenWrt 25 下載項目
OpenWrt 25 套件會使用 --allow-untrusted 安裝,因為它們是本機版本檔案,而不是來自路由器已設定軟體庫的套件。複製或安裝前,請先驗證其 SHA-256 值。
| 檔案 | v1.0.44 預期 SHA-256 |
|---|---|
vilanet-core_1.0.44_aarch64_cortex-a53.apk |
a8844e65752052b762222d08692fce373a152883e09167e1748673a532c9347f |
vilanet-core_1.0.44_aarch64_generic.apk |
42b19eed836589393dea4873dfa5cce3a19e1eb282b55b77f73f08b409b9aa5e |
vilanet-core_1.0.44_arm_arm926ej-s.apk |
e277c184d1e6a4af7628ba0a9e57fdf3eba90ee24b0820102191ecc73b4eeab7 |
vilanet-core_1.0.44_arm_cortex-a7_neon-vfpv4.apk |
974b4c34b897abba938d0094582872b62893b7f9eddda97724f254073b97d622 |
vilanet-core_1.0.44_mipsel_24kc.apk |
16a37e175dbcb43e01fe9753140ca385b870f1576298f62c860f61180b66e27c |
vilanet-core_1.0.44_x86_64.apk |
4fba942067e9538cac72f99c35789242460afbc3f4e274601d8e8e5a74f01f71 |
luci-app-vilanet_1.0.44_noarch.apk |
cb2e1fa3cda1e99d1f025bda15534b8572f1173bef5054dd071f48489818509f |
在 macOS 上執行 shasum -a 256 <filename>。在 Linux 或路由器上執行 sha256sum <filename>。若任一數值不符,請勿安裝這些檔案。
在 iStoreOS 上安裝
- 從目前版本下載
vilanet-istore-install_1.0.44.run。 - 開啟 iStoreOS 網頁介面。
- 前往 iStore > 手動安裝。
- 上傳
.run安裝程式。 - 離開頁面前,請檢查安裝結果。
- 開啟網路 > VilaNet。
在 OpenWrt 24.x 上安裝
下載符合架構的核心 IPK 及不受架構限制的 LuCI IPK。將它們複製到路由器:
scp -O vilanet-core_1.0.44_<arch>.ipk root@<router>:/tmp/
scp -O luci-app-vilanet_1.0.44_all.ipk root@<router>:/tmp/
透過 SSH 安裝兩個套件:
請先重新整理套件清單。在全新的路由器上,必須先執行 opkg update,opkg 才能找到 VilaNet 依賴的核心模組。
opkg update
opkg install /tmp/vilanet-core_1.0.44_<arch>.ipk \
/tmp/luci-app-vilanet_1.0.44_all.ipk
/etc/init.d/vilanet enable
vilanet version
在 OpenWrt 25.x 上安裝
下載符合架構的核心 APK 及 noarch LuCI APK。將它們複製到路由器:
scp -O vilanet-core_1.0.44_<arch>.apk root@<router>:/tmp/
scp -O luci-app-vilanet_1.0.44_noarch.apk root@<router>:/tmp/
透過 SSH 安裝兩個套件:
apk add --allow-untrusted --force-non-repository \
/tmp/vilanet-core_1.0.44_<arch>.apk \
/tmp/luci-app-vilanet_1.0.44_noarch.apk
/etc/init.d/vilanet enable
vilanet version
安裝程式會從 /tmp 刪除 LuCI 套件檔案。如需再次執行該命令,請先重新複製該檔案到路由器。
登入並連線
- 安裝後重新整理 LuCI。
- 開啟網路 > VilaNet。
- 在概覽中輸入 VilaVPN 帳號的電子郵件地址及密碼。
- 選取登入。
- 在同一頁面的快速操作下,第一次連線時將伺服器保留為自動 - 所有伺服器,或選擇特定伺服器。伺服器分頁中的每台伺服器旁也有連接按鈕。
- 選取連接。

這張真實 LuCI 畫面使用保留的範例地址 you@example.com,密碼欄位則為空白。為了讓登入控制項在手機上清楚可讀,寬幅的路由器畫面已經裁切;沒有任何介面元素是重新製作的。
實體路由器螢幕截圖及區域網路流量檢查仍是發布證據門檻;只有「已連線」標籤絕不是通道已建立的證明。
確認運作正常
先檢查路由器:
vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet
接著使用一部連上路由器的裝置:
- 開啟一般 HTTPS 網站。
- 返回網路 > VilaNet > 概覽。
- 確認VPN 服務仍顯示
running,且連接狀態仍顯示connected。
只有「已連線」標籤並不足夠。路由器狀態及來自區域網路裝置的流量都必須正常運作。
如果找不到 VilaNet 選單
- 強制重新整理 LuCI 頁面。
- 透過 SSH 執行
/etc/init.d/rpcd restart。 - 重新開啟 LuCI 並檢查網路 > VilaNet。
- 確認核心及 LuCI 套件都已安裝。
如果 VilaNet 啟動後停止
重新安裝前,請保留證據:
vilanet version
vilanet status --json
/etc/init.d/vilanet status
logread | grep vilanet
聯絡支援時,請提供路由器型號、OpenWrt 版本、套件管理器及經過遮蔽處理的輸出。請勿傳送密碼或原始訂閱資料。
不受支援的舊版安裝程式
舊版 vilanet-test-*.tar.gz 手動複製方式已停用。請使用官方版本中的目前 IPK、APK 或 iStoreOS 安裝程式。
下一步
變更路由模式、升級套件或移除 VilaNet 前,請先閱讀復原與回復。
這個頁面對您有幫助嗎?