先確認作業系統與處理器架構，再選擇對應的安裝套件。
v2rayN
依使用習慣選擇桌面版或經典 WPF 版。桌面版採用跨平台介面；WPF 版保留經典視窗配置，兩者皆可管理訂閱與系統代理。
前往下載 →v2rayN
開啟「關於這台 Mac」查看晶片資訊。Apple Silicon 與 Intel 使用不同安裝套件；安裝完成後，依系統提示確認啟動及網路相關權限。
前往下載 →v2rayNG / v2flyNG
建議先查看採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時，再了解 v2flyNG。依裝置架構選擇安裝套件，首次連線時需確認系統 VPN 授權。
前往下載 →v2rayN
依發行版選擇 deb 或 rpm，再確認 x64 或 arm64 架構。此處介紹搭配桌面環境的圖形用戶端，安裝後需另外確認桌面系統代理是否生效。
前往下載 →下載用戶端只代表已備妥本機工具。伺服器位址、協定參數與訂閱網址須由設定提供者提供，用戶端本身不會自動建立可用的遠端連線。取得設定後，先確認它是訂閱網址、單一分享連結，還是完整設定檔，再選擇相應的匯入入口。若將訂閱網址當成分享連結貼上，或把網頁網址當成訂閱網址更新，可能會導致清單空白。
首次安裝建議保留預設監聽設定，先匯入一份來源明確的設定，選取伺服器，再啟用一種連線方式。不要同時修改連接埠、DNS、路由與核心，否則出現問題時難以判斷是哪項設定造成變化。桌面端可先透過系統代理測試瀏覽器；Android 端則先確認 VPN 授權與連線通知。基本連線正常後，再依應用程式需求調整分流與背景執行策略。
查看所有用戶端 →依需求找到設定項目。示意卡僅供說明，不會變更本機設定。
依設定來源建立訂閱群組，輸入訂閱網址後執行更新。群組可保留來源資訊，之後更新時不必逐筆重新匯入；單一分享連結則適合臨時測試。更新前確認網路可連上訂閱網址，更新後檢查伺服器清單及目前選取的項目。若清單空白，先查看日誌，不要反覆刪除所有設定。訂閱網址可能含有存取憑證，截圖或尋求協助時應遮蔽完整網址。相較於手動管理多筆連線，透過群組更新更容易統一管理，但能否使用仍取決於設定來源。
透過路由規則決定要求要直連、經由代理，或阻擋出口。先選擇用戶端提供的基礎路由，再依需求新增網域或位址規則，避免一開始就維護龐大的規則集。規則通常依序比對，較具體的條件應放在適當位置；區域網路裝置連線異常時，先檢查私有位址是否被送往代理。系統代理只負責將流量導入用戶端，路由才決定導入後的去向。調整後使用相同應用程式與目標重新測試，並核對日誌中的出口，不要只憑模式名稱判斷實際行為。
先透過系統代理連線，讓遵循系統代理設定的應用程式使用；需要涵蓋其他流量時，再評估 TUN。系統代理通常不需要虛擬網卡權限，但有些程式會忽略這項設定。TUN 透過虛擬網路介面接收流量，涉及權限、路由與 DNS，啟用前應確認目前平台支援及所需元件。排錯時先只啟用一種方式，避免多個代理工具同時接管網路。關閉用戶端前，請清除系統代理；關閉 TUN 後，確認網路是否恢復。兩者不是速度等級，也不代表所有流量一定會經過相同出口。
將用戶端介面與實際處理連線的核心分開理解。介面負責編輯、匯入與啟動，核心則負責解析設定、建立傳輸及執行路由。選擇核心前，先確認協定、傳輸方式與參數是否受支援；即使協定名稱相同，支援的擴充功能也可能不同。v2rayN 可依選取的設定及用戶端支援範圍使用相應核心；Android 端則需區分 v2rayNG 與 v2flyNG 的核心系列。切換後請重新啟動連線並查看啟動日誌。不要把切換核心當成通用修復方式；設定不相容時，應回頭檢查個別參數。
先記下失敗時間，再開啟日誌重現一次操作。啟動錯誤優先檢查監聽連接埠、權限及設定解析；進入連線階段後，再區分網域解析、遠端連線與握手失敗。看到逾時不應立即更改所有設定，先確認失敗的是訂閱更新還是實際代理要求，兩者使用的網路路徑可能不同。暫時提高日誌詳細程度有助於定位，排查完成後再恢復常用等級。分享日誌前，請隱藏位址、訂閱憑證與個人路徑；保留與錯誤相關的上下文，比只截取最後一行更容易判斷原因。
依序操作：「匯入設定 → 選取伺服器 → 設定連線方式 → 驗證實際要求」。各平台與用戶端更新後，介面名稱可能略有不同；找不到入口時，先查看主視窗的設定選單、系統匣選單與日誌區域，不要直接套用其他平台的權限處理方式。
查看代理模式設定步驟 →分清專案、核心與介面，依設定需求選擇工具。
V2Ray 屬於 Project V 相關的代理工具生態系，核心概念是組合入站、出站、傳輸與路由等功能。日常使用時，通常不必直接編輯整份底層設定，而是透過圖形用戶端輸入參數或匯入訂閱。搜尋「V2Ray」時看到的名稱可能指專案、核心，也可能泛指這類用戶端；先確認討論對象，才能判斷教學是否適用於目前裝置。
將連線過程拆成幾個層次會更容易理解：應用程式先將要求交給本機入口，本機核心依規則選擇出口，再使用伺服器設定建立連線。用戶端中的伺服器清單只是管理設定的介面，並不代表遠端服務本身。介面能正常開啟，不代表伺服器可連線；連線按鈕顯示已啟用，也不能取代實際測試網頁或應用程式要求。了解這些差異是後續排錯的基礎。
V2Fly 社群延續 V2Ray 相關核心的開發與維護；Xray 則從相關程式碼基礎發展成獨立核心專案。兩者有部分共同的技術背景，但支援能力、設定細節與更新步調並不完全相同。選擇時應確認目前連線所需的協定、傳輸與安全參數，而不只是比較專案名稱。若使用特定擴充功能，也要確認用戶端已支援相應的編輯與匯入方式。
成功匯入只代表用戶端辨識到設定，不一定表示目前使用的核心已正確套用所有參數。如果某項設定在一款用戶端可連線，換到另一款卻失敗，應先比較核心系列、傳輸設定及產生的設定差異。不要直接以其他平台的底層片段覆蓋目前使用的設定；先備份，再依該用戶端支援的入口逐項調整。
v2rayN 適用於桌面平台，提供伺服器清單、訂閱群組、路由及日誌等圖形管理功能。跨平台桌面版與 Windows 經典 WPF 版的介面及執行環境不同，選擇時先確認系統支援，再考量視窗配置與使用習慣。在同一台電腦測試不同版本前，建議分別保存程式與設定資料夾，避免共用檔案造成設定遭覆寫或誤判遷移結果。
v2rayNG 適用於 Android，採用 Xray 核心，適合在手機上匯入訂閱並透過系統 VPN 連線。v2flyNG 同樣適用於 Android，採用 V2Fly 核心，可作為有相應核心需求時的替代選擇。兩款應用都需分別確認連線權限與背景執行設定；切換測試前先停止另一款的連線，避免系統 VPN 連線狀態互相影響。手機進入休眠後斷線時，應搭配電池策略與日誌判斷原因，而不是一再重新匯入訂閱。
這三款用戶端皆以開源方式開發，公開原始碼讓功能實作與設定處理有可討論、可檢視的基礎。開源不代表整個生態系採用同一份授權：v2rayN 與 v2rayNG 採用 GPL 系列授權，V2Ray 核心採用 MIT 授權，Xray 核心採用 MPL 2.0。用戶端、核心及隨附相依套件應分別查看各專案的授權條款，尤其是修改與散布時。
一般使用者更應留意安裝套件適用的平台、所需權限、設定來源及更新說明。原始碼公開不能取代對訂閱提供者的判斷，也無法保證在所有網路環境中都能正常連線。分享設定、截圖或排錯資料時，仍應保護訂閱網址與連線憑證。需要他人協助時，提供系統、用戶端類型、失敗步驟及相關錯誤即可，不必公開完整設定。
用戶端更新、核心更新與訂閱更新是不同工作。用戶端更新可能改變介面及產生設定的方式；核心更新可能影響協定與傳輸行為；訂閱更新則用來重新整理伺服器設定。遇到「更新後無法連線」時，先確認變更發生在哪一層。下載頁集中提供安裝入口，首頁則負責平台選擇與操作導覽；詳細安裝需求請以下載頁及相關說明為準。
升級前備份訂閱群組、手動設定與自訂路由，並關閉正在執行的連線，再依平台要求完成安裝。升級後先用原本可用的設定測試一次，確認正常後再調整新功能。若出現異常，記錄變更前後的操作與日誌，避免連續更新多項內容而失去比較基準。還原舊設定時也要留意相容性，不要將新舊程式檔案任意合併到同一個資料夾。
驗證前先確認測試用的應用程式是否遵循系統代理，再前往可確認網路出口的頁面測試。瀏覽器可用但某個桌面應用程式無法連線時，通常應先檢查該應用程式的代理行為；只有部分網域異常，則應接著檢查路由與 DNS。日誌顯示核心成功啟動，只代表核心已執行，不能據此判定所有應用程式都已連線。測試時盡量固定應用程式與目標，讓前後結果可以比較。
遇到連接埠占用時，先關閉重複執行的用戶端或其他監聽程式；變更本機連接埠後，也要同步修改使用該連接埠的應用程式設定。關閉用戶端後網路異常，先確認系統代理是否仍指向已停止的本機監聽。依「入口、路由、解析、遠端連線」的順序檢查，通常比反覆重新安裝更有效。完整文件依平台整理安裝、訂閱、代理與常見問題，可在基本設定完成後繼續查閱。
從介面選擇、連接埠衝突到 Android 背景執行設定，依遇到的問題閱讀。
比較 v2rayN 的 Avalonia 跨平台桌面版與僅支援 Windows 的 WPF 版，說明介面風格、系統支援、系統匣行為及執行相依需求，協助不同使用者選擇合適版本。
閱讀版本選擇說明 →v2rayN 啟動時提示連接埠遭占用，可使用系統指令找出占用 10808 等連接埠的程序，再到參數設定中變更本機監聽連接埠，並同步調整系統代理。
閱讀連接埠排查步驟 →整理 v2rayNG 在 Android 上耗電較高的常見原因，說明電池最佳化白名單、背景執行限制與 VPN 常駐通知的取捨，並依裝置型號提供調整方向。
閱讀背景設定建議 →