v2rayN
桌面版採用跨平台介面，經典 WPF 版則保留熟悉的視窗配置。先在系統設定中確認處理器類型，再閱讀安裝說明；切換兩種介面前，請先備份訂閱群組和自訂路由，以免把介面差異誤認為連線故障。
前往下載 →依作業系統選擇安裝檔
先確認作業系統和處理器架構，再選擇客戶端。安裝檔集中在下載頁，首頁則提供選擇建議與設定指引。
桌面版採用跨平台介面，經典 WPF 版則保留熟悉的視窗配置。先在系統設定中確認處理器類型，再閱讀安裝說明；切換兩種介面前，請先備份訂閱群組和自訂路由，以免把介面差異誤認為連線故障。
前往下載 →在「關於這台 Mac」查看晶片名稱，Apple Silicon 和 Intel 請使用各自的安裝檔。首次啟動若出現系統提示，先確認下載來源並閱讀提示內容；安裝完成後，檢查網路代理是否指向客戶端目前使用的本機連接埠。
前往下載 →建議先了解採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時，再考慮 v2flyNG。多數較新的 Android 手機可選 arm64；若不確定架構，請查看通用版說明。首次連線時，確認已授予系統 VPN 權限，並檢查是否有其他應用程式占用 VPN 通道。
前往下載 →Ubuntu、Debian 桌面版通常選擇 deb，Fedora 等發行版通常選擇 rpm，並確認架構是 x64 還是 arm64。圖形客戶端適合桌面環境；終端程式是否使用代理取決於自身設定，不能只看桌面系統代理的開關。
前往下載 →客戶端負責讀取設定、呼叫核心及管理本機代理，安裝後不會自動建立可用的遠端連線。請準備由可信來源提供的訂閱網址或單筆設定，確認使用權限與有效期限，再依教學匯入。訂閱連結可能含有存取憑證，請勿放進公開截圖，也不要提交至來源不明的線上轉換頁面。若確實需要轉換 V2Ray 訂閱，請先確認目標客戶端支援的格式，並優先使用設定提供者明確支援的匯出方式。
初次設定建議只啟動一個客戶端，保留預設監聽連接埠，暫時不要同時使用瀏覽器代理擴充功能或其他接管網路的工具。先確認訂閱可匯入、核心可啟動，再啟用系統代理；基本連線正常後，才調整分流與 TUN。每次只變更一個環節，發生異常時才能確認要回復哪項設定，不必同時猜測節點、DNS 和權限是否都有問題。
依設定項目了解連線流程
介面名稱可能因平台和版本而異。先了解設定的用途，再對照客戶端中的相應選項，不要把桌面版選單直接套用到 Android 版。
節點清單空白或更新後沒有變化時，先開啟「訂閱群組設定」，檢查網址是否完整、群組是否已啟用，以及訂閱是否仍有效。依來源分組，更新時較不容易混淆不同設定。若目前連線無法使用，可嘗試「更新訂閱（不透過代理）」；若網址只能透過特定網路路徑存取，則應選用相應通道。更新成功後，再檢查實際匯入的內容；請勿將請求完成視為節點已可連線。相較於逐筆手動維護，群組更方便統一更新，但無法自動修復失效網址。
查看教學 →同一個節點能存取部分網站，卻在其他網站逾時時，先確認目標網域符合哪條路由規則。規則通常依序比對，範圍較大的規則可能先攔截請求。「IPIfNonMatch」表示網域規則未符合時，再解析目標位址並嘗試比對 IP 規則，並不代表所有請求都會先解析。先使用容易理解的預設設定，再新增少量自訂規則；每次修改後，都用同一個目標重新測試。路由負責決定流量出口，不能取代節點連線檢查，也無法修復遠端驗證錯誤。
查看教學 →IPIfNonMatch系統代理只會影響會讀取系統代理設定的應用程式，不代表所有程式都會經過客戶端。「自動設定系統代理」會寫入本機代理位址；「清除系統代理」會移除相關設定；「不變更系統代理」則會保留現有設定。TUN 透過虛擬網路介面接管流量，通常也涉及權限、路由和 DNS。先確認一般代理連線正常，再決定是否啟用 TUN；不要一開始就同時開啟多種接管方式。終端機、瀏覽器擴充功能和 Android VPN 各有自己的設定入口，請分別確認實際請求路徑。
查看教學 →圖形客戶端與核心負責不同工作：前者管理設定，後者處理協定和網路連線。v2rayN 可在支援的設定情境中呼叫 Xray 或 sing-box，但實際選項與支援範圍依版本和平台而異。遇到不支援的傳輸方式或參數提示時，先記錄日誌中的錯誤，再確認設定需求，不要反覆切換核心。Android 端也要分清採用 Xray 的 v2rayNG，以及採用 V2Fly 的 v2flyNG。切換核心只可能解決相應的相容性問題，無法讓過期訂閱或錯誤憑證恢復有效。
查看教學 →Project V · V2Fly · Xray
分開了解客戶端、核心、協定和訂閱。下載圖形介面只是第一步，能否連線仍取決於設定與網路環境。
V2Ray 源自 Project V 生態系，核心概念是透過設定組合入站、出站和路由，讓應用程式請求依明確路徑處理。V2Fly 延續維護 V2Ray 相關核心；Xray 則以相關程式碼為基礎，發展出自己的實作與功能。兩者雖有歷史淵源，但不代表所有參數、協定擴充和設定檔都能直接互通。
協定名稱描述通訊規範，核心負責實作協定，圖形客戶端則將常用操作整理成選單。看到 VMess、VLESS、Trojan 或 REALITY 等名稱時，先確認設定需求與核心支援情況；不要只因客戶端名稱相似就直接匯入使用。傳輸方式、TLS 參數與伺服器端設定必須相互對應，只修改其中一端通常無法解決相容性問題。
排除問題時，記錄「使用哪個客戶端、哪個核心、什麼連線方式、在哪個步驟失敗」，比籠統地說「V2Ray 不能用」更有幫助。日誌中的啟動失敗與請求逾時屬於不同層級：前者應先檢查設定和監聽狀態，後者再檢查遠端伺服器、DNS 解析和流量出口。
v2rayN 適用於桌面環境，集中提供伺服器清單、訂閱群組、系統代理和路由管理。v2rayNG 適用於 Android 裝置，採用 Xray 核心，並透過系統 VPN 介面承接應用程式流量。v2flyNG 同樣適用於 Android，採用 V2Fly 核心，適合明確需要相應核心行為或相容範圍的情境。三者都是開源客戶端，但並非同一個程式換上不同介面。
桌面電腦和手機可以使用同一來源提供的相容設定，但本機代理連接埠、背景執行方式和權限需求各不相同。桌面版的「自動設定系統代理」不能取代 Android VPN 權限授權；Android 的連線按鈕也不等同於桌面版的所有網路設定。移轉時先匯入設定，再依目標裝置重新確認連線方式。
本站整理下載入口和中文操作說明，並非這些專案的官方開發網站。搜尋「v2rayN 官方網站」或「v2rayNG 官方網站」時，請進一步辨別網站身分、軟體專案和設定提供者；三者承擔的責任並不相同。
開源代表軟體程式碼依相應授權條款公開；使用、修改和再散布時，應遵循各專案的授權規定。客戶端、核心及附加元件可能採用不同授權；若要再次散布，應分別閱讀授權說明，不能只用「開源」兩字代替授權判斷。一般使用者也應分清軟體免費與遠端服務可能收費是兩回事。
訂閱通常包含一組連線設定，可能含有伺服器位址、使用者識別資料和驗證資訊。公開問題截圖時，請遮蔽訂閱網址和敏感參數，只保留錯誤類型、選單位置及必要的環境資訊。不要為了讓他人重現故障而公開完整訂閱；經過去識別處理的日誌與操作步驟，通常更有助於找出問題。
設定能匯入，不代表服務仍有效，也不代表所有應用程式都已透過代理連線。確認來源、相容性和使用權限後，再以實際連線驗證。遇到憑證錯誤時，先檢查系統時間、目標名稱與設定是否相符，不要把停用安全檢查當成通用解法。
圖形客戶端、核心和規則資料可能分開更新。選單新增一個選項，不代表所有舊設定都必須同步修改；協定支援變動也可能來自核心，而非介面。更新前記錄目前可正常運作的狀態，備份訂閱群組、自訂規則和必要設定，再閱讀與所用平台相關的版本更新說明。
更新後先測試最基本的設定：啟動客戶端，確認核心正常執行，再用已知可用的設定連線至固定目標。基本連線確認正常後，再恢復自訂路由、TUN 和背景啟動設定。若問題只在更新後出現，請保留具體錯誤和觸發步驟；不要同時刪除設定、替換核心和重設網路，以免無法判斷原因。
處理訂閱更新失敗時，先檢查網址和請求通道；處理網頁無法開啟時，先確認客戶端是否正在監聽、應用程式是否使用代理；網速變慢時，再比較網路狀況與遠端負載。依照從入口到出口的順序檢查，比反覆重新安裝更容易保留有效線索。複雜情況可接著參閱疑難排解手冊。
先確認清單中有可用的設定，且已選取目前使用的伺服器，再查看核心啟動日誌。核心正常啟動後，檢查「自動設定系統代理」，並確認瀏覽器是否受到擴充功能影響。若只有一個應用程式無法連線，應先檢查該應用程式的代理設定，不要立刻更換所有節點。請依設定教學進一步完成連線測試。
先確認是什麼程序占用連接埠，不要直接結束不明的系統程序。檢查是否重複啟動客戶端，或其他代理程式正在使用相同連接埠。若確實需要修改「本機混合監聽連接埠」，請記下新值、重新啟動服務，並同步更新手動設定的瀏覽器和應用程式代理。介面變更設定後，已寫入的舊連接埠不會自動全部清除，詳見疑難排解。
先關閉 TUN，確認一般代理模式是否正常。若一般模式可用，再分別檢查 TUN 所需權限、虛擬介面，以及其他網路工具是否造成衝突。保留目前 DNS 和路由設定的紀錄，每次只調整一項並重新測試。若關閉客戶端後仍無法連線，也要檢查是否殘留系統代理設定，詳見疑難排解手冊。
更新訂閱是向網址請求設定；連線至節點則是使用設定存取遠端伺服器，兩者可能使用不同的網路路徑。先確認訂閱網址有效且格式受支援，再比較透過代理與不透過代理的更新方式。現有節點逾時不一定會影響直接更新；訂閱更新成功也不代表遠端服務可用。其他症狀可在疑難排解中查找。
使用心得
依照具體症狀查找操作說明。先找出故障環節，再調整相應設定，並保留每一步修改前後的結果。
適用於 Ubuntu、Debian、Fedora 桌面使用者，說明 deb 與 rpm 套件的安裝指令、相依性問題處理、桌面捷徑與開機自動啟動設定。先確認發行版和處理器架構，再區分安裝失敗、介面無法啟動和代理未接管三種狀況。
閱讀安裝步驟 →整理訂閱網址失效、格式無法辨識、更新請求使用錯誤通道等常見原因，並說明如何設定訂閱群組的自動更新間隔與「不透過代理更新」。先判斷請求是否送達，再檢查回傳內容，避免將錯誤頁面誤認為有效訂閱。
閱讀更新故障排除 →已啟用自動設定系統代理，網頁仍無法開啟時，可分別檢查瀏覽器擴充功能、系統設定和終端機環境變數。先確認本機監聽仍在運作，再核對應用程式實際使用的位址與連接埠；瀏覽器可連線，不代表終端機也能連線。
閱讀代理故障排除 →