Windows
v2rayN桌面端優先選擇 v2rayN。跨平台桌面版與傳統 WPF 版採用不同的介面技術，執行環境需求也應分別確認。首次安裝請先閱讀下載頁說明，再依系統架構選擇版本；已有設定的使用者，升級前應備份訂閱群組、自訂路由與 DNS 設定。
啟動後先確認核心能正常運作，再匯入訂閱並設定目前使用的伺服器。若瀏覽器未使用系統代理，請優先檢查瀏覽器擴充功能、個別代理設定，以及用戶端的系統代理狀態。終端機通常需要另外指定代理；瀏覽器已連線，不代表所有桌面應用程式都已接入。
前往下載設定問答
從目前遇到的問題開始
先分清訂閱、用戶端與核心，再修改對應設定。用戶端顯示「已連線」，通常只代表本機代理已啟動；網站能否開啟，還要看節點參數、應用程式的代理方式、DNS 與路由是否搭配得宜。以下依常見操作逐一說明，範例欄位採 Xray 風格設定；其他核心請以實際設定格式為準。
哪些設定要先確認？
群組備註
日常使用訂閱網址貼上完整連結
儲存後操作更新目前訂閱
連線前確認選擇使用中的伺服器
先建立訂閱群組，再貼上完整連結並更新。訂閱網址用來取得伺服器清單，不等於單一伺服器的分享連結；若匯入類型選錯，常見情況是更新後清單為空。儲存後確認目前選取的群組，再選擇一台伺服器作為連線項目。若更新失敗，先檢查連結是否失效、回傳內容是否為登入頁面，以及用戶端能否連上該網址。分享畫面截圖時，請遮住完整訂閱連結，避免一併公開存取憑證。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}先確認哪些目的地需要直連，再將具體規則排在範圍較廣的規則之前。路由通常依序比對，第一條符合的規則會決定出站；只在末尾新增直連規則，可能無法覆蓋前面的代理規則。範例中的 direct 必須對應實際存在的出站標籤，核心也必須能讀取 geosite 資料檔。儲存後重新載入設定，並透過新建立的連線查看記錄。比起反覆切換全域模式，找出規則命中的原因，更有助於維持易管理的設定。
應用程式端瀏覽器安全 DNS
系統端網路介面卡與快取
核心端
dns / routing連線目標網域或已解析的 IP
先確認由哪一層解析網域，再選擇 DNS 伺服器。瀏覽器、作業系統與代理核心可能各自使用不同的查詢路徑，修改其中一處不代表所有應用程式都會採用該設定。若網域無法開啟但 IP 可連線，請搭配記錄檢查解析失敗、結果不符預期或查詢路徑無法連通等情況。網域策略會影響路由階段是否嘗試解析，不代表所有查詢都會經過代理。每次只調整一項設定並清除相關快取，比一次更換多組伺服器更容易找出問題。
遵循系統代理的應用程式先使用系統代理
忽略代理設定的應用程式評估由 TUN 接管
啟用前檢查權限與路由衝突
啟用後檢查區域網路與 DNS
應用程式不遵循系統代理時，再評估使用 TUN。TUN 透過虛擬網路介面接收流量，與瀏覽器讀取系統代理設定屬於不同層級的機制。啟用前先確認一般代理連線正常，並檢查用戶端所需權限、虛擬網卡支援情況，以及是否與其他網路工具衝突。啟用後，測試本機裝置、區域網路服務與 DNS 是否仍可連線。TUN 無法修正錯誤的伺服器參數，也不保證每個應用程式都能正常運作；若出現異常，請先關閉 TUN，回到已確認可用的基本連線進行排查。
本機狀態時間與基本網路
訂閱內容更新並確認使用項目
核心記錄查看第一個有效錯誤
遠端參數位址、連接埠、傳輸、TLS
先確認本機網路與時間，再檢查訂閱和記錄。逾時只表示連線未能在指定時間內完成，不能直接歸因於某一種故障。先更新訂閱並確認目前使用的伺服器，接著核對位址、連接埠、傳輸方式與 TLS 參數是否相互匹配。記錄中的解析失敗、連線遭拒與交握錯誤，分別指向不同環節，應個別處理。若多台裝置在同一個網路都遇到相同問題，再進一步確認伺服器端狀態；不要反覆重裝用戶端，取代對錯誤訊息的判讀。
哪些設定要先確認？
如何匯入訂閱連結？
建立群組貼上完整連結
儲存並更新選擇使用中的伺服器
先建立訂閱群組，再貼上完整連結並更新。訂閱網址用來取得伺服器清單，不等於單一伺服器的分享連結；若匯入類型選錯，常見情況是更新後清單為空。儲存後確認目前選取的群組，再選擇一台伺服器作為連線項目。若更新失敗，先檢查連結是否失效、回傳內容是否為登入頁面，以及用戶端能否連上該網址。分享畫面截圖時，請遮住完整訂閱連結，避免一併公開存取憑證。
如何設定路由分流？
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}先確認哪些目的地需要直連，再將具體規則排在範圍較廣的規則之前。路由通常依序比對，第一條符合的規則會決定出站；只在末尾新增直連規則，可能無法覆蓋前面的代理規則。範例中的 direct 必須對應實際存在的出站標籤，核心也必須能讀取 geosite 資料檔。儲存後重新載入設定，並透過新建立的連線查看記錄。比起反覆切換全域模式，找出規則命中的原因，更有助於維持易管理的設定。
從哪裡檢查 DNS？
依序確認瀏覽器 → 系統 → 核心
查看記錄查詢路徑與解析結果
先確認由哪一層解析網域，再選擇 DNS 伺服器。瀏覽器、作業系統與代理核心可能各自使用不同的查詢路徑，修改其中一處不代表所有應用程式都會採用該設定。若網域無法開啟但 IP 可連線，請搭配記錄檢查解析失敗、結果不符預期或查詢路徑無法連通等情況。網域策略會影響路由階段是否嘗試解析，不代表所有查詢都會經過代理。每次只調整一項設定並清除相關快取，比一次更換多組伺服器更容易找出問題。
什麼時候需要 TUN？
系統代理有效先維持基本連線
應用程式忽略代理評估由 TUN 接管
應用程式不遵循系統代理時，再評估使用 TUN。TUN 透過虛擬網路介面接收流量，與瀏覽器讀取系統代理設定屬於不同層級的機制。啟用前先確認一般代理連線正常，並檢查用戶端所需權限、虛擬網卡支援情況，以及是否與其他網路工具衝突。啟用後，測試本機裝置、區域網路服務與 DNS 是否仍可連線。TUN 無法修正錯誤的伺服器參數，也不保證每個應用程式都能正常運作；若出現異常，請先關閉 TUN，回到已確認可用的基本連線進行排查。
節點連線逾時，先檢查什麼？
本機網路、時間、使用中的伺服器
遠端位址、連接埠、傳輸、TLS
先確認本機網路與時間，再檢查訂閱和記錄。逾時只表示連線未能在指定時間內完成，不能直接歸因於某一種故障。先更新訂閱並確認目前使用的伺服器，接著核對位址、連接埠、傳輸方式與 TLS 參數是否相互匹配。記錄中的解析失敗、連線遭拒與交握錯誤，分別指向不同環節，應個別處理。若多台裝置在同一個網路都遇到相同問題，再進一步確認伺服器端狀態；不要反覆重裝用戶端，取代對錯誤訊息的判讀。
如何使用這些範例？先記錄目前可正常運作的設定，再針對單一問題逐項修改。路由視窗只是呈現設定關係的示意，並非可直接匯入的完整設定；其中的出站標籤必須與用戶端產生的出站一致，規則資料庫也必須確實存在。修改後請用新連線驗證，避免因既有長連線仍沿用舊路徑，誤以為設定沒有生效。
如果介面文字與教學不同，請先找到對應功能，而不是照著選單位置逐步操作。桌面與行動用戶端的訂閱管理、記錄入口和代理接入方式並不完全相同。初次使用建議先完成一般連線，再調整分流與 DNS；發生問題時，才能釐清變動的是伺服器連線、應用程式接入方式，還是額外規則。
平台選擇
V2Ray 用戶端下載入口
桌面裝置可先選 v2rayN，Android 裝置可先看 v2rayNG；需要與 V2Fly 核心相容時，再考慮 v2flyNG。用戶端負責管理本機設定與連線，訂閱和伺服器連線參數則需另外準備。請先確認作業系統、處理器架構與所需協定，再選擇對應平台的安裝檔；不要只因檔名中出現熟悉的用戶端名稱就直接安裝。
macOS
v2rayN先在系統的「關於本機」確認處理器，再選擇對應的 Apple Silicon 或 Intel 安裝入口。v2rayN 跨平台介面保留訂閱、伺服器與路由管理等主要操作流程，但系統代理授權、網路權限與視窗位置不一定和其他桌面系統完全相同。
首次開啟若出現系統提示，請先確認下載來源與套件類型，再依照系統提供的開啟方式操作，不要直接停用整套系統安全機制。連線後分別測試瀏覽器與實際使用的應用程式；若需要 TUN，再依用戶端說明授予必要權限，並檢查本機網路存取是否受到影響。
前往下載Android
優先選擇 v2rayNGAndroid 裝置可優先選擇採用 Xray 核心的 v2rayNG，採用 V2Fly 核心的 v2flyNG 則可作為備選。多數較新的裝置可選擇 arm64 套件；不確定架構時，請先查詢裝置資訊，再考慮通用套件。套件架構決定能否安裝，協定與核心功能則決定匯入的伺服器能否實際使用。
啟動代理時，系統通常會要求授權 VPN 連線，這是行動裝置接入應用程式流量的方式，不代表用戶端會自動提供遠端伺服器。若已使用其他採用相同介面的網路工具，請留意連線衝突。若在背景執行時斷線，也要檢查省電策略與背景活動限制，先釐清是系統暫停應用程式，還是伺服器連線失敗。
前往下載Linux
v2rayNLinux 桌面可使用 v2rayN，先依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。安裝完成不代表桌面環境會自動套用系統代理；不同桌面環境、瀏覽器與終端機處理代理設定的方式各異，需依實際使用的軟體逐一確認。
若用戶端能啟動但應用程式無法連線，先確認本機監聽連接埠、代理類型與應用程式設定，再檢查系統代理是否生效。只有確實需要接管未遵循代理設定的流量時，才評估使用 TUN，並依用戶端要求處理權限。伺服器上的純命令列環境與圖形桌面屬於不同的安裝情境，本頁下載入口以桌面用戶端為主。
前往下載下載前還要確認哪些事項？
安裝用戶端後就能連線嗎？還需要有效的伺服器設定或訂閱。用戶端是管理與接入工具，無法憑空產生可用的遠端服務；已有訂閱者應先確認有效期限與支援的協定。查看首次連線步驟 →
桌面與手機的設定可以直接互換嗎？常見分享連結可能可以分別匯入，但用戶端的備份檔、路由範本與核心設定不一定相容。移轉時請先匯入伺服器，再分別確認規則。查看用戶端差異 →
生態系與維護
Project V、V2Fly 與 Xray 的關係
先分清核心與用戶端，才能了解功能支援情況。核心負責協定、路由與 DNS 等網路邏輯；用戶端則負責整合訂閱、伺服器與設定，產生可執行的設定。同一個介面名稱，不代表底層使用相同核心；同一組伺服器參數，也不一定能直接交由任意核心執行。
Project V 的背景是什麼？
Project V 是以網路代理與通訊工具為核心的開源專案，V2Ray 是其中廣為人知的核心軟體。隨著開發與維護方向演變，V2Fly 延續 V2Ray 相關開發，Xray 則以相關程式碼為基礎，發展出自己的實作與功能方向。因此，日常搜尋中的「V2Ray」有時泛指整個使用情境，有時則特指某個核心；查詢設定語法時，應使用更明確的名稱。
這種關係不代表安裝一套軟體就能同時取得所有功能。圖形用戶端可以封裝不同的核心呼叫方式，而各核心則各自決定支援哪些協定、傳輸方式與設定欄位。若遇到「伺服器可以匯入但無法啟動」，應先確認實際使用的核心與啟動記錄，再判斷是否有欄位無法辨識，而不是只看用戶端名稱推測相容性。
V2Fly 與 Xray 該如何選擇？
先依伺服器提供的協定與傳輸需求選擇，再考量既有設定的移轉成本。兩者共用部分概念與歷史基礎，但功能方向與設定支援並不完全相同。包含 REALITY、特定 flow 等參數的設定，應確認所選核心實際支援的情況；不能只改檔名或複製到另一個用戶端，就認為轉換已完成。
對一般使用者而言，訂閱提供的完整參數通常比抽象的核心效能比較更重要。位址、連接埠、驗證資訊、傳輸方式與 TLS 選項必須相互匹配；少一個欄位就可能造成交握失敗。若沒有在相同環境下進行可重複的測試，不宜將單次連線速度歸因於核心本身。先維持連線可用，再針對明確問題調整，得出的結論更可靠。
三款用戶端各自負責什麼？
v2rayN 適用於桌面系統，提供訂閱管理、伺服器選擇與相關代理設定介面；v2rayNG 適用於 Android 裝置，採用 Xray 核心；v2flyNG 同樣適用於 Android 裝置，採用 V2Fly 核心。三者都是開源用戶端專案，但並非由本站開發，也不能將其中一款的功能說明直接套用到另外兩款。桌面環境可先看 v2rayN，行動裝置則依協定需求選擇。
開源代表程式碼及其授權條款可供了解與檢視，不代表遠端伺服器也由同一個專案提供。用戶端專案、核心專案與訂閱服務是不同環節。本站整理下載入口與中文操作說明，協助釐清這些環節之間的關係；伺服器的授權、可用性與使用範圍，仍須依服務提供者的資訊確認。
如何理解開源授權與更新？
開源授權規範程式碼使用、修改與再散布的條件，不應將「程式碼可檢視」解讀為可以忽略授權條款。V2Fly 相關核心與 Xray 的核心程式碼採用 MPL 2.0；個別檔案、相依套件與圖形用戶端仍應分別查看各自的授權聲明。用戶端、核心與附加元件可能採用不同授權，發行套件中的聲明才是確認實際使用條件的依據。
更新也分為不同層面：用戶端更新會影響介面與設定產生邏輯，核心更新涉及網路實作，規則資料更新會影響網域或 IP 分類，訂閱更新則會取得服務端提供的伺服器清單。這些更新不一定會同步進行。變更前請先備份，更新後查看記錄並測試常用應用程式；若問題只在更新後出現，請記下變動的元件，避免一次重設所有設定而失去排查線索。
Project VV2FlyXray開源用戶端
關於本站與內容範圍 →
近期文章
連線疑難排解與進階原理
排查設定問題時先從現象著手，探討原理則回到協定與核心。以下三篇依最近發布日期排序：節點連線逾時適合逐步排除連線路徑問題；系統代理問題則要分開檢查瀏覽器與終端機；REALITY 與 Vision 則有助於了解伺服器參數為何不能任意省略。閱讀時請保留自己的記錄脈絡，不要把不同錯誤當成同一個問題處理。
V2Ray 節點連線逾時：從本機到伺服器端的排查順序
依序檢查本機時間、訂閱更新、核心記錄、傳輸與 TLS 參數，以及伺服器端狀態，逐項排除節點連線逾時，並附上 v2rayN 與 v2rayNG 的對應查看位置。
查看連線逾時排查步驟 →v2rayN 系統代理未生效：分別排查瀏覽器與命令列終端機
瀏覽器未使用代理通常與擴充功能和 PAC 有關；終端機未使用代理，則需要手動設定環境變數。分別檢查這兩種情況，並說明何時值得評估 TUN 模式。
分辨應用程式的代理路徑 →REALITY 與 XTLS Vision 原理解析：減少一層加密為何能提升速度
解析 TLS 疊加 TLS 所造成的重複加密負擔，說明 Vision 如何改善資料傳輸、REALITY 如何改變憑證部署方式，並解釋 flow 與公鑰欄位的意義及適用條件。
了解協定與傳輸參數 →