Windows
v2rayN桌面版採用跨平台介面，經典 WPF 版則沿用傳統桌面操作方式。請依介面偏好與系統需求選擇，不要將介面差異誤認為節點協定不同。安裝前先在系統設定中確認裝置架構；首次啟動後匯入一筆可用設定，再設定系統代理。
移轉設定時，請保留原有的訂閱分組與自訂路由。若應用程式沒有使用系統代理，先檢查應用程式本身的設定，再考慮其他流量接管方式。
圖形客戶端負責管理設定，核心負責執行連線。先確認伺服器資訊完整，再決定哪些應用程式使用代理、哪些請求直接連線。以下依桌面、Android 與設定結構說明操作；右側片段僅示範部分欄位，並非可直接連線至遠端伺服器的完整設定。
在訂閱分組設定中新增網址，儲存後執行更新，再確認伺服器清單是否顯示協定、位址與連接埠。訂閱連結與單一分享連結的匯入入口不同，不能只憑網址長度判斷格式。不同來源建議分開建立分組，避免更新時混淆節點。訂閱網址通常包含存取憑證，請只儲存在自己的裝置；排查問題時記下錯誤訊息，不要將完整網址貼到公開頁面。
選取目前使用的伺服器後，先確認核心已啟動，再設定系統代理。系統代理會提供本機代理位址給遵循系統設定的應用程式使用，不代表所有程式都會經過代理。路由模式則決定交由核心處理的請求要使用哪個出站，兩者屬於不同層次。初次使用可先保留預設路由，測試瀏覽器連線後再逐步調整規則；若要接管更多應用程式，再閱讀虛擬網卡模式的權限與衝突說明。
連接埠可連通不代表協定交握成功。TCPing 主要反映 TCP 連線建立情況；實際連線測速還會涉及代理交握與目標請求，但仍無法代表所有網站的使用體驗。選取節點後，綜合客戶端記錄、瀏覽器請求與出口 IP，確認連線是否生效。若測速成功但應用程式仍無法使用，先檢查該程式是否使用系統代理，再檢查路由與 DNS，不要立刻反覆更換伺服器。
{ "inbounds": [ { "tag": "socks-in", "listen": "127.0.0.1", "port": 10808, "protocol": "socks", "settings": { "auth": "noauth", "udp": true } } ]}v2rayNG 可從剪貼簿匯入單一分享連結，也可在訂閱設定中儲存訂閱網址並更新內容。匯入前請確認剪貼簿沒有多餘說明文字，匯入後檢查伺服器類型與傳輸參數。節點名稱只是備註，不能據此判斷實際協定。初次設定建議先測試一筆資訊完整的伺服器，確認可連線後再整理訂閱分組，較容易分辨是格式問題還是伺服器本身的問題。
首次啟動連線時，Android 會顯示 VPN 連線授權提示。允許後，客戶端才能透過系統提供的介面接收應用程式流量。裝置上若同時執行其他 VPN 工具，可能發生資源占用衝突，請先確認目前由哪個工具建立連線。應用程式代理決定哪些應用程式使用客戶端，路由規則則決定這些請求如何出站；排除某個應用程式後，該應用程式的連線不會再由同一套路由接管，排查時需分開檢查。
若螢幕關閉後連線中斷，先檢查系統電池管理策略、背景執行權限與客戶端通知狀態。若只在行動網路或 Wi-Fi 下連線失敗，記錄切換前後的記錄，分辨是網域解析、遠端交握還是底層連線逾時。不要一次修改多項設定，否則難以判斷哪些調整有效。使用 REALITY 或特殊傳輸節點時，也需確認目前核心支援相應參數；不能因客戶端介面相似，就認定彼此相容。
{ "routing": { "domainStrategy": "AsIs", "rules": [ { "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" } ] }}入站描述核心如何在本機接收連線，常見欄位包括監聽位址、連接埠、協定與驗證方式。若只供本機應用程式使用，可用迴路位址明確限制監聽範圍；改成允許區域網路存取前，應先考慮驗證與防火牆設定。應用程式填寫的是本機入站連接埠，而非遠端伺服器連接埠。若出現位址已被使用的錯誤，先檢查其他客戶端或舊程序，再修改連接埠，並同步更新應用程式中的代理設定。
路由會依網域、目標 IP、連接埠或入站標籤選擇出站。規則通常依序比對，範圍較廣的規則若排在前面，可能讓後續精確規則無法生效。使用 geosite 與 geoip 時，須確認相應規則資料可用；引用某個出站標籤時，也必須存在同名的出站。新增規則前先儲存原始設定，再以明確目標測試比對結果，避免同時修改 DNS、嗅探與路由，失去排查線索。
出站負責連線至遠端服務，或執行直連、阻擋等動作。VLESS、VMess 與 Trojan 是不同的代理協定；REALITY 則是與安全傳輸相關的機制，不能只更換協定名稱就完成轉換。訂閱通常會提供遠端位址、身分資訊、傳輸與安全參數，但不同格式所包含的資訊不盡相同。手動移轉時需逐項核對，尤其留意伺服器名稱、傳輸路徑、公鑰及所選核心的支援情況。
{ "outbounds": [ { "tag": "direct", "protocol": "freedom", "settings": {} }, { "tag": "block", "protocol": "blackhole", "settings": {} } ]}桌面端建議從 v2rayN 開始；Android 端則依節點需求選擇 v2rayNG 或 v2flyNG。客戶端名稱、核心系列與處理器架構是三個不同面向：先選作業系統，再確認晶片架構，最後核對協定支援情況。下載頁集中列出安裝入口與適用說明，避免混用外觀相似的套件。
桌面版採用跨平台介面，經典 WPF 版則沿用傳統桌面操作方式。請依介面偏好與系統需求選擇，不要將介面差異誤認為節點協定不同。安裝前先在系統設定中確認裝置架構；首次啟動後匯入一筆可用設定，再設定系統代理。
移轉設定時，請保留原有的訂閱分組與自訂路由。若應用程式沒有使用系統代理，先檢查應用程式本身的設定，再考慮其他流量接管方式。
依「關於這台 Mac」顯示的晶片資訊，選擇 Apple Silicon 或 Intel 安裝套件。使用符合裝置架構的套件，可減少相容層帶來的額外變數。首次啟動若出現系統安全提示，先確認應用程式來源與系統需求，再依下載頁說明處理；不要為了啟動程式而長期關閉系統保護。
系統代理的生效範圍取決於應用程式是否遵循相關設定。排查時也要確認本機監聽連接埠、目前使用的伺服器與瀏覽器代理選項。
建議先了解採用 Xray 核心的 v2rayNG；需要相容 V2Fly 核心時，再考慮 v2flyNG。多數裝置使用 arm64 套件，若不確定架構，可查看通用版說明。兩款應用程式的核心能力不同，使用 REALITY 或特定傳輸參數時，應先確認協定需求，不能只照抄介面選項。
首次連線需要系統 VPN 授權。連線後請保持通知顯示，並檢查電池管理策略，分辨是應用程式受到背景限制，還是遠端伺服器中斷。
先依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。安裝圖形客戶端後，仍需檢查桌面環境的代理設定；瀏覽器、終端機與其他應用程式可能各自有獨立的代理選項。軟體安裝成功只代表程式可執行，不表示系統中的所有連線都已經透過代理。
保留現有網路設定作為參照。遇到本機連接埠占用或權限問題時，先查看記錄，再調整客戶端選項，避免多個代理程序同時接管流量。
查看所有客戶端 →選好安裝套件後，接著匯入訂閱並確認連線。
日常討論中的「V2Ray」可能指專案、核心，也可能泛指相關客戶端。排查問題時應區分這幾個層次：圖形介面決定如何輸入設定，核心決定如何執行欄位，伺服器設定則決定連線需要哪些參數。名稱相近不代表功能完全相同，也不表示所有設定都能直接互換。
Project V 是理解 V2Ray 專案背景的重要起點。V2Ray 以模組化設定組織代理連線，將接收請求的入站、選擇路徑的路由，以及實際發起連線的出站分開。V2Fly 是延續 V2Ray 開發的社群專案，其核心與相關規則資料是這個生態系的重要組成。理解這種設定模型，比記住某個介面的按鈕位置更有助於移轉。
教學提到 SOCKS 入站、網域規則或直連出站時，指的是核心中的職責分工，不是三台獨立裝置。一個客戶端可以管理多台伺服器，但每個請求最後使用哪個出站，仍由實際執行的設定決定。圖形介面產生的內容也可能隨客戶端設定改變，因此排查時應以目前執行狀態與記錄為準，而不只是查看曾經儲存的節點名稱。
Xray 從 V2Ray 相關程式碼發展而來，並形成自己的功能演進路線。XTLS Vision、REALITY 等功能通常需確認 Xray 的支援情況；V2Fly 也有自己的設定與傳輸功能演進。共享專案背景，不代表兩者在所有欄位、傳輸組合與預設行為上都一致。複製設定前，先確認來源指定的核心，再檢查客戶端實際呼叫的核心。
協定名稱相同，也不足以判斷相容性；還要檢查傳輸方式、安全層、流量控制參數與身分資訊。遇到「無法識別欄位」或「交握失敗」時，應分別確認設定解析與網路連線兩個階段。前者優先檢查核心支援與欄位寫法，後者再檢查伺服器位址、系統時間與安全參數。閱讀 Xray 與 V2Fly 差異說明，進一步了解節點需求與客戶端能力的差異。
v2rayN 是桌面圖形客戶端，提供伺服器管理、訂閱更新、代理設定與路由設定入口；實際連線能力仍取決於所選核心。v2rayNG 適用於 Android 裝置，主要搭配 Xray 核心相關功能；v2flyNG 則是採用 V2Fly 核心的 Android 替代選擇。三款客戶端皆為開源軟體，選擇時應先確認平台、核心與使用情境，再看應用程式名稱。
開源授權規範程式碼使用、修改與散布的條件。客戶端、核心與規則資料由不同專案組成，個別授權應查看軟體隨附的授權說明。開源有助於了解軟體來源與實作方式，但不能取代設定檢查，也不能證明訂閱來源可信。本網站整理安裝與使用文件，不提供遠端伺服器帳號；安裝客戶端後，也不會自動取得可用的伺服器連線資訊。
客戶端更新、核心更新、訂閱更新與規則資料更新並非同一件事。更新介面程式不一定會變更訂閱內容，更新訂閱也不一定會增加核心功能。升級前記下目前使用的伺服器、代理模式與自訂路由，並保留必要的設定備份。升級後先重新測試原本可用的情境，再啟用新功能；若同時更換伺服器、調整 DNS 並修改分流規則，發生問題時很難判斷原因。
排查記錄可只包含發生時間、客戶端名稱、核心類型、錯誤摘要與重現步驟。分享記錄前，請刪除訂閱網址、身分識別資料及其他敏感參數。憑證錯誤先檢查裝置時間與伺服器名稱；連線逾時先確認位址是否可達及不同網路下的差異；只有特定應用程式失敗時，先檢查代理接管範圍。客戶端比較適合用來選擇工具，常見問題可快速定位，疑難排查手冊則提供依症狀逐步檢查的完整流程。
完成首次連線後，再處理核心選擇、路由順序與 TLS 參數。閱讀時先確認問題發生在哪一層，再依文章中的檢查順序逐步縮小範圍。設定範例需配合實際伺服器參數與核心能力調整，不建議直接以局部片段覆蓋現有設定。
遇到憑證無效、交握失敗等提示時，依序檢查裝置時間、SNI 與偽裝網域是否一致、allowInsecure 開關及指紋設定，逐項排除常見 TLS 錯誤原因。先確認錯誤發生在憑證驗證還是建立連線階段，再決定下一步；不應把略過憑證驗證當成一般解決方法。
閱讀 TLS 排查步驟 →從 domainStrategy 說明 geosite、geoip 規則的撰寫順序，並提供中國大陸直連、海外走代理、廣告封鎖三種常見情境的路由範例。重點是確認規則是否被前面的寬泛條件搶先比對，以及 outboundTag 是否對應實際存在的出站；分流結果也需搭配 DNS 與目標位址確認。
閱讀路由設定說明 →整理兩個核心系列的發展背景，比較 XTLS Vision、REALITY 等功能的支援情況，並說明 v2rayNG 與 v2flyNG 的選擇方式。移轉前逐項確認協定、傳輸方式、安全層與欄位，避免只因節點名稱相同就認為設定可以直接沿用；客戶端介面允許填寫，也不代表核心能夠執行。
閱讀核心差異說明 →查看所有文章 →也可參閱首次連線與訂閱格式專題。