01 / 用戶端下載
先確認作業系統與處理器架構，再選擇安裝檔。桌面端可查看 v2rayN；Android 裝置建議優先選用 v2rayNG，若有 V2Fly 核心相容需求，再考慮 v2flyNG。下載頁面彙整各平台入口與安裝條件；首頁不固定列出特定版本。
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面，WPF 版則保留經典桌面操作方式。兩者皆可管理設定與訂閱，請依系統需求及個人使用習慣選擇，無須為同一組訂閱同時安裝兩種介面。
安裝前，請先在系統的「關於」頁面確認系統類型。首次啟動後，先匯入現有設定並選取目前使用的設定，再設定系統 Proxy。瀏覽器通常會讀取系統 Proxy；終端機與部分應用程式則須另外設定 Proxy 位址。用戶端能啟動，不代表所有程式都已透過 Proxy 連線。
移轉既有設定時，請先備份訂閱群組與自訂路由。保留一組可正常使用的設定，再逐項調整本機連接埠與 Proxy 模式，方便比對差異。
v2rayN 的 macOS 安裝檔依 Apple Silicon 與 Intel 分開提供。請在「關於這台 Mac」查看晶片或處理器資訊，再下載對應安裝檔。不同桌面系統之間可以共用設定內容，但仍須重新確認本機檔案路徑、權限與網路連線方式。
安裝完成後，先確認訂閱能否正常匯入，再檢查目前使用的設定與監聽連接埠。系統 Proxy 與 TUN 接管的範圍不同；後者還會涉及網路權限和路由變更。初次設定建議先採用容易檢查的連線方式，確認連線結果後再新增規則。
遇到系統安全性提示時，請先閱讀提示內容，並確認下載的檔案符合裝置架構。啟動失敗、權限要求與遠端連線失敗是不同問題，請分開排查。
v2rayNG 使用 Xray 核心，適合管理常見分享連結與訂閱；v2flyNG 使用 V2Fly 核心，可作為特定設定需求的替代選擇。多數較新的裝置可選 arm64；若不確定架構或安裝時遇到相容性問題，再依下載頁說明選擇通用版。
匯入設定後，還須選取要使用的項目並啟動連線。系統會要求建立 VPN 連線，這是將應用程式流量導入本機轉送路徑的必要步驟。若已有其他應用程式使用類似連線，請先確認是否衝突，再檢查個別應用程式 Proxy、路由模式與電池背景執行限制。
v2rayNG 的訂閱匯入與單一連結匯入是不同入口。需要日後更新一組設定時，請使用訂閱群組；若要暫時匯入單一設定，則可透過剪貼簿或掃描 QR Code。
Linux 桌面端可使用 v2rayN，請依發行版的套件管理系統選擇 deb 或 rpm，再確認處理器架構為 x64 或 arm64。套件格式與處理器架構是兩項獨立條件：套件管理器能辨識檔案，不代表程式一定能在目前的處理器上執行。
安裝後，透過圖形介面匯入訂閱並檢查本機監聽狀態。桌面環境、瀏覽器與終端機讀取 Proxy 設定的方式可能不同，請分別測試。啟用 TUN 前，也要確認所需權限與系統路由，避免同時執行多個接管流量的工具而產生衝突。
排查時，先保留預設路由與連接埠，查看記錄中是否有監聽或解析錯誤。先區分用戶端啟動問題與應用程式連線問題，再調整核心設定。
02 / 設定區段索引
圖形介面負責產生與管理設定，核心則依設定執行轉送。先了解資料從何處進入、由哪個出站傳送，再調整路由與 DNS，可減少同時變更多項設定而出錯的情況。以下片段僅用來說明欄位，並非可直接連線至遠端的完整設定。
本機入站會接收瀏覽器或其他應用程式傳來的連線。圖形用戶端通常會代為產生這段設定；日常使用時，先在設定中確認監聽連接埠，再讓應用程式使用相同的位址與連接埠。範例僅監聽迴路位址，適合本機連線；若要開放給區域網路使用，必須另外設定存取控管。SOCKS 與 HTTP 入站的使用方式不同，不能只改連接埠而忽略協定。若連接埠已被占用，應先找出衝突的程式，而不是一再更換遠端設定。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}出站設定描述連線最後如何傳送。Proxy 出站需要伺服器提供的位址、連接埠與驗證參數，不能只靠協定名稱自動建立連線。範例展示直連與阻斷兩種基本出站，方便理解路由如何引用標籤。使用 VMess、VLESS 或 Trojan 時，還須確認傳輸方式與安全層；REALITY 是安全傳輸相關功能，並非與這些協定完全同一層級的替代選項。建議保留匯入的參數，再依實際核心支援調整，避免自行猜測欄位組合。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}路由規則會將符合條件的連線交給指定出站，但不會建立出站本身。範例將私有位址交給 direct；實際設定必須有同名標籤，並提供可讀取的位址資料檔案。規則通常依序處理，範圍較大的規則若放得太前面，可能會先行涵蓋後續的精確規則。IPIfNonMatch 表示網域規則未命中時，會嘗試解析網域，以便繼續比對 IP 條件；這不代表所有網域都會預先解析。調整後，請同時查看目標網域與命中的出站，確認規則確實生效。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}DNS 設定會影響核心需要解析網域時的處理方式，但不代表所有應用程式的查詢都會自動進入核心。應用程式是否自行解析、是否啟用流量接管，以及出站如何處理網域，都會影響實際解析路徑。範例限制查詢 IPv4，並使用本機解析來源，僅用來說明欄位關係，並非通用的最佳化方案。確認裝置網路與目標服務條件後，再限制位址類型。若網域無法連線，但直接使用 IP 位址正常，請先檢查解析記錄與解析來源，再考慮修改 DNS 伺服器清單。
{
"dns": {
"servers": ["localhost"],
"queryStrategy": "UseIPv4"
}
}03 / 開源生態系與維護
產品名稱、核心名稱與協定名稱分別代表不同層次。選擇用戶端時，先確認執行平台；確認設定能否使用時，再查看核心支援範圍與伺服器參數。開源生態系提供可檢視的實作與持續更新，但實際連線結果仍取決於設定、系統與網路條件。
PROJECT V
Project V 是認識 V2Ray 工具生態系的起點。核心負責協定處理、連線轉送、路由與解析等基本功能；圖形用戶端則提供設定編輯、訂閱管理與系統連線功能。因此，搜尋「V2Ray 官方網站」或「V2Ray 用戶端」時，可能會看到專案文件、核心說明與圖形程式等不同內容。本網站依下載、入門與欄位參考分類整理，避免把不同層次的資訊混在同一份安裝清單中。
了解這些差異後，問題也更容易分類：找不到匯入選單，通常應先查看用戶端操作；記錄指出欄位無法辨識，則要確認核心支援情況；瀏覽器未連上本機連接埠，應檢查系統 Proxy。更換圖形介面不一定能修正遠端參數錯誤，修改協定也不能取代正確的應用程式連線設定。
XRAY / V2FLY
V2Fly 延續 V2Ray 的社群維護路線；Xray 則以相關技術為基礎，發展出自己的功能與設定能力。兩者有不少共通概念，但新增欄位、傳輸組合與預設行為並不一定完全相同。尤其是 REALITY 與 XTLS Vision，應確認適用於 Xray 的設定，不要將設定片段直接套用到任意核心。選擇核心應以所需功能與設定相容性為依據，而非只看名稱，也不要預設某一種核心永遠比較快。
選擇 V2Ray 協定也需要伺服器端配合。VMess、VLESS 與 Trojan 的驗證方式各不相同；TLS、REALITY 與傳輸層參數則涉及另一組設定條件。分享連結通常包含這些組合資訊，匯入後請檢查位址、連接埠、伺服器名稱與流控設定。測試成功只能證明特定測試路徑可用，不代表所有網站與應用情境都已驗證。
CLIENTS
v2rayN 適用於桌面環境，可管理訂閱群組、目前使用的設定、路由與 Proxy 連線；可用核心則依發行套件與用戶端支援範圍而定。v2rayNG 適用於 Android 裝置，使用 Xray 核心並透過系統 VPN 管理連線。v2flyNG 同樣適用於 Android 裝置，但採用 V2Fly 核心，適合既有設定明確依賴此實作的情況。這三款用戶端皆為開源專案，使用前仍請詳閱各自的發行說明與授權文件。
用戶端負責儲存設定，不會自動提供伺服器。訂閱網址與驗證參數須從可信來源取得，並依使用授權妥善保管。訂閱連結可能包含存取憑證，排查問題時請勿公開完整網址。分享錯誤資訊時，可保留錯誤類型、欄位名稱與操作步驟，同時移除網址中的個人識別資訊與驗證內容。
LICENSE / UPDATE
開源授權會說明原始碼的使用、修改與再散布條件。圖形用戶端、核心與隨附資料資源可能適用不同授權，不能將整個生態系簡單歸為同一種授權。免費使用也不會改變伺服器資源、網路存取與第三方服務各自的使用條款。設定手冊旨在說明技術欄位，不能取代專案授權文字，也不保證任何來源的設定都適用。
更新用戶端是替換程式與相關元件；更新訂閱是重新取得一組連線設定；更新路由資料則會改變 geosite、geoip 等分類的比對依據。三者解決的問題不同。升級前請備份自訂路由與訂閱群組；升級後先確認已知可用的設定，再逐項啟用新功能。請勿將「訂閱更新成功」當成程式已更新，也不要在一次排查中同時修改所有設定。
首次使用時，先確認匯入內容的類型：以 vmess://、vless:// 等開頭的內容通常是分享連結；用來定期取得一組設定的網址，則應加入訂閱管理。匯入完成後，選取目前要使用的項目，再啟用適合目前平台的流量連線方式，最後分別測試瀏覽器與需要連網的應用程式。每完成一步再進行下一步，便能清楚判斷問題出在匯入、連線或應用程式接入。
既有設定突然失效時，先檢查本機監聽、目前使用的設定與錯誤記錄，再查看訂閱是否有變更。V2Ray 延遲測試與實際瀏覽網頁並非相同的驗證方式：測試目標、解析路徑與規則命中都可能不同。需要操作步驟時，請查看入門指南；要依錯誤現象排查，請查看常見問題；需要修改欄位時，再參閱JSON 手冊。
04 / 設定主題
以下主題分別說明設定來源、連線分流與應用程式接入。請先依問題所在的層次閱讀，再回到用戶端確認結果。格式轉換只能改變資料的呈現方式，無法補上缺少的伺服器參數；路由規則只能選擇既有出站，也無法取代正確的連線設定。
比較三種常見訂閱與設定格式的結構及適用情境，說明格式互轉的做法，以及轉換後如何在用戶端確認匯入結果。
閱讀文章 →透過實際 routing 設定範例，示範中國大陸網站直連、境外網站走 Proxy 的分流方式，並說明 domainStrategy 的取捨與規則比對順序。
閱讀文章 →瀏覽器與終端機讀取 Proxy 設定的方式不同。從擴充功能衝突、PAC 模式、環境變數與本機連接埠四個方向逐項排查。
閱讀文章 →