桌面裝置可先看 v2rayN，Android 裝置則可先看 v2rayNG。安裝套件需符合作業系統與處理器架構；客戶端負責管理設定，實際連線仍需可用的伺服器參數或訂閱網址。
初次安裝可先了解 Desktop 桌面版；習慣傳統介面的使用者，也可以查看 WPF 版。兩者採用不同的介面框架，選擇時請考量系統需求與現有設定，不必只因介面改版就遷移。
下載前請在系統「關於」中確認裝置架構。首次啟動後，先找到訂閱群組與伺服器清單，再確認核心是否正常啟動。若出現執行相依項目提示，請依下載頁的說明處理，勿混用不同版本的程式檔案。
若先前安裝過其他代理工具，請先確認目前系統代理的指向。先結束舊客戶端再測試新客戶端，可降低連接埠遭占用或代理設定反覆被覆寫的機率。
請依「關於這台 Mac」顯示的晶片選擇安裝套件：Apple Silicon 選 arm64，Intel 選 x64。確認架構後，再依系統提示完成安裝並首次開啟 App。
系統代理權限與 TUN 所需權限並不相同。建議先完成一般系統代理連線，確認伺服器可用後，再考慮虛擬網卡模式。首次授權失敗時，請回到系統設定檢查相關項目，不要反覆重新安裝。
若 App 能正常啟動，但瀏覽器無法連線，請先核對系統代理的位址與連接埠，再檢查是否有其他網路工具同時接管流量。安全性提示的處理方式，可參考部落格中的 macOS 安裝與權限說明。
v2rayNG 採用 Xray 核心，適合從常見分享連結與訂閱匯入開始使用；v2flyNG 採用 V2Fly 核心，可作為相應設定情境的替代選擇。請依設定所需功能挑選，不要只憑客戶端名稱判斷連線能力。
較新的主流裝置通常選 arm64；若不確定架構，請先查詢裝置資訊，再確認通用安裝套件的適用範圍。匯入設定後選擇伺服器，啟動連線時依系統提示授予 VPN 權限。
若連線容易在背景中斷，請檢查電池最佳化與背景執行限制。Wi-Fi 與行動網路的 DNS 和網路條件可能不同，建議分別測試並記錄情況，再決定是否調整客戶端設定。
請依發行版的套件管理系統選擇 deb 或 rpm，再確認裝置架構為 x64 或 arm64。桌面版可在圖形介面中管理設定；安裝後仍須確認桌面環境的代理設定與客戶端一致。
有些應用程式會讀取系統代理，有些則使用獨立代理設定，因此瀏覽器能連線不代表所有程式都已接入。請先用明確支援代理的應用程式驗證，再逐一檢查其他應用程式的流量入口。
若要使用 TUN，也須考量權限、現有路由與 DNS 管理方式。不要同時變更多個網路管理元件；先保存原設定，再一次調整一項，發生異常時才能判斷是哪個步驟影響連線。
將設定分成五個獨立環節：先取得伺服器參數，再選擇執行核心，最後設定流量入口與出站規則。以下示意用於說明設定用途，不會變更裝置上的客戶端。
訂閱可用來集中管理伺服器設定，適合需要定期同步節點的情況。在訂閱群組中新增網址與容易辨識的名稱，再執行更新，確認伺服器清單中是否出現相應群組。分享連結則可從剪貼簿匯入，兩種方式請勿混用。首次連線尚未建立時，可先嘗試不透過代理更新；若網址只能在特定網路環境存取，再依實際情況調整。更新失敗時，先查看錯誤提示、網址有效期限與系統時間，不必立刻重新安裝客戶端。訂閱網址可能包含存取憑證，請避免公開截圖。
訂閱群組 → 新增訂閱網址 → 更新訂閱核心負責執行連線、解析協定與處理路由；客戶端介面則負責產生及管理設定。v2rayN 可在支援的設定中使用 Xray 或 sing-box，但切換核心不代表所有參數都能原封不動地沿用。請先確認伺服器使用的協定、傳輸方式與擴充欄位，再選擇能解析這些參數的核心。切換後請檢查啟動日誌與實際連線，特別留意不支援的欄位、連接埠占用或設定產生失敗。設定已正常運作時，不必頻繁更換核心；只有遇到明確的相容性需求或故障線索時，再逐項比對測試。
系統代理決定支援該設定的應用程式如何連入客戶端，但不會直接決定流量最後走直連或代理。自動設定系統代理會將系統入口指向本機監聽連接埠；清除系統代理可移除該入口；不變更系統代理則保留現有系統設定。初次使用可先選擇自動設定，再用瀏覽器測試。若只有部分應用程式生效，應檢查該 App 是否會讀取系統代理，而非直接認定伺服器故障。結束客戶端前也要確認系統代理已還原，避免本機監聽停止後，應用程式仍向原連接埠傳送請求。
路由會依據比對條件選擇出站，適合將區域網路、指定網域或特定位址導向不同連線路徑。請先了解預設路由模式，再新增少量明確規則，避免一開始就匯入大量來源不明的規則。網域規則仰賴客戶端取得網域資訊，位址規則則以目標位址為依據，兩者也會受到 DNS 策略影響。規則順序須依核心的比對機制確認，不能只看名稱判斷結果。測試時請同時查看存取日誌與目標是否可連線；頁面成功開啟只代表連線成立，不足以證明流量使用了預期的出站。
| 比對規則 | 出站 |
|---|---|
| geosite:cn | direct |
| geoip:private | direct |
TUN 透過虛擬網卡接入流量，可供不讀取系統代理的應用程式使用，但須搭配權限、路由與 DNS 設定。建議先確認一般代理連線正常，再啟用 TUN，方便區分伺服器問題與流量接入問題。啟用前請記錄原本的網路設定，並關閉可能衝突的其他虛擬網卡工具。啟用後分別測試瀏覽器、目標應用程式與區域網路存取，確認是否出現解析失敗或路由迴圈。若網路異常，先關閉 TUN 並確認連線已恢復，再查看日誌找出原因；不要同時變更核心、節點與 DNS。
驗證一般連線 → 檢查權限 → 啟用 Tun 模式 → 測試 DNS 與路由先讓一組設定穩定運作，再加入分流與虛擬網卡功能。每個步驟都保留可觀察的結果；遇到錯誤就停在當前環節排除，避免把安裝、訂閱與網路問題混在一起。
先從下載頁選擇符合平台與架構的安裝套件，安裝完成後開啟客戶端。桌面裝置可使用 v2rayN，Android 裝置可優先了解 v2rayNG；教學中的選單名稱可能因介面更新而不同，但訂閱管理、選擇伺服器與啟動連線的基本順序相同。
若取得的是訂閱網址，請在訂閱群組中新增項目並更新；若取得的是單一分享連結，請使用從剪貼簿匯入的功能。匯入後先確認群組與伺服器類型是否正確，並檢查是否出現清單空白或解析錯誤，再選擇一組設定進行測試。
客戶端不會自動產生可用伺服器。訂閱由提供者維護，網址失效、流量額度用盡或設定變更都可能影響連線。請像保管存取憑證一樣妥善保管訂閱；向他人詢問問題時，先遮蔽網址中的敏感資訊。
桌面端先選擇伺服器，再啟用自動設定系統代理，讓支援系統代理的應用程式接入客戶端。Android 端啟動連線時，請確認已授予系統 VPN 權限。首次測試先使用客戶端內建的基本路由設定，暫時不要疊加自訂規則。
檢查日誌是否出現核心啟動失敗、監聽連接埠遭占用或協定參數錯誤。啟動按鈕狀態改變只代表客戶端開始執行流程，不能取代實際連線測試。若有其他代理軟體同時執行，請先暫停其中一款，避免兩個程式互相變更流量入口。
伺服器選擇、系統代理與路由模式是三項不同設定。更換伺服器後，仍須確認應用程式使用的是目前客戶端的監聽連接埠；調整路由後，也要確認測試請求確實進入客戶端。
使用瀏覽器開啟穩定的網頁，再測試日常需要連線的應用程式。分別確認網域能否解析、連線是否建立，以及存取日誌中是否有相應請求。若瀏覽器正常而特定 App 失敗，請先檢查該 App 的代理設定與網路入口。
發生異常時，一次只調整一項：先更換一組已知可用的設定，或先切換網路環境，不要同時更換核心、路由與 DNS。記錄錯誤提示、操作順序與發生時間，通常比反覆點選測速更有助於找出問題。
確認連線正常後，再逐步新增分流規則或啟用 TUN。結束使用時，請檢查系統代理是否已還原；更新客戶端前先備份設定，更新後以相同的目標重新測試，方便判斷變化來自哪個環節。
了解「客戶端、核心、協定」三個層次，比記住某個按鈕的位置更重要。它們分別負責設定管理、連線執行與通訊規範，彼此不能取代。
Project V 是以 V2Ray 為基礎發展的開源代理工具生態系，核心功能包括協定處理、傳輸、DNS 與路由。V2Fly 延續 V2Ray 的社群維護路線；Xray 則以相關技術為基礎，發展出自有核心與擴充功能。兩條路線背景相近，但功能與設定各有差異，不能簡單視為只更換名稱。
客戶端將這些功能整合成圖形介面，方便管理訂閱、伺服器清單與常用選項。實際執行連線的是核心。因此，介面能辨識某個分享連結，不代表目前使用的核心一定支援其中所有參數；遇到連線問題時，需一併檢查匯入結果與核心日誌。
協定、傳輸與安全層也應分開理解。VMess、VLESS、Trojan 與 Shadowsocks 是常見設定中的協定名稱；WebSocket、gRPC 等描述傳輸方式；TLS 與 REALITY 則涉及連線安全機制。能否使用某種組合，取決於伺服器設定與客戶端核心是否共同支援，而不只是看協定標籤。
v2rayN 著重桌面端設定管理，提供 Windows、macOS 與 Linux 版本，適合集中管理訂閱、切換伺服器及調整代理與路由。v2rayNG 適用於 Android 裝置，採用 Xray 核心；v2flyNG 同樣適用於 Android，但採用 V2Fly 核心。三款客戶端皆為開源專案，選擇時應著重裝置平台與所需設定的相容性。
開源表示程式碼可依相應授權條款閱讀、使用及參與維護。客戶端、核心與附帶相依套件可能採用不同授權，實際授權範圍請以各專案隨版本提供的授權文件為準。免費客戶端與訂閱服務也是兩回事：軟體的使用方式不會決定伺服器提供者的服務條件、流量額度或有效期限。
本站以這三款客戶端為主，整理下載資訊與繁體中文教學，不以客戶端名稱作為連線品質指標。實際使用體驗還會受伺服器資源、網路環境、DNS、路由規則與應用程式行為影響。評估一組設定時，應固定測試條件、檢查日誌，並區分本機設定與遠端服務問題。
客戶端更新、核心更新、訂閱更新與規則資料更新是不同操作。前兩者會影響程式行為，訂閱更新會變更伺服器參數，規則資料則影響網域與位址分類。發生異常時，先確認最近變更的是哪一層，不要一次重設所有內容。
升級前先保存現有設定與重要選項，並閱讀版本變更說明。升級完成後，以原先正常的伺服器及相同應用程式進行驗證，再調整其他選項。保留可回復的設定紀錄，有助於避免重新設定時遺漏項目。
「無法連線」還需進一步釐清：是訂閱更新失敗、核心未啟動、網域解析失敗，還是連線建立後中斷？請先記錄具體症狀，再檢查相應環節。系統時間不準、連接埠占用與參數過期，都可能造成類似的連線失敗。
分享日誌前，請刪除訂閱網址、帳戶資訊與伺服器憑證。通常只保留錯誤類型與必要的前後文，就足以說明問題。常見症狀可先查閱 常見問題；若要從基礎概念逐章學習，請參閱 完整手冊。
依遇到的問題挑選文章：macOS 安裝權限、FakeDNS 與 TUN 搭配方式，以及新手常見概念。文章補充特定情境的處理方式；首次安裝仍建議依使用指南完成基本連線。
逐步處理 macOS 顯示無法驗證開發者、App 已損毀、網路延伸功能與系統代理授權等問題，並附上「隱私權與安全性」設定中的允許方式。
閱讀文章 →說明 FakeDNS 如何以保留位址池取代真實解析、如何搭配網域分流與 TUN，以及哪些情境適合啟用或停用。
閱讀文章 →一次解答新手最常遇到的十個問題：該安裝哪款客戶端、如何匯入訂閱、Xray 與 V2Fly 核心有何差異，以及如何選擇系統代理或 TUN。
閱讀文章 →