Windows
v2rayN 提供桌面版與經典 WPF 版。前者採用跨平台介面，後者適合習慣傳統視窗操作的使用者。先依執行環境選擇版本，再匯入設定；遇到連線問題時，不必反覆更換介面版本。
前往下載DOWNLOAD / 依裝置選擇
V2Ray 用戶端下載
先選擇作業系統，再確認處理器架構。桌面使用 v2rayN，Android 優先考慮 v2rayNG；需要 V2Fly 核心設定時，再選擇 v2flyNG。
macOS
選擇 v2rayN 時，先在「關於這台 Mac」確認晶片型號。Apple Silicon 與 Intel 必須使用不同架構的安裝檔。安裝應用程式後，還要確認系統代理設定；開啟視窗不代表瀏覽器已使用代理。
前往下載Android
v2rayNG 使用 Xray 核心，v2flyNG 則是 V2Fly 核心的替代選項。多數新款裝置適用 arm64；不確定架構時，請參閱通用版說明。首次連線需要授予系統 VPN 權限，背景連線也可能受到電池最佳化設定影響。
前往下載Linux
v2rayN 依 Linux 發行版提供 deb 與 rpm 安裝檔，並區分處理器架構。安裝前請確認系統使用的套件格式；啟動後，分別檢查桌面環境代理與應用程式本身的代理設定，不同程式可能讀取不同的網路設定。
前往下載CONFIGURATION / 核心設定
訂閱、路由與核心設定
連線狀況取決於多個環節：設定來源、流量路徑、核心能否辨識參數，以及應用程式是否確實使用代理。依序檢查以下四項，比一次改動多個開關更容易找出問題。
ROUTING
路由分流：先確認流量去向，再檢查規則
路由會決定連線透過代理、直接連線或遭到封鎖。v2rayN 的路由設定與系統代理是兩項不同功能：系統代理會將相容應用程式的連線交給用戶端，再由路由決定這些連線的出口方式。剛開始可選擇符合需求的預設模式，確認網頁正常後，再新增特定網域或位址規則。
排查特定網站時，先確認網域是否符合預期規則，再檢查規則順序與 DNS 解析。不要只因為顯示「已連線」，就認定所有流量都會經過代理，也不要直接套用其他用戶端的規則檔。桌面用戶端與 Android 用戶端的設定入口不同，代理涵蓋範圍也可能受個別應用程式設定影響。詳細檢查順序請參閱v2rayN 設定教學。
SUBSCRIPTION
匯入訂閱：分組儲存，按需更新
訂閱網址用來取得一組伺服器設定，單一分享連結通常只包含一筆設定。匯入前先確認內容類型，再到訂閱群組填入網址並更新；若取得的是單一伺服器連結，則使用從剪貼簿匯入等相應功能。匯入後仍須選取伺服器，並設為作用中伺服器。
更新失敗時，先分辨是網址無法連線、回傳內容為空，還是格式無法解析，不要直接刪除整個群組。保留原本可用的設定，確認網址是否完整、存取條件是否變更，再嘗試更新。訂閱網址可能包含存取憑證，分享截圖或記錄前請先遮蔽。若要進一步排查，請參閱訂閱失敗排查，不要以反覆重新安裝應用程式取代參數檢查。
CORE
Xray 與 V2Fly：依設定選擇核心
核心負責實際處理協定與連線，圖形用戶端則負責呈現設定及管理組態。Xray 與 V2Fly 同屬 Project V 相關開源生態，但功能與設定語法並不完全相同。使用 REALITY 或 XTLS Vision 時，請確認所選用戶端及核心支援相關功能，不能只看伺服器設定是否成功匯入。
v2rayN 支援的核心功能，須以所選版本與設定為準；Android 端可先區分使用 Xray 的 v2rayNG，以及使用 V2Fly 的 v2flyNG。移轉時請逐項確認流量控制、傳輸層安全性、伺服器名稱及其他必要參數，別把兩條分支單純視為新舊版本。下方可切換查看兩類設定的檢查重點。
REALITY 設定重點：確認公鑰、伺服器名稱、短 ID，以及服務端要求的指紋。若使用 Vision，流量控制也必須與服務端一致。安全性模式不是可任意替換的外觀選項。
設定相容性重點：依 V2Fly 支援的功能填寫協定、傳輸方式與 TLS 參數。移轉含有 Xray 專用欄位的設定時，請先確認是否支援；成功匯入不代表一定能正常執行。
LAN
區域網路分享：位址、連接埠與防火牆
同一區域網路中的其他裝置，可透過主機的代理監聽連接埠使用代理。先在 v2rayN 確認監聽設定，再視需要開啟「允許來自區域網路的連線」。其他裝置須填入主機的區域網路位址與實際監聽連接埠，不能填自己的回送位址。主機進入休眠、位址變更或遭防火牆封鎖，都可能造成連線中斷。
僅應在可信任的網路中開啟分享，並將防火牆允許範圍限制在必要的網路或裝置。系統代理不會自動轉送所有網路連線方式，電視、手機與其他電腦也都需要各自設定。若只在本機使用，請保持區域網路連線功能關閉。完整步驟請參閱v2rayN 允許區域網路連線說明，先確認本機可以連線，再排查裝置之間是否互通。
QUICKSTART / 三步上手
v2rayN 使用教學預覽
先完成一筆設定的連線測試，再調整分流與背景執行策略。桌面與 Android 的操作入口不同，但「準備設定、選擇伺服器、確認流量路徑」的順序相同。
-
匯入訂閱或伺服器連結
開啟用戶端，確認服務提供者提供的是訂閱網址、分享連結還是手動參數。訂閱網址要新增至訂閱群組並更新，分享連結則使用相應的匯入功能；手動設定則逐項填入協定、位址、連接埠與識別參數。清單出現項目後，請確認協定與傳輸方式符合原始說明，勿複製教學視窗中的範例值。
更新訂閱與更新用戶端是不同操作。前者會更新伺服器清單，後者則會取代應用程式。若訂閱更新失敗，請先保留現有項目，檢查網址與網路存取條件，不必先清除所有設定。
-
選取作用中伺服器與代理範圍
在清單中選取一筆設定，並設為作用中伺服器。桌面端請檢查系統代理模式，再選擇合適的路由預設；Android 端啟動連線時，請確認已授予系統 VPN 權限，並檢查是否啟用個別應用程式代理。若某個應用程式未納入代理範圍，就不能用它的連線結果判斷伺服器是否正常。
初次設定時，盡量只執行一個會接管系統網路的用戶端。多個代理工具同時修改系統設定，可能導致瀏覽器仍連到舊連接埠。切換應用程式後請重新確認代理位址，不要只看工作列上是否有圖示。
-
測試連線，再依症狀排查
啟動連線後，請使用確定納入代理範圍的應用程式瀏覽測試頁面，同時查看用戶端記錄。伺服器成功連線、網域成功解析與網頁成功載入是不同的檢查項目；一次連線測試成功，不代表所有應用程式都設定正確。建議分別測試平常直接連線的網站與預期經過代理的網站，確認分流符合需求。
遇到逾時，先檢查本機網路與伺服器參數；若只有瀏覽器無法連線，先檢查系統代理與瀏覽器設定；若鎖定螢幕後斷線，再檢查背景執行限制。記下每次修改的項目，一次只調整一處，才能判斷哪一步確實有效。
OPEN SOURCE / 用戶端與核心
Project V、V2Fly 與 Xray 生態
了解用戶端與核心各自負責的工作，有助於判斷安裝檔、設定與教學是否適用。名稱相近不代表功能完全相同，支援的協定也須依實際版本確認。
圖形介面管理設定，核心負責連線
Project V 是由網路代理工具與相關技術組成的開源生態。V2Ray 是其中常見的核心專案名稱，V2Fly 社群延續相關專案的開發與維護。Xray 則以相關程式碼為基礎，發展為獨立的核心分支，並形成自己的功能演進方向。兩條路線共用部分概念，但設定欄位、傳輸能力與更新週期並不總是一致。
v2rayN、v2rayNG 與 v2flyNG 都是提供使用者操作的圖形用戶端。它們將伺服器清單、訂閱、路由與執行狀態整合在介面中，再交由相應核心處理流量。因此，用戶端名稱、應用程式版本與核心能力應分開判斷：介面上看得到某個協定名稱，不代表所有組合的附加參數都能使用；伺服器設定也必須與服務端一致。
開源代表相關專案的程式碼與授權條件可供查閱、討論及改進。重用或散布時仍須遵守各專案的授權條款，用戶端與內含元件也可能適用不同授權。日常使用時，更實際的做法是留意應用程式說明、核心變更與設定相容性，而不是只憑「開源」兩字就認定任何設定都適用。
v2rayN：桌面設定管理
開源桌面用戶端，支援伺服器管理、訂閱群組、路由與系統代理設定。桌面版與 WPF 版的主要差異在於介面技術、平台支援與執行環境。選擇版本時應考量作業系統與使用習慣，連線能力則取決於所用核心及實際設定。
v2rayNG：Android 與 Xray 核心
適用於 Android 裝置的開源用戶端，透過系統 VpnService 接管選定應用程式的流量。其運作方式不同於桌面系統代理；首次授權、個別應用程式的代理範圍與背景電池管理，都是使用時須留意的項目。需要 Xray 相關功能時，請確認用戶端核心與服務端參數。
v2flyNG：V2Fly 核心替代選項
適用於 Android 裝置的開源用戶端，適合需要 V2Fly 核心設定的情境。選擇時應以設定相容性為準，不要因為名稱相近，就把兩款 Android 用戶端視為完全相同的替代品。移轉前請保留原有設定，再確認協定、傳輸方式與安全性設定是否受到支援。
FIELD NOTES / 使用心得
用戶端設定與排查文章
完成基本連線後，可接著設定區域網路分享、選擇桌面版本與調整 Android 背景執行。每篇文章聚焦一項實際設定，方便依目前遇到的問題查閱。
v2rayN 允許區域網路連線：與手機、電視及其他電腦共用代理
開啟「允許來自區域網路的連線」後，如何在其他裝置填入主機 IP 與連接埠，以及防火牆放行設定和常見連線問題的排查方法。
閱讀分享設定 →v2rayN 版本怎麼選：Avalonia 跨平台桌面版與 Windows WPF 版比較
比較 Avalonia 跨平台版與 Windows 專用 WPF 版在介面、系統整合及執行環境上的差異，依作業系統與使用習慣選擇安裝檔。
閱讀版本選擇指南 →v2rayNG 耗電量高怎麼辦：背景常駐、電池最佳化與連線策略排查
依系統電池用量統計找出耗電來源，了解背景常駐與電池最佳化的取捨，再檢查連線策略及喚醒頻率，避免盲目關閉所有限制。
閱讀耗電問題排查 →