v2rayN
首選Desktop 採用新一代跨平台介面,適合初次安裝或需要在不同桌面系統間切換的使用者。WPF 是經典穩定版,適合熟悉傳統選單和系統匣操作的使用者。兩種介面不必同時安裝,也別假設切換後會自動沿用設定。
安裝檔/平台索引
先選擇作業系統,再依處理器架構和安裝檔格式下載。安裝後,使用既有的訂閱網址或節點設定建立連線。
Desktop 採用新一代跨平台介面,適合初次安裝或需要在不同桌面系統間切換的使用者。WPF 是經典穩定版,適合熟悉傳統選單和系統匣操作的使用者。兩種介面不必同時安裝,也別假設切換後會自動沿用設定。
請先將 ZIP 完整解壓縮至本機資料夾,再從解壓縮後的資料夾啟動安裝程式。請勿直接在壓縮檔預覽畫面中點兩下執行程式;預覽工具可能只會將單一檔案解壓縮至暫存資料夾,導致安裝時找不到同一個安裝檔中的其他檔案。
若安裝程式提示缺少執行環境,請記下提示中的元件名稱、版本和架構,再依指示補齊。反覆切換桌面版與 WPF 版無法解決相依套件缺失。若裝置由公司或機構管理,請先確認軟體安裝政策,勿改用其他帳戶規避限制。
已有設定時,請先在舊客戶端記下訂閱群組、本機連接埠和目前的代理模式,備份後再結束系統匣中的程序。新客戶端首次啟動時,先確認連接埠未被占用,再匯入設定,最後啟用系統代理。這樣較容易判斷問題出在設定轉移或本機連接埠衝突。
| 檢查項目 | 適用條件 |
|---|---|
| 系統類型 | 本頁提供的兩個安裝檔皆為 x64,請至「設定 → 系統 → 關於」確認系統類型。 |
| 執行環境 | 請以目前所選版本的安裝提示為準。 |
只看到「64 位元」還不夠,請繼續確認處理器類型。x64 和 ARM64 都是 64 位元,但架構並不相同。
在 Apple 選單中開啟「關於這台 Mac」。若顯示 Apple 晶片,請選 Apple Silicon;若顯示 Intel 處理器,請選 Intel。安裝檔取決於晶片,不受裝置外觀或購買年份影響。
開啟對應的 DMG 檔。若視窗中有「應用程式」捷徑,請將客戶端拖曳至該資料夾,待複製完成後退出磁碟映像,再從「應用程式」啟動。請勿將映像中暫時掛載的副本當成已安裝的應用程式。
若系統提示應用程式不相容,請先確認重新下載的安裝檔符合目前的晶片,再檢查系統版本是否符合該版本需求。若出現安全政策提示,請保留原始提示,並確認來源與裝置政策;選錯晶片和應用程式遭政策封鎖是兩種不同問題。
轉移時請先關閉舊客戶端,再替換應用程式。替換應用程式不代表使用者設定也會清除;若新版本啟動後仍顯示舊訂閱,請先查看客戶端目前使用的設定,勿為了清空清單而直接刪除整個應用程式資料夾。
| 檢查項目 | 適用條件 |
|---|---|
| 晶片 | Apple 晶片適用 arm64,Intel 處理器適用 x64。 |
| 系統與權限 | 須符合該發行版的系統需求,並有權將應用程式複製到目標資料夾。 |
安裝後,先確認客戶端能載入設定,再測試依賴系統代理設定的應用程式。
2015 年後推出的主流手機通常可選 arm64,但仍應以系統支援的應用程式架構為準。若不確定裝置規格,或安裝程式明確提示架構不符,可改試通用版。清單中的版本欄位可能與安裝檔名稱不同;確認安裝結果時,請以系統應用程式資訊顯示的版本為準。
若訂閱明確支援 v2fly,可選用 v2flyNG。能匯入訂閱不代表其中每個節點都能使用。更換客戶端後,請先測試一個已知可用的節點,再決定是否轉移其他設定。
安裝權限是授予開啟 APK 的應用程式,例如瀏覽器或檔案管理員。若個人裝置允許安裝,請只授權目前使用的來源,安裝完成後即可撤銷權限。若系統回報簽章衝突,請先備份舊設定,並優先透過原發佈管道升級;尚未備份前,請勿直接解除安裝舊版本。
若能開啟應用程式但無法建立連線,請檢查系統是否已有其他應用程式持續使用 VPN,或是否拒絕了目前客戶端的 VPN 連線要求。請先在裝置允許的範圍內關閉衝突的連線,再單獨測試一個客戶端,避免將系統 VPN 衝突誤判為 APK 架構問題。
| 檢查項目 | 適用條件 |
|---|---|
| 應用程式架構 | 支援 arm64-v8a 時選擇 arm64;不確定架構時可考慮通用版。 |
| 系統版本 | 須符合 APK 的最低系統需求;請以系統安裝程式提示為準。 |
| 安裝政策 | 系統須允許從目前來源安裝應用程式;工作資料夾可能另有安裝限制。 |
部分裝置的處理器支援 64 位元,但系統只能執行 32 位元應用程式。選擇安裝檔時,請以系統支援的應用程式架構為準。
ARM64 安裝檔: 下載 deb · arm64 下載 rpm · aarch64
請在發行版的系統資訊中查看版本和處理器架構。amd64 與 x86_64 都用來標示 x64;arm64 與 aarch64 通常代表同一類 ARM 64 位元目標。請先確認發行版適用的安裝檔格式,再核對架構,勿因副檔名相同就跨架構安裝。
使用發行版的軟體安裝工具開啟本機安裝檔,查看工具列出的缺少相依套件。此 rpm 檔名中的 el10 是建置目標標記,不代表所有支援 rpm 的發行版都符合相依條件。若工具提示相依套件無法滿足,請先確認發行版版本和軟體來源;勿強制略過相依套件,也不要把變更副檔名當成格式轉換。
安裝成功後,請從桌面工作階段啟動客戶端。部分桌面環境的系統代理設定只會影響讀取該設定的應用程式;若瀏覽器和終端機的結果不同,請先確認各自如何讀取代理設定,再決定是否需要調整客戶端模式。
| 檢查項目 | 適用條件 |
|---|---|
| 安裝檔格式 | Debian、Ubuntu 系通常選 deb;Fedora、RHEL 系通常選 rpm。 |
| 處理器 | 提供 x64 和 ARM64 版本,不能依安裝檔格式推斷架構。 |
| 桌面環境 | 須有可啟動圖形化客戶端的桌面工作階段,且發行版須符合安裝檔的相依套件需求。 |
透過遠端終端機管理的主機,即使能安裝此安裝檔,也不代表目前的終端機工作階段能開啟圖形介面。
全新安裝只需為目前裝置選擇一個安裝檔。升級前則應記下客戶端名稱、系統架構和原安裝來源,並分別備份訂閱與手動設定。訂閱可以重新取得節點,但本機調整過的分流設定、連接埠和代理模式不一定能隨訂閱還原。
若下載後系統將檔案辨識為網頁,請先確認下載是否完成,以及檔案類型是否符合所選的下載項目。請勿只靠手動更改副檔名繼續安裝。下載失敗和安裝失敗的差別很明確:前者是未取得預期格式的檔案,後者才是系統安裝程式回報錯誤。
若要在另一部裝置上準備安裝檔,請依目標裝置的系統和架構選擇。複製安裝檔不會一併轉移客戶端的訂閱設定;若要共用設定,請另選支援的匯入方式,並妥善保管具有存取權限的訂閱網址。
查看客戶端比較首次啟動後,先確認程式能正常開啟,接著匯入訂閱並手動更新。確認清單中出現預期項目後,再選取一個已知可用的節點進行測試。取得訂閱和建立節點連線是兩次不同的請求,其中一次成功不代表另一次也正常。
先用一個可確認代理設定的應用程式進行比對,測試時一次只調整一個選項。系統代理仰賴應用程式讀取系統設定;TUN 則涉及虛擬網路介面、系統權限和套用範圍。首次排查時請勿同時修改模式、DNS 和路由規則,否則很難判斷是哪項設定影響結果。
使用相同的應用程式和目標網址,比較啟用前後的情況。若只有啟用後失敗,請先查看客戶端記錄;若兩種狀態都失敗,請從本機網路開始檢查。回報問題時請保留錯誤訊息和發生步驟,並移除訂閱網址及其他存取憑證。
查看 v2rayN 設定教學不需要。初次安裝可選桌面版;習慣使用 WPF 或已有相關設定的使用者,可繼續使用 WPF。切換前請先備份設定並關閉舊客戶端,避免兩個執行個體同時占用本機代理連接埠。
不行。通用版主要支援更多處理器架構,無法解決系統版本不足、安裝權限受限或應用程式簽章衝突。請先查看系統安裝程式顯示的原因,再決定是否更換安裝檔。
Debian、Ubuntu 系發行版通常使用 deb;Fedora、RHEL 系發行版通常使用 rpm。格式相符後,仍須確認處理器架構和發行版相依套件;檔案能開啟不代表可以安裝。
客戶端安裝檔不包含訂閱或節點。請向服務提供者或網路管理員取得相容的設定,再依照教學匯入。請勿在公開管道分享含有存取憑證的訂閱網址。
先不用重新安裝。請確認客戶端能更新訂閱、已選取節點,並檢查應用程式是否使用預期的代理模式。記下第一則相關錯誤;若暫停代理後仍無法連線,請先檢查系統網路。