Windows
v2rayN在下載中心選擇桌面版或經典 WPF 版。桌面版採用新一代跨平台介面，WPF 版則保留經典桌面操作方式。兩者都應先確認系統與執行環境需求，不要只憑檔案大小判斷是否適用。
安裝後先開啟主視窗，檢查記錄中是否有核心啟動錯誤，再匯入訂閱。已有設定的使用者，請先備份訂閱群組與自訂路由，避免遷移時只複製程式檔案，卻漏掉實際設定。
匯入訂閱
至連線生效
依設定階段查看各項選項。先確認一個節點能正常送出實際請求，再逐步加入分流、流量接管與核心選項。
儲存網址，依群組更新
開啟訂閱群組設定，為來源填寫別名，將完整訂閱網址貼到選填網址 Url，並保持啟用。儲存後執行更新訂閱，伺服器才會出現在清單中；只儲存網址不代表已匯入。不同來源分別建立群組，方便篩選、更新及找出失效網址。首次設定時，先讓篩選（正規表示式）和 User-Agent 留空，避免篩選條件隱藏節點。依來源說明設定自動更新間隔；更新失敗時，再分別嘗試透過代理與不透過代理的請求路徑。
查看詳細說明分辨連接埠探測與實際請求
更新訂閱後，先選取候選伺服器，再執行真實連線延遲測試。TCPing 主要反映與目標連接埠的連線狀況，無法取代協定交握與實際連線；真實連線延遲會透過代理連線向測試網址送出請求，更適合用來評估首次連線。測試結果仍會受測試目標、目前網路及伺服器負載影響，不宜只依單次數值排序。選定節點後，將它設為使用中的伺服器，再開啟目標應用程式確認。若測試失敗，先查看記錄中的交握或解析錯誤，不要直接啟用更多代理選項。
查看詳細說明依規則選擇輸出路徑
路由分流決定送入核心的請求要走 direct、proxy 或其他已定義的輸出路徑，但不會自動將應用程式流量導入客戶端。先確認系統代理或 TUN 已生效，再檢查規則是否命中。規則通常依序比對，應將區域網路等明確例外放在前面，避免寬泛條件提早攔截請求。網域策略 AsIs、IPIfNonMatch、IPOnDemand 會影響網域解析參與比對的時機，應依規則類型選擇。修改後分別造訪直連與代理目標，並查看記錄確認路徑。
查看詳細說明先選擇流量接管方式，再設定分流
系統代理會修改作業系統的代理設定，適合使用系統代理的瀏覽器和應用程式；自行管理連線的程式可能不會使用這項設定。TUN 透過虛擬網路介面接管流量，涵蓋方式不同，也涉及權限、路由與 DNS 設定。初次使用建議先設定系統代理，確認節點可用後再考慮 TUN；不要預設同時開啟兩種功能來排除問題。切換方式前先記下原設定，結束使用時確認代理設定已清除。若瀏覽器正常、其他應用程式卻無法連線，先確認該應用程式採用的代理路徑。
查看詳細說明依協定支援能力選擇核心
圖形客戶端負責管理設定，核心則負責處理協定、傳輸與路由。訂閱能成功解析，不代表目前的核心一定支援其中所有參數。涉及 VLESS、XTLS Vision 與 REALITY 的設定，應確認 Xray 是否支援；其他設定也須以實際核心能力為準。切換核心前，先備份訂閱與自訂路由；切換後重新測試使用中的伺服器，並查看啟動記錄。不要直接將其他核心的欄位複製到現有設定，也不要只憑介面外觀判斷兩款客戶端的功能是否相同。
查看詳細說明客戶端下載入口
依作業系統選擇安裝格式
桌面端選擇 v2rayN，行動裝置可先查看 v2rayNG。先確認處理器架構，再選擇安裝檔；訂閱網址與安裝套件是不同內容，安裝客戶端不會自動取得可用節點。
macOS
v2rayN依「關於這台 Mac」顯示的晶片選擇 Apple Silicon 或 Intel 安裝入口。晶片類型決定所需架構，不能以裝置外觀或購買年份代替判斷。安裝後依系統提示完成首次開啟與權限確認。
先透過系統代理確認瀏覽器能連線，再評估是否需要 TUN。若出現系統安全性提示，請確認應用程式來源與提示內容；不要為了啟動程式而全面關閉系統安全防護。
Android
優先選擇 v2rayNG優先選用採用 Xray 核心的 v2rayNG；需要 V2Fly 核心設定時，再考慮 v2flyNG。較新的主流裝置通常選擇 arm64；無法確認處理器架構時，請查看通用版下載入口與裝置系統資訊。
匯入訂閱後更新伺服器清單，啟動連線時確認已授權系統 VPN。其他使用相同 VPN 通道的應用程式可能會影響啟動；若連線在背景中斷，接著檢查省電設定與背景執行權限，不必反覆重新匯入訂閱。
Linux
v2rayN依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。使用圖形套件安裝程式完成安裝後，從桌面應用程式選單啟動，先確認介面、核心與設定目錄都能正常使用。
桌面環境的系統代理設定可能與應用程式本身的設定分開生效。若瀏覽器能用、其他程式卻無法連線，先確認程式是否讀取桌面代理；需要使用 TUN 時，再依文件檢查權限與路由，避免同時執行多個流量接管工具。
下載中心整理了安裝格式與系統需求。不確定該如何選擇時，先閱讀客戶端比較，確認所需核心與平台，再回到對應下載入口。
查看所有客戶端快速入門
匯入、測試、確認
將設定分成三個檢查點，每完成一步再繼續。發生問題時，就能分辨是訂閱請求、節點連線，還是應用程式代理環節出錯，避免在多項設定間反覆試錯。
-
建立訂閱群組並更新
準備可用的訂閱網址，確認複製的內容從協定開頭開始，且沒有漏掉查詢參數。開啟訂閱群組設定，填入方便辨識的別名與選填網址 Url，儲存後選擇更新訂閱。首次更新可先嘗試不透過代理；若目前網路無法連線至訂閱來源，且已有可用代理，再嘗試透過代理更新。
更新完成後，依訂閱群組篩選伺服器清單，確認新項目來自正確來源。清單為空時，先檢查啟用狀態、篩選（正規表示式）與更新記錄，不要急著修改協定欄位。訂閱網址可能包含存取憑證，公開截圖時請遮住完整網址；更換裝置時，請透過可信任的方式轉移。
-
測試節點並設為使用中的伺服器
選取少數候選項目執行真實連線延遲測試，確認是否能完成實際請求。TCPing 成功但真實連線延遲測試失敗，代表還需要檢查協定交握、憑證及目標連線狀況等環節，不能因此直接判定節點可用。先保持測試條件一致再比較候選項目，避免混用不同測試方式的結果。
將能正常完成請求的項目設為使用中的伺服器，並開啟記錄檢查核心狀態。若連接埠遭占用，先找出是否有其他代理程式同時執行；若出現 TLS 或設定解析錯誤，請依記錄中的關鍵字核對相關設定。每次只調整一項，調整後重新測試，才能判斷是哪項變更造成影響。
-
設定代理並確認實際對外 IP
桌面端先選擇自動設定系統代理，再使用遵循系統代理的瀏覽器送出請求。確認是否恢復連線後，透過可信任的對外 IP 查詢服務確認目前的請求路徑。啟用分流時，直連網站與代理網站可能顯示不同的對外 IP；應依目標命中的規則判斷，不必要求所有網站都走相同路徑。
如果瀏覽器仍使用原本的對外 IP，請檢查瀏覽器自身的代理設定、擴充功能與既有連線，再確認系統代理網址及客戶端監聽連接埠。若要讓不讀取系統代理的程式也透過代理連線，請接著閱讀 TUN 設定。測試結束後正常關閉客戶端，並確認系統代理已還原，避免留下指向已關閉連接埠的設定。
Project V · V2Fly · Xray
分辨客戶端與代理核心
先了解各層的職責，再判斷更新或更換客戶端能否解決問題。圖形介面、核心、訂閱來源與遠端伺服器都會影響連線結果，任何單一環節都無法取代其他環節。
訂閱網址圖形客戶端代理核心遠端伺服器
從 Project V 認識生態系
Project V 是以網路代理工具為核心的專案生態系，V2Ray 是其中重要的實作。日常搜尋中提到的「V2Ray 客戶端」，經常泛指一系列圖形工具，但客戶端名稱不等於核心名稱。介面中的訂閱群組、系統匣選單與伺服器清單屬於設定管理層；實際建立連線、處理傳輸與執行路由的則是核心。
因此，下載客戶端只是準備工作的第一步。還需要合法取得可用設定，確認遠端服務參數與本機核心相符，並選擇適合應用程式的流量接入方式。介面能正常開啟，不代表已能連上遠端伺服器。
分別確認 V2Fly 與 Xray
V2Fly 延續 V2Ray 的社群維護；Xray 則是以相關技術為基礎發展出的另一個核心分支。兩者有部分概念相同，但協定、傳輸與設定欄位的發展並不完全一致。使用 XTLS Vision 與 REALITY 等功能時，應依照 Xray 的實際實作確認設定，不能只看訂閱中是否出現 VLESS 字樣。
閱讀教學時，也要記下客戶端、核心與傳輸方式。某個欄位在其中一個分支有效，不代表換到另一個分支後仍可直接使用。遇到未知欄位或不支援的協定錯誤時，優先確認支援範圍，再考慮調整設定。
依使用情境選擇圖形客戶端
v2rayN 是開源桌面圖形客戶端，提供訂閱管理、節點測試與路由設定等操作功能，桌面平台可優先從它開始。v2rayNG 適用於 Android，使用 Xray 核心；v2flyNG 同樣適用於 Android，採用 V2Fly 核心，只有在設定確實需要時才考慮使用。三者名稱相近，但並不是同一個應用程式的不同介面主題。
客戶端與核心各自有專案授權，可在應用程式隨附的授權與關於資訊中查看。開源描述的是程式碼與授權方式，不代表客戶端提供訂閱服務，也不能取代對訂閱來源、伺服器權限與網路環境的確認。
分清客戶端更新與訂閱更新
更新訂閱是從既有來源取得伺服器設定；更新客戶端則會改變介面、核心整合方式或設定處理方式。前者可能新增、替換或移除節點；後者可能改變欄位支援情況。遇到問題時，先確認是哪個環節發生變化，不要把所有問題都歸咎於「需要重新安裝」。
升級前先備份訂閱網址、自訂路由與必要設定，並閱讀應用程式的更新說明。升級後先用熟悉的節點完成真實連線延遲與實際連線測試，再還原複雜規則。若出現相容性問題，記下記錄中的具體錯誤並保留可重現的條件，不要一次重設所有設定。
設定與疑難排解
近期教學文章
完成首次設定後，再依實際遇到的問題深入閱讀。記錄錯誤、主介面操作與憑證參數應分開處理，避免把不同層級的問題混在一起，進而大幅重設設定。
V2Ray TLS 交握錯誤原因：系統時間不同步與 SNI 偽裝網域填寫錯誤
憑證過期、x509 驗證失敗等錯誤，多半與本機時間不準或 SNI 和憑證網域不一致有關。本文依平台提供校時與參數確認步驟。
查看排除問題步驟v2rayN 主介面功能詳解：伺服器清單、訂閱群組、記錄面板與參數設定
逐區塊說明 v2rayN 主視窗：伺服器清單的右鍵選單、訂閱群組的篩選與更新、底部記錄與狀態列，以及參數設定中的常用選項。
查看介面說明v2rayN 核心啟動失敗排除：從記錄面板找出 config.json 設定錯誤
看懂記錄中的連接埠遭占用、JSON 解析失敗及未知協定欄位等錯誤，依錯誤關鍵字逐項修正設定，讓核心重新啟動。
檢查啟動記錄