# 在 Koolshare Merlin 上安裝並連線 VilaNet

本指南適用於 **Koolshare `rogsoft` Broadcom HND** 套件中心韌體的公開 VilaNet 套件，涵蓋從下載套件到讓路由器區域網路內的裝置連線的完整流程。

> **偏好豐富多彩的圖文呈現？** 請開啟[VilaNet Merlin 指南](https://merlin.vilavpn.com/)查看圖解及頁面配置。該網站目前的 CLI 範例與公開的 v1.0.10 套件不一致，因此在網站修正前，請以本頁已驗證的套件及 Web 介面步驟為準。

> **實體路由器驗證仍在等待進行。** VilaNet 1.0.10 的套件、安裝程式規範、網頁介面標籤及公開版本均已檢查，但這套完整程序尚未通過實體 HND 路由器的證據門檻。在完成該門檻前，請保留路由器備份及目前套件的副本。

## 開始前

你需要：

- 一部執行 Koolshare Merlin 或 Koolshare official-mod 韌體，並具有**軟體中心**（`rogsoft`）的路由器。
- 一部屬於受支援 **Broadcom HND** 套件系列的路由器。
- 路由器的管理員存取權限。
- 具有有效服務的 VilaVPN 帳號。
- 一部已連上該路由器的電腦或手機。

此套件**不**支援沒有 Koolshare 軟體中心的一般 Asuswrt-Merlin、原廠 ASUSWRT、舊版 `arm380` 或 `arm384`、QCA、MIPS、MIPSEL 或其他 Merlin 套件系列。若無法同時確認 Koolshare `rogsoft` 及 HND 支援，請勿上傳套件。

### 先備份路由器

1. 開啟路由器管理頁面。
2. 使用韌體的備份或儲存設定功能，下載目前的路由器設定備份。
3. 將備份儲存在路由器以外的位置。
4. 記下在 VilaNet 未執行時如何連上路由器管理頁面。

沒有可用的備份就不要繼續。若路由器上已有舊版 VilaNet 服務，安裝路由器套件時會暫時停止該服務；任何路由器層級的網路變更都可能影響區域網路上的每部裝置。

## 1. 下載目前套件

下載下列檔案，請勿解壓縮：

{% embed url="https://github.com/vilavpn/vilanet-merlin/releases/download/v1.0.10/vilanet-rogsoft-hnd-1.0.10.tar.gz" %}

版本頁面：[VilaNet for Asuswrt-Merlin v1.0.10](https://github.com/vilavpn/vilanet-merlin/releases/tag/v1.0.10)

預期檔名：

```text
vilanet-rogsoft-hnd-1.0.10.tar.gz
```

預期 SHA-256：

```text
019996031e87a99a6e6e95e7d0d3d4a107f844ed2806aba0052a47ff9160503b
```

你也可以下載[已發布的 SHA-256 檔案](https://github.com/vilavpn/vilanet-merlin/releases/download/v1.0.10/vilanet-rogsoft-hnd-1.0.10.sha256)。若裝置上有總和檢查工具，請先將下載的壓縮檔與上述數值比較，再上傳。請勿安裝已重新命名、解壓縮或總和檢查不符的檔案。

## 2. 透過 Koolshare 軟體中心安裝

不同 Koolshare 版本使用的文字略有不同，但安全方式是使用軟體中心的離線套件上傳功能。

1. 保持連上路由器的區域網路。
2. 開啟路由器管理頁面。常見地址為 `http://router.asus.com` 或路由器的區域網路 IP 位址。
3. 以路由器管理員身分登入。
4. 開啟 **Software Center／軟體中心**。
5. 開啟其中的**離線安裝**或手動上傳套件區域。
6. 選取 `vilanet-rogsoft-hnd-1.0.10.tar.gz`。不要先解壓縮該檔案。
7. 選擇軟體中心的上傳及安裝操作。
8. 等待安裝完成。當軟體中心顯示安裝進行中時，請勿重新整理、重新啟動路由器或關閉頁面。
9. 返回軟體中心，確認 **VilaNet** 顯示為已安裝模組。

若缺少必要的 Koolshare 套件中心標記，或路由器不在公開 HND 版本矩陣內，安裝程式會有意拒絕執行。若遭到拒絕，請勿嘗試繞過檢查，也不要使用一般 Merlin 說明安裝該壓縮檔。

## 3. 開啟 VilaNet 並登入

1. 在**軟體中心**中選取 **VilaNet**。
2. 確認 VilaNet 頁面開啟，並顯示下列分頁：**總覽**、**帳號**、**伺服器**、**設定**、**診斷**及**維護**。
3. 開啟**帳號**。
4. 輸入 VilaVPN 帳號的電子郵件地址及密碼。
5. 選取**登入**。
6. 等待帳號狀態確認已登入。在速度較慢的路由器上，登入程序可能會在背景繼續；仍在處理時請勿重複按下**登入**。

密碼欄位供登入操作使用，並不是路由器管理員密碼。絕對不要在螢幕截圖或支援訊息中放入真實密碼。

## 4. 保留自動套件及伺服器選擇

第一次連線時，請使用自動選項並保持路由設定不變。

1. 開啟**伺服器**。
2. 若目錄尚未載入，請選取**重新整理目錄**。
3. 在**套件**下選取**自動選擇套件**。
4. 在**伺服器**下選取**自動選擇伺服器**。
5. 第一次成功連線前，請勿變更**設定**或目前的路由模式。

自動選擇可讓 VilaNet 為帳號選用可用的服務套件及伺服器。第一次連線驗證完成後，如有需要，可返回**伺服器**並選擇特定位置。

## 5. 連線

1. 開啟**總覽**。
2. 選取**連線**。
3. 等待頁面顯示服務正在執行，且連線狀態為**已連線**。
4. 第一次連線啟動時，請勿變更路由模式。

若**連線**無法選取，請返回**帳號**確認登入狀態，再返回**伺服器**並選取**重新整理目錄**。

## 6. 確認區域網路裝置正在使用連線

不要只把按下按鈕當作成功證明。請同時驗證路由器狀態及路由器後方的裝置。

在 VilaNet **總覽**頁面上確認：

- **後端**已準備就緒。
- **帳號**已登入。
- **服務**或**執行中**顯示正在執行的狀態。
- **連線**或**已連線**顯示已連線狀態。
- **上次錯誤**下沒有出現新的錯誤。

接著使用連上同一路由器區域網路的手機或電腦：

1. 關閉該裝置的行動數據或其他 VPN，確保測試只使用路由器的連線。
2. 開啟新的瀏覽器視窗。
3. 確認一般網站可以載入。
4. 使用可信賴的 IP 查詢服務檢查裝置的公用 IP。
5. 與連線前看到的公用 IP 比較。公用 IP 已改變，加上路由器顯示已連線狀態，是最低限度的成功證據。

若只有路由器頁面顯示已連線，但區域網路流量無法運作，請將連線視為未驗證，並依照下方的復原步驟操作。

## 如果安裝或連線失敗

### 安裝後沒有出現 VilaNet

1. 返回**軟體中心**，確認是否顯示 VilaNet 已安裝。
2. 強制重新整理路由器管理頁面，或登出後再登入。
3. 確認路由器確實使用 Koolshare `rogsoft` Broadcom HND 韌體。
4. 確認上傳的檔名及 SHA-256 與本指南相符。
5. 若模組仍未出現，請停止操作。請勿使用一般 shell 安裝程式或停用平台檢查。

### 登入沒有完成

1. 再次嘗試前，請等待處理中的登入程序完成。
2. 確認路由器的日期、時間及 NTP 設定正確；大幅錯誤的時鐘可能會破壞安全連線。
3. 重新輸入一次帳號電子郵件地址及密碼。
4. 若已安裝舊版，請使用目前的 1.0.10 壓縮檔升級。此版本修正了較慢路由器上登入要求可能顯示為 `Failed to fetch` 或 `ERR_EMPTY_RESPONSE` 的問題。

### 路由器顯示已連線，但區域網路裝置無法瀏覽

1. 在**總覽**上選取**中斷連線**。
2. 確認區域網路裝置恢復一般網際網路存取。
3. 將路由模式保留為原始預設值；不要把切換模式當作第一個復原嘗試。
4. 開啟**診斷**並記下可見錯誤，但不要洩露帳號資料、公用 IP、伺服器識別資訊或憑證。
5. 返回**伺服器**，重新整理目錄，並使用**自動選擇套件**及**自動選擇伺服器**重試一次。
6. 若再次失敗，請讓 VilaNet 保持中斷連線，並聯絡支援，提供應用程式版本、路由器型號、韌體名稱及經過遮蔽處理的錯誤說明。

## 安全重設、解除安裝及復原

### 重設 VilaNet 設定

當錯誤的 VilaNet 設定導致無法順利重試時，請使用此方法：

1. 在**總覽**上選取**中斷連線**。
2. 開啟**維護**。
3. 選取**重設 VilaNet 資料**並確認警告。
4. 返回**帳號**並確認帳號狀態。
5. 重複上述自動套件／伺服器選擇及連線步驟。

重設會停止 VilaNet 服務，並清除 VilaNet 連線及路由設定。它無法取代你在安裝前建立的路由器設定備份。

### 解除安裝而不手動刪除檔案

1. 在**總覽**上選取**中斷連線**。
2. 返回 Koolshare **軟體中心**。
3. 找到 **VilaNet**，並使用軟體中心的解除安裝操作。
4. 等待解除安裝完成後，再重新啟動路由器或重新整理頁面。
5. 確認區域網路的一般網際網路存取正常。

正常的套件解除安裝會移除 VilaNet 程式檔案，但保留儲存的帳號及設定，供日後重新安裝使用。若要出售、退回或轉讓路由器，請先在**帳號**分頁使用**登出**，接著使用**重設 VilaNet 資料**，最後才解除安裝 VilaNet。轉讓所有權前，請依路由器製造商的說明還原或將路由器重設為原廠設定。

### 重新安裝目前套件

若 VilaNet 檔案似乎已損壞，但路由器及軟體中心仍可運作：

1. 透過軟體中心中斷連線並解除安裝 VilaNet。
2. 僅在軟體中心或路由器韌體要求時重新啟動路由器。
3. 再次驗證已儲存的 1.0.10 壓縮檔總和檢查。
4. 使用相同的已簽署公開套件，重複離線安裝步驟。
5. 登入，保留**自動選擇套件**、**自動選擇伺服器**及初始路由預設值，然後重新連線並再次完成區域網路驗證。

若解除安裝或復原影響路由器的一般網際網路存取，請停止進行變更，並使用韌體本身的復原程序還原路由器設定備份。

## 發布前仍需補充的證據

此頁面文字已可供審核，但尚未具備可發布的完整證據。在移除實體驗證通知前，VilaVPN 必須在受支援的 HND 路由器上擷取並驗證：

- 軟體中心離線上傳及成功安裝。
- 已安裝模組中顯示版本 1.0.10。
- 使用合成資料或完全遮蔽處理的帳號登入證據。
- **自動選擇套件**及**自動選擇伺服器**選項。
- 不變更預設路由模式的第一次連線。
- 已連線狀態，加上真實區域網路來回傳輸／公用 IP 驗證。
- 中斷連線、重設、解除安裝及完整復原。