DESKTOP
Windows
使用 v2rayN 管理訂閱分組、節點選擇、系統代理與路由規則。下載頁提供新一代桌面介面與傳統 WPF 介面，前者適合希望維持跨平台操作一致性的使用者，後者適合熟悉傳統 Windows 選單結構的使用者。安裝後先確認系統架構，再依教學完成首次訂閱更新。
前往下載LINK INSPECTION
連線檢修台：從匯入到出站逐段核對
客戶端連線問題通常不是單一開關造成的。先確認設定是否已匯入客戶端，再判斷核心能否啟動、路由是否命中，以及系統流量是否進入本機連接埠。以下依實際連線順序拆開檢查，每個項目都對應可執行的介面操作。
INPUT / SUBSCRIPTION
先確認訂閱已進入正確分組
v2rayN 桌面端與 v2rayNG Android 端都支援訂閱網址和單一節點分享連結，但入口、分組概念與更新操作並不完全相同。匯入後應先查看節點是否出現在目標分組，再手動執行一次訂閱更新，接著選擇具體節點作為目前伺服器。只把網址儲存到訂閱設定中，不代表節點已寫入主要清單；更新失敗時也不應反覆刪除客戶端，而應依序核對網址完整性、裝置時間、目前網路與日誌回傳內容。
本站教學將「儲存訂閱」「更新分組」「選擇節點」拆成獨立步驟，避免把三個動作混在一起。相較於只標示按鈕位置的簡短說明，這個順序能明確判斷故障發生在輸入、解析還是選擇階段，也方便在不同客戶端介面之間套用設定。
CORE / PROTOCOL
將客戶端介面與代理核心分開理解
圖形客戶端負責訂閱管理、系統代理、路由編輯與日誌顯示，真正處理協定握手、傳輸與出站連線的是核心。v2rayN 可搭配 Xray 與 V2Fly 生態系中的設定結構，v2rayNG 主要面向 Xray 核心，v2flyNG 則提供基於 V2Fly 的 Android 端選擇。選擇客戶端時應先考量平台與操作習慣，再確認節點所需的協定及傳輸組合能否由對應核心處理。
VMess、VLESS、Trojan 與 Shadowsocks 是協定層選項，TLS、WebSocket、gRPC 等則屬於安全性或傳輸組合，不能只憑協定名稱判斷設定是否完整。本站文件會同時標示位址、連接埠、使用者識別碼、傳輸方式、TLS 與 serverName 等相關欄位，減少只修改一個欄位後仍無法建立連線的情況。
MATCH / OUTBOUND
用規則順序決定流量去向
路由分流不是把網域簡單分成兩組，而是讓客戶端依規則順序檢查目標網域、目標 IP、程序或連接埠，並將首次命中的流量送往代理、直連或阻擋出站。規則過寬會覆蓋後續條件，規則過窄則可能漏掉同一服務使用的其他網域。編輯後應確認規則集已啟用、目標出站名稱存在，並透過日誌觀察請求最後命中了哪條規則。
常見的驗證方式是先保留一套最小規則，確認基礎連線正常後，再逐項加入區域網路直連、常用服務分組與自訂網域。如此可以明確找出是哪一組條件改變了結果。若瀏覽器能存取而終端程式無法存取，還要繼續檢查該程式是否讀取系統代理，不能直接將現象歸因於路由規則。
LOG / DIAGNOSIS
依日誌階段縮小故障範圍
客戶端顯示逾時，只能表示連線未在規定時間內完成，不能直接證明訂閱或節點已失效。排查時先看核心是否成功啟動，再看 DNS 是否回傳目標位址，接著檢查 TCP 連線、TLS 握手、協定驗證與路由出站。不同階段的錯誤對應不同處理方向：系統時間偏差常會影響憑證判斷，serverName 不一致會影響 TLS，連接埠被佔用則會讓本機代理無法監聽。
本站故障文件依「客戶端啟動—本機連接埠—網域解析—遠端握手—應用程式接入」組織檢查流程，並提供每一步的停止條件。確認某一步正常後再進入下一步，可以減少同時修改多個開關所引入的新變數，也方便還原至最近一次可用設定。
PLATFORM ENTRY
依作業系統進入客戶端下載頁
不同平台使用不同安裝格式與權限模型。桌面端優先使用 v2rayN，Android 可依核心需求在 v2rayNG 與 v2flyNG 之間選擇。平台入口會直接開啟下載頁的對應標籤，首頁不提供安裝包直連。
DESKTOP
macOS
v2rayN 桌面端依處理器架構提供相應的安裝入口。開啟系統資訊即可判斷裝置使用 Apple Silicon 或 Intel 處理器；架構選擇錯誤時，安裝包可能無法正常啟動。首次執行還需要依系統提示完成應用程式確認，並在客戶端中明確啟用所需的系統代理模式。
前往下載MOBILE
Android
v2rayNG 適合需要 Xray 協定支援與分應用程式代理的使用者，v2flyNG 則是 V2Fly 核心方向的替代選擇。首次連線時，系統會要求授權本機 VPN 服務；授權只負責將應用程式流量交給客戶端處理。為減少背景斷線，還應檢查系統省電策略，並將客戶端加入允許背景執行的清單。
前往下載DESKTOP
Linux
v2rayN 提供適用於常見軟體包系統的桌面安裝入口。使用 Debian、Ubuntu 等發行版時選擇 deb，使用 Fedora、Rocky Linux 等發行版時選擇 rpm，同時還要區分 x64 與 arm64 架構。連線後若瀏覽器正常而終端無法使用，需進一步設定代理環境變數或採用適合的流量接入方式。
前往下載QUICK START
從訂閱匯入到連線驗證的三步驟順序
首次設定不需要同時調整所有進階選項。先建立一條最小可用連線，再依應用程式範圍加入路由與分流規則，能更快判斷問題位於設定、節點還是系統流量入口。
-
STEP 01 / IMPORT
匯入訂閱並更新分組
在 v2rayN 中開啟「訂閱分組」管理入口，新增訂閱名稱與完整網址，儲存後返回主介面執行更新；在 v2rayNG 中進入訂閱設定，儲存網址後從選單觸發訂閱更新。更新完成後先核對節點數量與名稱是否有變化，再選擇一個節點作為目前伺服器。若清單為空，應先查看更新提示與日誌，不要直接進入系統代理設定，因為此時客戶端還沒有可用的遠端設定。
-
STEP 02 / CONNECT
啟動核心並選擇流量入口
桌面端先啟動選定的節點，確認日誌顯示本機代理連接埠已在監聽，再依使用情境開啟系統代理。只需要瀏覽器和會讀取系統代理的桌面程式時，系統代理通常已足夠；終端工具、特定應用程式或不讀取系統設定的程式，則需要另行設定代理環境變數或採用更完整的接入方式。Android 端選擇節點後啟動連線，並完成系統顯示的本機 VPN 服務授權。
-
STEP 03 / VERIFY
用日誌和實際請求驗證連線
連線按鈕顯示已啟動，只能表示客戶端流程已開始。接下來應開啟一個實際需要連網的應用程式，觀察請求是否進入客戶端日誌，並確認路由規則選擇了預期的出站。如果日誌中沒有任何請求，重點檢查系統代理、應用程式代理設定或 Android 分應用程式範圍；如果已有請求但握手失敗，則核對裝置時間、位址、連接埠、TLS 與 serverName 等節點欄位。
OPEN ECOSYSTEM
Project V、V2Fly 與 Xray 的生態關係
客戶端名稱、核心名稱與協定名稱經常同時出現，但它們處於不同層級。理解三者的關係後，才能依據平台、節點設定與功能需求選擇合適的客戶端。
Project V 提供協定與設定體系的基礎脈絡
Project V 是 V2Ray 生態形成過程中的基礎專案脈絡，V2Ray Core 曾圍繞入站、出站、路由、DNS、傳輸與策略等模組建立可組合的設定方式。圖形客戶端並不是這些網路能力本身，而是將設定管理、系統接入與執行狀態整理成可操作的介面。使用者在客戶端中看到的伺服器位址、連接埠、使用者識別碼、傳輸方式與路由規則，最終仍須轉換成核心能讀取的設定。
這種分層結構解釋了為什麼相同訂閱可以在不同客戶端中匯入，卻可能因核心支援範圍、欄位對應或客戶端更新節奏而產生不同結果。排查時應先區分是介面沒有儲存設定、訂閱解析不完整，還是核心無法識別某項協定參數，避免把所有問題都歸為「節點無法使用」。
V2Fly 與 Xray 屬於相關但獨立演進的核心家族
V2Fly 延續 V2Ray Core 的社群維護方向，著重模組化代理能力、路由與傳輸組合；Xray 則在相近的設定體系上持續擴充協定與傳輸能力。兩者共享不少概念，例如入站、出站、路由規則、DNS 與策略設定，但具體支援項目、欄位細節與更新節奏並不完全一致。訂閱中出現某種協定或傳輸組合時，應確認目標客戶端目前使用的核心是否能處理這些欄位。
核心差異不代表所有使用者都需要手動編輯複雜設定。多數情況下，客戶端會依訂閱內容產生設定並啟動對應核心。只有在日誌提示欄位不受支援、訂閱轉換遺漏參數，或需要編寫自訂路由時，才需要進一步查看核心與設定結構。本站相關教學會明確標示哪些步驟屬於客戶端介面，哪些判斷需要配合核心日誌。
LICENSE
開放原始碼授權與程式碼審閱
v2rayN、v2rayNG、v2flyNG 以及相關核心均以開放原始碼專案方式維護。開放原始碼授權規定程式碼使用、修改與散布的基本界線，社群參與者可以針對協定相容性、平台適配、介面功能與錯誤修正提交改進。對一般使用者而言，開放原始碼最直接的意義是客戶端與核心的職責、設定結構及變更討論都能公開記錄，而不是由單一封閉介面決定所有行為。
MAINTENANCE
客戶端與核心分別更新
圖形客戶端與代理核心可能採用不同的發布節奏。客戶端更新通常涉及介面、訂閱管理、系統代理與平台相容性；核心更新則多與協定實作、傳輸組合、路由及 DNS 行為相關。因此遇到新協定無法識別時，應同時核對客戶端是否支援對應設定，以及核心是否具備所需能力。升級前保留現有訂閱分組與自訂路由記錄，方便更新後逐項還原設定。
SELECTION
依平台與核心需求選擇
桌面平台優先使用 v2rayN，可在相近的操作邏輯下管理 Windows、macOS 與 Linux 設定；Android 常用 v2rayNG，需要 V2Fly 核心方向時可選擇 v2flyNG。選擇標準不應只看客戶端名稱，還要考量訂閱採用的協定、裝置架構、系統權限，以及是否需要分應用程式代理。客戶端比較頁提供三者的定位、適用平台與功能界線。
COMMON CHECKS
常見問題精選
以下是首次安裝與日常使用中最常見的四類情況。每項先提供檢查方向，完整步驟可繼續前往快速上手、常見問題或故障排查頁面。
儲存訂閱後為什麼沒有節點？
儲存網址只完成訂閱來源登記，還需要主動執行訂閱更新。若更新後仍然空白，先確認網址沒有遺漏字元，再檢查系統時間、目前網路與更新日誌。部分錯誤會直接指出請求失敗、解析失敗或回傳內容格式不符合預期，依錯誤階段處理比重複匯入更有效。
查看訂閱匯入步驟 →客戶端已連線，但瀏覽器仍無法存取？
先查看瀏覽器請求是否出現在客戶端日誌中。沒有請求通常表示系統代理尚未啟用、瀏覽器使用獨立代理設定，或本機監聽連接埠與系統設定不一致；已有請求則繼續檢查 DNS、路由命中與遠端握手。兩種情況的處理方向不同。
查看無法上網排查 →瀏覽器正常，終端機指令為什麼不走代理？
許多瀏覽器會讀取系統代理，而終端程式通常依賴自身設定或環境變數。確認客戶端本機 HTTP、SOCKS 連接埠後，再依工具支援的方式設定代理變數；需要涵蓋更多程式時，可評估適合該系統的流量接入模式。不要只憑瀏覽器結果判斷所有應用程式都已接入。
查看系統代理排查 →節點測速正常，實際連線仍然失敗怎麼辦？
基礎連通測試只能反映部分網路條件，完整連線還涉及協定驗證、TLS、serverName、傳輸方式與路由出站。應發起實際請求並查看核心日誌，確認失敗發生在解析、連線、握手還是驗證階段，再核對對應欄位，而不是連續切換大量節點。
開啟常見問題頁 →RECENT NOTES
協定選擇與客戶端排查文章
近期內容涵蓋協定橫向比較、TLS 憑證類錯誤與 Android 背景連線設定。文章以具體症狀或設定任務為切入點，提供可複核的欄位與操作順序。
VMess、VLESS、Trojan、Shadowsocks 差異與選擇：四種代理協定橫向比較
從加密方式、傳輸負擔、偽裝能力與核心支援四個面向整理協定差異，並結合家用寬頻、行動網路與效能受限裝置說明選擇條件。閱讀時可將協定層與 TLS、WebSocket 等傳輸層設定分開判斷。
閱讀全文 →V2Ray 顯示 TLS 握手失敗或憑證錯誤怎麼辦：時間不同步與 SNI 設定排查
TLS 報錯時應先核對裝置系統時間，再檢查 serverName 與憑證網域是否一致，接著查看相關安全選項與指紋設定。文章依握手階段說明常見錯誤，避免直接將憑證問題判定為節點失效。
閱讀全文 →v2rayNG Android 使用要點：VpnService 授權、省電白名單與分應用程式代理設定
說明首次連線授權的作用、系統省電策略對背景連線的影響，以及分應用程式代理中「繞過」與「僅代理」兩種範圍的差異。適合處理切換應用程式後斷線、背景執行一段時間後停止等行動端問題。
閱讀全文 →