v2rayN
首選Desktop 是採用新一代跨平台介面的桌面版,適合初次安裝。WPF 是經典穩定版,適合熟悉 Windows 版介面與系統匣選單的使用者。兩者擇一即可。
桌面平台使用 v2rayN;Android 首選 v2rayNG,也可依核心需求選擇 v2flyNG。先選裝置系統,再確認晶片架構或套件格式。
Desktop 是採用新一代跨平台介面的桌面版,適合初次安裝。WPF 是經典穩定版,適合熟悉 Windows 版介面與系統匣選單的使用者。兩者擇一即可。
| 檢查項目 | 安裝條件 |
|---|---|
| 系統類型 | 在「設定 → 系統 → 關於」確認系統為 64 位元,處理器為 x64。 |
| 安裝檔 | 先將 ZIP 解壓縮至可寫入的資料夾,再開啟安裝程式。 |
| 執行環境 | 若系統版本或執行階段不符合需求,請依安裝程式的提示處理。 |
在系統資訊中同時確認「64 位元作業系統」和「x64 型處理器」。只看到「64 位元」還不夠,不同架構的處理器都可能執行 64 位元系統。確認後,使用檔案總管的「全部解壓縮」解開 ZIP,不要直接在壓縮檔預覽視窗中執行安裝程式。這樣安裝程式讀取套件內的其他檔案時,才不會只取得暫存解壓縮的一個檔案。
從經典 WPF 版切換至桌面版時,先備份節點與訂閱群組,再從系統匣結束舊版,而不是只關閉主視窗。首次啟動新版後,檢查節點清單、路由選擇和本機監聽連接埠。如果客戶端已開啟,但網頁仍無法瀏覽,先確認舊版是否留下系統代理設定,以及代理指向的連接埠是否仍有程式在監聽;不要急著重新安裝或連續更換節點。
從 Apple 選單開啟「關於這台 Mac」。顯示 Apple M 系列晶片時選 Apple Silicon;顯示 Intel 處理器時選 Intel。
| 檢查項目 | 安裝條件 |
|---|---|
| 晶片或處理器 | Apple Silicon 對應 arm64;Intel 對應 x64。 |
| 安裝位置 | 裝置須能掛載 DMG,並有權限將 App 複製到「應用程式」。 |
| 系統版本 | 在「關於這台 Mac」查看目前版本;若 App 提示系統不相容,先確認所下載版本的需求。 |
按兩下 DMG,將 App 複製到「應用程式」,再從該資料夾首次開啟。複製完成後,可在 Finder 中退出磁碟映像檔;映像檔中的圖示和已安裝的 App 並非兩個都要執行的版本。若按兩下後出現不相容提示,先確認晶片架構與系統版本;若提示因裝置管理政策而禁止安裝,請聯絡裝置管理員,不要變更全域安全性設定。
升級時,先從選單列或 App 選單結束舊版,再取代 App。啟動後先在客戶端測試一個節點,再到「系統設定 → 網路」檢查目前網路服務的代理設定。曾切換 Wi-Fi 與有線網路的裝置,請確認目前使用中的服務;只查看未連線的網路服務,無法判斷瀏覽器正在使用哪條連線。
2015 年後的主流手機優先選擇 arm64;不確定系統是否支援 arm64-v8a 時,可選通用版。是否支援此架構取決於裝置系統,不只看處理器型號。
現有設定明確以 V2Fly 為目標時,請選擇 v2flyNG。遷移前先確認節點的傳輸方式與安全設定,兩款 App 的核心功能與設定項目並不完全相同。
| 檢查項目 | 安裝條件 |
|---|---|
| 應用程式架構 | 系統支援 arm64-v8a 時選擇 arm64;不確定時選通用版。 |
| 系統與儲存空間 | 系統須符合所選安裝檔的最低需求,並保留足夠的安裝空間。 |
| 安裝權限 | 用來開啟 APK 的瀏覽器或檔案管理員,必須獲准安裝 App。 |
| 連線權限 | 首次啟動代理連線時,請在系統彈出視窗中確認 VPN 連線要求。 |
在同一個使用者環境中,先中斷其他正在執行的 VPN,再測試新客戶端。
系統顯示「未安裝應用程式」時,先判斷問題是 APK 解析失敗、安裝權限不足,還是嘗試覆蓋現有 App。即使手機處理器支援 64 位元,系統也可能只提供 32 位元 App 環境,此時可改試通用版。若系統明確指出與現有 App 衝突,先確認是否更換了安裝來源;系統通常只允許簽章相符的版本覆蓋安裝。解除安裝可能會清除本機資料,請先備份,再決定是否重新安裝。
首次啟動代理時,請確認系統的 VPN 連線要求。若點選連線後立即中斷,檢查是否有其他 App 正在使用 VPN,以及系統是否為舊 App 開啟「一律開啟 VPN」。若只在螢幕關閉一段時間後中斷,先確認系統電池設定是否限制客戶端在背景執行,再比較同一節點在螢幕開啟與關閉時的狀況。這有助於分辨是 App 被暫停,還是節點本身不穩定。
卡片上的數字是版本清單中的 App 版本欄位,可能與個別安裝檔的檔名不同。處理覆蓋安裝時,請以實際安裝檔及系統「應用程式資訊」中記錄的版本為準;通用版與 arm64 版是架構選項,不代表升級或降級。
Debian、Ubuntu 系統先選 deb;RPM 系發行版先選 rpm。格式正確不代表一定與發行版版本及相依套件相容。
| 檢查項目 | 安裝條件 |
|---|---|
| 桌面環境 | 安裝檔適用於具備圖形桌面工作階段的系統。 |
| 系統架構 | x86_64 對應 x64;aarch64 對應 arm64。 |
| 套件與相依項目 | 依發行版選擇套件格式,再確認圖形安裝程式提示的相依項目與支援範圍。 |
在系統的「關於」頁面確認發行版、版本與系統架構。amd64 和 x86_64 是此處 x64 的對應名稱,不代表安裝檔只適用於某個品牌的處理器。下載後,使用發行版提供的圖形套件安裝程式開啟檔案。若提示缺少相依套件,記下錯誤訊息中的套件名稱與版本,再確認目前的發行版是否提供;不要因為 deb 無法安裝就改試 rpm,反之亦然。
啟動後先測試節點,再確認桌面環境是否接受客戶端寫入的系統代理設定。即使桌面代理設定已變更,部分 App 仍會使用自己的網路設定。若瀏覽器可以連線、另一個 App 卻不行,先確認該 App 是否讀取系統代理;若只有特定類型的流量需要由 TUN 接管,再依安裝文件確認權限與目前路由,不要一律以管理員身分啟動 App。
分別確認安裝、匯入與代理接管是否正常。遇到問題時,先找出哪個步驟尚未完成。
瀏覽器可能還在寫入下載檔案。先開啟瀏覽器的下載記錄,確認下載工作已完成,再前往目標資料夾。若檔案系統隱藏副檔名,可透過「內容」或「顯示簡介」辨別 ZIP、DMG、APK、deb 和 rpm。若出現檔案損毀或無法開啟的提示,先記下錯誤訊息與下載狀態;不要試圖變更副檔名,將一種套件格式改成另一種。
已在使用客戶端時,請備份節點、訂閱群組與自訂路由,並記下目前使用的本機連接埠和代理接管模式。手動新增的節點不一定包含在訂閱中,自訂路由也不會隨訂閱更新自動還原。備份可能含有訂閱網址和節點認證資訊,請存放在自己能控管的資料夾,不要放進公開雲端硬碟、聊天截圖或問題回報中。安裝新版後,先確認這些設定仍可讀取,再清除舊檔案。
初次安裝後清單是空的,屬於正常情況。以 v2rayN 為例,透過「訂閱群組」新增網址,再執行「更新全部訂閱」,確認清單中確實出現節點。接著選擇一個節點,先檢查客戶端記錄是否有連線或交握錯誤,再選擇系統代理或 TUN。排除問題時,別同時開啟多個客戶端,也不要一次變更多項設定;每次只調整一項,再重試同一個網頁,比較容易找出原因。
安裝檔選擇、覆蓋安裝與首次連線。
不需要。初次安裝可選擇採用新一代跨平台介面的桌面版;習慣經典 Windows 介面,或需要沿用相關操作說明,則可選經典 WPF 版。排除連線問題時只執行一個客戶端,避免兩個程式同時變更系統代理設定。
從 Apple 選單開啟「關於這台 Mac」。「晶片」欄顯示 Apple M 系列時選 Apple Silicon;「處理器」欄顯示 Intel 時選 Intel。請依這台 Mac 的實際晶片選擇,不要依購買年份或硬碟容量判斷。
不能。通用版適合不確定裝置應用程式架構的情況;若安裝失敗是因為系統版本過舊、安裝來源權限不足,或與現有應用程式簽章衝突,改用通用版也無法解決。先查看系統提示,再決定是否更換安裝檔。
先依發行版的套件系統選擇 deb 或 rpm,再依目前的系統架構選擇 x64 或 arm64。即使兩者都符合,也要確認安裝程式列出的發行版相容性與相依套件需求。
先備份現有節點、訂閱群組與自訂路由,並另外記下本機監聽連接埠和目前的代理接管模式。升級前先結束舊版;新版啟動後確認節點與路由正常,再啟用系統代理或 TUN。請妥善保管備份與訂閱網址。
安裝檔只包含客戶端,伺服器節點需要另外設定:匯入自己的節點設定,或新增有權使用的訂閱並更新。看到節點後,選擇要使用的項目,再設定代理接管方式並測試連線。