v2rayN
7.24.1Desktop 採用新一代跨平台 UI,適合初次使用,或希望在不同桌面系統維持相近操作體驗的使用者。WPF 是經典穩定版,保留熟悉的 Windows 介面。兩者都是圖形化客戶端,匯入訂閱前不必手動編寫設定。
這兩個下載檔都是 ZIP 壓縮檔。下載完成後請先完整解壓縮,再執行壓縮檔內的安裝程式;不要直接在壓縮軟體的暫存預覽資料夾中執行。
客戶端安裝檔/架構選擇
先依作業系統選客戶端,再依處理器挑選安裝檔。
桌面端使用 v2rayN;Android 建議使用 v2rayNG,需要 v2fly 核心時再選 v2flyNG。先確認裝置,再下載相符的檔案。
同一款客戶端,提供兩種介面。首次安裝建議選 Desktop 桌面版。
Desktop 採用新一代跨平台 UI,適合初次使用,或希望在不同桌面系統維持相近操作體驗的使用者。WPF 是經典穩定版,保留熟悉的 Windows 介面。兩者都是圖形化客戶端,匯入訂閱前不必手動編寫設定。
這兩個下載檔都是 ZIP 壓縮檔。下載完成後請先完整解壓縮,再執行壓縮檔內的安裝程式;不要直接在壓縮軟體的暫存預覽資料夾中執行。
| 檢查項目 | 選擇依據 |
|---|---|
| 系統 | 建議使用仍受維護的 Windows 10 / 11;實際相容性請以安裝程式提示為準。 |
| 架構 | 本頁提供的兩種安裝方式都是 x64,請先在系統的「關於」頁面確認系統類型。 |
| 安裝方式 | 先解壓縮 ZIP,再執行壓縮檔內的安裝程式;若出現執行環境提示,請依指示處理。 |
| 權限 | 一般訂閱操作與 TUN 所需的權限不同;啟用 TUN 時再依提示授權。 |
開啟 v2rayN 後,先新增訂閱網址並執行更新,確認清單中出現節點,再將要使用的節點設為目前項目。訂閱網址和單一節點分享連結是不同內容,請分別使用訂閱管理和剪貼簿匯入功能。若只將網址存入群組卻沒有執行更新,節點清單仍可能是空的。
瀏覽器等遵循系統代理設定的應用程式,可先透過系統代理測試。部分應用程式有獨立的網路設定,不會自動使用系統代理,這時再評估是否啟用 TUN。TUN 涉及虛擬網卡與路由,不要只因網頁無法開啟就同時啟用多種流量接管方式。離開客戶端前清除系統代理,可避免其他應用程式繼續連線到已關閉的本機連接埠。
從 WPF 切換到 Desktop 前,請先備份訂閱、路由和自訂設定。不要讓兩個執行個體同時占用本機監聽連接埠,也別假設不同安裝目錄一定共用同一份設定。完成遷移後,重新確認目前使用的節點、系統代理狀態和開機啟動選項,再決定是否移除舊版。
開啟「關於這台 Mac」,查看處理器是 Apple 晶片還是 Intel。
M 系列晶片請選 Apple Silicon 安裝檔,Intel 處理器請選 x64 安裝檔。建議選擇與硬體相符的版本,不要只依電腦購買年份判斷;外觀相同的裝置也可能搭載不同處理器。
開啟 DMG 後依視窗提示安裝,並從「應用程式」資料夾啟動。請先結束從磁碟映像檔暫時執行的程式,再進行後續設定。
| 檢查項目 | 選擇依據 |
|---|---|
| 晶片 | Apple M 系列選 arm64;Intel 處理器選 x64。 |
| 系統版本 | 請使用仍受維護的 macOS;最低版本依應用程式的實際需求為準。 |
| 安裝格式 | DMG 磁碟映像檔;安裝至「應用程式」資料夾後啟動。 |
| 權限 | 系統代理和 TUN 可能會出現不同的授權提示,請依實際使用的功能逐項確認。 |
若系統在首次開啟時顯示安全性提示,請先確認檔案是從本頁選擇的下載項目取得,再查看系統設定中的「隱私權與安全性」。請針對這次開啟應用程式的要求處理提示,不要關閉整套系統防護。應用程式完全無法啟動,和已啟動但網路不通是兩種不同問題,排查時請分開記錄。
成功開啟後匯入訂閱、執行更新並選擇節點。桌面應用程式是否使用代理,取決於它是否遵循系統設定;瀏覽器中個別設定的代理擴充功能也可能覆蓋系統選項。測試連線時先固定使用一種代理方式,避免系統代理、應用程式自訂代理和其他網路工具同時改變流量路徑。
需要 TUN 時,再依客戶端提示處理權限。若授權失敗,先記下日誌中的具體錯誤,再檢查虛擬網卡是否與現有網路擴充功能衝突。更新客戶端前請結束執行中的程式,並保留原有設定備份;完成替換後檢查選單列狀態與訂閱群組,確認新版本讀取了預期的設定位置。
先選客戶端,再選架構。2015 年後的主流手機通常建議優先選 arm64。
採用 Xray 核心,適合在 Android 上匯入訂閱、選擇節點和設定路由。初次使用建議從這款客戶端開始;協定與傳輸參數仍須和伺服器設定一致。
arm64 安裝檔適用於支援相應應用程式架構的裝置;不確定架構時可選通用版。安裝檔與版本資訊可能依各發布管道的更新時程而不同,請以應用程式內顯示為準。
採用 v2fly 核心,適合作為既有設定依賴該核心時的替代選項。不要只憑分享連結中的協定名稱判斷是否相容,也要確認傳輸、安全性和擴充參數。
兩款 Android 客戶端各自管理應用程式資料。更換客戶端後,需重新匯入設定並確認路由;不要假設另一款應用程式會自動沿用訂閱或連線狀態。
| 檢查項目 | 選擇依據 |
|---|---|
| 應用程式架構 | 主流裝置建議優先選 arm64;舊裝置或架構不明時可試用通用版。 |
| 系統相容性 | 請以 APK 安裝程式的系統需求為準;通用版無法解決系統版本過舊的問題。 |
| 安裝來源 | 請授予用來開啟 APK 的瀏覽器或檔案管理員本次安裝所需的權限。 |
| 連線授權 | 首次連線時需確認系統 VPN 要求;通常同一時間只能執行一項 VPN 服務。 |
下載完成後,從檔案管理員開啟 APK。若系統拒絕安裝,先確認提示是來源權限、系統版本還是架構不相符,不要重複下載同一個安裝檔。2015 年後的主流手機多半適用 arm64,但部分裝置的硬體與系統支援的應用程式架構不完全一致,請以實際安裝情況為準。
匯入訂閱後,先更新並選取有效節點,再點選連線並確認系統 VPN 授權。出現 VPN 圖示只代表流量接管服務已啟動,不表示遠端節點一定可用;還需開啟正常的測試頁面,並配合日誌確認網域解析與連線結果。若有其他 VPN 應用程式正在執行,請先結束後再測試。
若鎖定螢幕後經常斷線,可檢查電池最佳化、背景活動和廠商的自動啟動管理。只針對選用的客戶端調整必要設定,不必一次開放所有背景權限。使用依應用程式代理時,也要確認目標應用程式是否列入代理清單;路由排除和節點故障影響的連線範圍不同。
先確認 deb / rpm 套件體系,再確認 x64 / arm64 處理器架構。
Debian、Ubuntu 等發行版通常選 deb;採用 RPM 套件體系的發行版則選 rpm。格式相符只是第一步,仍需確認發行版版本與相依套件符合此版本的需求。
這裡提供的是桌面環境使用的圖形化客戶端。ARM 桌面裝置請選擇下方較小的 arm64 連結,不要將 amd64 安裝檔當成通用版。
| 檢查項目 | 選擇依據 |
|---|---|
| 桌面環境 | 需要可用的圖形桌面工作階段;系統匣支援情況依桌面環境而異。 |
| 套件格式 | 依發行版採用的套件體系選擇 deb 或 rpm。 |
| 架構 | amd64 / x86_64 對應 x64;aarch64 對應 arm64。 |
| 相依套件與權限 | 由套件管理員檢查相依套件;TUN 需要額外的網路裝置與路由權限。 |
使用圖形化軟體安裝程式開啟下載檔案。若出現相依性錯誤,先確認發行版和套件的目標環境,不要忽略錯誤強行安裝。rpm 檔名中的建置環境資訊,不代表它適用於所有採用 RPM 的系統。安裝程式列出的缺少元件與版本需求,是判斷相容性的直接依據。
首次啟動後匯入訂閱並更新節點,再檢查桌面環境的系統代理設定。Linux 上不同應用程式對系統代理的支援可能不同;圖形瀏覽器、命令列程式和背景服務不一定共用相同的代理設定。若瀏覽器能連線但其他應用程式不行,先確認該應用程式是否使用代理,再考慮調整節點。
啟用 TUN 前,請確認虛擬網路裝置可正常使用,並依客戶端說明授予最低限度的必要權限。若已有容器網路、其他 VPN 或自訂路由,請先保存原有設定。關閉 TUN 後若網路仍異常,請檢查路由與 DNS 是否已恢復,不要以反覆安裝客戶端代替網路狀態排查。
安裝完成後
下載完成只是第一步。依序檢查設定、流量接管方式和實際連線,更容易找出問題所在。
客戶端負責讀取設定、執行核心和管理代理,不會提供可直接使用的節點。訂閱網址應由可信任的設定服務提供者提供;複製時請保留完整內容,避免混入空格、換行或聊天訊息中的標點。
訂閱內容可能包含連線憑證,請勿將完整網址貼到公開討論區。回報問題時只需描述錯誤類型,並隱去伺服器位址、使用者識別資訊和訂閱參數。
查看訂閱匯入方式 →桌面端先使用系統代理,測試會遵循系統設定的應用程式;確實需要接管其他流量時,再設定 TUN。Android 透過系統 VPN 介面接管流量,也可依客戶端設定限定適用的應用程式。
全域路由和 TUN 不是同一個開關。前者決定流量進入客戶端後如何選擇出口,後者決定流量如何進入客戶端;是否直連仍須查看路由規則。
閱讀全平台設定指南 →先選一個節點並維持單一代理模式,再測試目標應用程式。延遲測試成功,只代表該次測試收到回應,不能取代實際網頁瀏覽,也不表示所有網域和應用程式都能正常連線。
遇到問題時,記錄客戶端名稱、系統架構、代理模式和日誌錯誤訊息。每次只調整一項設定,才能判斷影響來自訂閱、節點、DNS,還是應用程式本身的代理設定。
依問題現象查找常見解答 →下載與安裝常見問答
先排除套件格式和架構問題,再處理連線設定。
只安裝客戶端無法建立代理連線,還需要有效的節點設定或訂閱網址。匯入後更新訂閱、選擇節點,再開啟合適的代理模式。客戶端本身不提供訂閱服務。
初次使用建議選 Desktop 桌面版,採用新一代跨平台介面。習慣經典 Windows 介面則可選 WPF 經典穩定版。兩種版本都是 x64 安裝檔,安裝前請確認系統架構;切換版本前先備份設定。
2015 年後的主流手機通常建議優先選 arm64,仍請以裝置實際支援的應用程式架構為準。若不確定架構,或 arm64 安裝檔顯示不相容,可改用通用版;通用版支援較多架構,檔案通常也較大。
使用相同應用程式及設定位置更新,通常會保留原有設定,但安裝方式和跨版本遷移可能影響結果。更新前請使用客戶端的備份或匯出功能保存設定,不要先刪除應用程式資料;更新後檢查訂閱、目前使用的節點和代理模式。
先確認下載完成,再檢查檔案格式、處理器架構和系統版本是否相符。Windows ZIP 檔需先解壓縮;Android 需允許目前的安裝來源;macOS 請查看「隱私權與安全性」提示;Linux 則在軟體套件管理員中查看相依性錯誤。請勿為了解決安裝問題而關閉整套系統防護。