如何復原或回復 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 設定

從 System > Backup / Flash Firmware 建立一般 OpenWrt 設定備份，並將它儲存在路由器以外的位置。

請將備份視為敏感資料。其中可能包含帳號或網路設定。請勿將完整封存檔附加到支援案件。

選擇破壞性最低的復原方式

修復消失的 LuCI 選單

/etc/init.d/rpcd restart

強制重新整理瀏覽器，然後重新開啟 Network > 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 上，將兩個相符的 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 保持停止，並將上述遮蔽敏感資訊後的證據傳送給支援團隊。

重新安裝並不代表復原成功。安裝後，請確認以下三個條件：

1. /etc/init.d/vilanet status 回報服務正在執行。
2. vilanet status --json 回報預期的連線狀態。
3. 路由器後方的裝置可以載入一般 HTTPS 網站。

關於降級

較舊的套件可能使用不同的設定結構或憑證格式。不要只因為有較舊的資產可用，就將客戶的路由器降級。只有在 VilaVPN 支援團隊確認確切版本組合、路由器架構與回復程序後，才使用較舊版本。

只在必要時移除 VilaNet

移除套件會變更路由器，且可能移除網頁介面，同時留下必須另行處理的敏感設定。若目標是完整解除安裝，請向支援團隊索取該版本專用的移除程序。暫時復原時，停止服務是較安全的做法。

要傳送給支援團隊的內容

請傳送：

• 路由器確切型號與 OpenWrt 版本
• VilaNet 版本
• 套件管理器與架構
• 遮蔽敏感資訊後的狀態與 VilaNet 記錄行
• 停止服務是否恢復網際網路連線
• 上一次成功狀態與第一次失敗狀態的簡短說明

請勿傳送路由器備份、帳號密碼、原始訂閱資料或未經檢查的診斷封存檔。